Retrieve content demographics

Get demographic information with the supplied job ID. 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.

GET /v1/social/creators/contents/audience/{id}

Basic auth

curl 'https://api.staging.insightiq.ai/v1/social/creators/contents/audience/id_01JXY9AZK4KV' \
  --request GET \
  --header 'Authorization: Basic YOUR_BASE64_CREDENTIALS'

{
  "id": "id_01JXY9AZK4KV",
  "status": "IN_PROGRESS",
  "data": {
    "report": {
      "created_at": "2020-03-27T12:56:34.534978",
      "content_urls": [
        "https://example.com"
      ],
      "failed_content_urls": [
        "https://example.com"
      ],
      "creator_count": 1,
      "post_count": 1,
      "total_like_count": 1,
      "total_reach_count": 1
    },
    "creators": {
      "full_name": "example",
      "platform_profile_name": "Peter Parker",
      "url": "https://example.com",
      "image_url": "https://example.com",
      "follower_count": 1,
      "analysed_post_count": 1,
      "is_verified": true
    },
    "posts": {
      "platform_profile_name": "example",
      "url": "https://youtu.be/jzWweY4xPe8",
      "thumbnail_url": "https://youtu.be/jzWweY4xPe8.png",
      "format": "VIDEO",
      "published_at": "2021-05-26T00:00:00.000000",
      "title": "USA Tours",
      "like_count": 42134,
      "view_count": 42343,
      "share_count": 42343,
      "hashtags": [
        "['#couponcommunity', '#amazonfinds', '#like', '#amazondeals', '#promocodes', '#rundeal', '#explorepage', '#amazon', '#neverpayfullprice', '#onlinedeals']"
      ]
    },
    "audience": {
      "gender_age_distribution": [
        {}
      ],
      "countries": [
        {}
      ]
    }
  },
  "error": {
    "type": "INVALID_REQUEST_PARAMETERS",
    "error_code": "MISSING_FIELDS",
    "message": "Request is missing required fields: [enabled, name].",
    "request_id": "123e4567-e89b-42d3-a456-426614174000",
    "http_status_code": 400
  }
}

Path parameters

· 1

id string required

Unique job ID

Retrieve content demographics

Path parameters

Body

Responses