Get audience insights
GET {{baseUrl}}/ad_accounts/:ad_account_id/audience_insights?audience_insight_type=YOUR_TOTAL_AUDIENCE
Get Audience Insights for an ad account. The response will return insights for 3 types of audiences: the ad account's engaged audience on Pinterest, the ad account's total audience on Pinterest and Pinterest's total audience.
Learn more about Audience Insights.
Request Params
| Key | Datatype | Required | Description |
|---|---|---|---|
audience_insight_type | string | (Required) Type of audience insights. |
HEADERS
| Key | Datatype | Required | Description |
|---|---|---|---|
Accept | string |
RESPONSES
status: OK
{"categories":[{"key":"\u003cstring\u003e","name":"\u003cstring\u003e","ratio":"\u003cnumber\u003e","index":"\u003cnumber\u003e","id":"\u003cstring\u003e","subcategories":[{"key":"\u003cstring\u003e","name":"\u003cstring\u003e","ratio":"\u003cnumber\u003e","index":"\u003cnumber\u003e","id":"\u003cstring\u003e"},{"key":"\u003cstring\u003e","name":"\u003cstring\u003e","ratio":"\u003cnumber\u003e","index":"\u003cnumber\u003e","id":"\u003cstring\u003e"}]},{"key":"\u003cstring\u003e","name":"\u003cstring\u003e","ratio":"\u003cnumber\u003e","index":"\u003cnumber\u003e","id":"\u003cstring\u003e","subcategories":[{"key":"\u003cstring\u003e","name":"\u003cstring\u003e","ratio":"\u003cnumber\u003e","index":"\u003cnumber\u003e","id":"\u003cstring\u003e"},{"key":"\u003cstring\u003e","name":"\u003cstring\u003e","ratio":"\u003cnumber\u003e","index":"\u003cnumber\u003e","id":"\u003cstring\u003e"}]}],"demographics":{"ages":[{"key":"\u003cstring\u003e","name":"\u003cstring\u003e","ratio":"\u003cnumber\u003e"},{"key":"\u003cstring\u003e","name":"\u003cstring\u003e","ratio":"\u003cnumber\u003e"}],"genders":[{"key":"\u003cstring\u003e","name":"\u003cstring\u003e","ratio":"\u003cnumber\u003e"},{"key":"\u003cstring\u003e","name":"\u003cstring\u003e","ratio":"\u003cnumber\u003e"}],"devices":[{"key":"\u003cstring\u003e","name":"\u003cstring\u003e","ratio":"\u003cnumber\u003e"},{"key":"\u003cstring\u003e","name":"\u003cstring\u003e","ratio":"\u003cnumber\u003e"}],"metros":[{"key":"\u003cstring\u003e","name":"\u003cstring\u003e","ratio":"\u003cnumber\u003e"},{"key":"\u003cstring\u003e","name":"\u003cstring\u003e","ratio":"\u003cnumber\u003e"}],"countries":[{"key":"\u003cstring\u003e","name":"\u003cstring\u003e","ratio":"\u003cnumber\u003e"},{"key":"\u003cstring\u003e","name":"\u003cstring\u003e","ratio":"\u003cnumber\u003e"}]},"type":"YOUR_TOTAL_AUDIENCE","date":"6406-80-28","size":"\u003cinteger\u003e","size_is_upper_bound":"\u003cboolean\u003e"}