Stadium Goods APIstadiumgoods.com ↗
Access Stadium Goods product listings, variant pricing, inventory status, and collections via API. Search by keyword or SKU across the full sneaker catalog.
What is the Stadium Goods API?
The Stadium Goods API exposes 5 endpoints covering product search, catalog browsing, collection listings, and full product details from one of the largest premium sneaker and streetwear marketplaces. The search_products endpoint accepts keyword or SKU queries and returns variant-level pricing, availability, and images. All endpoints return structured JSON, making it straightforward to build price trackers, resale tools, or sneaker inventory dashboards.
curl -X GET 'https://api.parse.bot/scraper/20a12fbe-b9a4-451f-82af-3866d39f973e/search_products?limit=3&query=Jordan+1' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace stadiumgoods-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
from parse_apis.stadium_goods_api import StadiumGoods, Product, ProductSummary, Collection
client = StadiumGoods()
# Search for sneakers
for result in client.products.search(query="Nike Dunk"):
print(result.title, result.price, result.available, result.vendor)
# Navigate from summary to full product details
full = result.details()
print(full.title, full.vendor, full.product_type)
for variant in full.variants:
print(variant.title, variant.price, variant.sku, variant.available)
break
# Fetch a specific product by handle
product = client.products.get(handle="air-jordan-1-mid-barons-159360")
print(product.title, product.vendor, product.product_type)
for img in product.images:
print(img.src, img.width, img.height)
# Browse all products with auto-pagination
for item in client.products.list(limit=5):
print(item.title, item.handle, item.vendor)
# List collections
for coll in client.collections.list(limit=3):
print(coll.title, coll.handle, coll.products_count)
# Browse products in a specific collection via sub-resource
nike = client.collection(handle="nike")
for shoe in nike.products.list(limit=5):
print(shoe.title, shoe.handle, shoe.vendor)
Full-text search over the Stadium Goods catalog via Shopify suggest. Returns products matching the query with title, handle, pricing range, vendor, availability, and a single representative variant. Limited to 10 results maximum per query.
| Param | Type | Description |
|---|---|---|
| limit | integer | Maximum number of results to return (1-10). |
| queryrequired | string | Search keyword or SKU to look up (e.g. 'Jordan 1', 'Nike Dunk', 'DQ8426'). |
{
"type": "object",
"fields": {
"total": "integer count of products returned",
"products": "array of product objects with title, handle, price, price_min, price_max, available, vendor, type, image, body, variants"
},
"sample": {
"data": {
"total": 5,
"products": [
{
"id": 8290808070340,
"url": "/products/air-jordan-1-mid-barons-159360?_pos=1&_psq=Jordan+1&_ss=e&_v=1.0&variant=44947647463620",
"body": "Step into a piece of athletic heritage...",
"tags": [
"Sale",
"Tik Tok",
"Walmart"
],
"type": "Shoes",
"image": "https://cdn.shopify.com/s/files/1/0659/1168/5316/files/vavvz2cmqapvjfmpdkhtoaretbe1.png?v=1758032148",
"price": "113.00",
"title": "Air Jordan 1 Mid \"Barons\" DQ8426 101",
"handle": "air-jordan-1-mid-barons-159360",
"vendor": "JORDAN",
"variants": [
{
"id": 44947647463620,
"price": "113.00",
"title": "1",
"available": false,
"compare_at_price": "113.00"
}
],
"available": true,
"price_max": "190.00",
"price_min": "113.00",
"featured_image": {
"alt": "Air Jordan 1 Mid 1",
"url": "https://cdn.shopify.com/s/files/1/0659/1168/5316/files/vavvz2cmqapvjfmpdkhtoaretbe1.png?v=1758032148",
"width": 2000,
"height": 1200
},
"compare_at_price_max": "190.00",
"compare_at_price_min": "113.00"
}
]
},
"status": "success"
}
}About the Stadium Goods API
Product Search and Lookup
The search_products endpoint accepts a query parameter (keyword or SKU such as DQ8426 or Jordan 1) and returns up to 10 matching products per request. Each result includes title, handle, price, availability, vendor, image, and variants. The handle value from search results feeds directly into get_product_details for full variant-level data. get_product_details returns body_html, product_type, all variant sku values, per-variant price and availability, full image sets, and options (typically size).
Catalog and Collection Browsing
list_products pages through the entire Stadium Goods catalog with page and limit parameters (up to 250 per page). Each product record includes id, title, handle, vendor, product_type, variants, images, options, and creation/update timestamps. For brand- or category-scoped browsing, list_collections returns collection id, title, handle, description, published_at, and products_count. Pass a collection_handle from those results into list_products_by_collection to retrieve only products belonging to that collection, with the same full product schema and pagination controls.
Variant and Inventory Detail
Every product returned across all endpoints carries variant-level data — each variant maps a specific size option to its own price, sku, and availability flag. Stadium Goods lists products individually by size, so a single sneaker model may surface as many variants under one product handle, each priced independently. This makes the API particularly useful for per-size price tracking rather than just headline pricing.
The Stadium Goods API is a managed, monitored endpoint for stadiumgoods.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when stadiumgoods.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official stadiumgoods.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Track per-size resale prices for specific sneaker SKUs using
search_productswith SKU queries and variantpricefields - Monitor new product drops by polling
list_productssorted bycreated_attimestamps - Build a brand-specific catalog page by filtering
list_collectionsfor a vendor handle and fetching products vialist_products_by_collection - Compare Stadium Goods pricing across sizes using
get_product_detailsvariant array for a given product handle - Aggregate inventory availability signals across the sneaker catalog using the
availabilityflag on each variant - Populate a sneaker database with full metadata —
body_html,product_type,images,options— fromget_product_details
| 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 | 100 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 Stadium Goods have an official public developer API?+
What does `get_product_details` return that `search_products` does not?+
search_products returns a summary suitable for listing pages: title, handle, price, availability, vendor, and a single image. get_product_details returns the full record including body_html, all images in the images array, every variant with its individual sku, price, and availability flag, plus options and product_type. Use search_products to find a handle, then get_product_details for complete data.Are historical price or sales volume data available?+
How does pagination work across the catalog endpoints?+
list_products, list_collections, and list_products_by_collection all accept page and limit parameters. The maximum limit is 250 per page. The total field in each response reflects the count of records returned on that page, not the total catalog size, so iterate pages until a response returns fewer records than your requested limit.