--- title: "GOAT API: JSON data, 2 endpoints, 1 credit per call" description: "GOAT API for sneaker and apparel search by condition, size and price, with retail and lowest prices, and product details as JSON. 1 credit per successful call." url: https://perceptlayer.com/apis/goat --- [APIs](https://perceptlayer.com/apis) / [Marketplaces](https://perceptlayer.com/verticals/marketplaces) / GOAT 1 credit per call 2 endpoints 20 datapoints # GOAT API GOAT API for sneaker and apparel search by condition, size and price, with retail and lowest prices, and product details as JSON. 1 credit per successful call. [Get a free API key](https://perceptlayer.com/signup) Run it below GOAT GET /v1/goat/search?query=jordan+4&condition=used&sort=price\_asc ``` { "success": true, "data": { "query": "jordan 4", "market": "us", "currency": "USD", "sort": "price_asc", "filters": { "condition": "used" }, "total_count": 538, "items": [ { "id": 535629, "slug": "air-jordan-4-retro-td-cool-grey-2019-bq7670-007", "url": "https://www.goat.com/sneakers/air-jordan-4-retro-td-cool-grey-2019-bq7670-007", "name": "Air Jordan 4 Retro TD 'Cool Grey' 2019", "brand": { "name": "Air Jordan", "slug": "air-jordan" }, "silhouette": "Air Jordan 4", "category": "shoes", "product_type": "sneakers", "gender": "infant", "activities": [ "lifestyle" ], "tags": [ "detail:Air", "style:Tonal", "style:Athletic" ], "status": "active", "in_stock": true, "image": "https://image.goat.com/attachments/product_template_pictures/images/108/917/179/original/535629_00.png.png", "under_retail": false, "release_date": "2019-08-01T23:59:59Z", "retail_price": { "amount": 60, "currency": "USD" }, "lowest_price": { "amount": 35, "currency": "USD" }, "discount_percent": 41.7, "prices": [ { "condition": "used", "size": "7", "lowest_price": "…" } ] }, { "id": 1621610, "slug": "jordan-luka-4-laser-blue-hf0823-002", "url": "https://www.goat.com/sneakers/jordan-luka-4-laser-blue-hf0823-002", "name": "Air Jordan Luka 4 'Laser Blue'", "brand": { "name": "Air Jordan", "slug": "air-jordan" }, "silhouette": "Jordan Luka 4", "category": "shoes", "product_type": "sneakers", "gender": "men", "activities": [ "basketball" ], "status": "active", "in_stock": true, "image": "https://image.goat.com/attachments/product_template_pictures/images/110/361/271/original/HF0823_002.png.png", "under_retail": false, "release_date": "2025-06-05T23:59:59Z", "retail_price": { "amount": 130, "currency": "USD" }, "lowest_price": { "amount": 35, "currency": "USD" }, "discount_percent": 73.1, "prices": [ { "condition": "used", "size": "12", "lowest_price": "…" } ] }, { "id": 1393723, "slug": "air-jordan-4-retro-td-hyper-violet-fq1313-151", "url": "https://www.goat.com/sneakers/air-jordan-4-retro-td-hyper-violet-fq1313-151", "name": "Air Jordan 4 Retro TD 'Hyper Violet'", "brand": { "name": "Air Jordan", "slug": "air-jordan" }, "silhouette": "Air Jordan 4", "category": "shoes", "product_type": "sneakers", "gender": "infant", "activities": [ "lifestyle" ], "tags": [ "style:Lifestyle", "style:Basketball", "style:Streetwear" ], "status": "active", "in_stock": true, "image": "https://image.goat.com/attachments/product_template_pictures/images/099/609/775/original/FQ1313_151.png.png", "under_retail": false, "release_date": "2024-04-26T23:59:59Z", "retail_price": { "amount": 75, "currency": "USD" }, "lowest_price": { "amount": 42, "currency": "USD" }, "discount_percent": 44, "prices": [ { "condition": "used", "size": "7", "lowest_price": "…" } ] } ], "pagination": { "page": 1, "per_page": 12, "has_more": true } }, "meta": { "endpoint_family": "search", "request_id": "req_bd2b18e6383842379c7028632733407a", "credits_charged": 1, "credits_remaining": 1917 } } ``` 200 OK JSON X-Credits-Used: 1 Recorded from our API and shortened. Sample data ## What one call returns A recorded run of `search`: the fields and shapes you will get, shortened to 3 items. | # | id integer | slug string | url url | name string | brand object | silhouette string | category string | product\_type string | gender string | activities string\[\] | tags string\[\] | status string | in\_stock boolean | image url | under\_retail boolean | release\_date string | retail\_price object | lowest\_price object | discount\_percent number | prices object\[\] | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 1 | 535629 | air-jordan-4-retro-td-cool-grey-2019-bq7670-007 | https://www.goat.com/sneakers/air-jordan-4-retro-td-cool-grey-2019-bq7670-007 | Air Jordan 4 Retro TD 'Cool Grey' 2019 | {2 fields} | Air Jordan 4 | shoes | sneakers | infant | \[1 item\] | \[3 items\] | active | true | https://image.goat.com/attachments/product\_template\_pictures/images/108/917/179/original/535629\_00.png.png | false | 2019-08-01T23:59:59Z | {2 fields} | {2 fields} | 41.7 | \[1 item\] | | 2 | 1621610 | jordan-luka-4-laser-blue-hf0823-002 | https://www.goat.com/sneakers/jordan-luka-4-laser-blue-hf0823-002 | Air Jordan Luka 4 'Laser Blue' | {2 fields} | Jordan Luka 4 | shoes | sneakers | men | \[1 item\] | — | active | true | https://image.goat.com/attachments/product\_template\_pictures/images/110/361/271/original/HF0823\_002.png.png | false | 2025-06-05T23:59:59Z | {2 fields} | {2 fields} | 73.1 | \[1 item\] | | 3 | 1393723 | air-jordan-4-retro-td-hyper-violet-fq1313-151 | https://www.goat.com/sneakers/air-jordan-4-retro-td-hyper-violet-fq1313-151 | Air Jordan 4 Retro TD 'Hyper Violet' | {2 fields} | Air Jordan 4 | shoes | sneakers | infant | \[1 item\] | \[3 items\] | active | true | https://image.goat.com/attachments/product\_template\_pictures/images/099/609/775/original/FQ1313\_151.png.png | false | 2024-04-26T23:59:59Z | {2 fields} | {2 fields} | 44 | \[1 item\] | Recorded from our API · 3 items shown · 20 datapoints per item GET /v1/goat/search?query=jordan+4&condition=used&sort=price\_asc 20 datapoints ### Identity - id integer - slug string - name string - brand object - category string - product\_type string - status string ### Contact - url url ### Reputation - image url ### Price - retail\_price object - lowest\_price object - discount\_percent number - prices object\[\] ### Other - silhouette string - gender string - activities string\[\] - tags string\[\] - in\_stock boolean - under\_retail boolean - release\_date string Playground ## Run this API cURL shell ``` curl "https://api.perceptlayer.com/v1/goat/search?query=jordan+4&condition=used&sort=price_asc" \ -H "X-API-Key: $API_KEY" ``` GOAT · 2 endpoints ## Endpoints Every endpoint takes the same key. Open one for its parameters and an example request. | Endpoint | Required parameters | Cost | | --- | --- | --- | | [GET `/v1/goat/product`](https://perceptlayer.com/apis/goat/product) | none +4 optional | 1 credit | | [GET `/v1/goat/search`](https://perceptlayer.com/apis/goat/search) | none +15 optional | 1 credit | Overview ## About the GOAT API ## What you can get The GOAT API returns GOAT product and price data as JSON through 2 endpoints. Both take an optional `market` (us, uk, ca, au, de, jp or fr). - **Search:** `search` takes a `query`, with `brand`, `category` (sneakers, tops, bottoms, outerwear, dresses or belts), `gender` (men, women, youth or infant), `size`, `condition` (new, new\_with\_defects or used), `price_min`, `price_max`, `instant_ship`, `under_retail`, `sale`, `sort` (relevance, newest, price\_asc or price\_desc), `page` and `include_facets`. - **Products:** `product` takes a `url`, `slug` or `id`. The recorded search for "jordan 4" with `condition=used` and `sort=price_asc` returns `items`, each with `id`, `slug`, `name`, `brand`, `silhouette`, `product_type`, `gender`, `in_stock`, `under_retail`, `release_date`, `retail_price`, `lowest_price`, `discount_percent` and `prices` (by condition and size). It also returns `total_count` (538 in that recording) and `pagination` with `has_more`. ## How a call works Search, then look up: `GET /v1/goat/search?query=jordan 4&condition=used&sort=price_asc` with your key in the `X-API-Key` header. Each result carries a `slug` and an `id`, which `product` takes. Every successful call costs 1 credit; failed calls cost nothing. Marketplaces JSON REST MCP ### More marketplaces APIs [About You](https://perceptlayer.com/apis/about-you) [adidas](https://perceptlayer.com/apis/adidas) [AliExpress](https://perceptlayer.com/apis/aliexpress) [Allegro](https://perceptlayer.com/apis/allegro) [Amazon](https://perceptlayer.com/apis/amazon) [ASOS](https://perceptlayer.com/apis/asos) [Billiger.de](https://perceptlayer.com/apis/billiger) [bol.com](https://perceptlayer.com/apis/bol) [Chrono24](https://perceptlayer.com/apis/chrono24) [Costco](https://perceptlayer.com/apis/costco) [Craigslist](https://perceptlayer.com/apis/craigslist) [DBA](https://perceptlayer.com/apis/dba) Use cases ### Track lowest prices for a sneaker list by size and condition `Use the GOAT API to track lowest prices for a sneaker list by size and condition` ### Find pairs selling under retail with \`under\_retail\` `` Use the GOAT API to find pairs selling under retail with `under_retail` `` ### Compare new and used prices for the same silhouette `Use the GOAT API to compare new and used prices for the same silhouette` ### Compare prices across GOAT markets `Use the GOAT API to compare prices across GOAT markets` FAQ ## Questions **How much does the GOAT API cost?** Each successful call costs one credit, and each search page is one call. New accounts get free credits to start, and credit packs bring the price down as you scale. **Can I search used sneakers?** Yes. Pass \`condition=used\`, or new or new\_with\_defects, to \`search\`. **Do I need a GOAT account?** No. You call this GOAT API with your Perceptlayer key in the \`X-API-Key\` header, with no GOAT login. **What format are responses in?** Every endpoint returns JSON, with no HTML parsing on your side. **Should I build a GOAT scraper instead?** You can, but a GOAT scraper is code you maintain: page changes break it, requests get blocked, and GOAT's terms govern how you collect data. The GOAT API gives you 2 endpoints of named JSON fields for 1 credit per successful call, and failed calls cost nothing. A scraper makes sense only for data these endpoints don't return, so check the response in the playground on this page first. ## Try the GOAT API with 100 free credits No credit card. Failed calls are never billed. [Get a free API key](https://perceptlayer.com/signup) [Read the docs](https://docs.perceptlayer.com)