POST /v1/data/stockx/products/run
Pricing: $0.001 per product ($1.00 per 1,000).
Ways to call it
- Listing URL: set
listing_url(optional:maxResults,country_code) - Search: set
query(optional:maxResults,country_code) - Product URL: set
urls(optional:country_code)
Request
Send the inputs underparams. Only the keys below are accepted; any other key returns 422 invalid_params.
A StockX listing page URL: a brand page (https://stockx.com/brands/adidas) or a search results page (https://stockx.com/search?s=jordan%201). Brand pages also carry the 12-month market statistics; search pages do not.Format e.g.
https://stockx.com/brands/adidas.A keyword to search StockX for, e.g. ‘jordan 1 chicago’. We build the search URL for you, no need to paste one. Relevance-ranked, so it drops roughly 30-40% of a brand; use a brand page as the Listing URL for a full catalog.
One or more StockX product URLs, e.g. https://stockx.com/air-jordan-1-retro-high-og-chicago-reimagined-lost-and-found. One per line.
Number of products to return from a brand page or a search. Use 0 for all. Ignored when you pass product URLs.
Shopping region. Scopes the StockX market the asks and bids come from. Prices are quoted in USD regardless.198 allowed values, for example
AL (Albania), DZ (Algeria), AS (American Samoa), AD (Andorra), AO (Angola), AI (Anguilla), AG (Antigua & Barbuda), AR (Argentina), AM (Armenia), AW (Aruba). Fetch the full list with GET /v1/data/stockx/products?expand=options.Example
Response fields
Each row indata is one product, keyed by these fields.