API reference / Events

Enrich one event

Written and maintained by The ProspectAPIs team

POST/v1/events/enrich

POST /v1/events/enrich is the ProspectAPIs operation enrichEvent, in the Events group of the REST API. Billed as one enriched event at GET /pricing events.price_per_enriched_event_usd once events are available, only when at least one section is ok; a 400, 404, 503 or an answer with no ok section is free. One Luma or Partiful event's speakers, sponsors, agenda and side events, each section with a status (ok, not_published, unreadable with a reason), read logged out. Items parsed from the description carry source description, the heading they sat under and a confidence. Launching soon: answers 503 and charges nothing until GET /pricing reports events available. Cost: Launching soon. Send your API key as a Bearer token in the Authorization header.

How this fits with the rest of the events API, with worked examples, is in the event discovery guide.

Parameters

Request body

JSON (EventEnrichRequest). Exactly one of url or id.

{}

Responses

Every error answers with the same JSON body, an error string and sometimes a code; the errors page lists each status and when it happens. A per-key 429 carries Retry-After; see rate limits.

200 response fields

The event and its four sections, each with a status. The body is a EventEnrichResult.

Code samples

Each sample sends the same request. Set PROSPECTAPIS_KEY in your environment first. Values come from the spec's examples; replace them with your own.

curl -X POST https://api.prospectapis.com/v1/events/enrich \
  -H "Authorization: Bearer $PROSPECTAPIS_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

const res = await fetch("https://api.prospectapis.com/v1/events/enrich", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.PROSPECTAPIS_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({}),
});
if (!res.ok) throw new Error(`${res.status}: ${(await res.json().catch(() => ({}))).error ?? res.statusText}`);
const data = await res.json();
console.log(data);

import os, requests

res = requests.post(
    "https://api.prospectapis.com/v1/events/enrich",
    headers={"Authorization": f"Bearer {os.environ['PROSPECTAPIS_KEY']}"},
    json={},
    timeout=30,
)
res.raise_for_status()
data = res.json()
print(data)

Billing

Billing reserves before it serves: the call holds what it may cost, serves at most what that hold covers, and refunds the rest when the response closes. Any non-2xx answer refunds the whole hold, so a failed call costs nothing. The response reports your balance in X-Credits-Remaining.

Related

The event discovery guide covers this area end to end. Previous operation: Get one event. Every operation, grouped by area, is on the API reference index.

Create a free account to get a key, then run the samples above with your own values (this call acts for real, so use real inputs).