finishline.com APIfinishline.com ↗
Access Finish Line sneaker catalog data via 6 endpoints: search products, browse categories, get release dates, product details, store locations, and suggestions.
curl -X GET 'https://api.parse.bot/scraper/de510481-7bb5-4661-9ec5-2884b255e511/search_products?page=0&limit=3&query=Jordan' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products by keyword. Returns paginated product results with names, prices, images, brands, and URLs.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number (0-based) |
| limit | integer | Max results per page |
| queryrequired | string | Search keyword (e.g. 'Jordan', 'Nike Dunk') |
{
"type": "object",
"fields": {
"hits": "array of product objects with product_id, style_code, name, price, original_price, image_url, url, brand, color, rating, review_count",
"page": "integer current page number",
"total_hits": "integer total number of matching products",
"total_pages": "integer total number of pages"
},
"sample": {
"data": {
"hits": [
{
"url": "https://www.finishline.com/pdp/mens-air-jordan-retro-5-basketball-shoes/prod2799959/HQ7978/103",
"name": "Men's Air Jordan Retro 5 Basketball Shoes",
"brand": "Jordan",
"color": "White/Metallic Silver/Black",
"price": 215,
"rating": 5,
"image_url": "https://media.finishline.com/s/finishline/HQ7978_103?$Main$",
"product_id": "prod2799959",
"style_code": "HQ7978-103",
"review_count": 781,
"original_price": 215
}
],
"page": 0,
"total_hits": 631,
"total_pages": 211
},
"status": "success"
}
}About the finishline.com API
The Finish Line API covers 6 endpoints that expose product search, category browsing, sneaker release calendars, and store locations from finishline.com. The search_products endpoint returns paginated results with fields including price, original_price, brand, color, rating, and review_count. The get_product_details endpoint goes further, returning SKU-level stock_level values (HIGH, LOW, OOS, UNKNOWN) and available sizes for any product detail page URL.
Product Search and Browsing
The search_products endpoint accepts a query string (e.g., 'Jordan' or 'Nike Dunk') and returns paginated hits with fields including product_id, style_code, name, price, original_price, image_url, url, brand, color, rating, and review_count. Pagination is 0-based via the page and limit parameters. The get_product_listing_page endpoint mirrors this response shape but navigates by category slug — accepted slugs include mens-shoes, womens-clothing, boys-shoes, and similar category-level paths — making it straightforward to enumerate a full category.
Product Details and Inventory
get_product_details takes the full PDP URL returned in any hits[*].url field and returns a richer record: a sizes array with each entry carrying a size, sku, and stock_level (one of HIGH, LOW, OOS, or UNKNOWN), a colors array with style_color and name, a description string, and final and original prices. This is the primary endpoint for inventory checking at the SKU level.
Sneaker Releases and Suggestions
get_sneaker_releases requires no inputs and returns up to 50 entries from the release calendar. Each release object includes name, style_code, price, original_price, brand, release_date, released (boolean), launch type, and exclusive_access flag. The get_search_suggestions endpoint takes a partial query string and returns up to 5 preview objects, each with a name, image URL, and url — useful for typeahead interfaces or quickly resolving a style name to a PDP URL.
Store Locator
get_store_locator accepts either a city name via query or geographic coordinates via lat and lng. It returns up to 20 store records with store_id, name, city, state, zip, lat, and lng. This covers physical Finish Line retail locations in the US.
- Monitor sneaker release dates and
exclusive_accessflags from the release calendar to alert users before a drop. - Build a price-drop tracker by comparing
pricevsoriginal_priceacross category pages usingget_product_listing_page. - Check real-time size availability and SKU-level
stock_levelfor a specific shoe usingget_product_details. - Power a sneaker search autocomplete feature using
get_search_suggestionswith partial query input. - Aggregate brand and colorway inventory by scraping
brandandcolorfields fromsearch_productsfor a given keyword. - Find the nearest Finish Line retail location by passing GPS coordinates to
get_store_locator. - Compile a release calendar feed with
style_code,brand,price, andrelease_datefor reseller or enthusiast platforms.
| 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 Finish Line have an official public developer API?+
What stock level values does `get_product_details` return, and what do they mean?+
sizes array returns one of four stock_level strings per SKU: HIGH (ample inventory), LOW (limited stock remaining), OOS (out of stock), or UNKNOWN (status not determinable). This is per-size and per-SKU, not an aggregate product-level flag.How many sneaker releases does `get_sneaker_releases` return, and can it be filtered by brand or date?+
brand, release_date, and a released boolean, so filtering can be applied client-side. You can fork the API on Parse and revise it to add server-side filter parameters.Does the API include user reviews or review text?+
search_products and get_product_listing_page return rating and review_count fields, but individual review text and reviewer details are not exposed by any endpoint. You can fork the API on Parse and revise it to add a review-fetching endpoint.What happens if I pass both `query` and `lat`/`lng` to `get_store_locator`?+
query or geographic coordinates via lat and lng. If both are provided, results reflect whichever the source resolves first — for predictable results, use one input method at a time. The endpoint returns up to 20 stores regardless of input method.