List, search and filter the market catalog
Min tier: free. Enumerate the market catalog (~2.1M markets). Keyset-paginated on condition_id; page size scales with plan (25 free / 100 terminal / 250 terminal_pro).
q is a case-insensitive substring match on the market title and requires at least 2 characters. category takes a canonical slug (politics, crypto, sports, culture, economics, tech, science, geopolitics, breaking-news) and is expanded to the underlying stored variants for you.
A market's open/closed status is deliberately not returned or filterable here — that field is unreliable on a share of rows, and filtering on a wrong status is worse than not offering it. Use /v1/markets/{slug} for a single market's detail.
Request
- Base URL: https://crowdintel.xyz/api
- URL: https://crowdintel.xyz/api/v1/markets
- Auth: HTTP bearer
Query parameters
Title substring, min 3 characters (pg_trgm trigram size). Results are relevance-ordered and capped at the first 200 matches.
Canonical category slug.
Page size (default 25; max 25 free / 100 terminal / 250 terminal_pro).
Opaque pagination cursor from a previous response's next_cursor. Omit for the first page. A cursor that is supplied but undecodable returns 400 bad_request ("Invalid cursor") — it does not silently restart at page 1.
Response
A page of catalog entries.
Changes
No recorded changes to this operation across all 1 revision of this API.