SeatGeek API endpoint
Returns one page of SeatGeek events under a category/taxonomy, soonest first. taxonomy_id is a SeatGeek category id from GET /seatgeek/categories, e.g. 1010100 for MLB.
/seatgeek/events-by-categoryQuery parameters:
taxonomy_id: required. A SeatGeek category id from /seatgeek/categories, e.g. 1010100 for MLB.page: optional. 1-based page number. Defaults to 1.per_page: optional. Results per page, 1-50. Defaults to 25.Notable response behavior:
total is SeatGeek's own total count of events under the category, independent of page/per_page.events has the same shape as /seatgeek/event's response, including its own pricing stats and taxonomies.taxonomy_id is not a small fixed enum — it is SeatGeek's own ~163-node category id space, discovered via /seatgeek/categories. An id outside that set returns a well-formed empty events array with total: 0, not an error.| Field | Filled in, of 20 checked | Values in the sample |
|---|---|---|
| id | 20 | |
| title | 20 | “Salt River Rafters at Glendale Desert Dogs” and 17 other values |
| short_title | 20 | “Salt River Rafters at Glendale Desert Dogs” and 17 other values |
| type | 20 | baseball (11), mlb (9) |
| datetime_local | 20 | 2026-10-13 to 2026-10-19 |
| datetime_utc | 20 | 2026-10-13 to 2026-10-19 |
| status | 20 | normal in all 20 |
| score | 20 | 0.12 to 0.95, median 0.26 |
| popularity | 20 | 0.57 to 0.99, median 0.64 |
| url | 20 | seatgeek.com |
| venue | 20 | |
| performers | 20 | median 2 entries |
| stats | 18 | |
| taxonomies | 20 | median 4 entries |
| season_stage | 9 | postseason in all 9 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| taxonomy_id | integer | Yes | A SeatGeek taxonomy id from GET /seatgeek/categories | 1010100 | |
| page | integer | No | 1-based page number | ||
| per_page | integer | No | Results per page, 1-50 | ||
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/seatgeek/events-by-category?taxonomy_id=1010100&page=1" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"taxonomy_id": 1010100,
"page": 1,
"per_page": 25,
"total": 3475,
"events": [
{
"id": 17695775,
"title": "New York Yankees at Minnesota Twins",
"datetime_utc": "2026-09-15T23:40:00",
"venue": {
"id": 10,
"name": "Target Field"
},
"stats": {
"listing_count": 455,
"average_price": 48
}
}
]
}
}Request schema
No body schema
Response schema
#/definitions/seatgeek.eventsByCategoryResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | seatgeek.EventsByCategoryResult | No | ||||
| data.events | array | No | Event record, 57 fields: date_tbd, datetime_local, datetime_utc, description, id, is_open, performers, popularity, score, season_stage, short_title, stats and 7 more. Described under Get a SeatGeek event's detail API. | |||
| data.page | integer | No | ||||
| data.per_page | integer | No | ||||
| data.taxonomy_id | integer | No | ||||
| data.total | integer | No | ||||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 429 | Too Many Requests | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/seatgeek/events-by-category?taxonomy_id=1010100&page=1" \
-H "x-api-key: $CRAWLORA_API_KEY"