# GOAT Search

## Overview

| Property | Value |
|----------|-------|
| **Status** | private |
| **Method** | `GET` |
| **Endpoint** | `/v2/goat/search` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 1 credit per call |
| **Documentation** | https://www.piloterr.com/library/goat-search |

## Access

This endpoint is **private**. Requests return HTTP 403 until access is granted. There is no self-serve request-access button. Open a support ticket from the dashboard Help desk (https://app.piloterr.com/app?returnTo=help-desk/tickets/new) and include the endpoint path, your use case, target fields, and expected volume.

## Description

Search GOAT's sneaker and streetwear catalog in real time and get product slugs, prices, brand, SKU, and images as structured JSON.

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.piloterr.com/register

## Example Request

```bash
curl --location --request GET 'https://api.piloterr.com/v2/goat/search' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Search Air Jordan 1 Chicago

```json
{
  "page": 1,
  "results": [
    {
      "id": "1295",
      "sku": "555088-101",
      "url": "https://www.goat.com/en-us/sneakers/air-jordan-1-retro-high-chicago-2015-555088-101",
      "name": "Air Jordan 1 Retro High OG 'Chicago' (2015)",
      "slug": "air-jordan-1-retro-high-chicago-2015-555088-101",
      "image": "https://image.goat.com/attachments/product_template_pictures/images/001/234/567/original/555088_101.png.png",
      "category": "shoes",
      "brand_name": "Air Jordan",
      "release_date": "2015-02-14T00:00:00.000Z",
      "product_condition": "new_no_defects",
      "lowest_price_cents": 32500,
      "instant_ship_lowest_price_cents": 34000
    },
    {
      "id": "1103114",
      "sku": "DV1748-601",
      "url": "https://www.goat.com/en-us/sneakers/marvel-x-air-jordan-1-retro-high-og-spider-man-across-the-spider-verse-dv1748-601",
      "name": "Marvel x Air Jordan 1 Retro High OG 'Next Chapter'",
      "slug": "marvel-x-air-jordan-1-retro-high-og-spider-man-across-the-spider-verse-dv1748-601",
      "image": "https://image.goat.com/1000/attachments/product_template_pictures/images/085/116/986/original/1103114_00.png.png",
      "category": "shoes",
      "brand_name": "Air Jordan",
      "release_date": "2023-05-20T23:59:59.999Z",
      "product_condition": "new_no_defects",
      "lowest_price_cents": 20000,
      "instant_ship_lowest_price_cents": null
    }
  ],
  "total_pages": 43,
  "total_results": 847,
  "results_per_page": 20
}
```

### Search Nike Dunk Low Panda

```json
{
  "page": 1,
  "results": [
    {
      "id": "772893",
      "sku": "DD1391-100",
      "url": "https://www.goat.com/en-us/sneakers/nike-dunk-low-white-black-2021-dd1391-100",
      "name": "Nike Dunk Low 'Panda' (2021)",
      "slug": "nike-dunk-low-white-black-2021-dd1391-100",
      "image": "https://image.goat.com/attachments/product_template_pictures/images/065/234/891/original/DD1391_100.png.png",
      "category": "shoes",
      "brand_name": "Nike",
      "release_date": "2021-03-10T00:00:00.000Z",
      "product_condition": "new_no_defects",
      "lowest_price_cents": 11800,
      "instant_ship_lowest_price_cents": 12500
    }
  ],
  "total_pages": 12,
  "total_results": 234,
  "results_per_page": 20
}
```

### Search by SKU DV1748-601

```json
{
  "page": 1,
  "results": [
    {
      "id": "1103114",
      "sku": "DV1748-601",
      "url": "https://www.goat.com/en-us/sneakers/marvel-x-air-jordan-1-retro-high-og-spider-man-across-the-spider-verse-dv1748-601",
      "name": "Marvel x Air Jordan 1 Retro High OG 'Next Chapter'",
      "slug": "marvel-x-air-jordan-1-retro-high-og-spider-man-across-the-spider-verse-dv1748-601",
      "image": "https://image.goat.com/1000/attachments/product_template_pictures/images/085/116/986/original/1103114_00.png.png",
      "category": "shoes",
      "brand_name": "Air Jordan",
      "release_date": "2023-05-20T23:59:59.999Z",
      "product_condition": "new_no_defects",
      "lowest_price_cents": 20000,
      "instant_ship_lowest_price_cents": null
    }
  ],
  "total_pages": 1,
  "total_results": 1,
  "results_per_page": 20
}
```

## Documentation

## Overview
GOAT is one of the world's largest sneaker resale platforms. Prices shift hourly as inventory clears. GOAT runs Cloudflare. Piloterr handles the bypass so you get structured search results with a single GET call.

## Quickstart
```
GET https://api.piloterr.com/v2/goat/search?query=Air+Jordan+1+Chicago
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Product name, SKU, brand, or colorway |
| `page` | integer | no | Page number (default: 1) |
| `category` | string | no | Category filter |
| `brand` | string | no | Brand filter |
| `condition` | string | no | Condition filter |
| `size` | number | no | US shoe size |

## Main use cases
- Track real-time resale price movements for sneakers across conditions
- Monitor search rankings to see which colorways surface for a given keyword
- Build price comparison tools pulling GOAT data alongside StockX and Flight Club
- Feed automated trading systems with current lowest-price data
- Detect newly listed products after drop date to catch arbitrage windows

Get access at https://www.piloterr.com/pricing