TicketWeb API endpoint
Searches TicketWeb events by artist, event, or venue. A zero count with an empty events list is a valid no-results response. availability is one of `in_stock`, `sold_out`, `unknown` per event.
/ticketweb/searchQuery parameters:
q: required. Artist, event, or venue query (2-200 characters).page: optional. One-based result page, 1 to 50. Defaults to 1.Returns TicketWeb's own search results page for the query: one entry per matching event, each with its name, canonical URL, image, start time (local venue time, no UTC offset -- TicketWeb's own search feed does not include one), venue reference, and ticket availability. A zero count with an empty events list is a valid no-results response.
availability is one of:
in_stocksold_outunknown (TicketWeb did not report an availability state for that result)Notable response behavior:
200 with count: 0 and an empty events list, not an error.venue.address is TicketWeb's own short "City, ST" string, not a full street address -- use ticketweb_venue for the venue's full address.ticketweb_event with the id from an event's URL for pricing.| Field | Filled in, of 20 checked | Values in the sample |
|---|---|---|
| id | 20 | |
| name | 20 | “Cemented Comedy Showcase (LIVE Taping) ft. Rosebud Baker, S…” and 19 other values |
| url | 20 | ticketweb.com |
| image_url | 20 | ticketweb.com |
| start_time | 20 | 2026-10-13 to 2026-10-15 |
| venue | 20 | |
| availability | 20 | in_stock (18), sold_out (1), unknown (1) |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| q | string | Yes | Artist, event, or venue query | comedy | |
| page | integer | No | One-based result page, 1-50 Minimum: 1. Maximum: 50. | ||
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/ticketweb/search?q=comedy&page=1" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"query": "comedy",
"page": 1,
"count": 20,
"source_url": "https://www.ticketweb.com/search?q=comedy",
"fetched_at": "2026-08-24T18:00:00Z",
"events": [
{
"id": "14241184",
"name": "Comedy Beast",
"url": "https://www.ticketweb.com/event/comedy-beast-howlin-wolf-tickets/14241184",
"image_url": "https://www.ticketweb.com//i/00/12/41/18/44_Listings.jpg",
"start_time": "2026-08-25T19:30",
"venue": {
"name": "Howlin' Wolf",
"address": "New Orleans, LA",
"url": "https://www.ticketweb.com/venue/howlin-wolf-new-orleans-la/15005"
},
"availability": "in_stock"
}
]
}
}Request schema
No body schema
Response schema
#/definitions/ticketweb.searchResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | ticketweb.SearchResponse | No | ||||
| data.count | integer | No | 20 | |||
| data.events | array | No | EventSummary record, 10 fields: availability, id, image_url, name, start_time, url, venue. Described under Get a TicketWeb venue API. | |||
| data.fetched_at | string | No | ||||
| data.page | integer | No | 1 | |||
| data.query | string | No | ||||
| data.source_url | string | No | ||||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/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/ticketweb/search?q=comedy&page=1" \
-H "x-api-key: $CRAWLORA_API_KEY"