event-search

Search

Search ticketing/events and get ranked event bundles. Only query is required. Each result's sessions[] (and matched_sessions[] when a date filter was given) carries a per-date buy_url — a ready-to-use trackable link (CJ sid + redirect-wrapped) — hand it to the buyer directly. landing_url is the plain event page.

post/api/v1/events/search

Request

  • Base URL: https://api.intentlink.io (the document declares no server; this is the origin it was published from)
  • URL: https://api.intentlink.io/api/v1/events/search
  • Auth: none declared

Request body

querystring required

Natural-language intent, e.g. 'taylor swift concert near LA this summer'.

keywordsstring[]

Exact terms — performer / team / show / venue. Signals a precise lookup (BM25-leaning). Prefer a specific noun phrase over a bare generic word.

categoriesstring[]

Category filter, e.g. 'Concerts' / 'Sports' / 'Theater' (L1) or a full category-path level. Read GET /events/categories for valid values.

citystring nullable

City name, e.g. 'Los Angeles'.

statestring nullable

US state abbreviation, e.g. 'CA'.

countrystring
date_fromstring date nullable

Earliest event date (YYYY-MM-DD).

date_tostring date nullable

Latest event date (YYYY-MM-DD).

when'this_weekend' | 'this_week' | 'this_month' | 'next_7_days' | 'next_30_days'

Fuzzy-time helper. Expanded server-side to a date_from/date_to window (explicit date_from/date_to always win). Weeks are Mon–Sun; all windows start no earlier than today (the feed only holds upcoming events).

min_pricenumber nullable
max_pricenumber nullable
sort'relevance' | 'soonest' | 'cheapest'

Result ordering. relevance (default) is text-match first with a soonest tie-break; soonest sorts by the next upcoming date; cheapest by the lowest 'from' price.

limitinteger

Response

Successful Response

request_idstring required
statusstring required
querystring nullable
total_foundinteger nullable
agent_messagestring required
reasonstring nullable
errorsobject[]

Changes

No recorded changes to this operation across all 1 revision of this API.