Metadata availability and contents may vary depending on the product type. At the moment several types of metadata may be available:
Generic objects:
Electric products metadata may contain these fields:
Name | Description | Count |
---|---|---|
electric.voltage |
Product voltage (in volts), an Amount object.
|
28 300 (0% of products) |
An example of electric product metadata:
{
// ...
"product": {
"metadata": {
"electric": {
"voltage": {
"equals": {
"value": 1.5,
"unit": "volts"
}
}
}
}
}
}
External ids metadata may contain these fields:
Name | Description | Count |
---|---|---|
externalIds.amazonAsin | Amazon Standard Identification Number, string. | 1 271 133 (2% of products) |
An example of external ids metadata:
{
// ...
"product": {
"metadata": {
"externalIds": {
"amazonAsin": "AMAZONASIN"
}
}
}
}
Generic metadata may contain these fields:
Name | Description | Count |
---|---|---|
generic.ageGroups |
A list of strings, representing the age groups that the product is targeted for.
Possible values: infant (0-1 years), toddler (1-3),
child (3-12), teen (12-18), adult (18-60),
senior (60+).
|
3 257 (0% of products) |
generic.colors | Product color, an array of objects. See Product colors for the list of supported values and an example. | 8 470 888 (13% of products) |
generic.contributors | Product contributors (book authors, musicCD performers, etc.), a list of objects. Each contributor object has following attributes:
|
10 894 901 (17% of products) |
generic.dimensions |
Product and packaging dimensions information, an object:
|
7 269 998 (11% of products) |
generic.ingredients | Product ingredients or materials. See Product ingredients for detailed information. | 5 904 017 (9% of products) |
generic.manufacturerCode | Manufacturer product code, string. | 12 315 887 (19% of products) |
generic.power |
Product power (in watts), an Amount object.
|
7 311 (0% of products) |
generic.volume |
Product volume information, an Amount object:
|
390 610 (1% 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 702 100 (6% of products) |
An example of generic metadata:
{
// ...
"product": {
"metadata": {
"generic": {
"manufacturerCode": "PRODUCT-CODE-123",
"colors": ["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 172 492 (50% of food products) |
food.nutriScore |
Product Nutri-Score, an object:
|
783 686 (33% 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 189 241 (71% of print books) |
printBook.bisacCodes | BISAC codes of a print book, list of strings. | 1 241 869 (12% of print books) |
printBook.bindingType | Book binding type, one of strings: hardcover , paperback . |
8 272 904 (82% of print books) |
An example of print book metadata:
{
// ...
"product": {
"metadata": {
"printBook": {
"numPages": 123,
"bisacCodes": ["FIC027110"],
"bindingType": "paperback"
}
}
}
}
Media products metadata, relevant for digital or physical books, newspapers, magazines, music and sound recordings. May contain following fields:
Name | Description | Count |
---|---|---|
media.publicationYear | Media product publication or release year, integer. In case of re-issues that use the same barcode, this is the year of the first publication. For on-demand publications, this is the year of the original publication. | 11 503 713 (79% of media products) |
An example of media metadata:
{
// ...
"product": {
"metadata": {
"media": {
"publicationYear": 1990
}
}
}
}
Music CD metadata may contain these fields:
Name | Description | Count |
---|---|---|
musicCD.numberOfDiscs | Number of discs, integer. | 351 120 (25% of music CDs) |
An example of music CD metadata:
{
// ...
"product": {
"metadata": {
"musicCD": {
"numberOfDiscs": 1
}
}
}
}
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"
}
}