docs / goat

GOAT API

base /goat/v15 endpoints

post/goat/v1/search1 credit

Search GOAT for products by keyword. Returns matching products (name, slug, brand image, category) plus related curated collections. Resolves the `slug`/`product_id` you feed into product_detail and prices. `limit` caps results.

Parameter		Allowed / range	Description
query	required	—	What to search for — a sneaker/streetwear name, model, brand or SKU ('air jordan 4', 'nike dunk low', 'new balance 550', 'yeezy').
limit = 25	optional	1–50	Max products to return (1-50).

Try in playground →

post/goat/v1/suggest1 credit

Autocomplete suggestions for a partial query — quick product + collection name matches as the customer types. Lighter than search.

Parameter		Allowed / range	Description
query	required	—	Partial search text to complete.

Try in playground →

post/goat/v1/product_detail1 credit

Full catalogue record for one product by `slug` / `url` / `product_id`: name, nickname, brand, SKU, colorway, designer, gender, silhouette, release date, season, materials, size range, taxonomy, images, the GOAT display price and the offer floor/ceiling. Pair with `prices` for the live per-size resale grid.

Parameter		Allowed / range	Description
slug	optional	—	Product slug from a GOAT URL (goat.com/sneakers/<slug>) — copy it from search results. Provide slug OR url.
url	optional	—	Full GOAT product URL — alternative to slug.
product_id	optional	—	GOAT productTemplateId (the numeric id from a search/detail result). Provide product_id OR slug OR url.

Try in playground →

post/goat/v1/prices1 credit

Live per-size resale price grid for a product (the market-data moat). For each size of the given `condition` it returns the lowest live ask + listing count, plus the cheapest listing overall. Accepts `slug`/`url`/`product_id`. `condition` (used/new_no_defects), `country` set the market. Optional `size` narrows to one size (returns every live listing for it). Honest-empty when nothing is listed.

Parameter		Allowed / range	Description
slug	optional	—	Product slug from a GOAT URL (goat.com/sneakers/<slug>) — copy it from search results. Provide slug OR url.
url	optional	—	Full GOAT product URL — alternative to slug.
product_id	optional	—	GOAT productTemplateId (the numeric id from a search/detail result). Provide product_id OR slug OR url.
condition = used	optional	used · new_no_defects	Listing condition for the live price grid. 'used' is the deep public resale pool; 'new_no_defects' covers brand-new pairs.
country = US	optional	US · GB · DE · FR · IT · CA · AU · JP · KR · HK · NL · ES	Market/country the prices are quoted for (affects asks + FX).
size	optional	—	Optional single size (e.g. 10, 10.5) — returns every live listing for just that size instead of the whole grid.

Try in playground →

post/goat/v1/related1 credit

Products related to one product by `slug`/`url`: GOAT's recommended products plus the brand / category / silhouette grids GOAT surfaces on the page. Catalogue discovery from any starting product.

Parameter		Allowed / range	Description
slug	optional	—	Product slug from a GOAT URL (goat.com/sneakers/<slug>) — copy it from search results. Provide slug OR url.
url	optional	—	Full GOAT product URL — alternative to slug.

Try in playground →

Example request · search

curl -X POST https://api.reefapi.com/goat/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"air jordan 4"}'

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}