Our datasets include data for different share types – that is, different levels of ownership. Share types control the way you see data for brands changing hands.


This endpoint allows you to query the share types available for a specific shares dataset, so you can use these data types to refine a request to one of the main services.

URI https://api.euromonitor.com/catalog/ {MeasureType}/sharetype
Supported verbs GET, POST
Required headers Ocp-Apim-Subscription-Key, Accept, Authorization
Supported formats JSON, XML, CSV
Parameters
MeasureType Required The dataset that you wish to retrieve share types for. Can be CompanyShare or BrandShare
IndustryCodes Required A list of industry codes you wish to retrieve share types for
CategoryIds Optional A list of Category IDs you wish to retrieve share types for

A sample GET request might look like this:

GET https://api.euromonitor.com/catalog/BrandShare/sharetype?IndustryCodes=CT&CategoryIds=11069 HTTP/1.1
Host: api.euromonitor.com
Authorization: Bearer 
Accept: application/json; api-version=1.0
Ocp-Apim-Subscription-Key: 173bad6f0b319h23add9ad162493915e

The POST version of the same request will look like this:

POST https://api.euromonitor.com/catalog/BrandShare/sharetype HTTP/1.1
Host: api.euromonitor.com
Authorization: Bearer 
Accept: application/json; api-version=1.0
Content-Type: application/json
Ocp-Apim-Subscription-Key: 173bad6f0b319h23add9ad162493915e
{
    "industryCodes": [
        "CT"
    ],
    "categoryIds": [
        11069
    ]
}

A successful response body will have the following structure in JSON format:

[
    {
        "id": 0,
        "name": "string",
        "definition": "string"
    }
]

It is an array of DataType objects, each with the following members:

id The ID of the share type. Use a collection of these values when building requests to the main data services
name The name of the share type
definition The full definition of the share type