API හරහා TikTok ප්රේක්ෂක ජනවිකාශන
TikTok හි API for Business මගින් GET /business/get/ වෙතින් TikTok ගිණුමක අනුගාමික ජනවිකාශන ලැබේ: audience_ages, audience_genders, audience_countries සහ audience_cities. ඒ සෑම එකක්ම අනුගාමිකයන්ගේ කොටස් ලැයිස්තුවකි, අනුගාමික 100ක් හෝ ඊට වැඩි ගිණුම් සඳහා. සෑම දිනකම metrics තුළ audience_activity ලෙස පැය අනුව අනුගාමික ක්රියාකාරිත්වය ලැබේ, Advanced Access හෝ Verified Business Accounts ඇති සහ එකම අනුගාමික 100 ඇති ගිණුම් සඳහා. මේ සියලු ක්ෂේත්ර සඳහා user.insights scope අවශ්යයි.
easyCoexistence, Claude, ChatGPT හෝ ඔබේ තමන්ගේ කේතයෙන්, get_social_insights මගින් TikTok ගිණුමක අනුගාමික ජනවිකාශන කියවයි.
TikTok විසින් වයස, ලිංගය, රට සහ නගර බෙදීම් ලබා දීමට පෙර ගිණුමට අවශ්ය අනුගාමිකයන් ගණන.
audience_ages හි වයස් කාණ්ඩ: 18-24, 25-34, 35-44, 45-54 සහ 55+.
audience_activity හි කාල කලාපය, TikTok මත ක්රියාකාරී අනුගාමිකයන්ගේ පැය අනුව ගණන.
audience_countries, audience_genders සහ audience_activity සඳහා සාමාන්ය ප්රමාදය; TikTok මේවා නොබැඳි ලෙස ගණනය කරයි.
ගිණුම් endpoint එක මගින් කුමන ජනවිකාශන ලැබේද?
fields හි ක්ෂේත්ර නම් සඳහන් කළ විට GET /business/get/ ඒවා ලබා දෙයි. බෙදීම් හතර 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 ලබා දෙයි:
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'ප්රතිචාරය කෙසේ පෙනේද?
සෑම බෙදීමක්ම කණ්ඩායමක් එහි ප්රතිශතය සමඟ යුගල කරන objects ලැයිස්තුවකි. metrics හි සෑම දිනකම එහි දිනය සහ පැය ලැයිස්තුවක් වන audience_activity ඇත. පහත අගයන් TikTok හි තමන්ගේ උදාහරණ වන අතර, ලිංග ලැයිස්තුවට සහ පැය කිහිපයකට කපා ඇත:
{
"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ක් හෝ ඊට වැඩි වූ පසු ලැබේ. අනුගාමික 13ක ගිණුමක් සඳහා TikTok හි තමන්ගේ උදාහරණය එම ලැයිස්තු හිස් ලෙස පෙන්වයි. audience_activity ද අනුගාමික 100ක් අවශ්ය කරයි, ඊට අමතරව Advanced Access ඇති ගිණුමක් අවශ්ය වේ. එය TikTok for Business ගිණුමකට සම්බන්ධ කිරීමෙන්, සත්යාපනය නොකළ Business Center එකකින් හෝ Verified Business Account එකකින් ලැබේ. මේ සියලු ක්ෂේත්රවලට token එකේ user.insights scope අවශ්යයි.
ජනවිකාශන කොතරම් නවීනද?
දින එකක් හෝ දෙකක් පසුපසින්. TikTok විසින් audience_countries, audience_genders සහ audience_activity සාමාන්යයෙන් පැය 24 සිට 48 දක්වා පසුපසින් පවතින ක්ෂේත්ර ලෙස ලැයිස්තුගත කරයි, UTC හි. ages සහ cities සඳහා ද එම යාවත්කාලීන වේලාව දෙයි. අගයන් ලැබෙන්නේ TikTok Analytics වලින්. හිමිකරු යෙදුමේ පළමු වීඩියෝව පළ කිරීමෙන් පසු එය ක්රියාත්මක කරයි, ඊට පෙර දත්ත ලැබිය නොහැක. TikTok ජනවිකාශන පදනම් කරගන්නේ පරිශීලකයන් ඔවුන්ගේ පැතිකඩේ ඇතුළත් කරන දේ ඇතුළු සාධක කිහිපයක් මතයි.
අනුගාමික ජනවිකාශන වීඩියෝවක නරඹන්නන්ගෙන් කෙසේ වෙනස්ද?
ඒවා විවිධ පුද්ගලයන් විස්තර කරයි. ගිණුම් ලැයිස්තු අනුගාමිකයන් ආවරණය කරයි. /business/video/list/ මගින් එක පළ කිරීමක් නැරඹූ පුද්ගලයන්ගේ බෙදීම් ලැබේ: audience_genders, audience_countries සහ audience_cities, සෑම එකක්ම අයිතම 10 දක්වා, සහ audience_types. audience_types මගින් නරඹන්නන් නව සහ නැවත පැමිණි, අනුගාමිකයන් සහ අනුගාමික නොවන අය ලෙස බෙදයි. ඒවාට user.insights වෙනුවට video.insights scope අවශ්යයි.
easyCoexistence ඒවා කියවන්නේ කෙසේද?
ගිණුම මත get_social_insights සමඟ: object_id ඉවත් කරන්න, ක්ෂේත්ර නම් metrics ලෙස ලැයිස්තුගත කරන්න, සහ විශේෂිත දින සඳහා audience_activity අවශ්ය විට params හි start_date සහ end_date ලබා දෙන්න. එය TikTok ලැයිස්තු ඒවා තිබෙන ආකාරයටම ආපසු දෙයි, එබැවින් කොටස් සහ පැය ඉහත ආකාරයටම කියවේ.
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ක් හෝ ඊට වැඩි ගිණුම් සඳහා පමණි.
audience_ages, audience_genders, audience_countries, audience_cities හෝ audience_activity ඉල්ලන්න, එය TikTok ලැයිස්තු ඒවා තිබෙන ආකාරයටම ලබා දෙයි. සම්බන්ධතාවයකට මාසිකව US$ 9 සිට US$ 0.75 දක්වා, සම්බන්ධතා එකතු කරන විට පහළ යයි, පළමු දින 3 නොමිලේ.
නිතර අසන ප්රශ්න
TikTok API මගින් මගේ අනුගාමිකයන්ගේ වයස සහ ලිංගය පෙන්විය හැකිද?
ඔව්. /business/get/ මගින් audience_ages සහ audience_genders ලබා දෙයි, සෑම කාණ්ඩයකම අනුගාමිකයන්ගේ කොටස්. මෙය ගිණුමට අනුගාමික 100ක් හෝ ඊට වැඩි වූ පසු සහ token එකට 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 රට හෝ කලාප කේත ලෙස, සෑම එකක් සමඟම එතැනින් එන අනුගාමිකයන්ගේ කොටස සමඟ.
තවදුරටත් කියවන්න
ඔබේ පළමු channel එක මිනිත්තු දෙකකින් සම්බන්ධ කරන්න.
වේදිකා සමාලෝචන සඳහා බලා සිටීමට අවශ්ය නැත. WhatsApp, Instagram, TikTok හෝ වෙනත් channel එකක් සම්බන්ධ කර, පසුව ඔබේ AI හට පළ කිරීමට, ප්රතිචාර දැක්වීමට හෝ වාර්තා කිරීමට පවසා එය වැඩ කරන ආකාරය බලන්න.
- දින 3ක් නොමිලේ
- ඕනෑම වේලාවක අවලංගු කරන්න
- නිල API පමණි
- 24/7 නිරීක්ෂණය කෙරේ
සත්යාපනය කළේ