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

  • with_json_path boolean

    Set to "1" to also request api endpoint + json path for each item in the views, allosing easier query of detailed items attributes

Responses

  • 200 application/json

    Successfully returned product information

    Hide response attributes Show response attributes object
    • status string
    • result object

      Additional properties are allowed.

      Hide result attributes Show result attributes object
      • 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

        Additional properties are allowed.

        Hide product attributes Show product 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 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

          Additional properties are allowed.

          Hide product_page_urls attributes Show product_page_urls attributes object
        • descriptions object

          Additional properties are allowed.

          Hide descriptions attributes Show descriptions attributes object
          • name object

            Translations for the object. Available languages depend on your corporation settings

            Additional properties are allowed.

            Hide name attributes Show name attributes object
          • description object

            Translations for the object. Available languages depend on your corporation settings

            Additional properties are allowed.

            Hide description attributes Show description attributes object
          • short_description object

            Translations for the object. Available languages depend on your corporation settings

            Additional properties are allowed.

            Hide short_description attributes Show short_description attributes object
        • pictures array[object]
          Hide pictures attributes Show pictures attributes object
        • documents object

          The list of available types used as keys depend on your corporation settings and on the content attached to the product

          Additional properties are allowed.

          Hide documents attributes Show documents attributes object
          • technical-sheet object

            Localized URLs for the object. Available languages depend on your corporation settings

            Additional properties are allowed.

            Hide technical-sheet attributes Show technical-sheet attributes object
          • dcue-certificate object

            Localized URLs for the object. Available languages depend on your corporation settings

            Additional properties are allowed.

            Hide dcue-certificate attributes Show dcue-certificate attributes object
        • values object

          Property values attached to this object

          Additional properties are allowed.

          Hide values attributes Show values attributes object
          • 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
        • tiles object

          Tiles attached to this object. One tile is composed of a pictogram + localized title & value

          Additional properties are allowed.

          Hide tiles attributes Show tiles attributes object
          • tile_key string

            To be replaced with the tile key of the tile. It will have a mycorp/ prefix for private tiles to avoid conflicts

          • value object

            Full tile content, including its pictogram, title and content (all of them are optional)

            Additional properties are allowed.

            Hide value attributes Show value attributes object
            • pictures array[object]

              Direct links to different sizes of the picture. Can be hotlinked

              Hide pictures attributes Show pictures attributes object
            • title object

              Translations for the object. Available languages depend on your corporation settings

              Additional properties are allowed.

              Hide title attributes Show title attributes object
            • content object

              Translations for the object. Available languages depend on your corporation settings

              Additional properties are allowed.

              Hide content attributes Show content attributes object
        • 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

            Additional properties are allowed.

            Hide values attributes Show values attributes object
            • 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

          Additional properties are allowed.

          Hide variant_parent attributes Show variant_parent 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

        • 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

            Additional properties are allowed.

            Hide values attributes Show values attributes object
            • 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
  • 403 application/json

    Unauthorized product

    Hide response attributes Show response attributes object
  • 419 application/json

    Rate limit exceeded

    Hide response attributes Show response attributes object
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"
          }
        }
      },
      "views": {
        "web": {
          "norms": [
            {
              "key": "en388",
              "type": "property"
            },
            {
              "key": "tile-900",
              "type": "tile"
            }
          ],
          "default": [
            {
              "key": "technical-name",
              "type": "property"
            }
          ],
          "advantages": [
            {
              "key": "acme--fabdis-desc-32",
              "type": "localized-field"
            },
            {
              "key": "mycorp/comfort",
              "type": "property"
            }
          ]
        },
        "compare": {
          "default": [
            {
              "key": "mycorp/material",
              "type": "property"
            },
            {
              "key": "color",
              "type": "property"
            }
          ]
        }
      },
      "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"
}