TicketWeb API endpoint
Returns details for one TicketWeb event: venue, dates, age restriction, delivery methods, and per-tier ticket pricing (base price, fee breakdown, and total) when tickets are on sale. `has_tickets` is false and `sections` is empty for a free/RSVP event with no paid tickets, a sold-out event, or an access-code-gated event -- TicketWeb's own data does not reliably distinguish these three cases at this level, so the response reports the shared observable state (no purchasable sections) rather than guessing which applies.
/ticketweb/eventQuery parameters:
id: required. Numeric TicketWeb event id, e.g. 14241184 (the trailing path segment of ticketweb.com/event/<slug>/<id>).Notable response behavior:
sections lists each ticket tier (e.g. "GA Standing", "Reserved Seating"), each with one or more prices. Every price reports base (pre-fee face value), a fees breakdown, and total (the amount TicketWeb actually charges -- base plus every fees component).price_range is the event's page-level min/max total across all tiers, matching the range shown near TicketWeb's own buy button. It is omitted when the event has no purchasable tickets.has_tickets is false and sections is empty for three distinct upstream states TicketWeb does not reliably distinguish at this level: a free/RSVP event with no paid tickets, a sold-out event, and an access-code-gated event. The response reports the shared observable state (no purchasable sections) rather than guessing which applies.start_time, on_sale_time, and announce_time carry TicketWeb's own timezone-offset timestamps (e.g. 2026-08-25T19:30:00.000-05:00) when the upstream event has them set.503 upstream error (TicketWeb serves a generic block/challenge shell for a bad id rather than a distinguishable 404) -- treat a 503 for a freshly-looked-up id as "check the id" as well as "retry later".| Field | Filled in, of 1 checked | Values in the sample |
|---|---|---|
| id | 1 | |
| name | 1 | “Comedy Beast” |
| category | 1 | “Arts & Theater” |
| genre | 1 | “Comedy” |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| id | string | Yes | Numeric TicketWeb event id | 14241184 | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/ticketweb/event?id=14241184" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"source_url": "https://www.ticketweb.com/event/comedy-beast-howlin-wolf-tickets/14241184",
"fetched_at": "2026-08-24T18:00:00Z",
"event": {
"id": "14241184",
"name": "Comedy Beast",
"url": "https://www.ticketweb.com/event/comedy-beast-howlin-wolf-tickets/14241184",
"start_time": "2026-08-25T19:30:00.000-05:00",
"on_sale_time": "2026-07-01T12:05:00.000-05:00",
"age_restriction": 18,
"age_restriction_message": "Ages 18+",
"venue": {
"id": "15005",
"name": "Howlin' Wolf",
"address": "907 South Peters",
"city": "New Orleans",
"state": "LA",
"postal_code": "70130",
"country": "US",
"time_zone": "US/Central"
},
"attractions": [
{
"name": "Comedy Beast",
"category": "Arts & Theater",
"genre": "Comedy"
}
],
"delivery_methods": [
{
"name": "eTickets",
"description": "Display on your mobile device or print out your ticket for entry!",
"fee": "Free"
}
],
"currency": "USD",
"has_tickets": true,
"price_range": {
"min": 8.16,
"max": 8.16
},
"sections": [
{
"name": "GA Seating",
"sold_out": false,
"purchase_limit": 10,
"prices": [
{
"name": "GA Seating",
"base": 5,
"fees": {
"credit_card": 0.16,
"per_ticket": 1.5,
"rebate": 1.5
},
"total": 8.16,
"sold_out": false,
"max_purchase_limit": 10
}
]
}
]
}
}
}Request schema
No body schema
Response schema
#/definitions/ticketweb.eventResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | ticketweb.EventResponse | No | ||||
| data.event | ticketweb.EventDetail | No | ||||
| data.event.age_restriction | integer | No | 18 | |||
| data.event.age_restriction_message | string | No | Ages 18+ | |||
| data.event.announce_time | string | No | ||||
| data.event.attractions | array | No | ||||
| data.event.attractions[].category | string | No | Arts & Theater | |||
| data.event.attractions[].genre | string | No | Comedy | |||
| data.event.attractions[].id | string | No | ||||
| data.event.attractions[].image_url | string | No | ||||
| data.event.attractions[].name | string | No | Comedy Beast | |||
| data.event.currency | string | No | USD | |||
| data.event.delivery_methods | array | No | ||||
| data.event.delivery_methods[].description | string | No | ||||
| data.event.delivery_methods[].fee | string | No | Free | |||
| data.event.delivery_methods[].name | string | No | eTickets | |||
| data.event.description | string | No | ||||
| data.event.end_time | string | No | ||||
| data.event.has_tickets | boolean | No | true | |||
| data.event.id | string | No | 14241184 | |||
| data.event.image_url | string | No | ||||
| data.event.name | string | No | Comedy Beast | |||
| data.event.on_sale_time | string | No | 2026-07-01T12:05:00.000-05:00 | |||
| data.event.price_range | ticketweb.PriceRange | No | ||||
| data.event.price_range.max | number | No | 8.16 | |||
| data.event.price_range.min | number | No | 8.16 | |||
| data.event.sections | array | No | ||||
| data.event.sections[].name | string | No | GA Seating | |||
| data.event.sections[].prices | array | No | ||||
| data.event.sections[].prices[].base | number | No | 5 | |||
| data.event.sections[].prices[].fees | ticketweb.TicketFees | No | ||||
| data.event.sections[].prices[].fees.credit_card | number | No | 0.16 | |||
| data.event.sections[].prices[].fees.facility | number | No | ||||
| data.event.sections[].prices[].fees.per_ticket | number | No | 1.5 | |||
| data.event.sections[].prices[].fees.rebate | number | No | 1.5 | |||
| data.event.sections[].prices[].fees.taxes | number | No | ||||
| data.event.sections[].prices[].max_purchase_limit | integer | No | 10 | |||
| data.event.sections[].prices[].min_purchase_limit | integer | No | ||||
| data.event.sections[].prices[].name | string | No | GA Seating | |||
| data.event.sections[].prices[].sold_out | boolean | No | ||||
| data.event.sections[].prices[].total | number | No | 8.16 | |||
| data.event.sections[].purchase_limit | integer | No | 10 | |||
| data.event.sections[].sold_out | boolean | No | ||||
| data.event.start_time | string | No | 2026-08-25T19:30:00.000-05:00 | |||
| data.event.terms_and_conditions | string | No | ||||
| data.event.url | string | No | ||||
| data.event.venue | ticketweb.EventVenue | No | ||||
| data.event.venue.address | string | No | 907 South Peters | |||
| data.event.venue.city | string | No | New Orleans | |||
| data.event.venue.country | string | No | US | |||
| data.event.venue.id | string | No | 15005 | |||
| data.event.venue.map_image | string | No | ||||
| data.event.venue.name | string | No | Howlin' Wolf | |||
| data.event.venue.postal_code | string | No | 70130 | |||
| data.event.venue.state | string | No | LA | |||
| data.event.venue.time_zone | string | No | US/Central | |||
| data.fetched_at | string | No | ||||
| data.source_url | string | No | ||||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/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/event?id=14241184" \
-H "x-api-key: $CRAWLORA_API_KEY"