Foot Locker category listing
GET https://api.api.sh/footlocker/v1/category
All products of a Foot Locker category page (or collection id), with the same facets, sorts and product fields as search.
Every response includes credits_used: the credits this call cost.
Part of the Foot Locker API: 8 endpoints with prices, use cases and example responses.
Parameters
| name | type | description |
|---|---|---|
categoryrequired | string | A footlocker.com category link or path (e.g. /category/mens/shoes.html) or a collection id (e.g. men-s-shoes). Example: /category/mens/shoes.html |
sort | relevance | price_asc | price_desc | newest | rating | name | relevance (default), price_asc, price_desc, newest, rating, name. |
filter | string | name:value facet filter, repeatable (see search). |
price_min | number | Lowest price in USD. |
price_max | number | Highest price in USD. |
page | integer | Page number (default 1). Pass next_page back as page; null on the last page. Example: 1 |
limit | integer | Products per page, up to 100 (default 48). |
Every endpoint also takes fresh, raw, fields (see lean responses and caching).
Example
curl "https://api.api.sh/footlocker/v1/category?category=%2Fcategory%2Fmens%2Fshoes.html" \
-H "x-api-key: $APISH_KEY" import os, requests
res = requests.get(
"https://api.api.sh/footlocker/v1/category",
params={"category": "/category/mens/shoes.html"},
headers={"x-api-key": os.environ["APISH_KEY"]},
timeout=120,
)
res.raise_for_status()
data = res.json() const url = new URL("https://api.api.sh/footlocker/v1/category");
url.searchParams.set("category", "/category/mens/shoes.html");
const res = await fetch(url, { headers: { "x-api-key": process.env.APISH_KEY } });
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const data = await res.json(); Response
A JSON object with the fields described above, plus raw (the source's own data), cached, fetched_at and credits_used. Errors return {"success": false, "error": "…"} with the HTTP status (see errors). A lookup that ran but found nothing (404) costs the price above; refused calls and errors on our side are free (what's charged).
Example response (real call, trimmed: lists cut to 2 items, long text shortened, raw left out)
{"category": {"id": "men-s-shoes","name": "Men's Shoes","url": "https://www.footlocker.com/category/mens/shoes.html"},"sort": "relevance","applied_filters": {},"total": 2639,"page": 1,"count": 48,"next_page": 2,"sort_options": [{"id": "relevance","label": "Featured","order": "descending"},{"id": "price-asc","label": "Price (Low to High)","order": "ascending"},"… 5 more"],"facets": [{"name": "mensShoesSize","label": "Men's Shoes Size","type": "multiple","values": [{"value": "3.5","label": "3.5","count": 1},{"value": "4.0","label": "4.0","count": 13},"… 24 more"]},{"name": "brand","label": "Brand","type": "multiple","values": [{"value": "Jordan","label": "Jordan","count": 207},{"value": "Nike","label": "Nike","count": 813},"… 23 more"]},"… 12 more"],"items": [{"sku": "HQ797800","model_number": 440084,"name": "Jordan Retro 5 OG - Men's","brand": "Jordan","color": "Black/Glow Green/Orange","primary_color": "Black","price": 215,"list_price": 215,"on_sale": false,"new": false,"rating": 5,"reviews": 384,"currency": "USD","sizes": ["10.5","10.0","… 9 more"],"other_colors": [{"sku": "Q7978101","color": "White/Fire Red/Black","price": 169.99,"list_price": 215,"sellable": true},{"sku": "Q7978103","color": "White/Black/Silver","price": 215,"list_price": 215,"sellable": true}],"attributes": {"brand": "Jordan","footLockerOnly": "False","freeShipping": "True","gender": "Men's","onlineOnly": "False","productType": "Shoes","sport": ["Basketball","Casual"],"style": "Casual Sneakers","subStyle": "Casual Basketball Sneakers"},"categories": ["Casual Sneakers","Shoes","… 1 more"],"image": "https://images.footlocker.com/is/image/EBFL2/HQ797800","url": "https://www.footlocker.com/product/~/HQ797800.html"},{"sku": "W2288111","model_number": 333263,"name": "Nike Air Force 1 '07 - Men's","brand": "Nike","color": "White/White","primary_color": "White","price": 115,"list_price": 115,"on_sale": false,"new": false,"rating": 5,"reviews": 536,"currency": "USD","sizes": ["08.0","07.5","… 16 more"],"other_colors": [{"sku": "Q0614060","color": "Black/Anthracite/Iron Grey","price": 125,"list_price": 125,"sellable": true},{"sku": "Q228100","color": "Black/White/Orange Peel","price": 99.99,"list_price": 125,"sellable": true},"… 3 more"],"attributes": {"brand": "Nike","footLockerOnly": "False","freeShipping": "True","gender": "Men's","newArrivalDate": "2020-12-10T00:00:00.000Z","onlineOnly": "False","productType": "Shoes","sport": ["Basketball","Casual"],"style": "Casual Sneakers","subStyle": "Casual Basketball Sneakers"},"categories": ["Casual Sneakers","Shoes","… 1 more"],"image": "https://images.footlocker.com/is/image/EBFL2/W2288111","url": "https://www.footlocker.com/product/~/W2288111.html"},"… 46 more"],"cached": false,"credits_used": 1}The fastest way to see the full response is the playground: it runs this endpoint with your account and shows the exact JSON.