Skip to main content
GET
/
platforms
/
{platform}
/
profiles
/
{profile_id}
/
audience
Get audience analysis
curl --request GET \
  --url https://external-api.streamforge.com/platforms/{platform}/profiles/{profile_id}/audience \
  --header 'x-api-key: <api-key>'
{
  "payload": {
    "gender_distribution": {
      "male": {
        "percentage": 123
      },
      "female": {
        "percentage": 123
      },
      "non_binary": {
        "percentage": 123
      }
    },
    "age_ranges": [
      {
        "value": "<string>",
        "percentage": 123
      }
    ],
    "countries": [
      {
        "value": "<string>",
        "percentage": 123
      }
    ],
    "languages": [
      {
        "value": "<string>",
        "percentage": 123
      }
    ],
    "ethnicity_distribution": [
      {
        "value": "<string>",
        "percentage": 123
      }
    ],
    "occupation_distribution": [
      {
        "value": "<string>",
        "percentage": 123
      }
    ],
    "income_distribution": [
      {
        "value": "<string>",
        "percentage": 123
      }
    ],
    "education_level": [
      {
        "value": "<string>",
        "percentage": 123
      }
    ],
    "family_status": [
      {
        "value": "<string>",
        "percentage": 123
      }
    ],
    "religion_distribution": [
      {
        "value": "<string>",
        "percentage": 123
      }
    ],
    "engagement_style": [
      {
        "value": "<string>",
        "percentage": 123
      }
    ],
    "interests": [
      {
        "value": "<string>",
        "strength_rating": 123,
        "emoji": "<string>",
        "sub_interests": [
          {
            "value": "<string>",
            "strength_rating": 123,
            "emoji": "<string>"
          }
        ]
      }
    ],
    "community_health": {
      "loyalty_score": 123,
      "cohesion_score": 123,
      "toxicity_score": 123,
      "loyalty_signals": [
        "<string>"
      ],
      "cohesion_signals": [
        "<string>"
      ],
      "toxicity_signals": [
        "<string>"
      ]
    },
    "brand_safety": {
      "overall_risk_level": 123,
      "risk_factors": [
        {
          "factor": "<string>",
          "frequency": 123
        }
      ]
    }
  },
  "meta": {
    "source": "<string>",
    "received_at": "2023-11-07T05:31:56Z",
    "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "last_updated_at": "2023-11-07T05:31:56Z"
  }
}

Authorizations

x-api-key
string
header
required

Your API key. Include it in the x-api-key header for all requests.

Path Parameters

platform
enum<string>
required

Platform identifier

Available options:
twitch,
youtube,
tiktok
Example:

"twitch"

profile_id
string
required

Platform-specific creator ID

Example:

"484563826"

Response

Audience analysis found

payload
object
meta
object