APIs / GOAT / Search

GOAT: Search

Search from GOAT as JSON. 1 credit per successful call.

GET /v1/goat/search

Parameters

Send parameters in the query string.

Parameter	Type	Required	Allowed values
`query`	string	Optional	Up to 200 characters
`brand`	string	Optional	Up to 100 characters
`category`	string	Optional	sneakers, tops, bottoms, outerwear, dresses, belts
`gender`	string	Optional	men, women, youth, infant
`size`	string	Optional	Up to 60 characters
`condition`	string	Optional	new, new_with_defects, used
`price_min`	number	Optional	Any
`price_max`	number	Optional	Any
`instant_ship`	boolean	Optional	Any
`under_retail`	boolean	Optional	Any
`sale`	boolean	Optional	Any
`sort`	string	Optional	relevance, newest, price_asc, price_desc
`page`	integer	Optional	Any
`market`	string	Optional	us, uk, ca, au, de, jp, fr
`include_facets`	boolean	Optional	Any

Example request

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.

Run this endpoint in the playground with your own parameters. 1 credit per successful call; failed calls are free.