Docs

Product endpoint

Extract full product data for a single product page - dozens of structured fields including price, variations, seller offers, images, category ladder.

`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.

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

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.
`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)

{
  "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)

Endpoint reference - the resource model this endpoint is one example of
Search endpoint - the list pattern
Universal Web Scraper API - for sites without a dedicated endpoint
Async batch endpoint
Country + content language guide
Billing policy - only-2xx billing

GET /api/v1/{site}/product