Get product 📘
Get all information about a product:
- descriptions in multiple languages - name / long description / short description
- picture URLs - main picture + additional pictures
- documents in multiple languages - technical sheet, manuals, CE certificates...
- property values - as defined by segment data model
- variants - child products which are variants of the parent product
- SKUs - logistic references for products
- relations with other products - symmetrical and asymmetrical, and potentially from other segments
Path parameters
-
The segment key, as returned by list segments endpoint.
Values are
hand-protection
,foot-protection
,head-protection
,eye-protection
,body-protection
,ear-protection
,fall-protection
,respiratory-protection
,ergonomy
,safety-first-aid
,hygiene
,lockout-tagout
,electrical
,lightening
,safety-signs
, orsurface-cleaning
. -
The unique product id, as returned by list products endpoint.
Query parameters
-
with_sku_details boolean
Set to "1" to request all detailed SKU information, otherwise only SKU codes will be provided. SKU data model can be requested on the Fetch segment data model endpoint with "sku" as segment key.
-
with_asset_details boolean
Set to "1" to request more detailed information about assets (name, source url, multiple assets...)
GET /products/{segment_key}/{product_id}
curl \
-X GET https://api.ppe-analytics.com/api/v1/products/surface-cleaning/cbdeacabd0128cb641b64d0c0f590332 \
-H "PPEApiKey: $API_KEY"
Response examples (200)
{
"status": "OK",
"result": {
"product": {
"id": "f50938a24830edb8b1c2ecc3f7dd88a3",
"name": "Apo-low 1027",
"skus": [
{
"code": "APO1027-123",
"label": "APO-LOW 1027 polybag",
"values": [
{
"basic-unit-kind": "bg",
"basic-packaging-ean": 283762387623,
"basic-packaging-gross-weight": 540
}
]
},
{
"code": "APO1027-456",
"label": "APO-LOW 1027 single",
"values": [
{
"basic-unit-kind": "ea",
"basic-packaging-ean": 283762387624,
"basic-packaging-gross-weight": 122
}
]
},
{
"code": "APO1027-777",
"label": "APO-LOW 1027 FOR EXPORT",
"values": [
{
"basic-unit-kind": "bx",
"basic-packaging-ean": 283762387625,
"basic-packaging-gross-weight": 1250
}
]
}
],
"level": "parent",
"tiles": {
"en374-letters": {
"title": {
"en": "EN344 Letters",
"fr": "Lettres En344"
},
"content": {
"en": "B + some details",
"fr": "B + des détails"
},
"pictures": {
"square-80px": "https://static.ppe-analytics.com/pictograms/public/d5/b2/d5b2f59e-9129-40c2-a9ea-1478c1431bcf/d5b2f59e-9129-40c2-a9ea-1478c1431bcf-80.png",
"square-300px": "https://static.ppe-analytics.com/pictograms/public/d5/b2/d5b2f59e-9129-40c2-a9ea-1478c1431bcf/d5b2f59e-9129-40c2-a9ea-1478c1431bcf-300.png"
}
},
"mycorp/advantages": {
"title": {
"en": "Advantages",
"fr": "Avantages"
},
"content": {
"en": "Cheap / green / robust",
"fr": "Pas cher / écolo / robuste"
}
}
},
"assets": {
"technical-sheet": [
{
"url": "https://spontex.ppe-analytics.com/en/product/f50938a24830edb8b1c2ecc3f7dd88a3/pdf/dcue-certificate",
"name": "Apo-low 1027 Technical sheet EN",
"languages": [
"en"
],
"asset_uuid": "0bb230c2-2753-473c-b298-88fab2bc7001"
},
{
"url": "https://spontex.ppe-analytics.com/fr/product/f50938a24830edb8b1c2ecc3f7dd88a3/pdf/dcue-certificate",
"name": "Apo-low 1027 Technical sheet FR",
"languages": [
"fr"
],
"asset_uuid": "0bb230c2-2753-473c-b298-88fab2bc7002"
}
],
"instructions-for-use": [
{
"url": "https://assets.ppe-analytics.com/mapa/ab/b2/abb230c2-2753-473c-b298-88fab2bc7c8c/abb230c2-2753-473c-b298-88fab2bc7c8c-0.pdf",
"name": "Notice chemical range",
"languages": [
"en",
"fr"
],
"asset_uuid": "abb230c2-2753-473c-b298-88fab2bc7c8c"
}
]
},
"values": {
"has-latex": true,
"main-color": [
"blue"
],
"en388-digits": "4343X"
},
"pictures": [
{
"hd": "https://assets.ppe-analytics.com/mapa/9e/15/9e158040-272e-4f6a-8da5-1bed82f8ca80/9e158040-272e-4f6a-8da5-1bed82f8ca80-0-hd.jpg",
"types": [
"product-picture"
],
"original": "https://assets.ppe-analytics.com/mapa/9e/15/9e158040-272e-4f6a-8da5-1bed82f8ca80/9e158040-272e-4f6a-8da5-1bed82f8ca80-0.jpg",
"asset_uuid": "9e158040-272e-4f6a-8da5-1bed82f8ca80-0.jpg",
"square-80px": "https://assets.ppe-analytics.com/mapa/9e/15/9e158040-272e-4f6a-8da5-1bed82f8ca80/9e158040-272e-4f6a-8da5-1bed82f8ca80-0-80.jpg",
"square-300px": "https://assets.ppe-analytics.com/mapa/9e/15/9e158040-272e-4f6a-8da5-1bed82f8ca80/9e158040-272e-4f6a-8da5-1bed82f8ca80-0-300.jpg",
"square-800px": "https://assets.ppe-analytics.com/mapa/9e/15/9e158040-272e-4f6a-8da5-1bed82f8ca80/9e158040-272e-4f6a-8da5-1bed82f8ca80-0-800.jpg",
"is_main_picture": true
},
{
"hd": "https://assets.ppe-analytics.com/mapa/6c/b6/6cb60165-78ab-4bd7-8ac7-2afc3a5c952d/6cb60165-78ab-4bd7-8ac7-2afc3a5c952d-0-hd.png",
"types": [
"360-picture"
],
"original": "https://assets.ppe-analytics.com/mapa/6c/b6/6cb60165-78ab-4bd7-8ac7-2afc3a5c952d/6cb60165-78ab-4bd7-8ac7-2afc3a5c952d-0.png",
"asset_uuid": "6cb60165-78ab-4bd7-8ac7-2afc3a5c952d-0.png",
"square-80px": "https://assets.ppe-analytics.com/mapa/6c/b6/6cb60165-78ab-4bd7-8ac7-2afc3a5c952d/6cb60165-78ab-4bd7-8ac7-2afc3a5c952d-0-80.png",
"square-300px": "https://assets.ppe-analytics.com/mapa/6c/b6/6cb60165-78ab-4bd7-8ac7-2afc3a5c952d/6cb60165-78ab-4bd7-8ac7-2afc3a5c952d-0-300.png",
"square-800px": "https://assets.ppe-analytics.com/mapa/6c/b6/6cb60165-78ab-4bd7-8ac7-2afc3a5c952d/6cb60165-78ab-4bd7-8ac7-2afc3a5c952d-0-800.png"
}
],
"variants": [
{
"code": "1027-BG",
"rank": 0,
"label": "Apo-low 1027 BLUEGREEN",
"values": {
"color": [
"blue",
"green"
]
},
"product_id": "f60938a24830edb8b1c2ecc3f7dd88a4",
"segment_key": "ear-protection",
"last_modified": "2023-12-24 17:14:46 +0200",
"api_get_product": "/api/v1/products/ear-protection/f60938a24830edb8b1c2ecc3f7dd88a4",
"main_picture_url": "https://app.ppe-analytics.com/static/pictures/300/surface-cleaning/f50938a24830edb8b1c2ecc3f7dd88a3.jpg"
},
{
"code": "1027-BB",
"rank": 1,
"label": "Apo-low 1027 BLUEBLACK",
"values": {
"color": [
"blue",
"black"
]
},
"product_id": "f70938a24830edb8b1c2ecc3f7dd88a5",
"segment_key": "ear-protection",
"last_modified": "2024-01-09 12:55:02 +0200",
"api_get_product": "/api/v1/products/ear-protection/f70938a24830edb8b1c2ecc3f7dd88a5",
"main_picture_url": "https://app.ppe-analytics.com/static/pictures/300/surface-cleaning/f50938a24830edb8b1c2ecc3f7dd88a3.jpg"
}
],
"countries": [
"it",
"fr",
"gb",
"ml"
],
"documents": {
"technical-sheet": {
"en": "https://spontex.ppe-analytics.com/en/product/f50938a24830edb8b1c2ecc3f7dd88a3/pdf/technical-sheet",
"fr": "https://spontex.ppe-analytics.com/fr/product/f50938a24830edb8b1c2ecc3f7dd88a3/pdf/technical-sheet"
},
"instructions-for-use": {
"en": "https://assets.ppe-analytics.com/mapa/ab/b2/abb230c2-2753-473c-b298-88fab2bc7c8c/abb230c2-2753-473c-b298-88fab2bc7c8c-0.pdf",
"fr": "https://assets.ppe-analytics.com/mapa/ab/b2/abb230c2-2753-473c-b298-88fab2bc7c8c/abb230c2-2753-473c-b298-88fab2bc7c8c-0.pdf"
}
},
"relations": [
{
"key": "is_part_of_kit",
"type": "asymmetrical",
"products": [
{
"code": "CLEAN-KIT",
"label": "Kit nettoyage",
"product_id": "f70938a24830edb8b1c2ecc3f7dd88a5",
"segment_key": "surface-cleaning",
"manufacturer": "spontex",
"api_get_product": "/api/v1/products/ear-protection/f70938a24830edb8b1c2ecc3f7dd88a5",
"main_picture_url": "https://app.ppe-analytics.com/static/pictures/300/surface-cleaning/f50938a24830edb8b1c2ecc3f7dd88a3.jpg"
}
]
},
{
"key": "can_replace",
"type": "asymmetrical",
"products": [
{
"code": "APOLI",
"label": "Apo li light",
"product_id": "f70938a24830edb8b1c2ecc3f7dd88a5",
"segment_key": "surface-cleaning",
"manufacturer": "spontex",
"api_get_product": "/api/v1/products/ear-protection/f70938a24830edb8b1c2ecc3f7dd88a5",
"main_picture_url": "https://app.ppe-analytics.com/static/pictures/300/surface-cleaning/f50938a24830edb8b1c2ecc3f7dd88a3.jpg"
},
{
"code": "APOLOGIC",
"label": "Apo logic",
"product_id": "f70938a24830edb8b1c2ecc3f7dd88a5",
"segment_key": "surface-cleaning",
"manufacturer": "spontex",
"api_get_product": "/api/v1/products/ear-protection/f70938a24830edb8b1c2ecc3f7dd88a5",
"main_picture_url": "https://app.ppe-analytics.com/static/pictures/300/surface-cleaning/f50938a24830edb8b1c2ecc3f7dd88a3.jpg"
}
]
},
{
"key": "associated",
"type": "symmetrical",
"products": [
{
"code": "9872323-LUN",
"label": "Lunettes anti projections",
"product_id": "f70938a24830edb8b1c2ecc3f7dd88a5",
"segment_key": "eye-protection",
"manufacturer": "uvex",
"api_get_product": "/api/v1/products/ear-protection/f70938a24830edb8b1c2ecc3f7dd88a5",
"main_picture_url": "https://app.ppe-analytics.com/static/pictures/300/surface-cleaning/f50938a24830edb8b1c2ecc3f7dd88a3.jpg"
}
]
}
],
"segment_key": "surface-cleaning",
"descriptions": {
"name": {
"en": "Apo-low 1027",
"fr": "Apo-bas 1027"
},
"description": {
"en": "This product is truly awesome and made for you",
"fr": "Ce produit est vraiment incroyable et pensé pour vous"
},
"short_description": {
"en": "You deserve the best",
"fr": "La meilleure qualité pour vous"
}
},
"manufacturer": "spontex",
"main_picture_url": "https://app.ppe-analytics.com/static/pictures/300/surface-cleaning/f50938a24830edb8b1c2ecc3f7dd88a3.jpg",
"product_page_urls": {
"en": "https://website.uk/product-64654",
"fr": "https://website.fr/produit-64654"
}
},
"languages": [
"en",
"fr"
]
}
}
Response examples (404)
{
"status": "ERROR",
"message": "Unknown product id 'abcdef-1234'"
}
Response examples (403)
{
"status": "ERROR",
"message": "Unauthorized access to product 'secret-agent/007'"
}
Response examples (419)
{
"status": "ERROR",
"message": "Rate limit exceeded on this endpoint. Please slow down your calls a little"
}