Skip to main content
POST /v1/data/goat/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 under params. Only the keys below are accepted; any other key returns 422 invalid_params.
string
A GOAT listing page URL: a brand page (https://www.goat.com/brand/salomon) or a search results page (https://www.goat.com/search?query=nike). Brand pages return the full catalog; searches are relevance-ranked. Any GOAT filter in the URL is honoured.Format e.g. https://www.goat.com/brand/salomon.
string
A keyword to search GOAT for, e.g. ‘jordan 1 chicago’. We build the search URL for you, so there’s 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.
string[]
One or more GOAT product URLs, e.g. https://www.goat.com/sneakers/air-jordan-1-high-1985-4280. One per line.
integer
Number of products to return from a search or brand page. Use 0 for all. Ignored when you pass product URLs.
string
default:"US"
Shopping region. Shapes which sellers and sizes are offered and their asking prices. Regions without their own market get GOAT’s global pricing (the same listings as the default). Prices are quoted in USD regardless.170 allowed values, for example DZ (Algeria), AD (Andorra), AI (Anguilla), AG (Antigua and Barbuda), AR (Argentina), AM (Armenia), AW (Aruba), AU (Australia), AT (Austria), AZ (Azerbaijan). Fetch the full list with GET /v1/data/goat/products?expand=options.

Example

Response fields

Each row in data is one product, keyed by these fields.

Example response

Abridged: long text and lists are shortened.