--- title: Product endpoint description: Extract full product data for a single product page - dozens of structured fields including price, variations, seller offers, images, category ladder. order: 10 --- # `GET /api/v1/{site}/product` Returns structured data for a single product page on any supported e-commerce site. `product` is one resource type out of many: the same request and response shape covers the other dedicated specific-item endpoints (`article`, `job`, `listing`, `profile`, `property`, `video`, and more). Every endpoint follows the same `/api/v1/{site}/{resource}?api_key=YOUR_KEY&query=...` shape, so the patterns here carry over to the rest of the [453-endpoint catalogue](/scraper-api). This page is the canonical **specific-item pattern**: one identifier in, one rich JSON object out. The example below uses `walmart` as the site; swap it for any other supported store (`ebay`, `target`, `bestbuy`, `etsy`, and many more). ## Request ```http GET /api/v1/walmart/product?query=5085206428&api_key=cd_live_YOUR_KEY ``` ### Query parameters | Param | Type | Required | Default | Description | |---|---|---|---|---| | `query` | string | ✅ yes | - | The product identifier or full product URL for the chosen site | | `domain` | enum | - | site default | Regional storefront for sites that have one (e.g. `com`, `co.uk`, `de`). Supported values vary by site. | | `language` | string | - | region default | Content language as `xx_YY` (e.g. `en_US`, `de_DE`, `es_ES`). See [supported languages per region](/docs/guides/country-and-language). | | `add_html` | boolean | - | `false` | Attach the raw HTML of the page under `html` in the response | | `render_js` | boolean | - | - | Coming soon - returns 501 today | | `screenshot` | boolean | - | - | Coming soon - returns 501 today | ### Response (200) ```json { "id": "5085206428", "id_in_url": "5085206428", "parent_id": null, "url": "https://www.walmart.com/ip/5085206428", "page": 1, "page_type": "Product", "title": "LEGEND COOKWARE 5-Ply Stainless Steel Cookware Set", "product_name": "LEGEND COOKWARE 5-Ply Stainless Steel Cookware Set", "description": "Premium 5-ply construction distributes heat evenly …", "bullet_points": "5-PLY STAINLESS STEEL COOKWARE HEATS EVENLY\\n…", "brand": "LEGEND COOKWARE", "manufacturer": "LEGEND COOKWARE", "store_url": "https://www.walmart.com/seller/LEGEND+COOKWARE", "price": 299.99, "price_main": 299.99, "price_strikethrough": 399.99, "currency": "USD", "pricing_count": 3, "stock": "In Stock", "max_quantity": 10, "delivery": [ { "date": { "by": "Tuesday, April 25" }, "type": "FREE Delivery" } ], "featured_merchant": { "name": "LEGEND COOKWARE Store", "seller_id": "A1EXAMPLE", "is_fulfilled_by_site": true }, "offers": [ { "price": 299.99, "seller_name": "LEGEND COOKWARE Store", "seller_id": "A1EXAMPLE", "stock": "In Stock", "returns": "Free returns within 30 days" } ], "category": [ { "ladder": [ { "name": "Home & Kitchen", "url": "…" }, { "name": "Kitchen & Dining", "url": "…" }, { "name": "Cookware", "url": "…" } ]} ], "rating": 4.7, "reviews_count": 2481, "rating_stars_distribution": [ { "rating": 5, "percentage": 72 }, { "rating": 4, "percentage": 18 }, { "rating": 3, "percentage": 6 }, { "rating": 2, "percentage": 2 }, { "rating": 1, "percentage": 2 } ], "reviews": [ { "id": "R1…", "author": "J. Smith", "title": "Excellent build quality", "content": "These pans heat evenly and clean up beautifully.", "rating": 5, "timestamp": "Reviewed in the United States on April 12, 2026", "is_verified": true, "helpful_count": 12 } /* ~8 more */ ], "answered_questions_count": 23, "variations": [ { "id": "5085206428", "dimensions": { "color": "Silver", "size": "10 pc" }, "selected": true }, { "id": "5085206429", "dimensions": { "color": "Copper", "size": "10 pc" }, "selected": false } ], "images": [ "https://cdn.example.com/images/cookware-set-71…", "https://cdn.example.com/images/cookware-set-81…" ], "has_videos": true, "product_details": { "Brand": "LEGEND COOKWARE", "Material": "Stainless Steel" }, "product_dimensions": "17.1 x 13.1 x 12.6 inches", "sales_rank": [ { "ladder": [{ "name": "Home & Kitchen", "url": "…" }], "rank": 342 } ] } ``` ### Response headers - `Asa-Cost` - credits spent on this request (`5` for a standard product scrape, `0` for any non-2xx response) - `Asa-Resolved-Url` - the final target URL after any redirects - `Asa-Source-Status` - the target site's raw HTTP status (may differ from our HTTP status) - `Asa-Attempts` - how many internal attempts it took us to get this result - `Asa-Extractor-Version` - e.g. `walmart@1.0.0` ## Errors | HTTP | Body | Reason | |---|---|---| | 400 | `{"error":"invalid_params"}` | Query identifier malformed, or `domain` not valid for this site | | 401 | `{"error":"unauthorized"}` | Missing / bad API key | | 429 | `{"error":"rate_limited"}` | Too many requests from your key | | 501 | `{"error":"not_implemented","params":["render_js"]}` | You passed a roadmap param | | 404 | `{"error":"product_not_found","retryable":false}` | The target site returned 404 for the item: delisted, malformed, or never existed in this region. No retry will help. | | 502 | `{"error":"target_unreachable"}` | The target site blocked every internal retry we made (transient anti-bot pressure on hot items) | | 502 | `{"error":"extraction_failed"}` | The target site served something we couldn't parse | | 502 | `{"error":"id_mismatch"}` | The requested item redirected to a different product | | 502 | `{"error":"generic_gallery_page"}` | The target served a placeholder gallery on a 200 response (different from the 404 case above; same outcome: drop the item) | ## Related - [Endpoint reference](/docs/endpoint-reference) - the resource model this endpoint is one example of - [Search endpoint](/docs/endpoints/search) - the list pattern - [Universal Web Scraper API](/docs/endpoints/universal) - for sites without a dedicated endpoint - [Async batch endpoint](/docs/endpoints/batch) - [Country + content language guide](/docs/guides/country-and-language) - [Billing policy - only-2xx billing](/docs/guides/billing)