Product
Learn the common fields for product PDP endpoints and example domains.
Product PDP Cache agents extract structured data from e-commerce product detail pages, including product info, price, media, description, specifications, variants, seller, ratings, shipping, and warranty.
Description
Product agents return normalized fields for physical and digital products: product info (name, brand, category, condition, breadcrumbs), SKU/MPN/GTIN, price and discounts, wholesale tiers, stock status, media, description (full text, HTML, key features), specifications, variants (with price and stock), seller info, rating summary and distribution, shipping info, and warranty/returns.
Common Fields
| Field | Type | Description |
|---|---|---|
product_info | object | name, brand, category, condition, breadcrumbs (array of { url, name }) |
sku | string | Stock Keeping Unit identifier |
mpn | string | Manufacturer Part Number |
gtin | array | Global Trade Item Numbers. Each item: type (e.g. isbn13, ean13, upc), value (number) |
price | object | currency, current_price, is_flash_sale, original_price, currency_symbol, discount_percentage |
wholesale_tiers | array | Objects: min_qty, price_per_unit |
stock_status | object | status (e.g. in_stock, out_of_stock, pre_order), quantity |
media | array | Objects: url, type (image/video), is_thumbnail |
description | object | full_text, html_content, key_features (array of strings) |
specifications | array | Objects: name, value |
variants | array | Objects: mpn, sku, url, gtin, name, media, price, option (array of strings), product_url, stock_status, additionalProperties |
seller | object | id, name, type, badges, rating, location, sold_count, product_count |
rating_summary | object | sold_count, rating_count, review_count, average_rating |
rating_distribution | object | 1, 2, 3, 4, 5 — each with count and percentage |
shipping_info | object | weight, dimensions, free_shipping, fulfillment_type |
warranty_and_returns | object | has_warranty, warranty_type, warranty_period, return_policy_text |
Example Domains / URLs
Product PDP agents are typically available for major e-commerce and marketplace domains, for example:
- Amazon — e.g.
https://www.amazon.com/dp/...,https://www.amazon.co.uk/dp/... - Walmart — e.g.
https://www.walmart.com/ip/... - eBay — e.g.
https://www.ebay.com/itm/... - Tokopedia — e.g.
https://www.tokopedia.com/... - Shopee — e.g.
https://shopee.co.id/... - Lazada — e.g.
https://www.lazada.com/... - AliExpress — e.g.
https://www.aliexpress.com/item/...
Check the Marketplace for the full list of supported product domains.