Search Preview

Public: Fast search preview endpoint for navbar typeahead.

Returns lightweight event/market cards (title, image, probability, slug) suitable for rendering in a search dropdown without pagination overhead.

Sources (in priority order):

1. search:preview: Redis cache (30s TTL) — fastest
2. search:events: Redis cache (60s TTL) — existing search cache
3. DB direct query (≤20 rows, 5s timeout) — fallback for cold cache

Args: q: Search query string (min 2 chars required, max 50 used) limit: Max results to return (default 8, max 12)

GET /search/preview

Search Preview

cURL

curl --request GET \
  --url https://staging-api.polysimulator.com/search/preview

422

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Query Parameters

q · string · default: ""

limit · integer · default: 8

Response

200

application/json

Successful Response