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 |