# GOAT Product API Documentation

<p><strong>GOAT Product API Documentation</strong> Get one GOAT product by url, slug or id. The response has name, nickname, SKU, colorway, designer, silhouette, brand, gender, category path, release date, season, materials, size options, retail price, every image in full size, and one row per size, condition (new, new_with_defects or used) and box condition with the lowest price, the instant ship price, the last sold price and the stock status. A size that is sold out has no price but keeps its last sold price. All prices in the variants are US dollars converted by GOAT, even when the market is not us. The market sets the country of the offers. Each request costs 1 credit. The data is public GOAT data and the endpoint is read only. A failed request is never billed.</p>

- **Documentation:** [https://scrappa.co/docs/goat-api/goat_product](https://scrappa.co/docs/goat-api/goat_product)
- **API group:** GOAT API
- **Endpoint:** `GET https://scrappa.co/api/goat/product`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `url` | string | No | A goat.com product link, for example https://www.goat.com/sneakers/air-jordan-4-retro-black-cat-2025-fv5029-010. Send one of url, slug or id. |
| `slug` | string | No | The product slug from a search result. Send one of url, slug or id. |
| `id` | integer | No | The numeric product id from a search result. Send one of url, slug or id. |
| `market` | string | No | us (default), uk, ca, au, de, jp or fr. Sets the country for the size prices. Size prices are always in US dollars. |

## Example response

```json
{
    "data": {
        "market": "us",
        "product": {
            "id": 1469452,
            "sku": "DM7866 104",
            "url": "https://www.goat.com/sneakers/fragment-design-x-travis-scott-x-air-jordan-1-low-og-sp-sail-military-blue-dm7866-104",
            "name": "Fragment Design x Travis Scott x Air Jordan 1 Retro Low OG SP 'Sail Military Blue'",
            "slug": "fragment-design-x-travis-scott-x-air-jordan-1-low-og-sp-sail-military-blue-dm7866-104",
            "brand": "Air Jordan",
            "color": "Cream",
            "gender": [
                "men"
            ],
            "images": [
                "https://image.goat.com/1000/attachments/product_template_pictures/images/112/426/275/original/1469452_00.png.png",
                "https://image.goat.com/attachments/product_template_additional_pictures/images/112/426/279/original/1469452_01.jpg.jpeg",
                "https://image.goat.com/attachments/product_template_additional_pictures/images/112/426/278/original/1469452_02.jpg.jpeg"
            ],
            "season": "2025",
            "status": "active",
            "gallery": [
                {
                    "url": "https://image.goat.com/attachments/product_template_additional_pictures/images/112/426/279/original/1469452_01.jpg.jpeg",
                    "order": 1,
                    "aspect": 1.5,
                    "thumbnail": "https://image.goat.com/attachments/product_template_additional_pictures/images/112/426/279/grid/1469452_01.jpg.jpeg",
                    "medium_url": "https://image.goat.com/attachments/product_template_additional_pictures/images/112/426/279/medium/1469452_01.jpg.jpeg",
                    "dominant_color": "#000000"
                },
                {
                    "url": "https://image.goat.com/attachments/product_template_additional_pictures/images/112/426/278/original/1469452_02.jpg.jpeg",
                    "order": 2,
                    "aspect": 1.5,
                    "thumbnail": "https://image.goat.com/attachments/product_template_additional_pictures/images/112/426/278/grid/1469452_02.jpg.jpeg",
                    "medium_url": "https://image.goat.com/attachments/product_template_additional_pictures/images/112/426/278/medium/1469452_02.jpg.jpeg",
                    "dominant_color": "#000000"
                }
            ],
            "midsole": "Air",
            "category": "shoes",
            "colorway": "Sail/Black/Muslin/Military Blue",
            "designer": "Peter Moore",
            "nickname": "Sail Military Blue",
            "max_offer": {
                "amount": 4000,
                "currency": "USD"
            },
            "min_offer": {
                "amount": 25,
                "currency": "USD"
            },
            "size_unit": "us",
            "thumbnail": "https://image.goat.com/375/attachments/product_template_pictures/images/112/426/275/original/1469452_00.png.png",
            "main_image": "https://image.goat.com/750/attachments/product_template_pictures/images/112/426/275/original/1469452_00.png.png",
            "silhouette": "Air Jordan 1",
            "description": "The Fragment Design x Travis Scott x Air Jordan 1 Low OG SP 'Sail Military Blue' utilizes smooth white leather with tonal Swoosh branding on the medial side. On the lateral side, a reverse tumbled leather Swoosh stands out in a contrasting royal blue finish. The latter hue is repeated on the collar lining and back tab, featuring mismatched Cactus Jack and Wings logos. A vintage off-white finish is applied to the textured midsole, supported underfoot by a grippy blue rubber outsole.",
            "product_type": "sneakers",
            "release_date": "2025-11-15T23:59:59Z",
            "retail_price": {
                "amount": 150,
                "currency": "USD"
            },
            "size_options": [
                {
                    "label": "3",
                    "value": 3
                },
                {
                    "label": "3.5",
                    "value": 3.5
                },
                {
                    "label": "4",
                    "value": 4
                }
            ],
            "category_path": [
                "Footwear",
                "Sneakers",
                "Basketball",
                "Lifestyle Basketball"
            ],
            "listing_counts": {
                "used": 0,
                "selling": 0,
                "new_with_defects": 0
            },
            "upper_material": "Leather"
        },
        "variants": [
            {
                "size": "3.5",
                "available": true,
                "condition": "new",
                "size_value": 3.5,
                "lowest_price": {
                    "amount": 831,
                    "currency": "USD"
                },
                "stock_status": "single_in_stock",
                "box_condition": "good_condition",
                "last_sold_price": {
                    "amount": 1111,
                    "currency": "USD"
                },
                "instant_ship_price": {
                    "amount": 894,
                    "currency": "USD"
                }
            },
            {
                "size": "4",
                "available": false,
                "condition": "new",
                "size_value": 4,
                "stock_status": "not_in_stock",
                "box_condition": "badly_damaged",
                "last_sold_price": {
                    "amount": 980,
                    "currency": "USD"
                }
            }
        ],
        "price_currency": "USD"
    },
    "meta": {
        "billable": true,
        "endpoint_family": "product"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A parameter is missing or invalid. GOAT is not called and the request is not billable. |
| 404 | Not Found | GOAT has no product for this id, slug or url. This response is not billable. |
| 503 | Upstream Unavailable | GOAT did not answer after several tries. Retry later. This response is not billable. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)
