GOAT API by APISH avatar

GOAT API by APISH

Pricing

$4.00 / 1,000 credits

Go to Apify Store
GOAT API by APISH

GOAT API by APISH

GOAT sneaker search, lowest ask per size and condition, last sold prices and product details as JSON, via APISH. Pay per credit; failed calls are free.

Pricing

$4.00 / 1,000 credits

Rating

0.0

(0)

Developer

APISH

APISH

Maintained by Community

Actor stats

0

Bookmarked

2

Total users

1

Monthly active users

5 days ago

Last modified

Categories

Features

Limited permissions

Share

Get public GOAT data as clean, consistent JSON: gOAT search suggestions, one GOAT product, gOAT related products, gOAT search, gOAT lowest ask per size. 5 endpoints, one response shape, numbers parsed, absolute URLs.

How to use

  1. Pick an Endpoint. Each option shows what it returns and its price in credits.
  2. Enter its Parameters as JSON, for example {"q":"jordan 1"}. All parameters are listed below.
  3. Run. Each call becomes one row in the dataset. Use Batch to run the same endpoint for many inputs and Pages per input to follow pagination.

Pricing

Pay per event: you pay per APISH credit the call used. The price of each endpoint is in the table below. Calls that fail on our side (server errors, timeouts, blocks) are free.

Endpoints

EndpointReturnsRequired parametersCredits
/goat/v1/autocompleteGOAT search suggestionsq1
/goat/v1/productOne GOAT producturl1
/goat/v1/relatedGOAT related products—1
/goat/v1/searchGOAT search—1
/goat/v1/sizesGOAT lowest ask per size—1

Output

Each dataset row has endpoint, params, status, credits_used and the endpoint's data. Add "raw": 1 to the parameters to also get the site's original record, or "fields": "a,b.c" to return only the fields you need.

Endpoint details

GOAT search suggestions

Endpoint /goat/v1/autocomplete · 1 credit per successful call.

The suggestions GOAT's search box shows for a partial query: products (id, name, slug, category, image) and collections.

Parameters:

  • q (required): What has been typed so far.

Example parameters: {"q":"jordan 1"}

One GOAT product

Endpoint /goat/v1/product · 1 credit per successful call.

Parameters:

  • url (required)

Example parameters: {"url":"undefeated-x-air-jordan-4-retro-ib1519-200"}

Endpoint /goat/v1/related · 1 credit per successful call.

Products GOAT recommends alongside a product (similar styles): name, SKU, brand, colour, category, release date, lowest and display price, image and size range. Identify the product by id, by its goat.com link, or by q (the first search result).

Parameters:

  • id: GOAT's numeric product id (from search). One of id, url or q is required.
  • url: A goat.com product link.
  • q: Search words; the first result is used.
  • count: How many products (1-50).

Example parameters: {"id":"719082","q":"dunk low panda","count":12}

Endpoint /goat/v1/search · 1 credit per successful call.

Pass next_page from the previous response; next_page is null on the last page. Filter by brand, category, product type, activity, gender, colour, silhouette (model line), release year, condition, size and price range. Facet filters take the slug values listed in facets (comma-separated for several); applied_filters echoes the filters in effect.

Parameters:

  • q: Search words. May be left out when a brand, category or other facet filter is given, which lists that brand or category.
  • page: Page number. Pass next_page from the previous response; next_page is null on the last page.
  • sort — one of relevance, newest, price_asc, price_desc: Sort order (lowest ask for the price sorts). Default relevance.
  • sort_type: GOAT's own numeric sortType, passed as-is (overrides sort).
  • instant_ship: Only products available with Instant Ship.
  • under_retail: Only products selling under retail price.
  • brand: Brand slug(s) from facets.brands, comma-separated, e.g. nike or nike,air-jordan.
  • category: Category slug(s) from facets.categories, e.g. footwear, apparel, bags.
  • product_type: Product type slug(s) (nested under facets.categories), e.g. sneakers, tops, boots.
  • activity: Activity slug(s) (nested under facets.categories), e.g. basketball, running, lifestyle.
  • gender: Gender slug(s) from facets.genders: men, women, youth, infant.
  • color: Colour slug(s) from facets.colors, e.g. black or white,black.
  • silhouette: Model line(s), the product's silhouette in slug form (lowercase, hyphens), e.g. air-jordan-1, dunk or yeezy-boost-350; comma-separated for several.
  • release_year: Release year(s), e.g. 2022 or 2022,2023.
  • condition: Only products offered in this condition (comma-separated for several): new_no_defects, new_with_defects, used.
  • size: Only products with an offer in this size, e.g. 10, 10.5 (US shoe sizes) or m (apparel); comma-separated for several. Uses the single gender given (default men) and size_type. A size code such as us_shoes_women_8 is passed as-is.
  • size_type — one of shoes, tops, bottoms, outerwear, dresses: What size refers to: shoes (default for numbers), tops (default for letters), bottoms, outerwear, dresses.
  • min_price_cents: Lowest price, in cents (e.g. 10000 = $100).
  • max_price_cents: Highest price, in cents.

Example parameters: {"q":"jordan 1"}

GOAT lowest ask per size

Endpoint /goat/v1/sizes · 1 credit per successful call.

Every size of a GOAT product with its lowest ask, the condition and box condition of that offer, stock status, the instant-ship ask and the last sold price, plus the full list of size, condition and box-condition combinations. Prices are in cents. Pass q to open the first current search result, or an id or product url. Pass size for the price of one size only.

Parameters:

  • q: Search words; the first current result is used. Either q, id or url is required.
  • id: GOAT product id (the id from /goat/v1/search).
  • url: A GOAT product link (https://www.goat.com/sneakers/
  • condition — one of new_no_defects, new_with_defects, used: Only offers in this condition.
  • in_stock: Only sizes and conditions that have an ask right now.
  • size: One size only, e.g. 10, 10.5 or M (as in sizes[].size). 404 when the product does not list that size.
  • country: Two-letter market code (default US).

Example parameters: {"q":"dunk low panda"}

Support

Questions, bugs or a missing field? Open an issue in this Actor's Issues tab and we will reply there.

Public data only: nothing behind a login. You are responsible for how you use the data you collect.