Create a content demographics request

Get demographic information about the audience that has interacted with the provided content items. The API retrieves aggregated audience demographics data for up to 5 content items shared by a particular profile. Snapchat Spotlights are the only content type supported currently.

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

POST /v1/social/creators/contents/audience

Basic auth

curl 'https://api.staging.insightiq.ai/v1/social/creators/contents/audience' \
  --request POST \
  --header 'Authorization: Basic YOUR_BASE64_CREDENTIALS' \
  --header 'Content-Type: application/json' \
  --data '{
  "content_urls": [
    "https://example.com"
  ],
  "work_platform_id": "123e4567-e89b-42d3-a456-426614174000",
  "identifier": "example"
}'

{
  "id": "id_01JXY9AZK4KV",
  "created_at": "2026-01-01T12:00:00Z",
  "post_count": 1,
  "total_like_count": 1
}

Accepted

Body

application/json

content_urls array of string · min items: 1· max items: 5 required

Content URL to fetch audience. All content items should belong to a single profile only.

work_platform_id string · uuid required

Work platform ID for the platform on which you want to fetch audience.

identifier string required

Profile URL or username of the profile associated with the content items requested.

Body

Responses