# GOAT Product Scraper (`xtracto/goat-product-scraper`) Actor Look up GOAT sneakers by slug or URL and get the full product detail plus per-size availability and lowest ask. - **URL**: https://apify.com/xtracto/goat-product-scraper.md - **Developed by:** [Farhan Febrian Nauval](https://apify.com/xtracto) (community) - **Categories:** E-commerce, Lead generation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $20.00 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## GOAT Product Scraper Look up any sneaker on GOAT by its product slug or URL and get the full product detail — identity, retail price, images, release date — plus a complete per-size availability list with the lowest ask, instant-ship price, last sold price, and stock status for every size. ### Why use this actor - **Per-size availability** — every size comes through with its lowest ask, instant-ship price, last sold price, and whether it's in stock. - **Full product identity** — name, SKU, brand, colorway, designer, silhouette, release date, and retail price in one record. - **Lowest ask at a glance** — a single lowest-price summary plus the full size-by-size breakdown. - **Accepts slugs or URLs** — paste a `goat.com/sneakers/` link or just the slug. - **Per-country pricing** — pick a ship-to market (US, UK, Canada, Japan, and more) and get the sizes, stock, and lowest asks that actually apply there. - **No account, no API key** — works straight from public product pages. - **Stable JSON output** — same field names every run, ready for spreadsheets, databases, or pipelines. - **Automatic retries** — each product is retried with a fresh identity if a request is refused. ### How it works 1. You provide one or more GOAT product slugs or full `goat.com/sneakers/` URLs, and optionally a ship-to country. 2. The actor fetches each product and reads its full detail — name, SKU, brand, colorway, release date, retail price, and images. 3. It then pulls the per-size availability list for your chosen country — lowest ask, instant-ship price, last sold price, and stock status for each size. 4. Each product is saved as one `PRODUCT` record; products that can't be found return a record with an `error` field instead of being skipped. 5. Everything lands in your dataset, exportable as JSON, CSV, or Excel. You don't need to manage any browsers or scrapers. ### Input ```json { "slugs": [ "air-jordan-jordan-12-retro-bloodline-ct8013-003", "https://www.goat.com/sneakers/air-jordan-3-retro-bin23-io7744-600" ], "country": "US", "maxConcurrency": 4, "maxRequestRetries": 5, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"] } } ```` | Field | Type | Description | | --- | --- | --- | | `slugs` | array | **Required.** GOAT product slugs or full `goat.com/sneakers/` URLs (one per entry). | | `country` | string | Ship-to market for size availability and lowest asks. GOAT shows different in-stock sizes and lowest asks per market, so the same product can come back cheaper or with different stock in another country. One of `US`, `GB`, `CA`, `AU`, `DE`, `FR`, `JP`, `HK`. Default `US`. | | `maxConcurrency` | integer | Number of products fetched in parallel. Default `4`. | | `maxRequestRetries` | integer | Retries per product before giving up. Default `5`. | | `proxyConfiguration` | object | Apify Proxy or a custom proxy list. RESIDENTIAL recommended for consistent pricing and availability. | ### Output One `PRODUCT` record per slug. The `sizes` array is truncated below for readability: ```json { "recordType": "PRODUCT", "productTemplateId": 1686126, "country": "US", "slug": "air-jordan-jordan-12-retro-bloodline-ct8013-003", "name": "Air Jordan 12 Retro 'Bloodline'", "nickname": "Bloodline", "sku": "CT8013 003", "brand": "Air Jordan", "colorway": "Black", "designer": "Tinker Hatfield", "silhouette": "Air Jordan 12", "category": ["Lifestyle"], "productType": "sneakers", "gender": ["men"], "season": "2025", "status": "active", "releaseDate": "2026-05-23T23:59:59.999Z", "retailPriceCents": 21500, "lowestPriceCents": 18900, "minimumOfferCents": 2500, "maximumOfferCents": 200000, "currency": "USD", "sizeUnit": "us", "image": "https://image.goat.com/750/attachments/product_template_pictures/images/116/600/527/original/1686126_00.png.png", "gridImage": "https://image.goat.com/375/attachments/product_template_pictures/images/116/600/527/original/1686126_00.png.png", "url": "https://www.goat.com/sneakers/air-jordan-jordan-12-retro-bloodline-ct8013-003", "sizesCount": 34, "sizes": [ { "size": 7, "sizePresentation": "7", "shoeCondition": "new_no_defects", "boxCondition": "good_condition", "stockStatus": "single_in_stock", "lowestPriceCents": 23300, "instantShipLowestPriceCents": 25200, "lastSoldPriceCents": 23300, "currency": "USD" }, { "size": 8, "sizePresentation": "8", "shoeCondition": "new_no_defects", "boxCondition": "good_condition", "stockStatus": "single_in_stock", "lowestPriceCents": 19900, "instantShipLowestPriceCents": 21600, "lastSoldPriceCents": 23500, "currency": "USD" } ], "scrapedAt": "2026-06-10T11:03:22Z" } ``` If a slug can't be found, you get a diagnostic record instead of a silent skip: ```json { "recordType": "PRODUCT", "slug": "this-slug-does-not-exist-000000", "url": "https://www.goat.com/sneakers/this-slug-does-not-exist-000000", "error": "NOT_FOUND", "scrapedAt": "2026-06-10T11:05:00Z" } ``` | Field | Type | Description | | --- | --- | --- | | `recordType` | string | Always `"PRODUCT"`. | | `productTemplateId` | integer | GOAT's internal product id. | | `country` | string | Ship-to market the size availability and lowest asks reflect (echoes your `country` input). | | `slug` | string | Product slug. | | `name` | string | Product name. | | `nickname` | string | Short nickname when GOAT lists one. | | `sku` | string | Manufacturer style code. | | `brand` | string | Brand name. | | `colorway` | string | Primary color / colorway. | | `designer` | string | Designer credit when available. | | `silhouette` | string | Model silhouette (e.g. `Air Jordan 12`). | | `releaseDate` | string | Release date (ISO 8601). | | `retailPriceCents` | integer | Retail / release price, in cents. | | `lowestPriceCents` | integer | Lowest ask across all sizes, in cents. | | `minimumOfferCents` / `maximumOfferCents` | integer | Offer range GOAT accepts, in cents. | | `currency` | string | ISO currency of the prices. | | `image` / `gridImage` | string | Product image URLs. | | `url` | string | Full product URL. | | `sizesCount` | integer | Number of size entries returned. | | `sizes` | array | Per-size availability (see below). | | `error` | string | Present only on failure: `NOT_FOUND` or `BLOCKED_AFTER_RETRIES`. | | `scrapedAt` | string | ISO 8601 timestamp of collection. | Each entry in `sizes`: | Field | Type | Description | | --- | --- | --- | | `size` / `sizePresentation` | number / string | Size value and its display label. | | `shoeCondition` | string | e.g. `new_no_defects`. | | `boxCondition` | string | e.g. `good_condition`, `missing_lid`. | | `stockStatus` | string | e.g. `single_in_stock`, `not_in_stock`. | | `lowestPriceCents` | integer | Lowest ask for this size, in cents (`null` if none in stock). | | `instantShipLowestPriceCents` | integer | Lowest instant-ship ask for this size, in cents. | | `lastSoldPriceCents` | integer | Last sold price for this size, in cents. | | `currency` | string | ISO currency of the size's prices. | Note: prices are returned in cents. GOAT normalizes the amounts to USD while filtering the available sizes and lowest asks by the `country` market you pick, so changing `country` can return different in-stock sizes, stock status, and lowest asks for the same product. Run with a RESIDENTIAL proxy for consistent availability and pricing. ### Other GOAT Scrapers | Actor | Description | | --- | --- | | [GOAT Search Scraper](https://apify.com/goat-search-scraper) | Keyword and category search results with product tiles. | | [GOAT Product Scraper](https://apify.com/goat-product-scraper) | Full product detail with per-size availability and lowest ask. | # Actor input Schema ## `slugs` (type: `array`): GOAT product slugs or full goat.com/sneakers/ URLs to look up (one per array entry). ## `country` (type: `string`): Ship-to market for per-size availability and lowest asks. GOAT filters which sizes are in stock and their lowest ask by market, so the same product can show different sizes, stock status, and prices per country. Prices are returned in cents. ## `maxConcurrency` (type: `integer`): Maximum number of products fetched in parallel. ## `maxRequestRetries` (type: `integer`): How many times a product fetch is retried (rotating identity each time) before giving up. ## `proxyConfiguration` (type: `object`): Apify Proxy or your own proxy list. The RESIDENTIAL group is recommended for consistent US pricing and availability. ## Actor input object example ```json { "slugs": [ "air-jordan-jordan-12-retro-bloodline-ct8013-003" ], "country": "US", "maxConcurrency": 4, "maxRequestRetries": 5, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "slugs": [ "air-jordan-jordan-12-retro-bloodline-ct8013-003" ], "country": "US", "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }; // Run the Actor and wait for it to finish const run = await client.actor("xtracto/goat-product-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "slugs": ["air-jordan-jordan-12-retro-bloodline-ct8013-003"], "country": "US", "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], }, } # Run the Actor and wait for it to finish run = client.actor("xtracto/goat-product-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "slugs": [ "air-jordan-jordan-12-retro-bloodline-ct8013-003" ], "country": "US", "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }' | apify call xtracto/goat-product-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=xtracto/goat-product-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "GOAT Product Scraper", "description": "Look up GOAT sneakers by slug or URL and get the full product detail plus per-size availability and lowest ask.", "version": "1.0", "x-build-id": "ew40oHvUMvb8K5Wd6" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/xtracto~goat-product-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-xtracto-goat-product-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/xtracto~goat-product-scraper/runs": { "post": { "operationId": "runs-sync-xtracto-goat-product-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/xtracto~goat-product-scraper/run-sync": { "post": { "operationId": "run-sync-xtracto-goat-product-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "slugs" ], "properties": { "slugs": { "title": "Product slugs or URLs", "type": "array", "description": "GOAT product slugs or full goat.com/sneakers/ URLs to look up (one per array entry).", "items": { "type": "string" } }, "country": { "title": "Country market", "enum": [ "US", "GB", "CA", "AU", "DE", "FR", "JP", "HK" ], "type": "string", "description": "Ship-to market for per-size availability and lowest asks. GOAT filters which sizes are in stock and their lowest ask by market, so the same product can show different sizes, stock status, and prices per country. Prices are returned in cents.", "default": "US" }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 20, "type": "integer", "description": "Maximum number of products fetched in parallel.", "default": 4 }, "maxRequestRetries": { "title": "Max retries", "minimum": 1, "maximum": 15, "type": "integer", "description": "How many times a product fetch is retried (rotating identity each time) before giving up.", "default": 5 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify Proxy or your own proxy list. The RESIDENTIAL group is recommended for consistent US pricing and availability." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```