> ## Documentation Index
> Fetch the complete documentation index at: https://docs.polynode.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Search

> Search for games, teams, and events by name.

Search across all sports and esports events. Returns matching games with their slugs so you can drill into [Game Detail](/api-reference/sports/game-detail). PolyNode first uses Polymarket's public search endpoint, then falls back to Gamma tag/event search when that upstream is unavailable.

<ParamField query="q" type="string" required>
  Search query (e.g. `celtics`, `fnatic`, `manchester`).
</ParamField>

<ParamField query="key" type="string" required>
  Your API key.
</ParamField>

<ParamField query="limit" type="integer" default="20">
  Max results (up to 50).
</ParamField>

<ResponseExample>
  ```json theme={null}
  {
    "query": "fnatic",
    "source": "gamma:/public-search",
    "fallback": false,
    "count": 5,
    "results": [
      {
        "title": "Counter-Strike: fnatic vs FaZe (BO3) - DraculaN Playoffs",
        "slug": "cs2-fnc-faze-2026-03-31",
        "category": "Sports",
        "active": false,
        "closed": true,
        "volume": 15420.50
      },
      {
        "title": "Valorant: Fnatic vs ULF Esports (BO3) - VCT EMEA Group Stage",
        "slug": "val-fnc1-ulf-2026-04-01",
        "category": "Sports",
        "active": true,
        "closed": false,
        "volume": 8230.00
      }
    ]
  }
  ```
</ResponseExample>

## Search then drill down

```bash theme={null}
# Step 1: Search for a team or matchup
curl "https://api.polynode.dev/v2/sports/search?q=celtics&key=YOUR_KEY"

# Step 2: Take the slug from results and get full game detail
curl "https://api.polynode.dev/v2/sports/games/nba-nyk-hou-2026-03-31?key=YOUR_KEY"
```

<Note>
  Search covers all Polymarket events, not just games with scores. Results include season futures, playoff series, and prop markets. Use the `slug` to get full details on any result.
</Note>


## OpenAPI

````yaml GET /v2/sports/search
openapi: 3.1.0
info:
  title: PolyNode API
  description: >-
    Real-time Polymarket data API with decoded mempool settlements, OHLCV
    candles, and full Polygon JSON-RPC proxy.
  contact:
    name: PolyNode
    url: https://polynode.dev
  license:
    name: ''
  version: 2.0.0
servers:
  - url: https://api.polynode.dev
    description: Production
security:
  - api_key: []
paths:
  /v2/sports/search:
    get:
      tags:
        - Sports & Esports
      summary: Search
      description: >-
        Search for games, teams, and events by name. PolyNode first uses
        Polymarket public search, then falls back to Gamma tag/event search when
        that upstream is unavailable.
      operationId: sports_search
      parameters:
        - name: q
          in: query
          required: true
          description: Search query (e.g. celtics, fnatic)
          schema:
            type: string
        - name: limit
          in: query
          description: Max results (up to 50)
          schema:
            type: integer
            default: 20
      responses:
        '200':
          description: Search results
      security:
        - api_key: []
components:
  securitySchemes:
    api_key:
      type: apiKey
      in: header
      name: x-api-key

````