Get product 📘

GET /products/{segment_key}/{product_id}

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

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

  • Set to "1" to request more detailed information about assets (name, source url, multiple assets...)

  • 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
        • 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

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

        • The URL of the main picture for the product

        • 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
        • 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
          • Translations for the object. Available languages depend on your corporation settings

            Additional properties are allowed.

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

          • The API endpoint to get all information on the product

          • The URL of the main picture for the product

          • 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
            • 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
        • Additional properties are allowed.

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

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

          • Date of last modification on product

          • The id of the parent product (if level is "variant")

          • The API endpoint to get all information on the product

          • The URL of the main picture for the product

          • The URL of the public product page

          • The status of the product in the PIM. It is only available on products on which your are the owner

            Values are draft, ready, or archived.

        • 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
            • 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
            • 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

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

            • Date of last modification on product

            • The id of the parent product (if level is "variant")

            • The API endpoint to get all information on the product

            • The URL of the main picture for the product

            • The URL of the public product page

            • The status of the product in the PIM. It is only available on products on which your are the owner

              Values are draft, ready, or archived.

        • 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"
            }
          ]
        }
      ],
      "pim_status": "ready",
      "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"
}