Sign inGet a free API keyDashboard
Menu

APIs / Marketplaces / GOAT

1 credit per call2 endpoints20 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 keyRun 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 OKJSONX-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.

#idintegerslugstringurlurlnamestringbrandobjectsilhouettestringcategorystringproduct_typestringgenderstringactivitiesstring[]tagsstring[]statusstringin_stockbooleanimageurlunder_retailbooleanrelease_datestringretail_priceobjectlowest_priceobjectdiscount_percentnumberpricesobject[]
1535629air-jordan-4-retro-td-cool-grey-2019-bq7670-007https://www.goat.com/sneakers/air-jordan-4-retro-td-cool-grey-2019-bq7670-007Air Jordan 4 Retro TD 'Cool Grey' 2019{2 fields}Air Jordan 4shoessneakersinfant[1 item][3 items]activetruehttps://image.goat.com/attachments/product_template_pictures/images/108/917/179/original/535629_00.png.pngfalse2019-08-01T23:59:59Z{2 fields}{2 fields}41.7[1 item]
21621610jordan-luka-4-laser-blue-hf0823-002https://www.goat.com/sneakers/jordan-luka-4-laser-blue-hf0823-002Air Jordan Luka 4 'Laser Blue'{2 fields}Jordan Luka 4shoessneakersmen[1 item]—activetruehttps://image.goat.com/attachments/product_template_pictures/images/110/361/271/original/HF0823_002.png.pngfalse2025-06-05T23:59:59Z{2 fields}{2 fields}73.1[1 item]
31393723air-jordan-4-retro-td-hyper-violet-fq1313-151https://www.goat.com/sneakers/air-jordan-4-retro-td-hyper-violet-fq1313-151Air Jordan 4 Retro TD 'Hyper Violet'{2 fields}Air Jordan 4shoessneakersinfant[1 item][3 items]activetruehttps://image.goat.com/attachments/product_template_pictures/images/099/609/775/original/FQ1313_151.png.pngfalse2024-04-26T23:59:59Z{2 fields}{2 fields}44[1 item]

Recorded from our API · 3 items shown · 20 datapoints per itemGET /v1/goat/search?query=jordan+4&condition=used&sort=price_asc

20 datapoints

Identity

  • idinteger
  • slugstring
  • namestring
  • brandobject
  • categorystring
  • product_typestring
  • statusstring

Contact

  • urlurl

Reputation

  • imageurl

Price

  • retail_priceobject
  • lowest_priceobject
  • discount_percentnumber
  • pricesobject[]

Other

  • silhouettestring
  • genderstring
  • activitiesstring[]
  • tagsstring[]
  • in_stockboolean
  • under_retailboolean
  • release_datestring

Playground

Run this API

cURLshell
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.

EndpointRequired parametersCost
GET/v1/goat/product
none+4 optional
1 credit
GET/v1/goat/search
none+15 optional
1 credit

Overview

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.

MarketplacesJSONRESTMCP

More marketplaces APIs

About YouadidasAliExpressAllegroAmazonASOSBilliger.debol.comChrono24CostcoCraigslistDBA

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 keyRead the docs