GOAT Product API Documentation 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.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
This endpoint has no required query parameters.
4 optional filters available.
string
Optional
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.
https://example.com/product
string
Optional
The product slug from a search result. Send one of url, slug or id.
example
integer
Optional
The numeric product id from a search result. Send one of url, slug or id.
1234567890
string
Optional
us (default), uk, ca, au, de, jp or fr. Sets the country for the size prices. Size prices are always in US dollars.
US
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"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
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
A parameter is missing or invalid. GOAT is not called and the request is not billable.
{
"errors": {
"query": [
"A query is required unless you set a brand or category, for example jordan 4."
]
},
"message": "The request validation failed"
}Not Found
GOAT has no product for this id, slug or url. This response is not billable.
{
"meta": {
"billable": false,
"retryable": false,
"endpoint_family": "product"
},
"error": {
"code": "NOT_FOUND",
"message": "The requested GOAT product was not found."
},
"success": false
}Upstream Unavailable
GOAT did not answer after several tries. Retry later. This response is not billable.
{
"meta": {
"billable": false,
"retryable": true,
"endpoint_family": "product"
},
"error": {
"code": "UPSTREAM_UNAVAILABLE",
"message": "The GOAT API is temporarily unavailable. Please retry."
},
"success": false
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.