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 211 (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 586 290 (9% of products) |
| generic.contributors | Product contributors (book authors, musicCD performers, etc.), a list of objects. Each contributor object has following attributes:
|
10 939 395 (17% 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 688 230 (6% of products) |
| generic.volume |
Product volume information, an Amount object: |
330 364 (1% of products) |
| generic.dimensions |
Product and packaging dimensions information, an object: |
7 337 593 (12% of products) |
| generic.manufacturerCode | Manufacturer product code, string. | 12 370 974 (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 255 (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 175 490 (51% of food products) |
| food.nutriScore |
Product Nutri-Score, an object:
|
787 124 (34% 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 197 633 (71% of print books) |
| printBook.bisacCodes | BISAC codes of a print book, list of strings. | 1 243 592 (12% of print books) |
| printBook.bindingType | Book binding type, one of strings: hardcover, paperback. |
8 303 472 (82% of print books) |
An example of print book metadata:
{
// ...
"product": {
"metadata": {
"printBook": {
"numPages": 123,
"bisacCodes": ["FIC027110"],
"bindingType": "paperback"
}
}
}
}Music CD metadata may contain these fields:
| Name | Description | Count |
|---|---|---|
| musicCD.numberOfDiscs | Number of discs, integer. | 359 001 (25% of music CDs) |
An example of music CD metadata:
{
// ...
"product": {
"metadata": {
"musicCD": {
"numberOfDiscs": 1
}
}
}
}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 559 934 (78% of media products) |
An example of media metadata:
{
// ...
"product": {
"metadata": {
"media": {
"publicationYear": 1990
}
}
}
}Electric products metadata may contain these fields:
| Name | Description | Count |
|---|---|---|
| electric.voltage |
Product voltage, an Amount object.
|
21 023 (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"
}
}