footlocker.com APIfootlocker.com ↗
Access Foot Locker product listings, pricing, customer reviews, release calendars, and brand/category browsing data via a structured REST API.
curl -X GET 'https://api.parse.bot/scraper/dcf44ebc-52ab-4e02-9acf-4440e503ff29/search_products?page=1&query=nike+air+max' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products by keyword query. Returns product listings with price, images, variants, and basic ratings. Results are paginated with 48 products per page.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number (1-indexed) |
| queryrequired | string | Search keyword (e.g., 'nike air max') |
{
"type": "object",
"fields": {
"products": "array of product listing objects with name, sku, price, images, reviewRatings, and variantOptions",
"pagination": "object with currentPage, pageSize, sort, totalPages, totalResults",
"total_results": "integer total number of matching products"
},
"sample": {
"data": {
"products": [
{
"sku": "H4740007",
"name": "Nike Air Max 95 - Men's",
"price": {
"value": 190,
"formattedValue": "$190.00"
},
"images": [
{
"url": "https://images.footlocker.com/is/image/EBFL2/H4740007",
"format": "large"
}
],
"reviewRatings": {
"rating": 4,
"reviews": 81
}
}
],
"pagination": {
"sort": "relevance-descending",
"pageSize": 48,
"totalPages": 7,
"currentPage": 0,
"totalResults": 291
},
"total_results": 291
},
"status": "success"
}
}About the footlocker.com API
The Foot Locker API covers 8 endpoints for retrieving product data, customer reviews, and sneaker release calendars from footlocker.com. The search_products endpoint returns paginated results with name, SKU, price, images, variant options, and rating summaries across up to 48 products per page. Additional endpoints cover category browsing, brand filtering, sale items, new arrivals, and detailed per-SKU data including structured offers and availability.
Product Search and Browsing
The search_products endpoint accepts a query string (e.g., 'nike air max') and an optional page integer, returning an array of product listing objects with name, sku, price, images, reviewRatings, and variantOptions. The pagination object in the response exposes currentPage, pageSize, totalPages, and totalResults, making it straightforward to walk through large result sets. The same paginated structure applies to get_category_products (using a category_path like 'mens/shoes'), get_brand_products (using a brand string like 'Jordan'), get_sale_products, and get_new_arrivals.
Product Details and Reviews
get_product_details accepts a sku string obtained from any of the listing endpoints and returns a ld_json object typed as ProductGroup, containing name, description, brand, variants, and offers including pricing and availability. The response also includes a breadcrumbs array and, where present, a product_state object with additional internal product data. For customer feedback, get_product_reviews returns Bazaarvoice-sourced reviews keyed under BatchedResults.q0, with each review carrying Rating, ReviewText, SubmissionTime, and UserNickname. Note that this endpoint requires the product to have existing reviews and a valid model ID.
Release Calendar
get_release_calendar returns upcoming and recently launched sneakers without requiring any input parameters. Each entry in the products array includes brandName, name, id, skuLaunchDate, style, gender, image, and reservation details, making it useful for tracking launch windows and launch-day availability across genders and styles.
Sale and New Arrival Data
get_sale_products is the only listing endpoint that also returns originalPrice alongside the current price, making it the right endpoint for calculating discount amounts. get_new_arrivals surfaces the most recently added products across all categories, paginated in the same 48-items-per-page structure used throughout the API.
- Track sneaker release dates and launch prices using
get_release_calendardata includingskuLaunchDateandgender. - Build a price comparison tool using
priceandoriginalPricefields fromget_sale_products. - Aggregate customer sentiment by collecting
RatingandReviewTextfields fromget_product_reviewsacross multiple SKUs. - Monitor new inventory additions by polling
get_new_arrivalsand flagging SKUs not seen in a previous fetch. - Enumerate a brand's full catalog and variant options using
get_brand_productswith paginated requests. - Enrich a product database with availability and structured offers by calling
get_product_detailswith SKUs from search results. - Index category-level assortments for comparison shopping by browsing
get_category_productswith paths like'womens/clothing'.
| 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 Foot Locker have an official developer API?+
What does `get_product_details` return beyond what search results provide?+
get_product_details returns a ld_json object typed as ProductGroup with full description, brand, per-variant offers (including availability status), and a breadcrumbs array. Search and browse endpoints return a lighter product listing object without offer-level availability detail or product description text.Are there any products for which `get_product_reviews` will not return results?+
get_product_reviews requires the product to have existing customer reviews and a resolvable Bazaarvoice model ID. Products with no reviews, or those where the model ID cannot be resolved, will not return review data.Does the API cover Foot Locker stores outside the United States, such as EU or AU storefronts?+
Can I retrieve a product's full size run and stock levels for each size?+
get_product_details, but per-size inventory counts are not exposed as discrete stock level fields. The offers object in get_product_details includes availability status. You can fork this API on Parse and revise it to add a dedicated size-availability endpoint if your use case requires per-size stock signals.