{"uid":"cap_GeazRX6eYDEKP7aD35HRN","slug":"scanna-event-catalog-search-8bd6d1bc","name":"Scanna Event Catalog Search","description":"Cross-venue event catalog with free-text search (q), venue and status filters, and limit/offset paging pushed into SQL. Search uses a trigram index on title; if that index is absent or INVALID it falls back to a bounded ILIKE, so search stays bounded either way. total is CAPPED for display: 10000 means at least 10000, not exactly. Unknown venue is 400 BAD_VENUE. No match returns total 0 and an empty, billable 200.","url":"https://api.scanna.xyz/catalog/events","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":[],"properties":{"q":{"type":"string","description":"Free-text search over the event title"},"limit":{"type":"integer","default":50,"maximum":200,"minimum":1},"venue":{"type":"string","description":"Single venue. Unknown venue is 400 BAD_VENUE."},"offset":{"type":"integer","default":0,"maximum":10000,"minimum":0},"status":{"type":"string","default":"active","description":"Lifecycle status. Defaults to active."}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["events","limit","offset","total","updated_at"],"properties":{"limit":{"type":"integer"},"total":{"type":"integer","description":"CAPPED for display. A value at the cap means 'at least', not 'exactly'."},"events":{"type":"array","items":{"type":"object","required":["category","id","market_count","mutually_exclusive","slug","status","sub_title","title","url","venue","venue_event_id"],"properties":{"title":{"type":"string"},"venue":{"type":"string"},"status":{"type":"string"},"public_id":{"type":"string","description":"Stable public UUID — internal ids are never exposed"},"market_count":{"type":"integer"}}}},"offset":{"type":"integer"},"updated_at":{"type":"string","format":"date-time","description":"REQUEST time, not data age. The catalog behind it can be hours old."}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.010014","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.010014/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.010014","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.010014","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_SyAXL-juN62VmKLo3nKNA","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.010014","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Searches and pages through a cross-venue prediction market event catalog with free-text title search, venue and status filters, and limit/offset pagination","exampleAgentPrompt":"Search the Scanna event catalog for active events about the US election on Polymarket, and show me the first 20 results.","exampleUseCases":[{"title":"Discovering election prediction events","prompt":"Search the Scanna catalog for any active events related to 'presidential election' on Polymarket — give me up to 50 results."},{"title":"Browsing all active Kalshi events","prompt":"Pull the first 100 active events from Scanna's event catalog filtered to Kalshi, no keyword filter needed, just show me what's live."},{"title":"Finding sports events by keyword","prompt":"Can you search the Scanna event catalog for active events with 'NBA championship' in the title, limited to 25 results starting from offset 0?"}],"resultDescription":"Returns a paginated list of cross-venue prediction market events, each with title, slug, venue, status, market count, mutually_exclusive flag, sub_title, URL, and a stable public UUID. Also returns total (capped at 10000 for display), limit, offset, and the request timestamp as updated_at. If no events match, returns total 0 and an empty events array (still a billable 200). Invalid venue returns 400 BAD_VENUE.","failureModes":["400 BAD_VENUE: the venue parameter value is not recognized — check supported venue names","Empty result (200, total=0): no events match the query/filter combination — not an error but still billed","Total capped at 10000: if total equals 10000, actual count may be higher; cannot determine exact total beyond cap","Stale data: updated_at reflects request time, not data freshness — catalog may be hours old","Trigram index fallback: if index is absent or invalid, search uses bounded ILIKE which may be slower or less precise"],"whenToPreferThis":"Use this endpoint when you need to discover or search prediction market events across venues (Polymarket, Kalshi, etc.) by keyword, filter by venue or lifecycle status, and page through results. Prefer this over market-level endpoints when you want event-level metadata and want to search by title text. It is the right choice for event discovery workflows, catalog browsing, or building lists of matching events before diving into market detail.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:38:24.480Z","isFirstParty":false}