zyte logo

DaaS Standard Product Schema

The below schema describes and defines the standard fields we attempt to retrieve from webpages, where present, for each record type as part of the Zyte data-as-a-service offering

FieldsSub-fieldsExampleStandardsDescription
urlhttps://example.com/product22Type: string.
If possible, it should have canonical form.
Required attribute.
The main URL of the product page.
nameWhite two-door refrigeratorType: string.
Format: trimmed.
Required attribute.
The name of the product, as appears on the page.
price11999.99Type: string.
The value should not be equal nor lower than regularPrice.
Format:
- no thousands separator
- full stop as decimal separator
The price at which the product is being offered.
regularPrice9999.99Type: string.
The value should not be equal nor higher than price.
Format:
- no thousands separator
- full stop as decimal separator
The price at which the product was being offered and which is presented as a reference to the current price. It may be represented by original price, list price or maximum retail price for which the product is sold. This field is only returned if it is explicitly mentioned in the offer or the product page.
currencyUSDType: string.
ISO 4217 standard.
Currency associated with the price.
availabilityInStockType: string.
Takes one of the values: InStock, OutOfStock.
Availibility status for the product.
skuA123DK9823Type: string.The Stock Keeping Unit (SKU) i.e. a merchant-specific identifier for the product.
mpnHSC0424PPType: string.The Manufacturer Part Number (MPN) of the product. The product would have the same MPN across different e-commerce websites.
gtin{
"type": "ean13",
"value": "978-3-16-148410-0"
}
Type: dictionary.Standardized GTIN product identifier which is unique for a product across different sellers.
typeean13Type: string.
Takes one of the values: ean13, gtin8, gtin14, isbn10, isbn13, ismn, issn, upc.
Type of product identifier.
value978-3-16-148410-0Type: string.
brand{"name": "Samsung"}Type: dictionary.Details of the brand associated with the product.
nameSamsungType: string.The name of the brand.
breadcrumbs[{
"name": "Level 1",
"link": "http://example.com/level1"
},
{
"name": "Level 2",
"link": "http://example.com/level1/level2"
}]
Type: array of dictionaries.A list of breadcrumbs with optional name and URL.
nameLevel 1Type: string.Breadcrumb name or category name.
linkhttp://example.com/level1Type: string.Breadcrumb link.
images[
{"url": "http://example.com/image1.png"},
{"url": "http://example.com/image2.png"}
]
Type: array of dictionaries.
Should include the mainImage.
A list of URL or data URL values of all images of the product.
urlhttp://example.com/image1.pngType: string.
descriptionMoisture-Full Freshness all over the fridge
Deliciously tasty, odor free frozen food
5 Conversion Modes on demand
Twin Cooling Plus™
Type: string.
Format:
- trimmed (no whitespace at the beginning or the end of the description string),
- line breaks included,
- no length limit,
- no normalization of Unicode characters.
Full description of the product.
aggregateRating{
"ratingValue": 4.5,
"bestRating": 5.0,
"reviewCount": 31
}
Type: dictionary.The overall rating, based on a collection of reviews or ratings.
ratingValue4.5Type: float.
The value should not be higher than bestRating.
The rating for the content.
bestRating5.0Type: float.
The value should not be lower than ratingValue.
The highest value allowed in this rating system.
reviewCount31Type: int.The total number of reviews.
colorwhiteType: string.The color of the product.
sizeXLType: string.Denotes the size of the product. Pertinent to products such as garments, shoes, accessories etc.
stylepolka dotsType: string.Denotes the style of the product. Pertinent to products such as garments, shoes, accessories etc.
hasVariantstrueType: boolean.Indicates if product variants are available.
weight1020 gType: string.
Should include unit of measure.
The weight of the product, including the unit of measure.
features[
"Easily store and access 2TB.",
"Designed to work with WIndows."
]
Type: array of strings.List of product features, usually listed as bullet points.