Skip to main content

​
Search Competitions

curl -X GET "https://your-domain.com/api/competitions/search?keyword=premier" \
  -H "X-API-Key: your-api-key-here"
Search for football competitions and leagues by name or slug using trigram similarity. Returns up to 10 matched competitions ordered by ID.

​
Query Parameters

​
keyword
string
required
Keyword to search for in competition names or slugs. Supports fuzzy matching and accent-insensitive search.

​
Response

Returns an array of up to 10 matching competitions.
​
id
integer
Unique identifier for the competition
​
name
string
Full name of the competition (e.g., “Premier League”, “UEFA Champions League”)
​
slug
string
URL-friendly slug for the competition
URL to the competition’s logo image
​
logo_dark
string
URL to the competition’s logo image (dark theme version)
​
country
string
ISO 2-letter country code for domestic competitions (e.g., “GB”, “ES”, “FR”). Null for international competitions.
[
  {
    "id": 1,
    "name": "Premier League",
    "slug": "premier-league-kits",
    "logo": "https://www.footballkitarchive.com/images/logos/competitions/premier-league.png",
    "logo_dark": "https://www.footballkitarchive.com/images/logos/competitions/premier-league-dark.png",
    "country": "GB"
  },
  {
    "id": 5,
    "name": "UEFA Champions League",
    "slug": "uefa-champions-league-kits",
    "logo": "https://www.footballkitarchive.com/images/logos/competitions/ucl.png",
    "logo_dark": "https://www.footballkitarchive.com/images/logos/competitions/ucl-dark.png",
    "country": null
  }
]

​
Examples

curl -X GET "https://your-domain.com/api/competitions/search?keyword=premier"

curl -X GET "https://your-domain.com/api/competitions/search?keyword=champions"

curl -X GET "https://your-domain.com/api/competitions/search?keyword=liga"

curl -X GET "https://your-domain.com/api/competitions/search?keyword=serie"

curl -X GET "https://your-domain.com/api/competitions/search?keyword=brasileiro"
# Returns "Campeonato Brasileiro Série A"
Results are cached for optimal performance. The search uses trigram word similarity for fuzzy matching.

​
Get Competition by ID

curl -X GET "https://your-domain.com/api/competitions/1" \
  -H "X-API-Key: your-api-key-here"
Retrieve detailed information about a specific competition by its ID.

​
Path Parameters

​
competition_id
integer
required
The unique identifier of the competition

​
Response

​
id
integer
Unique identifier for the competition
​
name
string
Full name of the competition
​
slug
string
URL-friendly slug for the competition
​
logo
string
URL to the competition’s logo image
​
logo_dark
string
URL to the competition’s logo image (dark theme version)
​
country
string
ISO 2-letter country code for domestic competitions. Null for international competitions.
{
  "id": 1,
  "name": "Premier League",
  "slug": "premier-league-kits",
  "logo": "https://www.footballkitarchive.com/images/logos/competitions/premier-league.png",
  "logo_dark": "https://www.footballkitarchive.com/images/logos/competitions/premier-league-dark.png",
  "country": "GB"
}

​
Competition Types

The Football Kit Archive includes kits from various competition types:

​
Domestic Leagues

  • Premier League (England)
  • La Liga (Spain)
  • Serie A (Italy)
  • Bundesliga (Germany)
  • Ligue 1 (France)
  • Eredivisie (Netherlands)
  • Primeira Liga (Portugal)
  • Championship (England)
  • And many more domestic leagues worldwide…

​
International Club Competitions

  • UEFA Champions League
  • UEFA Europa League
  • UEFA Conference League
  • Copa Libertadores
  • Copa Sudamericana
  • CAF Champions League
  • AFC Champions League

​
International Tournaments

  • FIFA World Cup
  • UEFA European Championship
  • Copa América
  • Africa Cup of Nations
  • Asian Cup

​
Domestic Cups

  • FA Cup (England)
  • Copa del Rey (Spain)
  • Coppa Italia (Italy)
  • DFB-Pokal (Germany)
  • Coupe de France (France)
  • And many more domestic cup competitions…
Use the search endpoint to discover all available competitions in the database.