Metadata availability and contents may vary depending on the product type. At the moment several types of metadata may be available:
Generic objects:
External ids metadata may contain these fields:
| Name | Description | Count |
|---|---|---|
| externalIds.amazonAsin | Amazon Standard Identification Number, string. | 1 279 309 (2% of products) |
An example of external ids metadata:
{
// ...
"product": {
"metadata": {
"externalIds": {
"amazonAsin": "AMAZONASIN"
}
}
}
}Generic metadata may contain these fields:
| Name | Description | Count |
|---|---|---|
| generic.ingredients | Product ingredients or materials. See Product ingredients for detailed information. | 5 585 859 (9% of products) |
| generic.contributors | Product contributors (book authors, musicCD performers, etc.), a list of objects. Each contributor object has following attributes:
|
10 940 545 (18% of products) |
| generic.weight |
Product weight information, a mapping of net (for net weight), gross (for gross weight) or unknown (when we lack information whether it's net or gross weight) to an Amount object: |
3 572 771 (6% of products) |
| generic.volume |
Product volume information, an Amount object: |
248 762 (0% of products) |
| generic.dimensions |
Product and packaging dimensions information, an object: |
7 338 063 (12% of products) |
| generic.manufacturerCode | Manufacturer product code, string. | 12 366 307 (20% of products) |
| generic.color | Product color, one of strings: beige, black, blue, bronze, brown, chrome, dark_blue, gold, gray, green, ivory, khaki, light_blue, magenta_fuchsia, multi, orange, pink, purple, red, silver, transparent, white, yellow. |
7 865 720 (13% of products) |
An example of generic metadata:
{
// ...
"product": {
"metadata": {
"generic": {
"manufacturerCode": "PRODUCT-CODE-123",
"color": "white",
"contributors": [
{
"names": {
"en": "John Smith"
},
"type": "author"
}
]
}
}
}
}Food metadata may contain these fields:
| Name | Description | Count |
|---|---|---|
| food.nutrimentsPer100Grams | Food nutriments information. See Food nutriments for detailed information. | 1 169 638 (52% of food products) |
| food.nutriScore |
Product Nutri-Score, an object:
|
785 373 (35% of food products) |
An example of food metadata:
{
// ...
"product": {
"metadata": {
"food": {
"nutrimentsPer100Grams": {
"fat": {
"equals": {
"value": 1.0,
"unit": "grams"
}
},
"proteins": {
"equals": {
"value": 12.0,
"unit": "grams"
}
},
"energy": {
"equals": {
"value": 654,
"unit": "kcal"
}
},
},
"nutriScore": {
"score": 1,
"grade": "B"
}
}
}
}
}Print book metadata may contain these fields:
| Name | Description | Count |
|---|---|---|
| printBook.numPages | Number of pages in print book, integer. | 7 195 726 (71% of print books) |
| printBook.publishedYear | Book publication year, integer. In case of reprints or on-demand publications, this is the year of the original publication. | 8 296 442 (82% of print books) |
| printBook.bisacCodes | BISAC codes of a print book, list of strings. | 1 243 593 (12% of print books) |
| printBook.bindingType | Book binding type, one of strings: hardcover, paperback. |
8 303 531 (82% of print books) |
An example of print book metadata:
{
// ...
"product": {
"metadata": {
"printBook": {
"numPages": 123,
"publishedYear": 2021,
"bisacCodes": ["FIC027110"],
"bindingType": "paperback"
}
}
}
}Music CD metadata may contain these fields:
| Name | Description | Count |
|---|---|---|
| musicCD.releasedYear | Year of first music CD release, integer. | 1 371 179 (96% of music CDs) |
| musicCD.numberOfDiscs | Number of discs, integer. | 360 406 (25% of music CDs) |
An example of music CD metadata:
{
// ...
"product": {
"metadata": {
"musicCD": {
"releasedYear": 1990,
"numberOfDiscs": 1
}
}
}
}Electric products metadata may contain these fields:
| Name | Description | Count |
|---|---|---|
| electric.voltage |
Product voltage, an Amount object.
|
3 134 (0% of products) |
An example of electric product metadata:
{
// ...
"product": {
"metadata": {
"electric": {
"voltage": {
"equals": {
"value": 1.5,
"unit": "volts"
}
}
}
}
}
}
Amount represents various amounts in metadata properties.
It is a mapping of one or several measures (currently supported: equals,
lessThan, greaterThan) to value objects. Each value object consists of
value field that holds the numeric amount and unit field, containing the unit in
which this amount is represented.
// Precise amount example
{
"equals": {
"value": 12.5,
"unit": "ml"
}
}
// Amount range example
{
"greaterThan": {
"value": 10,
"unit": "mg"
},
"lessThan": {
"value": 20,
"unit": "mg"
}
}