API ద్వారా TikTok మెన్షన్లు: ఖాతాను మెన్షన్ చేసే పోస్ట్లు మరియు కామెంట్లను కనుగొనడం
వ్యాపారాల కోసం TikTok API లో భాగమైన TikTok Mentions API, GET /business/mention/video/list/ ద్వారా ఖాతాను క్యాప్షన్లో @ తో మెన్షన్ చేసే గత 90 రోజుల టాప్ 1,000 పబ్లిక్ పోస్ట్లను, మరియు /business/mention/comment/list/ ద్వారా దాన్ని మెన్షన్ చేసే టాప్ 1,000 కామెంట్లు లేదా రిప్లైలను ఇస్తుంది. రెండింటికీ biz.brand.insights స్కోప్, మరియు Advanced Access లేదా ధృవీకరించబడిన వ్యాపార ఖాతా ఉన్న ఖాతా అవసరం.
easyCoexistence వ్యాపారాల కోసం TikTok API ద్వారా TikTok ఖాతాను కనెక్ట్ చేస్తుంది: Claude, ChatGPT లేదా మీ స్వంత కోడ్ ప్రత్యేక టూల్స్తో కామెంట్లను చదివి వాటికి రిప్లై ఇవ్వగలవు మరియు కామెంట్ ఈవెంట్లను వచ్చిన వెంటనే స్వీకరించగలవు, మరియు get_social_credentials ఇతర API for Business కాల్ల కోసం మీ స్వంత కోడ్కు టోకెన్ను ఇస్తుంది, TikTok తెరిచిన చోట Mentions ఎండ్పాయింట్లు కూడా కలిపి.
/business/mention/video/list/ ద్వారా అందే అత్యధికంగా మెన్షన్ చేసిన పోస్ట్లు, అన్నీ పబ్లిక్గా ఉండి గత 90 రోజుల నుండి, ఒక్కో అభ్యర్థనకు 100 వరకు.
మెన్షన్ చేసిన సమయం నుండి Mentions API లో అది అందుబాటులోకి వచ్చే సుమారు ఆలస్యం.
ఒక వినియోగదారు క్యాప్షన్ లేదా కామెంట్లో వ్యాపారాన్ని మెన్షన్ చేసిన తర్వాత Mentions వెబ్హుక్ కోసం TikTok ఇచ్చే లేటెన్సీ.
UTC 0 నుండి 7 am వరకు జరిగే రిఫ్రెష్ తర్వాత, ప్రతి ఖాతాకు ప్రతి Mentions ఎండ్పాయింట్ను TikTok ఎంత తరచుగా పిలవమని సిఫార్సు చేస్తుంది.
/business/mention/comment/list/ కు biz.brand.insights తో పాటు అవసరమైన స్కోప్, ఖాతాను మెన్షన్ చేసే కామెంట్లను తిరిగి ఇవ్వడానికి.
ఏ ఎండ్పాయింట్లు Mentions API లో ఉన్నాయి?
ఆరు రీడ్ ఎండ్పాయింట్లు, ప్రతి ఒక్కటీ https://business-api.tiktok.com/open_api/v1.3 పై GET, ఖాతా యాక్సెస్ టోకెన్ను Access-Token హెడర్లో, దాని open_id ను business_id గా పంపుతారు. రెండు మెన్షన్లను జాబితా చేస్తాయి, రెండు మెన్షన్ చేసిన పోస్ట్లు ఏమి చెబుతున్నాయో సారాంశం ఇస్తాయి, మరియు రెండు వెబ్హుక్ ప్రకటించిన ఒక్క మెన్షన్ను తెస్తాయి:
ఏ పోస్ట్లు మరియు కామెంట్లు మెన్షన్లుగా లెక్కించబడతాయి?
ఖాతా హ్యాండిల్ను @ తో ట్యాగ్ చేసేవి, పోస్ట్ క్యాప్షన్లో లేదా కామెంట్ టెక్స్ట్లో, పబ్లిక్ పోస్ట్పై, మరియు TikTok యొక్క ఇతర ఫిల్టర్లను దాటేవి:
- పోస్ట్ గత 90 రోజులలో ప్రచురితమైంది.
- దాని రచయిత మైనర్ కాదు లేదా వయసు తెలియనిది కాదు: యూరప్లో 17 లేదా అంతకంటే తక్కువ మైనర్గా, US మరియు ఇతర ప్రాంతాల్లో 12 లేదా అంతకంటే తక్కువ మైనర్గా లెక్కిస్తారు.
- ఆ హ్యాండిల్ను మెన్షన్ చేసే అత్యధికంగా ఇష్టపడిన 1,000 పోస్ట్లు లేదా కామెంట్లలో ఒకటి.
- వ్యాపారం యొక్క స్వంత పోస్ట్లు ఈ నియమాలకు సరిపోతే అవి కూడా లెక్కించబడతాయి.
- మెన్షన్ మాత్రమే ఉండి వేరే టెక్స్ట్ లేని కామెంట్లకు ర్యాంక్ తక్కువ ఇవ్వబడుతుంది.
ఖాతా వాటిని ఉపయోగించే ముందు ఏమి కావాలి?
అర్హత గల ఖాతా, సరైన అనుమతి ఉన్న యాప్, టోకెన్పై స్కోప్లు, మరియు యజమాని యాప్కు అనుమతి ఇచ్చిన తర్వాత ఒక రోజు వేచి ఉండటం:
- Advanced Access లేదా ధృవీకరించబడిన వ్యాపార ఖాతా; /business/get/ పై
has_advanced_accessఏ ఖాతాలు అర్హత గలవో చూపుతుంది. - డెవలపర్ యాప్పై Mentions అనుమతి; పోస్ట్లకు Mentions, Content మరియు కామెంట్లకు Mentions, Comment గా జాబితా చేయబడుతుంది.
- యాక్సెస్ టోకెన్పై biz.brand.insights, అలాగే కామెంట్ మెన్షన్లకు comment.list.
- మొదటి పుల్కు ముందు అనుమతి ఇచ్చిన తర్వాత 24 గంటలు, TikTok యొక్క గెట్టింగ్-స్టార్టెడ్ గైడ్ కోరినట్లు.
ఖాతాను మెన్షన్ చేసే పోస్ట్లను ఎలా జాబితా చేయాలి?
GET /business/mention/video/list/ తో. fields డేటాను ఎంచుకుంటుంది: డిఫాల్ట్గా item_id మరియు caption, అభ్యర్థనపై create_time, video_link, likes, comments, shares, thumbnail_url, views, reach మరియు creator_handle_name కూడా. sort_field CREATE_TIME, LIKES, COMMENTS లేదా SHARES తీసుకుంటుంది, sort_type ASC లేదా DESC తో. number_of_days 90 రోజులను తగ్గిస్తుంది, regions ఎంచుకున్న ప్రాంతాల క్రియేటర్లను ఉంచుతుంది, cursor మరియు has_more ఉపయోగించి ఫలితాలను పేజీల వారీగా తీసుకోవచ్చు. views మరియు reach 1,000 కంటే తక్కువ ఉంటే null గా ఉంటాయి, థంబ్నెయిల్ లింక్లు 48 గంటలు పని చేస్తాయి:
curl --get 'https://business-api.tiktok.com/open_api/v1.3/business/mention/video/list/' \
-H 'Access-Token: <ACCESS_TOKEN>' \
--data-urlencode 'business_id=<OPEN_ID>' \
--data-urlencode 'fields=["item_id","video_link","caption","likes","creator_handle_name"]' \
--data-urlencode 'sort_field=LIKES' \
--data-urlencode 'number_of_days=30' \
--data-urlencode 'max_count=100'
{
"code": 0,
"message": "OK",
"request_id": "<REQUEST_ID>",
"data": {
"videos": [
{
"item_id": "<ITEM_ID>",
"video_link": "https://www.tiktok.com/@/video/<ITEM_ID>",
"caption": "<CAPTION>",
"likes": 243,
"creator_handle_name": "<HANDLE>"
}
],
"cursor": 100,
"has_more": true
}
}ఖాతాను మెన్షన్ చేసే కామెంట్లను ఎలా జాబితా చేయాలి?
GET /business/mention/comment/list/ తో, దీని టోకెన్కు comment.list కూడా కావాలి. డిఫాల్ట్గా comment_id మరియు comment_text ఇస్తుంది; item_id, video_link, caption, video_likes, thumbnail_url, commenter_display_name, comment_type, comment_create_time మరియు comment_likes అభ్యర్థనపై వస్తాయి, మరియు comment_type COMMENT లేదా REPLY గా ఉంటుంది. max_count 100 వరకు కోరితే తప్ప ఒక పేజీలో 10 ఉంటాయి; VIDEO_LIKES, COMMENT_CREATE_TIME లేదా COMMENT_LIKES ప్రకారం క్రమబద్ధీకరిస్తారు. TikTok యొక్క ట్రస్ట్ అండ్ సేఫ్టీ విధానాల వల్ల, has_more ఇంకా true గా ఉన్నా పేజీ తక్కువ ఫలితాలతో రావచ్చు.
మెన్షన్కు రిప్లై ఎలా ఇవ్వాలి?
TikTok యొక్క కామెంట్ రిప్లై ఎండ్పాయింట్ ద్వారా. POST /business/comment/reply/create/ business_id, కామెంట్ మెన్షన్ నుండి item_id ను video_id గా, comment_id, మరియు 1,200 అక్షరాల వరకు text తీసుకుంటుంది; రిప్లై ఆ కామెంట్ కింద పబ్లిక్గా కనిపిస్తుంది, దాన్ని కలిగి ఉన్న ఏ పోస్ట్పైనైనా. TikTok రిఫరెన్స్ దీనికి comment.list.manage స్కోప్ మరియు అదే ఖాతా అవసరాన్ని పేర్కొంటుంది. దాని Mentions రిఫరెన్స్ కేవలం కామెంట్ మెన్షన్లకు మాత్రమే రిప్లై ఉందని జాబితా చేస్తుంది.
మెన్షన్లు వెబ్హుక్ ద్వారా రాగలవా?
అవును. Mentions అనుమతితో, యాప్ event_type BRAND_MENTION తో POST /business/webhook/update/ ను పిలుస్తుంది, ఆపై మెన్షన్ జరిగిన రెండు లేదా మూడు గంటలలోపు TikTok brand.mention.event ను పంపుతుంది, దాని ఇతర వెబ్హుక్ల లాగే Tiktok-Signature తో సంతకం చేయబడి. content అనేది క్రమబద్ధీకరించిన JSON స్ట్రింగ్, దీనిలో ఇవి ఉంటాయి:
type_of_event: CREATE, EDIT, లేదాPRIVACY_CHANGE, పోస్ట్ గోప్యతా సెట్టింగ్లలో మార్పు కోసం.mention_type: కామెంట్ లేదా రిప్లై కోసం COMMENT, క్యాప్షన్ కోసంVIDEO_MENTION, ఇక్కడcomment_id0 గా ఉంటుంది.video_id,video_create_time,share_urlమరియుvideo_caption, ఇవి పోస్ట్ను వివరిస్తాయి.open_id_of_mentioned_user,unique_name_of_mentioned_user, మరియుunique_identifier, ఇది APIల అంతటా ఒకేలా ఉండే కామెంటర్ ID.- వివరాలు ఈవెంట్ జరిగిన 48 గంటలలోపు /business/mention/video/get/ లేదా /business/mention/comment/get/ నుండి వస్తాయి.
Mentions ఎండ్పాయింట్లను ఎంత తరచుగా పిలవాలి?
ప్రతి ఎండ్పాయింట్కు, ప్రతి ఖాతాకు రోజుకు ఒకసారి, 7 am UTC తర్వాత, ఇది TikTok యొక్క సలహా. ఎండ్పాయింట్లు డెవలపర్ యాప్ యొక్క గ్లోబల్ రేట్ లిమిట్లను పంచుకుంటాయి, కానీ TikTok అర్ధరాత్రి నుండి ఉదయం 7 am UTC మధ్య మునుపటి రోజు డేటాను రిఫ్రెష్ చేస్తుంది, మరియు అదే రోజులో మరిన్ని పుల్లు అనవసరమని పిలుస్తుంది. కొత్త మెన్షన్ జాబితా ఎండ్పాయింట్లకు చేరడానికి సుమారు 24 నుండి 48 గంటలు పడుతుంది, అందువల్ల వెబ్హుక్ వేగవంతమైన సిగ్నల్.
బ్రాండ్ హ్యాష్ట్యాగ్లు ఎలా పని చేస్తాయి?
అవి వ్యాపారం ఎంచుకున్న హ్యాష్ట్యాగ్లను ఉపయోగించే పోస్ట్లకు మెన్షన్లను విస్తరిస్తాయి. POST /business/mention/hashtag/add/ ప్రతి అభ్యర్థనకు 10 హ్యాష్ట్యాగ్లను, ప్రతి ఖాతాకు 50 వరకు ప్రారంభిస్తుంది; ఇవి /business/mention/hashtag/verify/list/ సూచించే 100 వరకు నుండి తీసుకోబడతాయి లేదా పూర్తి హ్యాండిల్ కలిగి ఉంటాయి, @TikTok కోసం #drinktiktok లాగా. ప్రారంభించిన హ్యాష్ట్యాగ్ను ఏడు రోజుల పాటు తొలగించలేరు, మరియు దాని పోస్ట్లు ప్రారంభించిన 24 గంటల తర్వాత /business/mention/hashtag/video/list/ లో కనిపిస్తాయి.
easyCoexistence TikTok మెన్షన్లతో ఏమి చేయగలదు?
మీ స్వంత కోడ్కు ఖాతా టోకెన్ను అందించండి: get_social_credentials business/ కింద ఉన్న వ్యాపారాల కోసం API మార్గాలకు టోకెన్ మరియు business_id ను ఇస్తుంది, వాటిలో business/mention/ కూడా ఉంటుంది. ఖాతా మరియు యాప్ పైన పేర్కొన్న అవసరాలను తీర్చినప్పుడు TikTok సమాధానం ఇస్తుంది. మెన్షన్ వెబ్హుక్లు దాని బయటే ఉంటాయి: easyCoexistence తన యాప్ను కేవలం కామెంట్ ఈవెంట్లకు మాత్రమే సబ్స్క్రైబ్ చేస్తుంది మరియు business/webhook/ మార్గాలను తనకే ఉంచుకుంటుంది, కాబట్టి BRAND_MENTION ఈవెంట్లు ఫార్వార్డ్ కావు. ఖాతా స్వంత పోస్ట్లపై కామెంట్లు, మెన్షన్లతో సహా, ఇంకా comment.update ఈవెంట్లుగా వస్తాయి, వాటిని set_social_webhook_destination ఫార్వార్డ్ చేస్తుంది:
GET https://business-api.tiktok.com/open_api/v1.3/business/mention/comment/list/
?business_id=<BUSINESS_ID>
&fields=["item_id","comment_id","comment_text","commenter_display_name","comment_type"]
&sort_field=COMMENT_CREATE_TIME&max_count=50
Access-Token: <ACCESS_TOKEN>
POST https://business-api.tiktok.com/open_api/v1.3/business/comment/reply/create/
Access-Token: <ACCESS_TOKEN>
{ "business_id": "<BUSINESS_ID>", "video_id": "<ITEM_ID>", "comment_id": "<COMMENT_ID>", "text": "Thanks for the mention!" }సాధారణ పొరపాట్లు
- Advanced Access లేని ఖాతా కోసం Mentions ఎండ్పాయింట్లను పిలవడం. TikTok వాటిని Advanced Access లేదా ధృవీకరించబడిన వ్యాపార ఖాతా ఉన్న ఖాతాలకు అందిస్తుంది, ఇది /business/get/ పై has_advanced_access చూపుతుంది.
- అర్ధరాత్రి UTC తర్వాత వెంటనే మెన్షన్లను పుల్ చేయడం. TikTok అర్ధరాత్రి నుండి ఉదయం 7 am UTC మధ్య మునుపటి రోజు డేటాను రిఫ్రెష్ చేస్తుంది, కాబట్టి 7 am తర్వాత చేసిన పుల్ మొత్తం రోజును చూస్తుంది.
- comment_id 0 ను కామెంట్గా చదవడం. మెన్షన్ వెబ్హుక్లో ఇది అర్థం, మెన్షన్ పోస్ట్ క్యాప్షన్లో ఉంది, mention_type VIDEO_MENTION తో.
- పరీక్ష కోసం బ్రాండ్ హ్యాష్ట్యాగ్ను ప్రారంభించడం. TikTok ప్రారంభించిన హ్యాష్ట్యాగ్ను తొలగించడానికి ముందు ఏడు రోజులు ఉంచుతుంది, మరియు అది ఖాతా యొక్క 50 లో లెక్కించబడుతుంది.
ప్రతి కనెక్షన్కు నెలకు US$ 9 నుండి US$ 0.75 వరకు, ఎక్కువ కనెక్షన్లు జోడిస్తే తగ్గుతుంది, మొదటి 3 రోజులు ఉచితం.
తరచుగా అడిగే ప్రశ్నలు
TikTok API నా ఖాతాను మెన్షన్ చేసే పోస్ట్లను కనుగొనగలదా?
అవును, క్యాప్షన్లో దాని హ్యాండిల్ను @ తో మెన్షన్ చేసేవి. /business/mention/video/list/ గత 90 రోజుల నుండి 1,000 వరకు పబ్లిక్ పోస్ట్లను ఇస్తుంది, ప్రతి క్రియేటర్ను creator_handle_name తో పేర్కొంటుంది.
ప్రైవేట్ TikTok పోస్ట్లు మెన్షన్లుగా లెక్కించబడతాయా?
లేదు. Mentions API గత 90 రోజుల పబ్లిక్ పోస్ట్లను మాత్రమే లెక్కిస్తుంది, మైనర్ లేదా వయసు తెలియని రచయితలను వదిలేస్తుంది: యూరప్లో 17 లేదా అంతకంటే తక్కువ, US మరియు ఇతర ప్రాంతాల్లో 12 లేదా అంతకంటే తక్కువ.
TikTok మెన్షన్ కనిపించడానికి ఎంత సమయం పడుతుంది?
జాబితా ఎండ్పాయింట్ల ద్వారా సుమారు 24 నుండి 48 గంటలు, మెన్షన్ వెబ్హుక్ ద్వారా రెండు లేదా మూడు గంటల వరకు.
నా TikTok ఖాతా మెన్షన్ అయినప్పుడు easyCoexistence నన్ను హెచ్చరించగలదా?
ఫార్వార్డ్ చేసిన ఈవెంట్గా కాదు, ఎందుకంటే అది TikTok కామెంట్ ఈవెంట్లను ఫార్వార్డ్ చేస్తుంది, మెన్షన్ ఈవెంట్లను కాదు. ఖాతా అర్హత పొందినప్పుడు మీ స్వంత కోడ్ get_social_credentials నుండి వచ్చిన టోకెన్తో అభ్యర్థనపై మెన్షన్లను చదవగలదు.
చదవడం కొనసాగించండి
మీ మొదటి ఛానెల్ను రెండు నిమిషాల్లో కనెక్ట్ చేయండి.
ప్లాట్ఫామ్ సమీక్షల కోసం ఎదురుచూడాల్సిన అవసరం లేదు. WhatsApp, Instagram, TikTok లేదా మరో ఛానెల్ను కనెక్ట్ చేయండి, ఆపై పోస్ట్ చేయమని, ప్రత్యుత్తరం ఇవ్వమని లేదా రిపోర్ట్ ఇవ్వమని మీ AIకి చెప్పండి, అది పని చేయడం చూడండి.
- 3 రోజులు ఉచితం
- ఎప్పుడైనా రద్దు చేయండి
- అధికారిక APIలు మాత్రమే
- 24/7 పర్యవేక్షణ
ధృవీకరించిన తేదీ