Clubs Endpoints

Search Clubs

curl -X GET "https://your-domain.com/api/clubs/search?keyword=manchester" \
  -H "X-API-Key: your-api-key-here"

Search for clubs using a keyword. The search is performed on both club names and slugs using trigram word similarity for fuzzy matching.

Query Parameters

string

required

Keyword to search for in club names and slugs. Supports accent-insensitive search (e.g., “Málaga” and “Malaga” return the same results).

Response

Returns an array of up to 10 matching clubs, ordered by ID.

integer

Unique identifier for the club

string

Full name of the club

string

URL-friendly slug for the club

string

URL to the club’s logo image

[
  {
    "id": 1,
    "name": "Manchester United",
    "slug": "manchester-united-kits",
    "logo": "https://www.footballkitarchive.com/images/logos/clubs/manchester-united.png"
  },
  {
    "id": 2,
    "name": "Manchester City",
    "slug": "manchester-city-kits",
    "logo": "https://www.footballkitarchive.com/images/logos/clubs/manchester-city.png"
  }
]

Get Club by ID

curl -X GET "https://your-domain.com/api/clubs/1" \
  -H "X-API-Key: your-api-key-here"

Retrieve detailed information about a specific club by its ID.

Path Parameters

integer

required

The unique identifier of the club

Response

integer

Unique identifier for the club

string

Full name of the club

string

URL-friendly slug for the club

string

URL to the club’s logo image

{
  "id": 1,
  "name": "Manchester United",
  "slug": "manchester-united-kits",
  "logo": "https://www.footballkitarchive.com/images/logos/clubs/manchester-united.png"
}

Get Club Seasons

curl -X GET "https://your-domain.com/api/seasons?id=1" \
  -H "X-API-Key: your-api-key-here"

Retrieve all available seasons for a specific club. Returns seasons sorted by year in descending order (most recent first).

Query Parameters

integer

required

Club ID to retrieve seasons for

Response

Returns an array of seasons for the club.

integer

Unique identifier for the season

string

Season year in format “YYYY” or “YYYY-YY” (e.g., “2024” or “2024-25”)

[
  {
    "id": 123,
    "year": "2024-25"
  },
  {
    "id": 122,
    "year": "2023-24"
  },
  {
    "id": 121,
    "year": "2022-23"
  }
]

This endpoint is cached for optimal performance. Results are sorted by year in descending order.

Get Club Kits

curl -X GET "https://your-domain.com/api/clubs/1/kits?season=123&page=1&page_size=20" \
  -H "X-API-Key: your-api-key-here"

Retrieve all kits for a specific club. This is a nested resource endpoint following REST conventions.

Path Parameters

integer

required

The unique identifier of the club

Query Parameters

integer

Filter kits by season ID (optional)

integer

default:"1"

Page number for pagination (minimum: 1)

integer

default:"20"

Number of items per page (minimum: 1, maximum: 100)

Response

Returns a paginated array of kits.

integer

Unique identifier for the kit

string

Full name of the kit (e.g., “Manchester United 2024-25 Home Kit”)

string

URL to the main image of the kit

[
  {
    "id": 1001,
    "name": "Manchester United 2024-25 Home Kit",
    "main_img_url": "https://www.footballkitarchive.com/images/kits/manchester-united-2024-25-home.jpg"
  },
  {
    "id": 1002,
    "name": "Manchester United 2024-25 Away Kit",
    "main_img_url": "https://www.footballkitarchive.com/images/kits/manchester-united-2024-25-away.jpg"
  }
]

For more flexible filtering options, use /api/kits?club={club_id} instead, which supports additional filters like color, design, and country.

Get Random Clubs

curl -X GET "https://your-domain.com/api/random-clubs/?page=1&page_size=20" \
  -H "X-API-Key: your-api-key-here"

Retrieve a paginated list of random clubs with kit counts.

Query Parameters

integer

default:"1"

Page number for pagination (minimum: 1)

integer

default:"20"

Number of items per page (minimum: 1, maximum: 100)

Response

array

Array of club objects

integer

Unique identifier for the club

string

Full name of the club

string

URL-friendly slug for the club

string

URL to the club’s logo image

string

ISO 2-letter country code (e.g., “GB”, “ES”, “FR”)

integer

Number of kits available for this club

object

Pagination information

integer

Current page number

integer

Total number of pages

integer

Total number of clubs

boolean

Whether there is a next page

boolean

Whether there is a previous page

integer

Next page number (null if no next page)

integer

Previous page number (null if no previous page)

{
  "clubs": [
    {
      "id": 1,
      "name": "Manchester United",
      "slug": "manchester-united-kits",
      "logo": "https://www.footballkitarchive.com/images/logos/clubs/manchester-united.png",
      "country": "GB",
      "kit_count": 150
    },
    {
      "id": 5,
      "name": "Real Madrid",
      "slug": "real-madrid-kits",
      "logo": "https://www.footballkitarchive.com/images/logos/clubs/real-madrid.png",
      "country": "ES",
      "kit_count": 145
    }
  ],
  "pagination": {
    "current_page": 1,
    "total_pages": 25,
    "total_count": 500,
    "has_next": true,
    "has_previous": false,
    "next_page": 2,
    "previous_page": null
  }
}

Only clubs with logos are included in the results. The default logo is excluded.

Overview

Endpoints

Advanced

Clubs Endpoints

Search Clubs

Query Parameters

Response

Get Club by ID

Path Parameters

Response

Get Club Seasons

Query Parameters

Response

Get Club Kits

Path Parameters

Query Parameters

Response

Get Random Clubs

Query Parameters

Response

​Search Clubs

​Query Parameters

​Response

​Get Club by ID

​Path Parameters

​Response

​Get Club Seasons

​Query Parameters

​Response

​Get Club Kits

​Path Parameters

​Query Parameters

​Response

​Get Random Clubs

​Query Parameters

​Response

Search Clubs

Query Parameters

Response

Get Club by ID

Path Parameters

Response

Get Club Seasons

Query Parameters

Response

Get Club Kits

Path Parameters

Query Parameters

Response

Get Random Clubs

Query Parameters

Response