E-commerce & Marketplaces

GOAT API

The GOAT API returns live sneaker and streetwear resale data as clean JSON.

5 actionsLive JSON1,000 free creditsMCP-ready

🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.

The primary search endpoint returns matching products (id, slug, URL, name, image, category) plus curated collections, and product_detail and prices expose the resale pricing and variant data behind a listing. You can also suggest queries and pull related products. It is built for resale-price intelligence, sneaker apps and reselling tools that need GOAT market data without scraping a heavily-defended marketplace. One ReefAPI key, one shared credit pool, the standard envelope.

Live example

Real request and response JSON

Captured from the indexed primary action, search, on Jul 18, 2026, 5:19 PM UTC.

Captured request

{
  "method": "POST",
  "url": "https://api.reefapi.com/goat/v1/search",
  "headers": {
    "x-api-key": "$REEF_KEY",
    "content-type": "application/json"
  },
  "body": {
    "query": "air jordan 4"
  }
}

Captured response

{
  "ok": true,
  "meta": {
    "api": "goat",
    "endpoint": "search",
    "mode": "live",
    "latency_ms": 381.8,
    "record_count": 25,
    "bytes": 11257,
    "cache_hit": false,
    "stop_reason": "complete",
    "method": "ssr_next_data+web_api",
    "query": "air jordan 4",
    "pagination": {
      "has_more": false
    }
  },
  "data": {
    "results": [
      {
        "product_id": "1567309",
        "slug": "air-jordan-4-retro-black-cat-2025-fv5029-010",
        "url": "https://www.goat.com/sneakers/air-jordan-4-retro-black-cat-2025-fv5029-010",
        "name": "[redacted-name]",
        "image": "https://image.goat.com/attachments/product_template_pictures/images/112/064/690/original/1567309_00.png.png",
        "category": "shoes"
      },
      {
        "product_id": "1653296",
        "slug": "air-jordan-4-retro-toro-bravo-2026-fq8138-600",
        "url": "https://www.goat.com/sneakers/air-jordan-4-retro-toro-bravo-2026-fq8138-600",
        "name": "[redacted-name]",
        "image": "https://image.goat.com/attachments/product_template_pictures/images/115/979/043/original/1653296_00.png.png",
        "category": "shoes"
      },
      {
        "product_id": "1487425",
        "slug": "air-jordan-4-retro-og-white-cement-2025-fv5029-100",
        "url": "https://www.goat.com/sneakers/air-jordan-4-retro-og-white-cement-2025-fv5029-100",
        "name": "[redacted-name]",
        "image": "https://image.goat.com/attachments/product_template_pictures/images/108/196/609/original/1487425_00.png.png",
        "category": "shoes"
      }
    ],
    "collections": [
      {
        "record_id": "5a48381c-ac1c-4883-95e3-b8be04efd5c8",
        "title": "Air Jordan 4",
        "slug": "air-jordan-4-alias",
        "subtype": "StaticCollection"
      },
      {
        "record_id": "8440c30c-f511-4a03-9139-ed16c4046765",
        "title": "Air Jordan 4",
        "slug": "air-jordan-4",
        "subtype": "StaticCollection"
      },
      {
        "record_id": "5b4928f8-26ed-4196-87c[redacted-phone]ee057",
        "title": "FORMAT | AIR JORDAN 4",
        "slug": "format-air-jordan-4",
        "subtype": "StaticPictureCollection"
      }
    ]
  }
}

Actions

What the GOAT API does

Action	Description	Concrete use case	Key params
search	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.	Pricing teams call search to search GOAT for products by keyword.	query, limit
suggest	Autocomplete suggestions for a partial query — quick product + collection name matches as the customer types. Lighter than search.	Marketplace operators call suggest to get autocomplete suggestions for a partial query.	query
product_detail	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.	Catalog enrichment teams call product_detail to get full catalogue record for one product by `slug` / `url` / `product_id`.	slug, url, product_id
prices	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.	Retail analysts call prices to get live per-size resale price grid for a product (the market-data moat).	slug, url, product_id, condition, country, ...
related	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.	Pricing teams call related to get products related to one product by `slug`/`url`.	slug, url

Code samples

Call search from your stack

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"}'

import requests

r = requests.post(
    "https://api.reefapi.com/goat/v1/search",
    headers={"x-api-key": REEF_KEY},
    json={
  "query": "air jordan 4"
},
)
print(r.json()["data"])

const res = await fetch("https://api.reefapi.com/goat/v1/search", {
  method: "POST",
  headers: {
    "x-api-key": process.env.REEF_KEY,
    "content-type": "application/json",
  },
  body: JSON.stringify({
  "query": "air jordan 4"
}),
});
const { ok, data, meta, error } = await res.json();

MCP one-liner

Ask your MCP-connected assistant: call reefapi.goat.search with {"query":"air jordan 4"}.

Use cases

Who uses this API and why

Resale-price tools call search then prices to track a sneaker's market value across sizes.
Sneaker apps use product_detail to show live GOAT listings alongside other marketplaces.
Resellers use related and suggest to discover trending models and comparable products.

FAQ

Questions developers ask before integrating

What is the GOAT API?

GOAT API is a ReefAPI endpoint group for goat It returns live JSON through POST requests under /goat/v1.

Is the GOAT API free to try?

Yes. ReefAPI starts with 1,000 free credits, no card required. GOAT calls use the same shared credit balance as every other ReefAPI engine.

Do I need a GOAT login or account?

No login to GOAT is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.

How fresh is the GOAT data?

The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.

How many credits does the GOAT API use?

GOAT actions currently cost 1 credit per successful call. Failed or blocked calls are free, and all APIs draw from one credit pool.

Can I call GOAT from an AI assistant or MCP client?

Yes. Connect ReefAPI once through MCP and your assistant can call goat actions with the same key, credit pool and JSON envelope used by normal REST requests.

Is the GOAT API a GOAT scraper?

It is the managed alternative to a DIY GOAT scraper. Instead of building and maintaining your own scraper — proxies, headless browsers, captcha and constant breakage — you call one ReefAPI endpoint and get the same goat back as clean JSON.

Why does my GOAT scraper keep getting blocked?

Most GOAT scrapers break on anti-bot defenses, rate limits and IP bans that need rotating residential proxies and browser fingerprinting to clear. ReefAPI handles all of that for you — no proxies, no captchas, no maintenance — and returns live JSON. Blocked or failed calls are free.

docs / goat

GOAT

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
}