Audience Insights
Get Audience Insights
HTTP Request
POST https://adsapi.snapchat.com/v1/adaccounts/{ad_account_id}/targeting_insights
Parameters
| Parameter | Default | Description |
|---|---|---|
| ad_account_id | The Ad Account ID to be used |
Attributes
| Attribute | Description | Required | Possible Values |
|---|---|---|---|
| base_spec | Valid targeting spec | R | Any valid spec described here |
| targeting_spec | Valid targeting spec | R | Any valid spec described here |
Query Parameters
| Parameter | Description | Required | Possible Values |
|---|---|---|---|
| dimension_category | The category to filter the output results | O | Can be one of: demo/geo/device/interest/engagement/aggregated |
Example
curl -X POST \
-d '{"base_spec": {"interests": [{"category_id": ["SLC_36"]}],"geos": [{"country_code": "us"}]},"targeting_spec": {"interests": [{"category_id": ["SLC_37"]}],"geos": [{"country_code": "us"}]}}'\
-H "Content-Type: application/json" \
-H "Authorization: Bearer meowmeowmeow" \
https://adsapi.snapchat.com/v1/adaccounts/139ee7a0-8225-4076-9048-4cb7d7b3a926/targeting_insights?dimension_category=demo
The above command returns JSON structured like this:
{
"request_status": "SUCCESS",
"request_id": "5b21985200ff0b57ca241c591c0001737e616473617069736300016275696c642d35336630363134382d312d3137352d3100010137",
"targeting_insights": {
"target_audience": {
"audience_size_minimum": "10500000",
"audience_size_maximum": "10800000"
},
"reference_audience": {
"audience_size_minimum": "1110000",
"audience_size_maximum": "1125000"
},
"categories": {
"demographics": {
"distribution": {
"age_groups": {
"key": "",
"insight": [
{
"value": "",
"count": 0,
"id": "35+",
"name": "35+",
"target_audience_percent": 10.3,
"reference_audience_percent": 11.9,
"target_index_to_reference": 0.9,
"metadata": {}
},
{
"value": "",
"count": 0,
"id": "18-20",
"name": "18-20",
"target_audience_percent": 21.2,
"reference_audience_percent": 16.9,
"target_index_to_reference": 1.3,
"metadata": {}
},
{
"value": "",
"count": 0,
"id": "21-24",
"name": "21-24",
"target_audience_percent": 17,
"reference_audience_percent": 20,
"target_index_to_reference": 0.8,
"metadata": {}
},
{
"value": "",
"count": 0,
"id": "13-17",
"name": "13-17",
"target_audience_percent": 30.6,
"reference_audience_percent": 18.9,
"target_index_to_reference": 1.6,
"metadata": {}
},
{
"value": "",
"count": 0,
"id": "25-34",
"name": "25-34",
"target_audience_percent": 20.9,
"reference_audience_percent": 32.3,
"target_index_to_reference": 0.6,
"metadata": {}
},
{
"value": "",
"count": 0,
"id": "UNKNOWN",
"name": "unknown",
"target_audience_percent": 0,
"reference_audience_percent": 0,
"target_index_to_reference": 0,
"metadata": {}
}
]
},
"gender": {
"key": "",
"insight": [
{
"value": "",
"count": 0,
"id": "MALE",
"name": "male",
"target_audience_percent": 46.4,
"reference_audience_percent": 55,
"target_index_to_reference": 0.8,
"metadata": {}
},
{
"value": "",
"count": 0,
"id": "GENDER_UNKNOWN",
"name": "gender_unknown",
"target_audience_percent": 0.2,
"reference_audience_percent": 0,
"target_index_to_reference": 0,
"metadata": {}
},
{
"value": "",
"count": 0,
"id": "FEMALE",
"name": "female",
"target_audience_percent": 53.4,
"reference_audience_percent": 45,
"target_index_to_reference": 1.2,
"metadata": {}
}
]
},
"languages": {
"key": "",
"insight": [
{
"value": "",
"count": 0,
"id": "AR",
"name": "ar",
"target_audience_percent": 0.1,
"reference_audience_percent": 0.2,
"target_index_to_reference": 0.7,
"metadata": {}
},
{
"value": "",
"count": 0,
"id": "FR",
"name": "fr",
"target_audience_percent": 0.2,
"reference_audience_percent": 0.1,
"target_index_to_reference": 1.4,
"metadata": {}
},
{
"value": "",
"count": 0,
"id": "ES",
"name": "es",
"target_audience_percent": 3.3,
"reference_audience_percent": 4.7,
"target_index_to_reference": 0.7,
"metadata": {}
},
{
"value": "",
"count": 0,
"id": "EN",
"name": "en",
"target_audience_percent": 99.1,
"reference_audience_percent": 98.6,
"target_index_to_reference": 1,
"metadata": {}
}
]
},
"advanced_demographics": {
"key": "",
"insight": [
{
"value": "",
"count": 0,
"id": "EXPD_307",
"name": "Household Income ($150,000-$174,999)",
"target_audience_percent": 2.9,
"reference_audience_percent": 3.4,
"target_index_to_reference": 0.9,
"metadata": {}
},
{
"value": "",
"count": 0,
"id": "DLXD_202",
"name": "HHI: 50k-75k",
"target_audience_percent": 17.7,
"reference_audience_percent": 18.7,
"target_index_to_reference": 0.9,
"metadata": {}
},
[[[snip]]]
{
"value": "",
"count": 0,
"id": "FEMALE_UNKNOWN",
"name": "female_unknown",
"target_audience_percent": 0,
"reference_audience_percent": 0,
"target_index_to_reference": 0,
"metadata": {
"gender": "FEMALE",
"age_groups": "unknown"
}
}
]
}
}
}
}
}
}
Was this page helpful?