Search Clubs
curl -X GET "https://your-domain.com/api/clubs/search?keyword=manchester" \
-H "X-API-Key: your-api-key-here"
Query Parameters
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.
Unique identifier for the club
URL-friendly slug for the club
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"
Path Parameters
The unique identifier of the club
Response
Unique identifier for the club
URL-friendly slug for the club
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"
Query Parameters
Club ID to retrieve seasons for
Response
Returns an array of seasons for the club.
Unique identifier for the season
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"
Path Parameters
The unique identifier of the club
Query Parameters
Filter kits by season ID (optional)
Page number for pagination (minimum: 1)
Number of items per page (minimum: 1, maximum: 100)
Response
Returns a paginated array of kits.
Unique identifier for the kit
Full name of the kit (e.g., “Manchester United 2024-25 Home Kit”)
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"
Query Parameters
Page number for pagination (minimum: 1)
Number of items per page (minimum: 1, maximum: 100)
Response
Unique identifier for the club
URL-friendly slug for the club
URL to the club’s logo image
ISO 2-letter country code (e.g., “GB”, “ES”, “FR”)
Number of kits available for this club
Whether there is a next page
Whether there is a previous page
Next page number (null if no next page)
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.