लॉग इनमुफ़्त ट्रायल शुरू करें
easyCoexistence आधिकारिक एपीआई

एपीआई के ज़रिए TikTok दर्शक डेमोग्राफ़िक्स

TikTok का API for Business GET /business/get/ से फ़ॉलोअर डेमोग्राफ़िक्स लौटाता है: audience_ages, audience_genders, audience_countries और audience_cities, जिनमें से हर एक फ़ॉलोअर के हिस्सों की सूची है, उन खातों के लिए जिनके कम से कम 100 फ़ॉलोअर हों। हर दिन की metrics में audience_activity के रूप में हर घंटे की फ़ॉलोअर गतिविधि आती है, उन खातों के लिए जिनके पास Advanced Access या Verified Business Accounts हों और उतने ही 100 फ़ॉलोअर हों। इन सबके लिए टोकन पर user.insights स्कोप चाहिए।

easyCoexistence Claude, ChatGPT या अपने कोड से get_social_insights के जरिए TikTok खाते के फ़ॉलोअर डेमोग्राफ़िक्स पढ़ता है: 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 array के साथ, और audience_activity वाली दैनिक metrics के लिए UTC में तारीख़ सीमा के साथ। 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'

जवाब कैसा दिखता है?

हर विवरण एक ऐसी सूची है जिसमें हर object एक समूह को उसके हिस्से से जोड़ता है, और metrics का हर दिन अपनी तारीख़ और hours की 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, जो दर्शकों को नए और लौटने वाले, तथा फ़ॉलोअर और गैर-फ़ॉलोअर में बाँटता है। इनके लिए user.insights की जगह video.insights स्कोप चाहिए।

easyCoexistence इन्हें कैसे पढ़ता है?

खाते पर get_social_insights से: object_id छोड़ दें, फ़ील्ड नामों को metrics में सूचीबद्ध करें, और जब किन्हीं ख़ास दिनों के लिए audience_activity चाहिए तो params में start_date और end_date दें। यह 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 दिन मुफ़्त।

अक्सर पूछे जाने वाले सवाल

क्या TikTok API मेरे फ़ॉलोअर की उम्र और लिंग दिखा सकता है?

हाँ। /business/get/ audience_ages और audience_genders लौटाता है, हर समूह में फ़ॉलोअर का हिस्सा, जब खाते के कम से कम 100 फ़ॉलोअर हों और टोकन पर user.insights हो।

TikTok API कौन-से आयु समूह इस्तेमाल करता है?

18-24, 25-34, 35-44, 45-54 और 55+, हर एक में फ़ॉलोअर का हिस्सा।

क्या TikTok API बताता है कि मेरे फ़ॉलोअर कब ऑनलाइन होते हैं?

audience_activity हर घंटे TikTok पर सक्रिय फ़ॉलोअर UTC+0 में, हर दिन की metrics के भीतर देता है, Advanced Access या Verified Business Accounts के लिए जिनके 100 या उससे अधिक फ़ॉलोअर हों।

TikTok API फ़ॉलोअर के देश कैसे देता है?

audience_countries में ISO 3166-1 alpha-2 देश या क्षेत्र कोड के रूप में, हर एक के साथ वहाँ से आए फ़ॉलोअर का हिस्सा।

पढ़ना जारी रखें

एपीआई के ज़रिए TikTok वीडियो मेट्रिक्स: व्यूज़, वॉच टाइम और पूरा देखने की दरTikTok API for Business हर वीडियो के लिए ये मेट्रिक्स लौटाता है: व्यूज़, रीच, वॉच टाइम, पूरा देखने की दर, रिटेंशन, ट्रैफ़िक स्रोत और दर्शकों के देश।TikTok एनालिटिक्स API: अकाउंट इनसाइट्स और वीडियो मेट्रिक्सAPI for Business से मिलने वाले TikTok मेट्रिक्स: किसी अकाउंट के रोज़ के फ़ॉलोअर, व्यूज़ और लाइक, तथा हर वीडियो के व्यूज़, लाइक, कमेंट और शेयर।TikTok API for Business के स्कोप: हर अनुमति क्या खोलती हैTikTok के अपने नामों वाली अनुमतियाँ, जो उसकी Accounts API के साथ काम करती हैं: हर एक क्या खोलती है, हर फ़ील्ड के स्कोप, और टोकन कैसे जाँचें।API के ज़रिए TikTok खाते के वीडियो की सूची/business/video/list/ से TikTok खाते की पोस्ट की सूची: फ़ील्ड, कर्सर पेजिनेशन, प्रति पेज 20 पोस्ट और ID से फ़िल्टर।TikTok API for Business बनाम Content Posting APITikTok का API for Business developers.tiktok.com से अलग क्यों है: कमेंट और उनका वेबहुक, इनसाइट्स, कौन से खाते जुड़ते हैं और टोकन कैसे नवीनीकृत होते हैं।

दो मिनट में अपना पहला चैनल कनेक्ट करें।

किसी प्लैटफ़ॉर्म की समीक्षा का इंतज़ार नहीं। WhatsApp, Instagram, TikTok या कोई और चैनल कनेक्ट करें, फिर अपने AI से पोस्ट करने, जवाब देने या रिपोर्ट बनाने को कहें और उसे काम करते देखें।

  • 3 दिन मुफ़्त
  • कभी भी रद्द करें
  • सिर्फ़ आधिकारिक एपीआई
  • 24/7 निगरानी

इस तारीख को सत्यापित