Deck API

Get product 📘

GET /products/{segment_key}/{product_id}

Api key

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

segment_key string Required

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, or surface-cleaning.
product_id string Required

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...)

Responses

• 200 application/json

Successfully returned product information
Hide response attributes Show response attributes object
- status string
- result object
  
  Hide result attributes Show result attributes
  
  languages array[string]
  
  Available languages depend on your corporation settings
  
  Value is en fr it es de hu ja be pt es fi ro tr pt-BR es-AR.
  
  product object
  
  Hide product attributes Show product attributes
  
  segment_key string
  
  Unique slug to identify the segment
  
  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, or surface-cleaning.
  
  id string
  
  Id to identify the product, unique segment-wise
  
  name string
  
  The name of the product
  
  manufacturer string
  
  The manufacturer key of the product
  
  level string
  
  The level of the product in the product hierarchy. Products which are not part of any hierarchy are marked as 'single'
  
  Values are single, parent, or variant.
  
  main_picture_url url
  
  The URL of the main picture for the product
  
  product_page_urls object
  
  Localized URLs for the object. Available languages depend on your corporation settings
  
  Hide product_page_urls attributes Show product_page_urls attributes
  
  en string
  
  fr string
  
  descriptions object
  
  Hide descriptions attributes Show descriptions attributes
  
  name object
  
  Translations for the object. Available languages depend on your corporation settings
  
  Hide name attributes Show name attributes
  
  en string
  
  fr string
  
  description object
  
  Translations for the object. Available languages depend on your corporation settings
  
  Hide description attributes Show description attributes
  
  en string
  
  fr string
  
  short_description object
  
  Translations for the object. Available languages depend on your corporation settings
  
  Hide short_description attributes Show short_description attributes
  
  en string
  
  fr string
  
  pictures array[object]
  
  Hide pictures attributes Show pictures attributes object
  
  is_main_picture boolean
  
  asset_uuid string
  
  types array[string]
  
  Unique slug to identify an asset type for pictures
  
  Values are product-picture, picture-in-context, 360-picture, benefits-picture, or pictogram.
  
  original url
  
  square-80px url
  
  square-300px url
  
  square-800px url
  
  hd url
  
  documents object
  
  The list of available types used as keys depend on your corporation settings and on the content attached to the product
  
  Hide documents attributes Show documents attributes
  
  technical-sheet object
  
  Localized URLs for the object. Available languages depend on your corporation settings
  
  Hide technical-sheet attributes Show technical-sheet attributes
  
  en string
  
  fr string
  
  dcue-certificate object
  
  Localized URLs for the object. Available languages depend on your corporation settings
  
  Hide dcue-certificate attributes Show dcue-certificate attributes
  
  en string
  
  fr string
  
  values object
  
  Property values attached to this object
  
  Hide values attributes Show values attributes
  
  property_key string
  
  To be replaced with the property key of the property
  
  value string
  
  The value for this property can be:
  
  a value_key for enum
  
  an array of value_key for enum_list
  
  a string otherwise
  
  variants array[object]
  
  The list of available variants of this product
  
  Hide variants attributes Show variants attributes object
  
  segment_key string
  
  Unique slug to identify the segment
  
  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, or surface-cleaning.
  
  id string
  
  Id to identify the product, unique segment-wise
  
  name string
  
  The name of the variant product
  
  code string
  
  The code to identify the variant (optional)
  
  rank integer
  
  The rank of the variant in the variants list
  
  api_get_product url
  
  The API endpoint to get all information on the product
  
  main_picture_url url
  
  The URL of the main picture for the product
  
  last_modified date
  
  Date of last modification on product
  
  values object
  
  Property values attached to this object
  
  Hide values attributes Show values attributes
  
  property_key string
  
  To be replaced with the property key of the property
  
  value string
  
  The value for this property can be:
  
  a value_key for enum
  
  an array of value_key for enum_list
  
  a string otherwise
  
  variant_parent object
  
  Hide variant_parent attributes Show variant_parent attributes
  
  segment_key string
  
  Unique slug to identify the segment
  
  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, or surface-cleaning.
  
  id string
  
  Id to identify the product, unique segment-wise
  
  name string
  
  The name of the product
  
  manufacturer string
  
  The manufacturer key for the product
  
  level string
  
  The level of the product in the product hierarchy. Products which are not part of any hierarchy are marked as 'single'
  
  Values are single, parent, or variant.
  
  last_modified date
  
  Date of last modification on product
  
  parent_id string
  
  The id of the parent product (if level is "variant")
  
  api_get_product url
  
  The API endpoint to get all information on the product
  
  main_picture_url url
  
  The URL of the main picture for the product
  
  product_page_url url
  
  The URL of the public product page
  
  skus array[object]
  
  The list of active SKUs on this product. SKU data model can be requested on the Fetch segment data model endpoint with "sku" as segment key.
  
  Hide skus attributes Show skus attributes object
  
  code string
  
  The unique code for the SKU
  
  label string
  
  A description for this SKU
  
  values object
  
  Property values attached to this object
  
  Hide values attributes Show values attributes
  
  property_key string
  
  To be replaced with the property key of the property
  
  value string
  
  The value for this property can be:
  
  a value_key for enum
  
  an array of value_key for enum_list
  
  a string otherwise
  
  relations array[object]
  
  The list of relations that this product has with other products, potentially from other segments. Relations can be asymmetrical or symmetrical. In a symmetrical relation both product are at the same level, whereas in an asymmetrical relation the roles of the products involved is not the same, one is the leader and the other the follower.
  
  Hide relations attributes Show relations attributes object
  
  key string
  
  A key to define the type of relation between two products
  
  Values are is_part_of_kit, has_for_kit_content, is_spare_part_for, has_for_spare_parts, is_accessory_for, has_for_accessories, is_replaceable_by, can_replace, is_premium_replaceable_by, can_premium_replace, associated, or part_of_same_collection.
  
  type string
  
  Defines wether a relation is symmetrical (true for both parties equally) or asymmetrical (different for each party)
  
  Values are symmetrical or asymmetrical.
  
  products array[object]
  
  The list of relations with other products on this product
  
  Hide products attributes Show products attributes object
  
  segment_key string
  
  Unique slug to identify the segment
  
  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, or surface-cleaning.
  
  id string
  
  Id to identify the product, unique segment-wise
  
  name string
  
  The name of the product
  
  manufacturer string
  
  The manufacturer key for the product
  
  level string
  
  The level of the product in the product hierarchy. Products which are not part of any hierarchy are marked as 'single'
  
  Values are single, parent, or variant.
  
  last_modified date
  
  Date of last modification on product
  
  parent_id string
  
  The id of the parent product (if level is "variant")
  
  api_get_product url
  
  The API endpoint to get all information on the product
  
  main_picture_url url
  
  The URL of the main picture for the product
  
  product_page_url url
  
  The URL of the public product page
  
  countries array[string]
  
  The list of countries in which the product is sold, using alpha-2 iso codes
• 404 application/json

Unknown product id
Hide response attributes Show response attributes object
- status string
- message string
• 403 application/json

Unauthorized product
Hide response attributes Show response attributes object
- status string
- message string
• 419 application/json

Rate limit exceeded
Hide response attributes Show response attributes object
- status string
- message string

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": {
    "languages": [
      "en",
      "fr"
    ],
    "product": {
      "segment_key": "surface-cleaning",
      "id": "f50938a24830edb8b1c2ecc3f7dd88a3",
      "name": "Apo-low 1027",
      "manufacturer": "spontex",
      "level": "parent",
      "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"
      },
      "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"
        }
      },
      "pictures": [
        {
          "is_main_picture": true,
          "asset_uuid": "9e158040-272e-4f6a-8da5-1bed82f8ca80-0.jpg",
          "original": "https://assets.ppe-analytics.com/mapa/9e/15/9e158040-272e-4f6a-8da5-1bed82f8ca80/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",
          "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"
          ]
        },
        {
          "asset_uuid": "6cb60165-78ab-4bd7-8ac7-2afc3a5c952d-0.png",
          "original": "https://assets.ppe-analytics.com/mapa/6c/b6/6cb60165-78ab-4bd7-8ac7-2afc3a5c952d/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",
          "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"
          ]
        }
      ],
      "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"
        }
      },
      "assets": {
        "instructions-for-use": [
          {
            "asset_uuid": "abb230c2-2753-473c-b298-88fab2bc7c8c",
            "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"
            ]
          }
        ],
        "technical-sheet": [
          {
            "asset_uuid": "0bb230c2-2753-473c-b298-88fab2bc7001",
            "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-88fab2bc7002",
            "url": "https://spontex.ppe-analytics.com/fr/product/f50938a24830edb8b1c2ecc3f7dd88a3/pdf/dcue-certificate",
            "name": "Apo-low 1027 Technical sheet FR",
            "languages": [
              "fr"
            ]
          }
        ]
      },
      "values": {
        "main-color": [
          "blue"
        ],
        "has-latex": true,
        "en388-digits": "4343X"
      },
      "variants": [
        {
          "product_id": "f60938a24830edb8b1c2ecc3f7dd88a4",
          "segment_key": "ear-protection",
          "label": "Apo-low 1027 BLUEGREEN",
          "code": "1027-BG",
          "rank": 0,
          "main_picture_url": "https://app.ppe-analytics.com/static/pictures/300/surface-cleaning/f50938a24830edb8b1c2ecc3f7dd88a3.jpg",
          "api_get_product": "/api/v1/products/ear-protection/f60938a24830edb8b1c2ecc3f7dd88a4",
          "last_modified": "2023-12-24 17:14:46 +0200",
          "values": {
            "color": [
              "blue",
              "green"
            ]
          }
        },
        {
          "product_id": "f70938a24830edb8b1c2ecc3f7dd88a5",
          "segment_key": "ear-protection",
          "label": "Apo-low 1027 BLUEBLACK",
          "code": "1027-BB",
          "rank": 1,
          "main_picture_url": "https://app.ppe-analytics.com/static/pictures/300/surface-cleaning/f50938a24830edb8b1c2ecc3f7dd88a3.jpg",
          "api_get_product": "/api/v1/products/ear-protection/f70938a24830edb8b1c2ecc3f7dd88a5",
          "last_modified": "2024-01-09 12:55:02 +0200",
          "values": {
            "color": [
              "blue",
              "black"
            ]
          }
        }
      ],
      "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
            }
          ]
        }
      ],
      "relations": [
        {
          "key": "is_part_of_kit",
          "type": "asymmetrical",
          "products": [
            {
              "product_id": "f70938a24830edb8b1c2ecc3f7dd88a5",
              "segment_key": "surface-cleaning",
              "label": "Kit nettoyage",
              "manufacturer": "spontex",
              "code": "CLEAN-KIT",
              "main_picture_url": "https://app.ppe-analytics.com/static/pictures/300/surface-cleaning/f50938a24830edb8b1c2ecc3f7dd88a3.jpg",
              "api_get_product": "/api/v1/products/ear-protection/f70938a24830edb8b1c2ecc3f7dd88a5"
            }
          ]
        },
        {
          "key": "can_replace",
          "type": "asymmetrical",
          "products": [
            {
              "product_id": "f70938a24830edb8b1c2ecc3f7dd88a5",
              "segment_key": "surface-cleaning",
              "label": "Apo li light",
              "manufacturer": "spontex",
              "code": "APOLI",
              "main_picture_url": "https://app.ppe-analytics.com/static/pictures/300/surface-cleaning/f50938a24830edb8b1c2ecc3f7dd88a3.jpg",
              "api_get_product": "/api/v1/products/ear-protection/f70938a24830edb8b1c2ecc3f7dd88a5"
            },
            {
              "product_id": "f70938a24830edb8b1c2ecc3f7dd88a5",
              "segment_key": "surface-cleaning",
              "label": "Apo logic",
              "manufacturer": "spontex",
              "code": "APOLOGIC",
              "main_picture_url": "https://app.ppe-analytics.com/static/pictures/300/surface-cleaning/f50938a24830edb8b1c2ecc3f7dd88a3.jpg",
              "api_get_product": "/api/v1/products/ear-protection/f70938a24830edb8b1c2ecc3f7dd88a5"
            }
          ]
        },
        {
          "key": "associated",
          "type": "symmetrical",
          "products": [
            {
              "product_id": "f70938a24830edb8b1c2ecc3f7dd88a5",
              "segment_key": "eye-protection",
              "label": "Lunettes anti projections",
              "manufacturer": "uvex",
              "code": "9872323-LUN",
              "main_picture_url": "https://app.ppe-analytics.com/static/pictures/300/surface-cleaning/f50938a24830edb8b1c2ecc3f7dd88a3.jpg",
              "api_get_product": "/api/v1/products/ear-protection/f70938a24830edb8b1c2ecc3f7dd88a5"
            }
          ]
        }
      ],
      "countries": [
        "it",
        "fr",
        "gb",
        "ml"
      ]
    }
  }
}

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"
}