# GOAT Product

## Overview

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

## 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

Fetch a GOAT product by URL or slug and get full sneaker details: SKU, colorway, brand, size range, pricing tiers, and gallery images.

## 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/product' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Fetch by product slug

```json
{
  "id": 1103114,
  "sku": "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",
  "color": "Red",
  "story": "The Marvel x Air Jordan 1 Retro High OG 'Next Chapter' delivers a collaborative colorway tied to the animated film 'Spider-Man: Across the Spider-Verse.'",
  "gender": [
    "men"
  ],
  "season": "2023",
  "status": "active",
  "details": "University Red/Black/White",
  "midsole": "Air",
  "category": [
    "Lifestyle"
  ],
  "designer": "Peter Moore",
  "nickname": "Next Chapter",
  "size_type": "numeric_sizes",
  "size_unit": "us",
  "brand_name": "Air Jordan",
  "is_ownable": true,
  "silhouette": "Air Jordan 1",
  "size_brand": "air_jordan",
  "size_range": [
    3.5,
    4,
    4.5,
    5,
    5.5,
    6,
    6.5,
    7,
    7.5,
    8,
    8.5,
    9,
    9.5,
    10,
    10.5,
    11,
    11.5,
    12,
    12.5,
    13,
    14,
    15,
    16,
    17
  ],
  "is_wantable": true,
  "picture_url": "https://image.goat.com/1000/attachments/product_template_pictures/images/085/116/986/original/1103114_00.png.png",
  "is_offerable": true,
  "product_type": "sneakers",
  "release_date": "2023-05-20T23:59:59.999Z",
  "size_options": [
    {
      "value": 9,
      "presentation": "9"
    },
    {
      "value": 9.5,
      "presentation": "9.5"
    },
    {
      "value": 10,
      "presentation": "10"
    },
    {
      "value": 10.5,
      "presentation": "10.5"
    },
    {
      "value": 11,
      "presentation": "11"
    }
  ],
  "special_type": "standard",
  "is_resellable": true,
  "upper_material": "Leather",
  "direct_shipping": false,
  "taxonomy_level1": "Footwear",
  "taxonomy_level2": "Sneakers",
  "grid_picture_url": "https://image.goat.com/375/attachments/product_template_pictures/images/085/116/986/original/1103114_00.png.png",
  "main_picture_url": "https://image.goat.com/750/attachments/product_template_pictures/images/085/116/986/original/1103114_00.png.png",
  "product_category": "shoes",
  "is_raffle_product": false,
  "is_fashion_product": false,
  "lowest_price_cents": 20000,
  "available_sizes_new": [
    9.5,
    10,
    10.5
  ],
  "maximum_offer_cents": 200000,
  "minimum_offer_cents": 2500,
  "available_sizes_used": [],
  "grid_glow_picture_url": "https://image.goat.com/glow-4-5-25/375/attachments/product_template_pictures/images/085/116/986/original/1103114_00.png.png",
  "main_glow_picture_url": "https://image.goat.com/glow-4-5-25/750/attachments/product_template_pictures/images/085/116/986/original/1103114_00.png.png",
  "new_lowest_price_cents": 20000,
  "used_lowest_price_cents": 0,
  "special_display_price_cents": 20000,
  "product_template_external_pictures": [
    {
      "order": 1,
      "aspect": 1.5,
      "grid_picture_url": "https://image.goat.com/attachments/product_template_additional_pictures/images/085/116/990/grid/1103114_01.jpg.jpeg",
      "main_picture_url": "https://image.goat.com/attachments/product_template_additional_pictures/images/085/116/990/medium/1103114_01.jpg.jpeg"
    },
    {
      "order": 2,
      "aspect": 1.5,
      "grid_picture_url": "https://image.goat.com/attachments/product_template_additional_pictures/images/085/116/991/grid/1103114_02.jpg.jpeg",
      "main_picture_url": "https://image.goat.com/attachments/product_template_additional_pictures/images/085/116/991/medium/1103114_02.jpg.jpeg"
    }
  ],
  "localized_special_display_price_cents": {
    "amount": 20000,
    "currency": "USD",
    "amount_usd_cents": 20000
  }
}
```

### Fetch Nike Dunk Low Panda by URL

```json
{
  "id": 772893,
  "sku": "DD1391-100",
  "name": "Nike Dunk Low 'Panda' (2021)",
  "slug": "nike-dunk-low-white-black-2021-dd1391-100",
  "color": "White",
  "story": "The Nike Dunk Low 'Panda' delivers a classic two-tone colorway on the iconic basketball silhouette turned lifestyle sneaker. A white tumbled leather upper contrasts with black overlays on the toe cap, side panels, and Swoosh.",
  "gender": [
    "men",
    "women"
  ],
  "season": "2021",
  "status": "active",
  "details": "White/Black",
  "category": [
    "Lifestyle"
  ],
  "designer": "Peter Moore",
  "nickname": "Panda",
  "size_type": "numeric_sizes",
  "size_unit": "us",
  "brand_name": "Nike",
  "is_ownable": true,
  "silhouette": "Dunk Low",
  "size_range": [
    3.5,
    4,
    4.5,
    5,
    5.5,
    6,
    6.5,
    7,
    7.5,
    8,
    8.5,
    9,
    9.5,
    10,
    10.5,
    11,
    11.5,
    12,
    13
  ],
  "is_wantable": true,
  "picture_url": "https://image.goat.com/1000/attachments/product_template_pictures/images/065/234/891/original/DD1391_100.png.png",
  "is_offerable": true,
  "product_type": "sneakers",
  "release_date": "2021-03-10T00:00:00.000Z",
  "special_type": "standard",
  "is_resellable": true,
  "upper_material": "Leather",
  "direct_shipping": false,
  "taxonomy_level1": "Footwear",
  "taxonomy_level2": "Sneakers",
  "grid_picture_url": "https://image.goat.com/375/attachments/product_template_pictures/images/065/234/891/original/DD1391_100.png.png",
  "main_picture_url": "https://image.goat.com/750/attachments/product_template_pictures/images/065/234/891/original/DD1391_100.png.png",
  "product_category": "shoes",
  "is_raffle_product": false,
  "is_fashion_product": false,
  "lowest_price_cents": 11800,
  "available_sizes_new": [
    8,
    8.5,
    9,
    9.5,
    10,
    10.5,
    11
  ],
  "maximum_offer_cents": 150000,
  "minimum_offer_cents": 2500,
  "available_sizes_used": [
    9,
    10
  ],
  "new_lowest_price_cents": 11800,
  "used_lowest_price_cents": 9500,
  "special_display_price_cents": 11800,
  "localized_special_display_price_cents": {
    "amount": 11800,
    "currency": "USD",
    "amount_usd_cents": 11800
  }
}
```

## Documentation

## Overview
GOAT product pages contain the full sneaker record: brand, SKU, size range, pricing across conditions, and gallery images. Accessing this requires bypassing Cloudflare. Piloterr handles that. One GET request, full JSON response.

## Quickstart
```
GET https://api.piloterr.com/v2/goat/product?query=nike-dunk-low-white-black-2021-dd1391-100
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | GOAT product URL or slug |

## Main use cases
- Build and maintain a structured sneaker database for resale platforms or price trackers
- Monitor size availability and pricing for specific SKUs to power stock alert systems
- Feed recommendation engines with designer, silhouette, and taxonomy data
- Track release-day pricing vs. current market value over time
- Aggregate gallery images and descriptions for cross-platform e-commerce catalogs

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