IngiaAnza kipindi cha majaribio bila malipo
easyCoexistence API rasmi

Kutajwa kwenye TikTok kupitia API: kutafuta machapisho na maoni yanayotaja akaunti

API ya Kutajwa ya TikTok, sehemu ya API for Business, inarudisha machapisho 1,000 ya juu ya umma kutoka siku 90 zilizopita yanayotaja akaunti ya biashara kwa @ katika maelezo yake, kupitia GET /business/mention/video/list/, na maoni au majibu 1,000 ya juu yanayotaja akaunti hiyo, kupitia /business/mention/comment/list/. Zote mbili zinahitaji scope ya biz.brand.insights na akaunti yenye Advanced Access au Verified Business Account.

easyCoexistence huunganisha akaunti ya TikTok kupitia API for Business ya TikTok: Claude, ChatGPT au msimbo wako mwenyewe husoma maoni yake na kuyajibu kwa zana maalumu na hupokea matukio ya maoni yanapofika, na get_social_credentials huipa msimbo wako mwenyewe token kwa simu nyingine za API for Business, ikiwemo endpoints za Mentions pale TikTok inapozifungulia akaunti.

1,000

Machapisho mengi zaidi ambayo /business/mention/video/list/ inarudisha, yote ya umma na kutoka siku 90 zilizopita, hadi 100 kwa ombi.

24 to 48 hours

Ucheleweshaji wa wastani kati ya kutajwa kwa akaunti na kupatikana kupitia Mentions API.

2 to 3 hours

Muda wa kuchelewa ambao TikTok inatoa kwa webhook ya Mentions baada ya mtumiaji kumtaja mfanyabiashara kwenye maelezo au maoni.

Once a day

Mara ambazo TikTok inapendekeza kuita kila endpoint ya Mentions kwa kila akaunti, baada ya kusasishwa kwa data kati ya usiku wa manane na 7 am UTC.

comment.list

Scope ya /business/mention/comment/list/ inahitaji, pamoja na biz.brand.insights, ili kurudisha maoni yanayotaja akaunti.

Ni endpoints gani ambazo Mentions API inazo?

Endpoints sita za kusoma, kila moja ni GET kwenye https://business-api.tiktok.com/open_api/v1.3 ikiwa na access token ya akaunti kwenye header ya Access-Token na open_id yake kama business_id. Mbili zinaorodhesha kutajwa, mbili zinafupisha kile machapisho yaliyotajwa yanasema, na mbili zinachukua kutajwa moja ambalo webhook ilitangaza:

/business/mention/video/list/Up to 1,000 posts whose caption mentions the account, 100 a page
/business/mention/comment/list/Up to 1,000 comments or replies whose text mentions the account
/business/mention/top_word/list/The 20 keywords that appear most in mentioned posts' captions
/business/mention/top_hashtag/list/The 20 hashtags used most in those captions
/business/mention/video/get/One mentioned post from a webhook event, within 48 hours
/business/mention/comment/get/One comment mention from a webhook event, within 48 hours

Ni machapisho na maoni gani yanahesabika kama kutajwa?

Yale yanayotaja jina la mtumiaji la akaunti kwa @, katika maelezo ya chapisho au maandishi ya maoni, kwenye chapisho la umma, na yanayopita vichujio vingine vya TikTok:

  • Chapisho limechapishwa ndani ya siku 90 zilizopita.
  • Mwandishi wake si mtoto wala ana umri usiojulikana: umri wa 17 au chini unahesabika kama mtoto barani Ulaya, na 12 au chini nchini Marekani na maeneo mengine.
  • Ni miongoni mwa machapisho au maoni 1,000 yaliyopendwa zaidi yanayotaja jina hilo la mtumiaji.
  • Machapisho ya biashara yenyewe yanayokidhi sheria hizi nayo yanahesabika.
  • Maoni yaliyo na kutaja pekee, bila maandishi mengine, yanapangwa chini zaidi.

Akaunti inahitaji nini kabla ya kuvitumia?

Akaunti inayostahili, programu yenye ruhusa sahihi, scope kwenye token, na kusubiri siku moja baada ya mmiliki kuidhinisha programu:

  • Advanced Access au Verified Business Account; has_advanced_access kwenye /business/get/ inaonyesha akaunti zinazostahili.
  • Ruhusa ya Mentions kwenye programu ya msanidi, iliyoorodheshwa kama Mentions, Content kwa machapisho na Mentions, Comment kwa maoni.
  • biz.brand.insights kwenye access token, pamoja na comment.list kwa kutajwa kwenye maoni.
  • Saa 24 baada ya idhini kabla ya kuvuta data ya kwanza, kama mwongozo wa kuanza wa TikTok unavyoelekeza.

Unaorodheshaje machapisho yanayotaja akaunti?

Kwa GET /business/mention/video/list/. fields huchagua data, item_id na caption kwa chaguo-msingi, pamoja na create_time, video_link, likes, comments, shares, thumbnail_url, views, reach na creator_handle_name ukiomba. sort_field inakubali CREATE_TIME, LIKES, COMMENTS au SHARES pamoja na sort_type ASC au DESC, number_of_days hupunguza siku 90, regions huchuja waundaji kutoka maeneo uliyochagua, na cursor pamoja na has_more hupitia matokeo kurasa kwa kurasa. views na reach husomeka null chini ya 1,000, na viungo vya thumbnail hudumu saa 48:

Mentioned posts, sorted by likes
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
  }
}

Unaorodheshaje maoni yanayotaja akaunti?

Kwa GET /business/mention/comment/list/, ambayo token yake pia inahitaji comment.list. Kwa chaguo-msingi hurudisha comment_id na comment_text; item_id, video_link, caption, video_likes, thumbnail_url, commenter_display_name, comment_type, comment_create_time na comment_likes huja ukiomba, na comment_type husomeka COMMENT au REPLY. Ukurasa mmoja una maoni 10 isipokuwa max_count ikiomba hadi 100, yakipangwa kwa VIDEO_LIKES, COMMENT_CREATE_TIME au COMMENT_LIKES. Kwa sababu ya sera za uaminifu na usalama za TikTok, ukurasa unaweza kurudi na maoni machache wakati has_more bado ni true.

Unajibuje kutajwa?

Kupitia endpoint ya kujibu maoni ya TikTok. POST /business/comment/reply/create/ inachukua business_id, video_id iliyowekwa sawa na item_id kutoka kwenye kutajwa kwa maoni, comment_id na text ya hadi herufi 1,200, na jibu linaonekana hadharani chini ya maoni hayo, kwenye chapisho linalobeba maoni hayo. Rejeleo la TikTok linataja scope ya comment.list.manage na sharti hilo hilo la akaunti. Rejeleo lake la Mentions linaorodhesha jibu kwa kutajwa kwa maoni pekee.

Je, kutajwa kunaweza kufika kupitia webhook?

Ndiyo. Kwa ruhusa ya Mentions, programu huita POST /business/webhook/update/ yenye event_type BRAND_MENTION, kisha TikTok hutuma brand.mention.event ndani ya saa mbili au tatu baada ya kutajwa, ikitiwa saini kwenye Tiktok-Signature kama webhook zake nyingine. content ni JSON string iliyopangwa, ikiwa na:

  • type_of_event: CREATE, EDIT, au PRIVACY_CHANGE kwa mabadiliko ya mpangilio wa faragha wa chapisho.
  • mention_type: COMMENT kwa maoni au jibu, VIDEO_MENTION kwa maelezo ya chapisho, ambapo comment_id husomeka 0.
  • video_id, video_create_time, share_url na video_caption, zinazoelezea chapisho.
  • open_id_of_mentioned_user, unique_name_of_mentioned_user, na unique_identifier, kitambulisho cha mtoa maoni kinachobaki sawa katika API zote.
  • Maelezo zaidi hupatikana kutoka /business/mention/video/get/ au /business/mention/comment/get/, ndani ya saa 48 baada ya tukio.

Endpoints za Mentions zinapaswa kuitwa mara ngapi?

Mara moja kwa siku kwa kila endpoint na akaunti, baada ya 7 am UTC, ndicho ushauri wa TikTok. Endpoints zinashiriki kikomo cha kiwango cha programu ya msanidi, lakini TikTok husasisha data ya siku iliyopita kati ya usiku wa manane na 7 am UTC, na kuvuta data tena ndani ya siku hiyo hakuhitajiki. Kutajwa kipya pia huchukua takriban saa 24 hadi 48 kufika kwenye endpoints za orodha, jambo linalofanya webhook kuwa ishara ya haraka zaidi.

Hashtag za chapa zinafanyaje kazi?

Zinapanua kutajwa hadi machapisho yanayotumia hashtag ambazo biashara imechagua. POST /business/mention/hashtag/add/ huwezesha hadi hashtag 10 kwa ombi na 50 kwa akaunti, zinazochukuliwa kutoka hadi 100 ambazo /business/mention/hashtag/verify/list/ inapendekeza, au zenye jina kamili la mtumiaji, kama #drinktiktok kwa @TikTok. Hashtag iliyowezeshwa haiwezi kuondolewa kwa siku saba, na machapisho yake hufika kwenye /business/mention/hashtag/video/list/ saa 24 baada ya kuwezeshwa.

easyCoexistence inaweza kufanya nini na kutajwa kwa TikTok?

Mpe msimbo wako mwenyewe token ya akaunti: get_social_credentials hurudisha token na business_id kwa njia za API for Business zinazoanza na business/, ikiwemo business/mention/. TikTok hujibu akaunti na programu zinapotimiza masharti hapo juu. Webhook za kutajwa zinabaki nje yake: easyCoexistence husajili programu yake kwa matukio ya maoni pekee, na huweka njia za business/webhook/ kwa ajili yake, kwa hiyo matukio ya BRAND_MENTION hayasambazwi. Maoni kwenye machapisho ya akaunti yenyewe, pamoja na kutajwa, bado hufika kama matukio ya comment.update, ambayo set_social_webhook_destination husambaza:

Comment mentions and a reply, from your own code
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!" }

Makosa ya kawaida

  • Kuita endpoints za Mentions kwa akaunti isiyo na Advanced Access. TikTok huzitoa kwa akaunti zenye Advanced Access au Verified Business Account; has_advanced_access kwenye /business/get/ huonyesha hilo.
  • Kuvuta kutajwa mara tu baada ya usiku wa manane UTC. TikTok husasisha data ya siku iliyopita kati ya usiku wa manane na 7 am UTC, kwa hiyo kuvuta baada ya 7 am huona siku nzima.
  • Kusoma comment_id ya 0 kama maoni. Kwenye webhook ya kutajwa, inamaanisha kutajwa kuko kwenye maelezo ya chapisho, chenye mention_type VIDEO_MENTION.
  • Kuwezesha hashtag ya chapa ili kuijaribu. TikTok huweka hashtag iliyowezeshwa kwa siku saba kabla haijaondolewa, na inahesabika kwenye kikomo cha akaunti cha 50.
Kufanya hili ukitumia EasyCoexistence

Kuanzia US$ 9 hadi US$ 0.75 kwa muunganisho kwa mwezi, bei inashuka unapoongeza miunganisho, pamoja na siku 3 za kwanza bila malipo.

Maswali yanayoulizwa mara kwa mara

Je, API ya TikTok inaweza kupata video zinazotaja akaunti yangu?

Ndiyo, zile zinazotaja jina lake la mtumiaji kwa @ kwenye maelezo. /business/mention/video/list/ hurudisha hadi machapisho 1,000 ya umma ya siku 90 zilizopita, na creator_handle_name humtaja kila muundaji.

Je, machapisho binafsi ya TikTok yanahesabika kama kutajwa?

Hapana. Mentions API huhesabu machapisho ya umma ya siku 90 zilizopita pekee, na huacha waandishi wasio na umri au wenye umri usiojulikana: 17 au chini barani Ulaya, na 12 au chini nchini Marekani na maeneo mengine.

Kutajwa kwa TikTok huchukua muda gani kuonekana?

Takriban saa 24 hadi 48 kupitia endpoints za orodha, na hadi saa mbili au tatu kupitia webhook ya Mentions.

Je, easyCoexistence inaweza kunijulisha akaunti yangu ya TikTok inapotajwa?

Si kama tukio lililosambazwa, kwa kuwa husambaza matukio ya maoni ya TikTok na si matukio ya kutajwa. Msimbo wako mwenyewe unaweza kusoma kutajwa unapoomba, kwa token kutoka get_social_credentials, pale ambapo akaunti inastahili.

Endelea kusoma

Unganisha chaneli yako ya kwanza ndani ya dakika mbili.

Hakuna ukaguzi wa majukwaa wa kusubiri. Unganisha WhatsApp, Instagram, TikTok au chaneli nyingine, kisha mwombe AI wako achapishe, ajibu au atoe ripoti, na uone akifanya kazi.

  • Siku 3 bila malipo
  • Ghairi wakati wowote
  • API rasmi pekee
  • Hufuatiliwa saa 24/7

Imethibitishwa kwenye