classicfootballshirts.co.uk APIclassicfootballshirts.co.uk ↗
Access Classic Football Shirts product data via API. Search by keyword or team to get prices, sizes, stock status, SKUs, and product URLs.
curl -X GET 'https://api.parse.bot/scraper/73fcfdc9-d8df-488d-b5fa-66bb10075e9c/search_products?limit=3&query=Arsenal' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for football shirt products by keyword query. Returns matching products from the Classic Football Shirts catalog with prices, sizes, and metadata.
| Param | Type | Description |
|---|---|---|
| limit | integer | Maximum number of products to return. |
| queryrequired | string | Search keyword to find products (e.g. 'Arsenal', 'Liverpool', 'Barcelona', 'MLS'). |
{
"type": "object",
"fields": {
"query": "string - the search query used",
"total": "integer - number of products returned",
"products": "array of product objects with name, sku, price, currency, sizes, availability, stock_quantity, product_url, image_url, team, season, brand, style, condition"
},
"sample": {
"data": {
"query": "Arsenal",
"total": 3,
"products": [
{
"sku": "IZ0114",
"name": "2024-25 Arsenal Third Shirt",
"team": "Arsenal",
"brand": "adidas",
"price": 44.99,
"sizes": [
"L",
"XL",
"M"
],
"style": "Third",
"season": "2024-25",
"currency": "USD",
"condition": "Brand New - With Tags",
"image_url": "https://www.classicfootballshirts.com/pub/media/catalog/productw=150,h=150,q=90,f=webp/pub/media/catalog/product//c/5/c547dd7a92226555461d9f86709b19e76845943580c5ab19cb65c9e7e32c473b.jpeg",
"product_url": "https://www.classicfootballshirts.com/2024-25-arsenal-third-shirtiz0114.html",
"availability": "In Stock",
"stock_quantity": 5644
}
]
},
"status": "success"
}
}About the classicfootballshirts.co.uk API
The Classic Football Shirts API provides 2 endpoints that return product listings from classicfootballshirts.co.uk, including prices, available sizes, stock quantities, and direct product URLs. The search_products endpoint accepts any keyword — a club name, league, or era — while get_products_by_team targets a specific team directly, both returning up to a configurable number of results with 11 fields per product.
Endpoints and What They Return
Both endpoints return an array of product objects under a products key. Each object includes name, sku, price, currency, sizes (an array of available size options), availability, stock_quantity, product_url, image_url, team, and season. The search_products endpoint takes a required query string — useful for broad searches like 'MLS', '1990s', or a specific club — and also echoes back the query and a total count. The get_products_by_team endpoint takes a team parameter and is optimised for club-level lookups such as 'Arsenal' or 'Barcelona', returning the same product shape alongside the team value and total.
Filtering and Pagination
Both endpoints accept an optional limit integer to cap the number of results returned. This is the primary way to control response size. There is no offset or cursor parameter exposed, so iterating deep into a large catalog requires adjusting the limit value rather than paginating through pages.
Data Shape Notes
The sizes field reflects the sizes currently listed on the product — useful for filtering before directing a user to the product page. availability and stock_quantity give a snapshot of in-stock status at query time. sku is the site's own product identifier, which can be useful for deduplication when the same shirt appears in both endpoint results. product_url and image_url are absolute URLs suitable for direct linking or image display.
- Build a price tracker that monitors classic shirt prices for specific teams over time using
priceandskufields. - Populate a shirt-finder tool that lets users search by club or keyword and displays size availability before linking out.
- Compare stock quantities across multiple teams to identify which eras or clubs have the most inventory.
- Aggregate product listings for a retro kit comparison site using
team,season, andpricefields. - Alert users when a specific shirt becomes available by polling
availabilityandstock_quantityfor a given team. - Feed an e-commerce affiliate site with current shirt listings including images and direct product links.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Classic Football Shirts have an official developer API?+
What does the `get_products_by_team` endpoint return that `search_products` doesn't?+
get_products_by_team takes a team parameter and echoes it back in the response, making it more direct for club-specific lookups. search_products accepts a broader query string and echoes that back instead, so it works for non-team searches like league names or eras.Does the API return historical pricing or only the current listed price?+
Are individual product detail pages or seller/condition notes accessible?+
How fresh is the product data, and can it reflect sold-out status accurately?+
availability and stock_quantity fields reflect the state of the listing at query time. Classic Football Shirts is a real-time retail site where inventory changes frequently, so there can be a lag between a shirt selling out and the next time the data is refreshed. For time-sensitive use cases, polling at shorter intervals will give more accurate results.