Sign in
Platform Integration

Audience insights (any platform)

Who follows a connected account, when they are online, what they tap on the profile and how it compares to its category. One endpoint per QUESTION with a platform, exactly like /uploadposts/comments and /uploadposts/post-analytics — never one URL per network. Only tiktok answers today; any other value returns 400 with error_code platform_not_supported and a message naming the supported ones. activity_by_hour (24 entries, followers online per hour, summed over the window) is the field to build a publishing schedule on. The window is trimmed to what the platform accepts — at most 60 days, always ending before today — so read the range that comes back, not the one you sent. Requires the profile_analytics capability.

get/uploadposts/audience

Query parameters

platform'tiktok' required

The network to ask. Only tiktok answers today.

userstring required

Profile username as configured in Upload-Post. profile is accepted as an alias.

start_datestring date

First day of the window, ISO YYYY-MM-DD. Defaults to end_date minus 29 days.

end_datestring date

Last day of the window, ISO YYYY-MM-DD. Must be earlier than today. Defaults to yesterday.

benchmark_category'PERSONAL_BLOG' | 'MACHINERY_AND_EQUIPMENT' | 'HEALTH_AND_WELLNESS' | 'PETS' | 'AUTOMOTIVE_AND_TRANSPORTATION' | 'EDUCATION_AND_TRAINING' | 'FOOD_AND_BEVERAGE' | 'REAL_ESTATE' | 'ELECTRONICS' | 'SHOPPING_AND_RETAIL' | 'PUBLIC_ADMINISTRATION' | 'ART_AND_CRAFTS' | 'BABY' | 'GAMING' | 'RESTAURANTS_AND_BARS' | 'HOME_FURNITURE_AND_APPLIANCES' | 'PROFESSIONAL_SERVICES' | 'SOFTWARE_AND_APPS' | 'MEDIA_AND_ENTERTAINMENT' | 'BEAUTY' | 'SPORTS_FITNESS_AND_OUTDOORS' | 'CLOTHING_AND_ACCESSORIES' | 'TRAVEL_AND_TOURISM' | 'OTHERS' | 'FINANCE_AND_INVESTING'

Adds the benchmark block: the averages of that content category. Case-insensitive; the full list also comes back in benchmark_categories on every call.

Response

Audience insights.

successboolean
platformstring
bio_descriptionstring nullable

The account's current bio text.

benchmark_categoriesstring[]

The 25 values benchmark_category accepts. Always present, so a picker can be built without a second call.

Example response

{
  "success": true,
  "platform": "tiktok",
  "audience": {
    "countries": [
      {
        "country": "ES"
      }
    ],
    "cities": [
      {
        "city": "Madrid"
      }
    ],
    "ages": [
      {
        "age": "25-34"
      }
    ],
    "genders": [
      {
        "gender": "female"
      }
    ]
  },
  "activity_by_hour": [
    {
      "hour": "14",
      "followers_online": 1494
    }
  ],
  "profile_actions": {
    "bio_link_clicks": 318
  },
  "benchmark": {
    "category": "SOFTWARE_AND_APPS",
    "average_engagement_rate": 0.0144
  }
}

Changes