התחברותהתחילו תקופת ניסיון
easyCoexistence ממשקי API רשמיים

נתונים דמוגרפיים של העוקבים ב-TikTok דרך ה-API

ה-API של TikTok for Business מחזיר את נתוני הדמוגרפיה של העוקבים של חשבון, דרך GET /business/get/: audience_ages, audience_genders, audience_countries וכן audience_cities, כל אחד כרשימה של שיעורי עוקבים, לחשבונות עם 100 עוקבים לפחות. פעילות העוקבים לפי שעה מגיעה בשדה audience_activity בתוך המדדים של כל יום, לחשבונות עם Advanced Access או Verified Business Accounts ואותם 100 עוקבים. כל אלה דורשים את ההרשאה user.insights.

easyCoexistence קורא את נתוני העוקבים של חשבון TikTok דרך get_social_insights, מ-Claude, מ-ChatGPT או מהקוד שלכם: מבקשים audience_ages, audience_genders, audience_countries, audience_cities או audience_activity, והכלי מחזיר את הרשימות של TikTok כפי שהן.

100

מספר העוקבים שחשבון צריך כדי ש-TikTok תחזיר את פילוחי הגיל, המגדר, המדינה והעיר שלו.

5 groups

קבוצות הגיל של השדה audience_ages: 18-24, 25-34, 35-44, 45-54 ו-55+.

UTC+0

אזור הזמן של audience_activity, מספר העוקבים הפעילים ב-TikTok בכל שעה.

24 to 48 h

העיכוב הרגיל של השדות audience_countries, audience_genders וכן audience_activity, שאותם TikTok מחשב במצב אופליין.

איזה נתונים דמוגרפיים מחזירה נקודת הקצה של החשבון?

GET /business/get/ מחזירה אותם כששמותיהם מופיעים בשדה fields. ארבעת הפילוחים נמצאים בראש השדה data, רשימה אחת לכל ממד, ופעילות השעות נמצאת בשדה metrics, קבוצה אחת לכל יום:

  • audience_ages: שיעור העוקבים בכל קבוצת גיל, 18-24, 25-34, 35-44, 45-54 ו-55+.
  • audience_genders: שיעור העוקבים לפי מגדר: Female, Male או Other.
  • audience_countries: שיעור העוקבים לכל מדינה או אזור, כקוד ISO 3166-1 alpha-2.
  • audience_cities: שיעור העוקבים לכל עיר, לפי city_name.
  • audience_activity: לכל יום, העוקבים הפעילים ב-TikTok בכל שעה, בשדה hour ובשדה count.

איך מבקשים אותם?

שמות השדות מועברים בשדה fields כמערך JSON, וטווח תאריכים ב-UTC למדדים היומיים שנושאים את audience_activity. start_date וכן end_date מגיעים עד 60 ימים אחורה, ובלעדיהם TikTok מחזיר את 7 הימים שעד יום לפני הבקשה:

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'

איך נראית התשובה?

כל פילוח הוא רשימה של אובייקטים שמזווגים קבוצה לשיעור שלה, וכל יום בשדה metrics נושא את התאריך שלו ורשימה בשם audience_activity של שעות. הערכים שלהלן הם הדוגמאות של TikTok עצמה, מקוצרות לרשימת המגדר ולכמה שעות:

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

אילו חשבונות מקבלים אילו פילוחים?

הפילוחים של גיל, מגדר, מדינה ועיר מגיעים כשלחשבון יש 100 עוקבים לפחות; הדוגמה של TikTok לחשבון עם 13 עוקבים מחזירה את הרשימות ריקות. audience_activity דורש גם הוא 100 עוקבים, ומעבר לכך חשבון עם Advanced Access, שמתקבל מחיבור ל-TikTok for Business או ל-Business Center לא מאומת, או Verified Business Account. כל השדות האלה דורשים את ההרשאה user.insights על האסימון.

כמה טריים הנתונים הדמוגרפיים?

יום או יומיים מאחור. TikTok מציין את audience_countries, audience_genders וכן audience_activity בין השדות שבדרך כלל מתעכבים 24 עד 48 שעות, ב-UTC, ונותן אותו מועד עדכון לגילים ולערים. הנתונים מגיעים מ-TikTok Analytics, שהבעלים מפעיל באפליקציה אחרי פרסום הסרטון הראשון, ונתונים מלפני כן אינם זמינים. TikTok מבסס את הדמוגרפיה על כמה גורמים, כולל מה שהמשתמשים כותבים בפרופילים שלהם.

במה נתוני העוקבים שונים מהצופים בסרטון?

הם מתארים אנשים שונים. הרשימות של החשבון מכסות את העוקבים. /business/video/list/ מחזיר פילוחים של האנשים שצפו בפוסט אחד: audience_genders, audience_countries וכן audience_cities, עד 10 ערכים לכל אחד מהם, וכן audience_types, שמחלק את הצופים לחדשים וחוזרים ולעוקבים ולא-עוקבים. אלה דורשים את ההרשאה video.insights במקום user.insights.

איך easyCoexistence קורא אותם?

עם get_social_insights על החשבון: משאירים את object_id בחוץ, מפרטים את שמות השדות בשדה metrics, ומעבירים start_date וכן end_date בשדה params כשרוצים audience_activity לימים מסוימים. הכלי מחזיר את הרשימות של TikTok כפי שהן, כך שהשיעורים והשעות נקראים בדיוק כמו שלמעלה.

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

טעויות נפוצות

  • ציפייה לפילוחים בחשבון קטן. TikTok מחזיר שיעורי גיל, מגדר, מדינה ועיר מ-100 עוקבים, והדוגמה שלו לחשבון עם 13 עוקבים מראה את הרשימות ריקות.
  • קריאת שעות audience_activity כשעון מקומי. TikTok מדווח עליהן ב-UTC+0, ולכן מזיזים אותן לאזור הזמן של הקהל לפני תכנון פוסטים.
  • לראות בנתוני העוקבים נתוני צופים. הרשימות של החשבון מתארות את העוקבים; audience_countries של הסרטון מתאר את האנשים שצפו בו.
  • ציפייה לשדה audience_activity בחשבון אישי. TikTok מחזיר אותו לחשבונות עם Advanced Access או Verified Business Accounts שיש להם 100 עוקבים לפחות.
עושים את זה עם EasyCoexistence

US$ 9 עד US$ 0.75 לחיבור בחודש, יורד ככל שמוסיפים חיבורים, עם 3 הימים הראשונים בחינם.

שאלות נפוצות

האם ה-API של TikTok יכול להראות את הגיל והמגדר של העוקבים שלי?

כן. GET /business/get/ מחזיר את audience_ages ואת audience_genders, שיעורי עוקבים לכל קבוצה, כשלחשבון יש 100 עוקבים לפחות והאסימון כולל את ההרשאה user.insights.

אילו קבוצות גיל משתמש ה-API של TikTok?

18-24, 25-34, 35-44, 45-54 ו-55+, וכל אחת עם שיעור העוקבים שנמצאים בה.

האם ה-API של TikTok אומר מתי העוקבים שלי פעילים?

audience_activity נותן את העוקבים הפעילים ב-TikTok בכל שעה, ב-UTC+0, בתוך המדדים של כל יום, לחשבונות עם Advanced Access או Verified Business Accounts ו-100 עוקבים ומעלה.

איך ה-API של TikTok מחזיר את מדינות העוקבים?

כקודי מדינה או אזור לפי ISO 3166-1 alpha-2 בשדה audience_countries, וכל אחד עם שיעור העוקבים משם.

המשיכו לקרוא

מחברים את הערוץ הראשון שלכם תוך שתי דקות.

בלי לחכות לאישורים של הפלטפורמות. מחברים את WhatsApp, Instagram, TikTok או ערוץ אחר, מבקשים מה-AI לפרסם, להשיב או להפיק דוח, ורואים אותו עובד.

  • 3 ימי ניסיון חינם
  • ביטול בכל עת
  • רק ממשקי API רשמיים
  • ניטור 24/7

נבדק ב-