SeatDataDocs
API DocumentationAPI Referencev0.x

Request event add

POST/v0.4/events/event-request-add

Submit a search query to find and add events to the SeatData platform.

Returns a job ID used to check status.

Notes:

  • Maximum 5 simultaneous jobs (pending or processing) per user
  • Maximum query length: 200 characters
  • Allowed characters: alphanumeric, spaces, basic punctuation (a-zA-Z0-9 -_.,'"&)

Authorization

AuthorizationBearer <token>

Pass Authorization: Bearer <api_key>. Preferred for new integrations.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

curl -X POST "https://example.com/v0.4/events/event-request-add" \  -H "Authorization: Bearer YOUR_API_KEY" \  -H "Content-Type: application/json" \  -d '{    "search_query": "Taylor Swift Madison Square Garden"  }'
{  "job_id": "550e8400-e29b-41d4-a716-446655440000",  "status": "pending",  "message": "Job queued.",  "active_jobs": 1,  "max_simultaneous": 5}

Search events (legacy) POST

Legacy event search (POST) - for new integrations, prefer `GET /v1/events/search`. Searches SeatData events. Returns the SeatData Event ID needed for the salesdata, listings, and v1 stats endpoints. - All search fields are case-insensitive. - Partial strings will be matched, including dates (e.g., `'2023'` in `event_date` matches all 2023 events). - All body properties are optional. - Use `historical=true` to search events before the current date. - No charge per call. > **Note:** Searches with non-Western characters (Cyrillic, CJK, > Greek, etc.) return an empty result. For multilingual lookup, > use `tm_event_id` or `std_event_id` via the v1 search endpoint. > **Caveat:** `venue_name` and `venue_state` may contain > non-standard values (e.g., "CA" or "Cal" for California). For > standardized values, use the v1 search endpoint.

Get event-add status GET

Poll for the status of a submitted event-add job. **Job Lifecycle:** - `pending` - Created, waiting to start - `processing` - Actively searching for and adding events - `completed` - Finished successfully with results - `failed` - Error occurred - `timeout` - Took longer than 3 minutes