Tell Cito API what you are building.

Get endpoint recommendations, exact requests, code snippets, and a free-key CTA without digging through every page.

Docs/Call of Duty API/Search

Back to Call of Duty API

Search

Global search across players, teams, and tournaments

Global Search

GET/cod/search

Search across players, teams, and tournaments with fuzzy matching. Great for building autocomplete features.

Query Parameters

Parameter	Type	Description
`q`*	string	Search query
`type`	string	Filter by type (player, team, tournament)
`limit`	number	Results per type (default: 5)

Example Request

GET /api/v1/cod/search?q=simp

Response

{
  "success": true,
  "query": "simp",
  "results": {
    "players": [
      {
        "codPlayerId": "...",
        "ign": "Simp",
        "realName": "Chris Lehr",
        "team": "Atlanta FaZe",
        "imageUrl": "https://...",
        "matchScore": 1.0
      }
    ],
    "teams": [
      {
        "slug": "atlanta-faze",
        "name": "Atlanta FaZe",
        "logoUrl": "https://...",
        "matchScore": 0.3
      }
    ],
    "tournaments": []
  }
}

Search Tips

• Player searches match against IGN, real name, and Activision ID
• Team searches match against full name, short name, and slug
• Results are sorted by match relevance score
• Use the type parameter to limit search to specific entity types

Leaderboards

Statistics