Log masukMulakan percubaan percuma
easyCoexistence API rasmi

Demografi audiens TikTok melalui API

API for Business TikTok memulangkan demografi pengikut akaun TikTok daripada GET /business/get/: audience_ages, audience_genders, audience_countries dan audience_cities, setiap satu senarai bahagian pengikut, bagi akaun dengan sekurang-kurangnya 100 pengikut. Aktiviti pengikut setiap jam dipulangkan sebagai audience_activity dalam metrik setiap hari, bagi akaun dengan Advanced Access atau Verified Business Accounts dan syarat 100 pengikut yang sama. Semuanya memerlukan skop user.insights.

easyCoexistence membaca demografi pengikut akaun TikTok dengan get_social_insights daripada Claude, ChatGPT atau kod anda sendiri: minta audience_ages, audience_genders, audience_countries, audience_cities atau audience_activity dan ia memulangkan senarai TikTok seperti sedia ada.

100

Bilangan pengikut yang perlu dimiliki akaun sebelum TikTok memulangkan pecahan umur, jantina, negara dan bandarnya.

5 groups

Kumpulan umur dalam audience_ages: 18-24, 25-34, 35-44, 45-54 dan 55+.

UTC+0

Zon masa bagi audience_activity, iaitu bilangan pengikut yang aktif di TikTok setiap jam.

24 to 48 h

Kelewatan biasa bagi audience_countries, audience_genders dan audience_activity, yang dikira TikTok secara luar talian.

Demografi apakah yang dipulangkan oleh endpoint akaun?

GET /business/get/ memulangkannya apabila dinamakan dalam fields. Empat pecahan berada di bahagian atas data, satu senarai bagi setiap dimensi, dan aktiviti setiap jam berada dalam metrics, satu set bagi setiap hari:

  • audience_ages: bahagian pengikut dalam setiap kumpulan umur, 18-24, 25-34, 35-44, 45-54 dan 55+.
  • audience_genders: bahagian pengikut mengikut jantina: Female, Male atau Other.
  • audience_countries: bahagian pengikut bagi setiap negara atau wilayah, dalam kod ISO 3166-1 alpha-2.
  • audience_cities: bahagian pengikut bagi setiap bandar, mengikut city_name.
  • audience_activity: bagi setiap hari, bilangan pengikut yang aktif di TikTok pada setiap jam, sebagai hour dan count.

Bagaimana anda memintanya?

Dengan nama medan dalam fields, dalam tatasusunan JSON, dan julat tarikh dalam UTC bagi metrik harian yang membawa audience_activity. start_date dan end_date boleh mencapai sehingga 60 hari ke belakang, dan tanpa keduanya TikTok memulangkan 7 hari sehingga hari sebelum permintaan:

Follower demographics for a TikTok account
curl -G 'https://business-api.tiktok.com/open_api/v1.3/business/get/' \
  -H 'Access-Token: <ACCESS_TOKEN>' \
  --data-urlencode 'business_id=<OPEN_ID>' \
  --data-urlencode 'fields=["audience_ages","audience_genders","audience_countries","audience_cities","audience_activity"]' \
  --data-urlencode 'start_date=2026-10-24' \
  --data-urlencode 'end_date=2026-10-30'

Seperti apakah rupa respons?

Setiap pecahan ialah senarai objek yang memadankan kumpulan dengan peratusannya, dan setiap hari dalam metrics membawa tarikhnya serta senarai audience_activity bagi jam. Nilai di bawah ialah contoh TikTok sendiri, dipangkas kepada senarai jantina dan beberapa jam sahaja:

Demographics in the /business/get/ response
{
  "code": 0,
  "message": "OK",
  "request_id": "<REQUEST_ID>",
  "data": {
    "audience_genders": [
      { "gender": "Female", "percentage": 0.7554470336505679 },
      { "gender": "Male", "percentage": 0.24455296634943213 }
    ],
    "metrics": [
      {
        "date": "<DATE>",
        "audience_activity": [
          { "hour": "20", "count": 1 },
          { "hour": "23", "count": 4 },
          { "hour": "7", "count": 4 }
        ]
      }
    ]
  }
}

Akaun mana mendapat pecahan yang mana?

Bahagian umur, jantina, negara dan bandar datang selepas akaun mempunyai sekurang-kurangnya 100 pengikut; contoh TikTok bagi akaun 13 pengikut memulangkan senarai tersebut kosong. audience_activity juga memerlukan 100 pengikut, dan selain itu akaun yang mempunyai Advanced Access, yang diperoleh dengan memautkannya kepada akaun TikTok for Business atau Business Center yang tidak disahkan, atau Verified Business Account. Setiap medan ini memerlukan skop user.insights pada token.

Sejauh manakah segarnya demografi?

Lewat sehari atau dua. TikTok menyenaraikan audience_countries, audience_genders dan audience_activity antara medan yang biasanya lewat 24 hingga 48 jam, dalam UTC, dan memberi masa kemas kini yang sama bagi umur dan bandar. Angka datang daripada TikTok Analytics, yang dihidupkan pemilik dalam aplikasi selepas menerbitkan video pertama, dan data sebelum itu tidak tersedia. TikTok mengira demografi berdasarkan beberapa faktor, termasuk apa yang pengguna masukkan dalam profil mereka.

Bagaimana demografi pengikut berbeza daripada penonton video?

Ia menggambarkan orang yang berbeza. Senarai akaun meliputi pengikut. /business/video/list/ memulangkan pecahan orang yang menonton satu siaran: audience_genders, audience_countries dan audience_cities, masing-masing sehingga 10 entri, dan audience_types, yang membahagikan penonton kepada baharu dan kembali, pengikut dan bukan pengikut. Ini memerlukan skop video.insights dan bukannya user.insights.

Bagaimana easyCoexistence membacanya?

Dengan get_social_insights pada akaun: tinggalkan object_id, senaraikan nama medan sebagai metrics, dan hantar start_date serta end_date dalam params apabila anda mahu audience_activity bagi hari tertentu. Ia memulangkan senarai TikTok seperti sedia ada, jadi bahagian dan jam dibaca tepat seperti di atas.

Follower demographics through MCP
get_social_insights {
  "account_id": "<ACCOUNT_ID>",
  "metrics": ["audience_ages", "audience_genders", "audience_countries", "audience_cities", "audience_activity"],
  "params": { "start_date": "2026-10-24", "end_date": "2026-10-30" }
}

Kesilapan biasa

  • Menjangka pecahan bagi akaun kecil. TikTok memulangkan bahagian umur, jantina, negara dan bandar bermula dari 100 pengikut, dan contohnya bagi akaun 13 pengikut menunjukkan senarai kosong.
  • Membaca jam audience_activity sebagai waktu tempatan. TikTok melaporkannya dalam UTC+0, jadi tukar kepada zon masa audiens sebelum merancang siaran.
  • Menganggap demografi pengikut sebagai demografi penonton. Senarai akaun menggambarkan pengikut; audience_countries bagi video menggambarkan orang yang menontonnya.
  • Menjangka audience_activity pada akaun peribadi. TikTok memulangkannya bagi akaun dengan Advanced Access atau Verified Business Accounts yang mempunyai sekurang-kurangnya 100 pengikut.
Menggunakan EasyCoexistence untuk ini

US$ 9 hingga US$ 0.75 setiap sambungan sebulan, menurun apabila anda menambah sambungan, dengan 3 hari pertama percuma.

Soalan lazim

Bolehkah API TikTok menunjukkan umur dan jantina pengikut saya?

Ya. /business/get/ memulangkan audience_ages dan audience_genders, bahagian pengikut bagi setiap kumpulan, apabila akaun mempunyai sekurang-kurangnya 100 pengikut dan token mempunyai user.insights.

Kumpulan umur mana yang digunakan oleh API TikTok?

18-24, 25-34, 35-44, 45-54 dan 55+, masing-masing dengan bahagian pengikut di dalamnya.

Adakah API TikTok memberitahu bila pengikut saya dalam talian?

audience_activity memberikan pengikut yang aktif di TikTok setiap jam, dalam UTC+0, dalam metrik setiap hari, bagi Advanced Access atau Verified Business Accounts dengan 100 pengikut atau lebih.

Bagaimana API TikTok memberikan negara pengikut?

Sebagai kod negara atau wilayah ISO 3166-1 alpha-2 dalam audience_countries, dengan bahagian pengikut dari setiap negara itu.

Teruskan membaca

Sambungkan saluran pertama anda dalam masa dua minit.

Tidak perlu menunggu semakan platform. Sambungkan WhatsApp, Instagram, TikTok atau saluran lain, kemudian minta AI anda menyiarkan, membalas atau melaporkan, dan lihat ia bekerja.

  • 3 hari percuma
  • Batal bila-bila masa
  • API rasmi sahaja
  • Dipantau 24/7

Disahkan pada