solebox.com APIwww.solebox.com ↗
Access Solebox product listings via API. Retrieve brand, name, price, images, sizes, and stock status with filters for category, brand, price range, and sorting.
curl -X GET 'https://api.parse.bot/scraper/81372760-674a-4ffa-a6a6-3bdfb3181c69/get_products?page=1&brand=adidas_originals-830&sorting=key-relevance&per_page=24&category_id=2833' \ -H 'X-API-Key: $PARSE_API_KEY'
Get product listings from a Solebox category with optional filters for price range, brand, sorting, and pagination. Returns products with brand, name, price, images, available sizes, and stock status.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number (1-based). |
| brand | string | Brand filter. Accepts the format 'slug-id' (e.g., 'adidas_originals-830', 'nike_1-392') where the numeric ID after the last dash is used for filtering. Also accepts a bare numeric ID (e.g., '830'). |
| sorting | string | Sort order: key-relevance, new-desc, price-asc, price-desc, reduction-desc. |
| per_page | integer | Products per page (max 24). |
| max_price | string | Maximum price filter in EUR (e.g., '100'). Omitting applies no maximum price constraint. |
| min_price | string | Minimum price filter in EUR (e.g., '1'). Omitting applies no minimum price constraint. |
| category_id | string | Category ID to browse (e.g., 2821=Bekleidung/Apparel, 2833=Schuhe/Shoes, 2834=Accessoires). |
{
"type": "object",
"fields": {
"category": "object with id, name, slug",
"products": "array of product objects with id, brand, name, display_name, price, currency, formatted_price, was_price, has_discount, color, url, image_url, all_image_urls, available_sizes, in_stock, is_new",
"page_size": "integer - products per page",
"total_pages": "integer - total pages available",
"current_page": "integer - current page number (1-based)",
"total_results": "integer - total number of matching products"
},
"sample": {
"data": {
"category": {
"id": 2821,
"name": "Bekleidung",
"slug": "bekleidung"
},
"products": [
{
"id": 87763,
"url": "https://www.solebox.com/de-de/p/dickies-mechanic-ss-tee-gelb-87763",
"name": "Mechanic SS Tee",
"brand": "Dickies",
"color": "gelb",
"price": 17.99,
"is_new": false,
"currency": "EUR",
"in_stock": true,
"image_url": "https://asset.solebox.com/images/f_auto,q_auto,d_fallback-sole.png/g_auto,c_fill,w_600,h_600/dpr_1.0/02426726_1",
"was_price": "34,99 €",
"display_name": "Mechanic SS Tee",
"has_discount": true,
"all_image_urls": [
"https://asset.solebox.com/images/f_auto,q_auto,d_fallback-sole.png/g_auto,c_fill,w_600,h_600/dpr_1.0/02426726_1"
],
"available_sizes": [
"M"
],
"formatted_price": "17,99 €"
}
],
"page_size": 24,
"total_pages": 1,
"current_page": 1,
"total_results": 6
},
"status": "success"
}
}About the solebox.com API
The Solebox API exposes 1 endpoint — get_products — that returns up to 10 fields per product including brand, name, price, discount status, color, available sizes, and stock availability across Solebox's sneaker, apparel, and accessories catalog. You can filter results by category, brand slug, price range, and sort order, with paginated responses reporting total results and total pages for full catalog traversal.
What the API Returns
The get_products endpoint returns a paginated list of products from solebox.com. Each product object includes id, brand, name, display_name, price, currency, formatted_price, was_price, has_discount, color, and a direct url to the product page. The response also carries top-level metadata: current_page, total_pages, total_results, page_size, and a category object with id, name, and slug.
Filtering and Category Browsing
Products are scoped by category_id — for example, 2833 for Schuhe (Shoes), 2821 for Bekleidung (Apparel), or 2834 for Accessoires. Price filtering accepts min_price and max_price in EUR as strings. Brand filtering uses a slug-id format such as adidas_originals-830 or nike_1-392. The sorting parameter accepts five values: key-relevance, new-desc, price-asc, price-desc, and reduction-desc. per_page caps at 24 items per request; use the page parameter for pagination.
Discount and Pricing Data
Each product exposes both price (current) and was_price (original), along with the boolean has_discount. This lets you identify reduced items without additional requests. formatted_price provides a display-ready string in EUR. No additional authentication is needed to access these fields — they are available across the full catalog.
- Monitor price drops on specific sneaker brands using
has_discountandwas_pricefields - Build a Solebox product feed filtered by category (Shoes, Apparel, Accessories) for a deals aggregator
- Track new arrivals by sorting with
new-descand recording product IDs over time - Compare prices across a brand's catalog using
brandslug filter andprice-ascsorting - Aggregate color and size availability data for a sneaker search tool
- Generate discount-sorted product lists with
reduction-descto surface the deepest sale items - Paginate through the full Solebox catalog to build an offline product database using
total_pagesandtotal_results
| 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 Solebox have an official developer API?+
Does get_products return individual product detail pages, including size-level stock?+
What does the brand filter accept, and where do I find the numeric ID?+
brand parameter uses a combined slug-id format, for example adidas_originals-830 or nike_1-392. The numeric suffix is specific to Solebox's catalog. If you don't know a brand's ID, you can omit the filter and inspect the brand field in returned product objects to identify the correct slug, then cross-reference by browsing category results.Are product reviews or ratings returned by the API?+
How fresh is the product and pricing data?+
get_products will reflect current catalog state including price changes and stock updates.