Giriş yapınÜcretsiz denemeyi başlatın
easyCoexistence Resmi API'ler

API ile TikTok takipçi demografisi

TikTok API for Business, takipçi demografisini GET /business/get/ üzerinden döndürür: audience_ages, audience_genders, audience_countries ve audience_cities; her biri takipçi oranlarından oluşan bir liste olarak, en az 100 takipçisi olan hesaplar için. Her günün metriklerindeki audience_activity alanı ise saatlik takipçi etkinliğini, Advanced Access ya da Verified Business Accounts olan ve aynı 100 takipçiye sahip hesaplar için verir. Hepsi user.insights kapsamını gerektirir.

easyCoexistence, Claude, ChatGPT ya da kendi kodunuzdan get_social_insights ile bir TikTok hesabının takipçi demografisini okur: audience_ages, audience_genders, audience_countries, audience_cities ya da audience_activity isteyin; TikTok'un listelerini olduğu gibi döndürür.

100

Yaş, cinsiyet, ülke ve şehir dökümlerini TikTok'un döndürmesi için hesabın sahip olması gereken takipçi sayısı.

5 groups

audience_ages içindeki yaş grupları: 18-24, 25-34, 35-44, 45-54 ve 55+.

UTC+0

audience_activity'nin saat dilimi, TikTok'ta aktif olan takipçilerin saatlik sayısıdır.

24 to 48 h

audience_countries, audience_genders ve audience_activity için olağan gecikme; TikTok bu verileri çevrimdışı hesaplar.

Hesap uç noktası hangi demografileri döndürür?

fields içinde adı geçtiğinde GET /business/get/ bunları döndürür. Dört döküm, data'nın en üst düzeyinde yer alır, her boyut için bir liste olarak; saatlik etkinlik ise metrics içinde, her gün için bir küme olarak durur:

  • audience_ages: her yaş grubundaki takipçi oranı; 18-24, 25-34, 35-44, 45-54 ve 55+.
  • audience_genders: cinsiyete göre takipçi oranı: Female, Male veya Other.
  • audience_countries: ülke veya bölge başına takipçi oranı, ISO 3166-1 alpha-2 kodu ile.
  • audience_cities: şehir başına takipçi oranı, city_name ile.
  • audience_activity: her gün için, her saatte TikTok'ta aktif olan takipçiler; hour ve count olarak.

Bunları nasıl istersiniz?

Alan adlarını fields içinde, JSON dizisi olarak verin ve audience_activity taşıyan günlük metrikler için UTC cinsinden bir tarih aralığı ekleyin. start_date ve end_date en fazla 60 gün geriye gider; bunlar verilmezse TikTok, istekten bir gün önceye kadar olan son 7 günü döndürür:

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'

Yanıt nasıl görünür?

Her döküm, bir grubu yüzdesiyle eşleştiren nesnelerin listesidir; metrics içindeki her gün, tarihini ve saatlerin audience_activity listesini taşır. Aşağıdaki değerler TikTok'un kendi örnekleridir; cinsiyet listesine ve birkaç saate kısaltılmıştır:

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

Hangi hesaplar hangi dökümleri alır?

Yaş, cinsiyet, ülke ve şehir oranları, hesabın en az 100 takipçisi olduğunda gelir; TikTok'un 13 takipçili bir hesap için verdiği örnekte bu listeler boş döner. audience_activity de 100 takipçi ister; buna ek olarak Advanced Access, yani bir TikTok for Business hesabına ya da doğrulanmamış bir Business Center'a bağlanarak elde edilen erişim, ya da Verified Business Account gerekir. Bu alanların her biri, erişim token'ı üzerinde user.insights kapsamını gerektirir.

Demografiler ne kadar güncel?

Bir ya da iki gün geride. TikTok, audience_countries, audience_genders ve audience_activity alanlarını genellikle UTC'ye göre 24 ila 48 saat geride kalanlar arasında sayar; yaş ve şehir için aynı güncelleme süresini verir. Veriler, hesap sahibinin ilk videoyu yayımladıktan sonra uygulamada açtığı TikTok Analytics'ten gelir; bundan önceki veriler yoktur. TikTok demografileri, kullanıcıların profillerine yazdıkları şeyler dahil birkaç etkene dayandırır.

Takipçi demografisi, bir videonun izleyicilerinden nasıl farklıdır?

Farklı kişileri anlatırlar. Hesap listeleri takipçileri kapsar. /business/video/list/ ise tek bir gönderiyi izleyenlerin dökümlerini döndürür: her biri en fazla 10 girişli audience_genders, audience_countries ve audience_cities, bir de izleyicileri yeni ve geri dönen, takipçi ve takipçi olmayan olarak ayıran audience_types. Bunlar user.insights yerine video.insights kapsamını gerektirir.

easyCoexistence bunları nasıl okur?

Hesap üzerinde get_social_insights ile: object_id'yi dışarıda bırakın, alan adlarını metrics olarak sıralayın ve belirli günler için audience_activity istediğinizde params içinde start_date ve end_date geçirin. TikTok'un listelerini olduğu gibi döndürür; bu nedenle oranlar ve saatler yukarıda anlatıldığı gibi aynen okunur.

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

Yaygın hatalar

  • Küçük bir hesaptan döküm beklemek. TikTok, yaş, cinsiyet, ülke ve şehir oranlarını 100 takipçiden itibaren döndürür; 13 takipçili bir hesap için verdiği örnekte bu listeler boştur.
  • audience_activity saatlerini yerel saat sanmak. TikTok bunları UTC+0 olarak bildirir; gönderi planlamadan önce izleyicinin saat dilimine çevirin.
  • Takipçi demografisini izleyici demografisi sanmak. Hesap listeleri takipçileri anlatır; bir videonun audience_countries alanı ise onu izleyenleri anlatır.
  • Kişisel bir hesapta audience_activity beklemek. TikTok bunu, en az 100 takipçisi olan Advanced Access ya da Verified Business Account sahibi hesaplar için döndürür.
Bunu EasyCoexistence'la yapmak

Bağlantı başına aylık US$ 9 ile US$ 0.75 arasında, bağlantı ekledikçe düşer; ilk 3 gün ücretsiz.

Sık sorulan sorular

TikTok API'si takipçilerimin yaşını ve cinsiyetini gösterebilir mi?

Evet. /business/get/ audience_ages ve audience_genders döndürür; bunlar grup başına takipçi oranlarıdır. Hesabın en az 100 takipçisi olduğunda ve erişim token'ında user.insights bulunduğunda gelir.

TikTok API'si hangi yaş gruplarını kullanır?

18-24, 25-34, 35-44, 45-54 ve 55+; her biri içindeki takipçi oranıyla birlikte.

TikTok API'si takipçilerimin ne zaman çevrimiçi olduğunu söyler mi?

audience_activity, her günün metriklerinde, saat başına TikTok'ta aktif olan takipçileri UTC+0 olarak verir; Advanced Access ya da 100 ve üzeri takipçisi olan Verified Business Account için geçerlidir.

TikTok API'si takipçilerin ülkelerini nasıl verir?

audience_countries içinde ISO 3166-1 alpha-2 ülke veya bölge kodları olarak; her biri oradan gelen takipçi oranıyla birlikte.

Okumaya devam edin

İlk kanalınızı iki dakikada bağlayın.

Beklemeniz gereken platform incelemesi yok. WhatsApp, Instagram, TikTok veya başka bir kanalı bağlayın, ardından yapay zekânızdan paylaşım yapmasını, yanıtlamasını ya da rapor vermesini isteyin ve işini izleyin.

  • 3 gün ücretsiz
  • İstediğiniz zaman iptal
  • Yalnızca resmi API'ler
  • 7/24 izleniyor

Doğrulama tarihi