Skip to main content
POST
Search events

Authorizations

apikey
string
header
required

Your Eventory API key. Sent as the apikey request header.

Body

application/json
query
string
default:""

Free-text query.

Maximum string length: 200
page
integer
default:1

1-based page index. At most the first 1,000 results of a query can be paged; past that, hits is empty.

Required range: 1 <= x <= 1000
hitsPerPage
integer
default:24
Required range: 1 <= x <= 100
sortBy
enum<string>
default:recommended

Only recommended, tickets_sold.desc, tickets_sold_24h.desc, average_ticket_price_sold.desc and capacity.desc order the whole result set. Every other value sorts only the first page × hitsPerPage results of the relevance order. See the Search filters guide.

Available options:
recommended,
event_date,
event_date.desc,
event_name,
event_name.desc,
average_ticket_price_sold,
average_ticket_price_sold.desc,
tickets_sold,
tickets_sold.desc,
tickets_sold_24h,
tickets_sold_24h.desc,
available_tickets,
available_tickets.desc,
capacity,
capacity.desc
filterExpression
string
default:""

Filter expression. See the Search filters guide.

Maximum string length: 6000
Example:

"venue_country_code:US AND tickets_sold > 1000"

Response

Search results.

hits
object[]

Numbers in hits are JSON numbers, not strings. Hits may carry other fields than the ones listed here; those can change without notice. For an event's details, call GET /eventory/data/viagogo/E-{viagogo_event_id} or GET /eventory/data/ticketmaster/{ticketmaster_event_id}.

page
integer
hitsPerPage
integer
nbHits
integer

Total matching events.

nbPages
integer
processingTimeMS
integer