Skip to main content

Planning Intelligence: Social Media

Returns the Planning Intelligence social media section of the insight. For each question it gives the share of the audience giving each answer (values), against the baseline's share, for the whole audience and split by demographic group (groups).

Questions are keyed by ID. Each carries its title (name), the full question (question) and a short statement of what it measures (statement); each answer carries a short label (name). A question with multi_select has independent answer rates; otherwise its rates sum to 1.

Requires the Planning Intelligence social media report section permission, which can only be granted by StatSocial. Insights generated before this section was available have no social media data and return an error.

Getting Started​

URL REQUEST (GET)
https://api.statsocial.com/platform/v0/reports/planning/social-media

hash: Insight hash

https://api.statsocial.com/platform/v0/reports/planning/social-media?hash=xxxx

Can send a default baseline.
Available types: global, global_males, global_females, usa, usa_males, usa_females,UK, Canada, France, Germany, Italy, Spain, or any other insight hash.
If no baseline is specified, it defaults to global.

https://api.statsocial.com/platform/v0/reports/planning/social-media?hash=xxxx&baseline=usa

Successful return​

values and indexes hold one entry per insight hash. A group's profiles counts each insight's profiles in the group; an insight with too few of them has 0 profiles and zero values at its position.

{
"information": {
"version": "string"
},
"response": {
"hashes": [
"string"
],
"baseline": "string",
"baseline_alias": "string",
"questions": {
"ad_action_platform": {
"name": "Ad Receptivity",
"question": "On which platform are you most likely to act on an ad or sponsored content?",
"statement": "Where they are most likely to act on an ad",
"metrics": [
{
"id": "instagram",
"name": "Instagram",
"baseline": 0.069,
"values": [
0.068
],
"indexes": [
98
]
},
{
"id": "no_ads",
"name": "Doesn't act on ads",
"baseline": 0.368,
"values": [
0.36
],
"indexes": [
98
]
}
]
}
},
"groups": {
"18_34": {
"profiles": [
4210
],
"questions": {
"ad_action_platform": {
"name": "Ad Receptivity",
"question": "On which platform are you most likely to act on an ad or sponsored content?",
"statement": "Where they are most likely to act on an ad",
"metrics": [
{
"id": "instagram",
"name": "Instagram",
"baseline": 0.08,
"values": [
0.11
],
"indexes": [
138
]
}
]
}
}
}
}
}
}

Groups: 18_34, 35_54, 55_plus, male and female.