Suggest
Use when an agent has a name or phrase and needs the (source, id) of the matching event or market before calling another tool. Resolves free text against events AND markets in one call, best-first, and reports total_events / total_markets so the agent can tell a precise hit from an ambiguous one. Every row carries event_path, the internal link to use for follow-up lookups. Prefer this over running list_events?search= and list_markets?search= separately when the goal is identification rather than a filtered listing. Note: headline carries literal <b> highlight markup — quote title instead, or strip the tags.
Request
- Base URL: https://api.pdata.world
- URL: https://api.pdata.world/api/v1/search/suggest
- Auth: none declared
Query parameters
Free-text query, matched against event titles and market questions. Queries shorter than 2 characters deliberately return an empty result set rather than half the dataset.
Maximum number of coalesced results to return (1-20, default 8). total_events / total_markets in the envelope are uncapped and reflect the full match count, not this limit.
Response
Successful Response
Changes
No recorded changes to this operation across all 1 revision of this API.