Retrieve audience demographics

Retrieves audience demographics for the given account. Demographics object contains information related to the audience of the user: countries, cities, age & gender distribution, etc. The values in this data are in percentages and are tied to a particular work platform account. This data is lifetime data.

Usually used in conjunction with the "PROFILES_AUDIENCE.*" webhooks, read more.

GET /v1/audience

Basic auth

curl 'https://api.sandbox.insightiq.ai/v1/audience?account_id=123e4567-e89b-42d3-a456-426614174000' \
  --request GET \
  --header 'Authorization: Basic YOUR_BASE64_CREDENTIALS'

{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "created_at": "2022-03-27T12:56:34.534978",
  "updated_at": "2022-03-27T12:56:34.534978",
  "user": {
    "id": "fb83e3ca-eae7-4eaa-bf51-601ea4b3daeb",
    "name": "John Doe"
  },
  "account": {
    "id": "fb83e3ca-eae7-4eaa-bf51-601ea4b3daeb",
    "platform_username": "[email protected]"
  },
  "work_platform": {
    "id": "fb83e3ca-eae7-4eaa-bf51-601ea4b3daeb",
    "name": "Instagram",
    "logo_url": "https://insightiq.ai/storage/instagram.png"
  },
  "countries": [
    {
      "code": "US",
      "value": 78.9
    }
  ],
  "cities": [
    {
      "name": "Boulder",
      "value": 45.6
    }
  ],
  "gender_age_distribution": [
    {
      "gender": "FEMALE",
      "age_range": "13-18",
      "value": 12.3
    }
  ]
}

Returns all Profiles objects.

Query parameters

· 1

account_id string · uuid required

Unique ID of the connected account.

Query parameters

Responses