MasukMulai uji coba gratis
easyCoexistence API resmi

Demografi audiens TikTok lewat API

API for Business TikTok mengembalikan demografi pengikut akun TikTok dari GET /business/get/: audience_ages, audience_genders, audience_countries dan audience_cities, masing-masing berupa daftar proporsi pengikut, untuk akun dengan minimal 100 pengikut. Aktivitas pengikut per jam tersedia sebagai audience_activity di metrics setiap hari, untuk akun dengan Advanced Access atau Verified Business Accounts dan syarat 100 pengikut yang sama. Semuanya memerlukan scope user.insights.

easyCoexistence membaca demografi pengikut akun TikTok dengan get_social_insights dari Claude, ChatGPT, atau kode Anda sendiri: minta audience_ages, audience_genders, audience_countries, audience_cities atau audience_activity, dan ia mengembalikan daftar TikTok apa adanya.

100

Jumlah pengikut yang harus dimiliki akun sebelum TikTok mengembalikan rincian usia, gender, negara dan kota.

5 groups

Kelompok usia di audience_ages: 18-24, 25-34, 35-44, 45-54 dan 55+.

UTC+0

Zona waktu audience_activity, yaitu jumlah pengikut yang aktif di TikTok per jam.

24 to 48 h

Keterlambatan yang umum untuk audience_countries, audience_genders dan audience_activity, yang dihitung TikTok secara offline.

Demografi apa saja yang dikembalikan endpoint akun?

GET /business/get/ mengembalikannya jika disebutkan di fields. Empat rincian berada di bagian atas data, satu daftar untuk setiap dimensi, dan aktivitas per jam berada di metrics, satu set untuk setiap hari:

  • audience_ages: proporsi pengikut di tiap kelompok usia, 18-24, 25-34, 35-44, 45-54 dan 55+.
  • audience_genders: proporsi pengikut menurut gender: Female, Male atau Other.
  • audience_countries: proporsi pengikut per negara atau wilayah, dalam kode ISO 3166-1 alpha-2.
  • audience_cities: proporsi pengikut per kota, berdasarkan city_name.
  • audience_activity: untuk setiap hari, jumlah pengikut yang aktif di TikTok pada tiap jam, sebagai hour dan count.

Bagaimana cara memintanya?

Dengan nama field di fields, dalam bentuk array JSON, dan rentang tanggal dalam UTC untuk metrik harian yang memuat audience_activity. start_date dan end_date dapat mundur hingga 60 hari, dan jika keduanya dihilangkan, TikTok mengembalikan 7 hari hingga sehari 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 apa responsnya?

Setiap rincian berupa daftar objek yang memasangkan sebuah kelompok dengan persentasenya, dan setiap hari di metrics memuat tanggalnya serta daftar audience_activity berisi jam-jam. Nilai berikut adalah contoh dari TikTok sendiri, dipangkas hanya pada daftar gender dan beberapa jam:

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 }
        ]
      }
    ]
  }
}

Akun mana yang mendapat rincian yang mana?

Proporsi usia, gender, negara dan kota tersedia setelah akun memiliki minimal 100 pengikut; contoh TikTok untuk akun dengan 13 pengikut mengembalikan daftar tersebut kosong. audience_activity juga memerlukan 100 pengikut, dan selain itu akun harus memiliki Advanced Access, yang diperoleh dengan menautkannya ke akun TikTok for Business atau Business Center yang belum diverifikasi, atau Verified Business Accounts. Setiap field ini memerlukan scope user.insights pada token.

Seberapa mutakhir demografinya?

Tertinggal sehari atau dua hari. TikTok mencantumkan audience_countries, audience_genders dan audience_activity di antara field yang biasanya tertinggal 24 hingga 48 jam, dalam UTC, dan memberikan waktu pembaruan yang sama untuk usia dan kota. Angkanya berasal dari TikTok Analytics, yang diaktifkan pemilik di aplikasi setelah mengunggah video pertama, dan data dari sebelum itu tidak tersedia. TikTok menghitung demografi berdasarkan beberapa faktor, termasuk apa yang dicantumkan pengguna di profil mereka.

Apa bedanya demografi pengikut dengan penonton video?

Keduanya menggambarkan orang yang berbeda. Daftar akun mencakup pengikut. /business/video/list/ mengembalikan rincian orang yang menonton satu unggahan: audience_genders, audience_countries dan audience_cities masing-masing hingga 10 entri, dan audience_types, yang membagi penonton menjadi baru dan kembali, serta pengikut dan non-pengikut. Itu memerlukan scope video.insights, bukan user.insights.

Bagaimana easyCoexistence membacanya?

Dengan get_social_insights pada akun: hilangkan object_id, cantumkan nama field sebagai metrics, dan berikan start_date serta end_date di params ketika Anda menginginkan audience_activity untuk hari-hari tertentu. Ia mengembalikan daftar TikTok apa adanya, sehingga proporsi dan jam terbaca persis 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" }
}

Kesalahan umum

  • Mengharapkan rincian untuk akun kecil. TikTok mengembalikan proporsi usia, gender, negara dan kota mulai dari 100 pengikut, dan contohnya untuk akun 13 pengikut menunjukkan daftar kosong.
  • Membaca jam audience_activity sebagai waktu lokal. TikTok melaporkannya dalam UTC+0, jadi geser ke zona waktu audiens sebelum merencanakan unggahan.
  • Menganggap demografi pengikut sebagai demografi penonton. Daftar akun menggambarkan pengikut; audience_countries pada video menggambarkan orang yang menontonnya.
  • Mengharapkan audience_activity pada akun pribadi. TikTok mengembalikannya untuk akun dengan Advanced Access atau Verified Business Accounts yang memiliki minimal 100 pengikut.
Melakukan ini dengan EasyCoexistence

Dari US$ 9 hingga US$ 0.75 per koneksi per bulan, turun seiring Anda menambah koneksi, dengan 3 hari pertama gratis.

Pertanyaan yang sering diajukan

Bisakah API TikTok menampilkan usia dan gender pengikut saya?

Bisa. /business/get/ mengembalikan audience_ages dan audience_genders, proporsi pengikut per kelompok, setelah akun memiliki minimal 100 pengikut dan token memiliki user.insights.

Kelompok usia apa yang digunakan API TikTok?

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

Apakah API TikTok memberi tahu kapan pengikut saya online?

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

Bagaimana API TikTok menyajikan negara pengikut?

Sebagai kode negara atau wilayah ISO 3166-1 alpha-2 di audience_countries, masing-masing dengan proporsi pengikut dari sana.

Lanjut membaca

Hubungkan saluran pertama Anda dalam dua menit.

Tanpa menunggu peninjauan platform. Hubungkan WhatsApp, Instagram, TikTok, atau saluran lainnya, lalu minta AI Anda untuk memposting, membalas, atau membuat laporan, dan lihat hasilnya langsung.

  • Gratis 3 hari
  • Batalkan kapan saja
  • Hanya API resmi
  • Dipantau 24/7

Diverifikasi pada