---
title: "GOAT API: Search | Perceptlayer"
description: "Search from GOAT as JSON. 1 credit per successful call."
url: https://perceptlayer.com/apis/goat/search
---

[APIs](https://perceptlayer.com/apis) / [GOAT](https://perceptlayer.com/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 OK JSON X-Credits-Used: 1

Recorded from our API and shortened.

[Run this endpoint in the playground](https://perceptlayer.com/apis/goat?try=search#playground) with your own parameters. 1 credit per successful call; failed calls are free.