Kirjaudu sisäänAloita ilmainen kokeilu
easyCoexistence Viralliset API:t

TikTok-maininnat API:n kautta: julkaisut ja kommentit, jotka mainitsevat tilin

TikTokin Mentions API, osa API for Business -rajapintaa, palauttaa 1 000 parasta julkista julkaisua viimeiseltä 90 päivältä, jotka mainitsevat yritystilin @-merkinnällä kuvatekstissään. Tämä tapahtuu osoitteesta GET /business/mention/video/list/. Lisäksi se palauttaa 1 000 parasta kommenttia tai vastausta, jotka mainitsevat tilin, osoitteesta /business/mention/comment/list/. Molemmat vaativat biz.brand.insights-scopen sekä tilin, jolla on Advanced Access tai Verified Business Account.

easyCoexistence yhdistää TikTok-tilin TikTokin API for Business -rajapinnan kautta.

1,000

Eniten mainittuja julkaisuja, jotka /business/mention/video/list/ palauttaa: kaikki julkisia ja viimeisen 90 päivän ajalta, enintään 100 pyyntöä kohden.

24 to 48 hours

Likimääräinen viive maininnan tekemisen ja sen saatavuuden välillä Mentions API:ssa.

2 to 3 hours

TikTokin ilmoittama viive Mentions-webhookille sen jälkeen, kun käyttäjä mainitsee yrityksen kuvatekstissä tai kommentissa.

Once a day

Kuinka usein TikTok suosittelee kutsumaan kutakin Mentions-päätepistettä tiliä kohden kello 0–7 UTC:n päivityksen jälkeen.

comment.list

Scope /business/mention/comment/list/ tarvitsee biz.brand.insights-scopen lisäksi, jotta se palauttaa tiliä mainitsevat kommentit.

Mitkä päätepisteet Mentions API:ssa on?

Kuusi lukupäätepistettä, joista jokainen on GET-pyyntö osoitteeseen https://business-api.tiktok.com/open_api/v1.3. Tilin access tokenissa lähetetään Access-Token-otsakkeessa ja sen open_id business_id-kentässä. Kaksi listaa maininnat, kaksi tiivistää, mitä mainituissa julkaisuissa sanotaan, ja kaksi hakee yksittäisen maininnan, jonka webhook on ilmoittanut:

/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

Mitkä julkaisut ja kommentit lasketaan maininnoiksi?

Ne, jotka merkitsevät tilin käyttäjätunnuksen @-merkillä julkaisun kuvatekstissä tai kommentin tekstissä, julkisella julkaisulla, ja jotka läpäisevät TikTokin muut suodattimet:

  • Julkaisu on julkaistu viimeisen 90 päivän aikana.
  • Sen tekijä ei ole alaikäinen eikä iältään tuntematon: 17 tai alle lasketaan alaikäisiksi Euroopassa, 12 tai alle Yhdysvalloissa ja muilla alueilla.
  • Se kuuluu 1 000 eniten tykätyn julkaisun tai kommentin joukkoon, jotka mainitsevat käyttäjätunnuksen.
  • Yrityksen omat julkaisut lasketaan mukaan, jos ne täyttävät nämä säännöt.
  • Kommentit, jotka sisältävät pelkän maininnan ilman muuta tekstiä, sijoittuvat alemmas.

Mitä tili tarvitsee ennen kuin voi käyttää niitä?

Kelpoisen tilin, sovelluksen oikeudet, tokeniin kuuluvat scopet ja vuorokauden odotuksen sen jälkeen, kun omistaja on valtuuttanut sovelluksen:

  • Advanced Access tai Verified Business Account. has_advanced_access-kenttä osoitteessa /business/get/ kertoo, mitkä tilit täyttävät ehdot.
  • Mentions-oikeus kehittäjäsovelluksessa, nimellä Mentions, Content julkaisuille ja Mentions, Comment kommenteille.
  • biz.brand.insights access tokenissa sekä comment.list kommenttimaininnoille.
  • 24 tuntia valtuutuksen jälkeen ennen ensimmäistä hakua, kuten TikTokin aloitusopas neuvoo.

Miten listataan julkaisut, jotka mainitsevat tilin?

Pyynnöllä GET /business/mention/video/list/. fields valitsee tiedot: oletuksena item_id ja caption, ja pyynnöstä lisäksi create_time, video_link, likes, comments, shares, thumbnail_url, views, reach ja creator_handle_name. sort_field ottaa arvot CREATE_TIME, LIKES, COMMENTS tai SHARES, ja sort_type ASC tai DESC. number_of_days kaventaa 90 päivää, regions rajaa tulokset valittujen alueiden tekijöihin ja cursor sekä has_more selaavat tuloksia. views ja reach ovat null alle 1 000:n kohdalla, ja pikkukuvalinkit ovat voimassa 48 tuntia:

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

Miten listataan kommentit, jotka mainitsevat tilin?

Pyynnöllä GET /business/mention/comment/list/, jonka token tarvitsee myös comment.list-oikeuden. Oletuksena se palauttaa comment_id ja comment_text. item_id, video_link, caption, video_likes, thumbnail_url, commenter_display_name, comment_type, comment_create_time ja comment_likes saa pyynnöstä, ja comment_type on COMMENT tai REPLY. Sivulla on 10 kommenttia, ellei max_count pyydä enintään 100, ja lajittelu on VIDEO_LIKES, COMMENT_CREATE_TIME tai COMMENT_LIKES. TikTokin luottamus- ja turvallisuuskäytäntöjen vuoksi sivu voi palautua lyhyenä, vaikka has_more on yhä tosi.

Miten vastaat maininnan?

TikTokin kommenttivastauspäätepisteen kautta. POST /business/comment/reply/create/ ottaa business_id:n, video_id:n, joka on kommenttimaininnan item_id, comment_id:n ja text-kentän, jossa on enintään 1 200 merkkiä. Vastaus näkyy julkisesti kyseisen kommentin alla sillä julkaisulla, joka sitä kantaa. TikTokin ohjeessa mainitaan comment.list.manage-scope ja sama tiliedellytys. Sen Mentions-ohjeessa vastaus on listattu vain kommenttimaininnoille.

Voivatko maininnat tulla webhookilla?

Kyllä. Mentions-oikeudella sovellus kutsuu POST /business/webhook/update/ -päätepistettä event_type-arvolla BRAND_MENTION, ja TikTok lähettää sen jälkeen brand.mention.event-tapahtuman enintään kahden tai kolmen tunnin kuluessa maininnasta. Se on allekirjoitettu Tiktok-Signature-otsakkeella kuten muut webhookit. content on sarjallistettu JSON-merkkijono, joka sisältää:

  • type_of_event: CREATE, EDIT tai PRIVACY_CHANGE, kun julkaisun yksityisyysasetusta muutetaan.
  • mention_type: COMMENT kommentille tai vastaukselle, VIDEO_MENTION kuvatekstille, jolloin comment_id on 0.
  • video_id, video_create_time, share_url ja video_caption, jotka kuvaavat julkaisua.
  • open_id_of_mentioned_user, unique_name_of_mentioned_user ja unique_identifier, eli kommentoijan tunniste, joka pysyy samana eri rajapinnoissa.
  • Yksityiskohdat saa /business/mention/video/get/ tai /business/mention/comment/get/ -päätepisteestä 48 tunnin sisällä tapahtumasta.

Kuinka usein Mentions-päätepisteitä pitäisi kutsua?

TikTokin suositus on kerran päivässä päätepistettä ja tiliä kohden, kello 7 UTC:n jälkeen. Päätepisteet jakavat kehittäjäsovelluksen yleiset rajoitukset, mutta TikTok päivittää edellisen päivän tiedot kello 0–7 UTC välillä, eikä samana päivänä tehdyt lisähaut ole tarpeen. Uusi maininta vie myös noin 24–48 tuntia saapua listauspäätepisteisiin, minkä vuoksi webhook on nopeampi signaali.

Miten brändin hashtagit toimivat?

Ne laajentavat maininnat julkaisuihin, jotka käyttävät yrityksen valitsemia hashtageja. POST /business/mention/hashtag/add/ ottaa käyttöön enintään 10 hashtagia pyyntöä kohden ja 50 tiliä kohden. Hashtagit valitaan enintään 100 ehdotuksen joukosta, jotka /business/mention/hashtag/verify/list/ tarjoaa, tai ne sisältävät koko käyttäjätunnuksen, kuten #drinktiktok tilille @TikTok. Käyttöön otettua hashtagia ei voi poistaa seitsemään päivään, ja sen julkaisut tulevat /business/mention/hashtag/video/list/ -päätepisteeseen 24 tunnin kuluttua käyttöönotosta.

Mitä easyCoexistence voi tehdä TikTok-maininnoilla?

Anna omalle koodillesi tilin token: get_social_credentials palauttaa tokenin ja business_id:n API for Business -poluille, jotka ovat business/-alkuisia, business/mention/ mukaan lukien. TikTok vastaa, kun tili ja sovellus täyttävät yllä mainitut ehdot. Maininta-webhookit jäävät tämän ulkopuolelle: easyCoexistence tilaa sovelluksensa vain kommenttitapahtumiin ja pitää business/webhook/-polut itsellään, joten BRAND_MENTION-tapahtumia ei välitetä. Tilin omien julkaisujen kommentit, maininnat mukaan lukien, saapuvat yhä comment.update-tapahtumina, jotka set_social_webhook_destination välittää:

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

Yleiset virheet

  • Mentions-päätepisteiden kutsuminen tilille, jolla ei ole Advanced Accessia. TikTok palvelee niitä tileille, joilla on Advanced Access tai Verified Business Account, minkä has_advanced_access-kenttä osoitteessa /business/get/ kertoo.
  • Maininnoiden hakeminen heti keskiyön UTC:n jälkeen. TikTok päivittää edellisen päivän tiedot kello 0–7 UTC välillä, joten haku kello 7 jälkeen näkee koko päivän.
  • comment_id 0:n lukeminen kommentiksi. Maininta-webhookissa se tarkoittaa, että maininta on julkaisun kuvatekstissä ja mention_type on VIDEO_MENTION.
  • Brändin hashtagin ottaminen käyttöön kokeillakseen. TikTok pitää käyttöön otetun hashtagin seitsemän päivää ennen kuin sen voi poistaa, ja se lasketaan tilin 50 hashtagin määrään.
Näin teet tämän EasyCoexistencen avulla

Claude, ChatGPT tai oma koodisi lukee sen kommentit ja vastaa niihin omilla työkaluilla sekä vastaanottaa kommenttitapahtumat heti kun ne saapuvat, ja get_social_credentials antaa omalle koodillesi tokenin muita API for Business -kutsuja varten, mukaan lukien Mentions-päätepisteet siltä osin kuin TikTok avaa ne tilille. US$ 9–US$ 0,75 yhteydeltä kuukaudessa, hinta laskee yhteyksien määrän kasvaessa, ja ensimmäiset 3 päivää ovat ilmaista kokeilua.

Usein kysytyt kysymykset

Voiko TikTok API löytää videoita, jotka mainitsevat tilini?

Kyllä, ne, jotka merkitsevät käyttäjätunnuksen @-merkillä kuvatekstissä. /business/mention/video/list/ palauttaa enintään 1 000 julkista julkaisua viimeiseltä 90 päivältä, ja creator_handle_name kertoo kunkin tekijän käyttäjätunnuksen.

Lasketaanko yksityiset TikTok-julkaisut maininnoiksi?

Ei. Mentions API laskee vain julkiset julkaisut viimeiseltä 90 päivältä, eikä se sisällytä alaikäisiä tai iältään tuntemattomia tekijöitä: 17 tai alle Euroopassa, 12 tai alle Yhdysvalloissa ja muilla alueilla.

Kuinka kauan TikTok-maininta kestää näkyä?

Noin 24–48 tuntia listauspäätepisteiden kautta ja enintään kahdesta kolmeen tuntiin Mentions-webhookin kautta.

Voiko easyCoexistence hälyttää minua, kun TikTok-tiliäni mainitaan?

Ei tapahtumana, joka välitetään, koska se välittää TikTokin kommenttitapahtumat eikä maininta-tapahtumia. Oma koodisi voi lukea maininnat pyynnöstä get_social_credentials-työkalun tokenilla siltä osin kuin tili täyttää ehdot.

Lue lisää

Yhdistä ensimmäinen kanavasi kahdessa minuutissa.

Ei alustojen tarkastuksia odotettavana. Yhdistä WhatsApp, Instagram, TikTok tai jokin muu kanava, pyydä sitten tekoälyäsi julkaisemaan, vastaamaan tai raportoimaan ja seuraa, kun se hoitaa homman.

  • 3 päivää ilmaiseksi
  • Peruuta milloin tahansa
  • Vain viralliset API:t
  • Valvottu 24/7

Vahvistettu