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

Voiko TikTok API hakea videoita, hashtageja tai trendejä?

Kyllä, TikTok-API voi hakea videoita, mainoksia ja trendejä, kukin omassa API:ssa: Research API hakee julkisia videoita avainsanan, hashtagin, käyttäjätunnuksen, alueen tai päivämäärän mukaan tutkijoille, joille TikTok hyväksyy käyttöoikeuden. Commercial Content API hakee mainoksia avainsanan tai mainostajan nimen perusteella. API for Business palauttaa suosittuja hashtageja, niiden trendaavat videot ja trendaavat hakusanat. Display API lukee valtuutetun käyttäjän oman profiilin ja videot.

easyCoexistence yhdistää TikTok-tilit TikTokin API for Business -rajapinnan kautta, jotta Claude, ChatGPT tai oma alustasi voi listata tilin julkaisut ja kommentit ja lukea sen insightit, ja get_social_credentials antaa omalle koodillesi tokenin business/-poluille, kuten hashtag-ehdotuksille.

1,000 a day

Research API -pyyntöjä päivässä, enintään 100 000 tietuetta, ja kiintiö nollautuu klo 00.00 UTC.

30 days

Pisin aikaväli start_date ja end_date välillä yhdessä Research API:n videokyselyssä, joka palauttaa enintään 100 videota pyyntöä kohti.

Top 200

Suosituimmat hashtagit: /discovery/trending_list/ järjestää maan ja kategorian mukaan viimeisten 1, 7, 30 tai 120 päivän ajalta.

20

Trendaavat hakusanat: /discovery/trending/search/ palauttaa tileille, joilla on Advanced Access tai Verified Business Account.

50 characters

Pisin search_term, jonka Commercial Content API hyväksyy: oletuksena vastaavuus on tarkka lause, vaihtoehtoisesti sumea lause.

Mikä TikTok-API voi hakea?

Useampi, kahdella kehittäjäportaalilla, kukin eri tyyppiselle kehittäjälle. developers.tiktok.com tarjoaa Research API:n, Commercial Content API:n ja Display API:n; business-api.tiktok.com tarjoaa API for Business -rajapinnan, jonka Discovery-, Accounts- ja Mentions-päätepisteet kattavat trendit ja yrityksen oman sisällön:

Research APIPublic videos by keyword, hashtag, username, region or date; approved researchers
Commercial Content APIAds by keyword or advertiser name, starting with ads data from the EU
Discovery endpointsPopular hashtags, their trending videos, and trending search keywords
Mentions endpointsUp to 1,000 recent public posts carrying the business's brand hashtags
Hashtag suggestion10 hashtags for a keyword, for the authorized account's captions
Display APINo search: an authorized user's profile and public videos

Miten Research API hakee videoita?

Pyynnöllä POST https://open.tiktokapis.com/v2/research/video/query/ ja client access tokenilla, jolla on research.data.basic scope. Query-objekti yhdistää and-, or- ja not-ehdot, joista kukin on operaatio, kuten EQ tai IN, kentälle, kuten keyword, hashtag_name, username, region_code, create_date tai video_length. start_date ja end_date, muodossa YYYYMMDD, voivat olla enintään 30 päivän päässä toisistaan, ja max_count palauttaa pyyntöä kohti enintään 100 videota:

A Research API video query, after TikTok's own example
curl -X POST 'https://open.tiktokapis.com/v2/research/video/query/?fields=id,video_description,create_time' \
  -H 'Authorization: Bearer <CLIENT_ACCESS_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{
    "query": {
      "and": [
        { "operation": "IN", "field_name": "region_code", "field_values": ["JP", "US"] },
        { "operation": "EQ", "field_name": "hashtag_name", "field_values": ["animal"] }
      ],
      "not": [
        { "operation": "EQ", "field_name": "video_length", "field_values": ["SHORT"] }
      ]
    },
    "max_count": 100,
    "start_date": "20261001",
    "end_date": "20261030"
  }'

Mitä Research API palauttaa, ja kuinka tuoretta data on?

Julkisten videoiden kentät, jotka on nimetty fields-kentässä, kuten id, video_description, create_time, region_code, view_count, like_count, comment_count, share_count, hashtag_names ja username. TikTokin UKK varoittaa, että tilastot, kuten katselu- ja seuraajamäärät, voivat päivittyä jopa 10 päivän kuluessa, ja uudet videot voivat ilmestyä hakuun jopa 48 tunnin kuluttua. Päivittäinen kiintiö on 1 000 pyyntöä ja enintään 100 000 tietuetta yhteensä kaikissa Research API:ssa, ja se nollautuu klo 00.00 UTC.

Kuka voi käyttää Research API:a?

Tutkijat, joiden hankkeen TikTok hyväksyy; pelkkä kehittäjätili ei anna pääsyä. TikTok listaa akateemiset oppilaitokset Yhdysvalloissa, ETA:ssa, Isossa-Britanniassa, Kanadassa tai Sveitsissä, voittoa tavoittelemattomat tai itsenäiset tutkimuslaitokset EU:ssa sekä akateemiset tai voittoa tavoittelemattomat organisaatiot Brasiliassa, jotka tutkivat nuorten turvallisuutta verkossa. Hakijoiden on toimittava riippumatta kaupallisista intresseistä, ja heillä on oltava määritelty tutkimussuunnitelma, ilmoitettu rahoitus ja eettinen arviointi. TikTok vastaa tyypillisesti 4 viikon sisällä. Kun kysytään, ovatko sisällöntuottajat, mainostajat ja kaupalliset käyttäjät oikeutettuja, TikTokin UKK vastaa kieltävästi.

Miten Commercial Content API hakee mainoksia?

Pyynnöllä POST https://open.tiktokapis.com/v2/research/adlib/ad/query/ ja research.adlib.basic -scopella. search_term hyväksyy enintään 50 merkkiä, ja vastaavuus on oletuksena exact_phrase tai fuzzy_phrase, joka löytää missä tahansa järjestyksessä mitkä tahansa tai kaikki sanat. Suodattimet rajaavat tuloksia julkaisupäivämäärien ja kohdemaiden mukaan, ja kukin kutsu palauttaa enintään 10 mainosta. TikTokin tuotesivu kertoo, että data alkaa EU:n mainoksista ja pysyy saatavilla vuoden ajan siitä, kun mainos on viimeksi näytetty. Yleisö ja tutkijat missä tahansa maassa voivat hakea online-lomakkeella, ja TikTok vastaa odotettavasti 2 arkipäivän sisällä.

Mitä trendejä API for Business palauttaa?

Sen Discovery-päätepisteet, jotka eroavat toisistaan käytetyn tokenin mukaan. /discovery/trending_list/ järjestää enintään 200 suosittua hashtagia maan mukaan, oletuksena US, ja toimialakategorian mukaan 1, 7, 30 tai 120 päivän ajalta, ja kunkin hashtagin sijoituksen, katselut ja julkaisut. /discovery/video_list/ palauttaa enintään 10 hashtagin 20 trendaavinta videota; molemmat vaativat advertiser_id:n ja mainostajan access tokenin. Kaksi muuta vaativat TikTok-tilin tokenin discovery.search.words-scopella, tileille, joilla on Advanced Access tai Verified Business Account:

  • /discovery/trending/search/: 20 TikTokin trendaavaa hakusanaa tai tilille räätälöitynä is_personalized-asetuksella.
  • /discovery/trending/search/keyword/: 20 suositeltua hakusanaa kyselylle, jonka pituus on enintään 255 merkkiä, esimerkiksi tuotteelle tai brändille.

Mitä TikTok-tilin oma API voi hakea?

Hashtageja sen kuvatekstiin ja julkaisuja, joissa on sen brändihashtageja. GET /business/hashtag/suggestion/ ottaa avainsanan ja valinnaisen kielen ja palauttaa 10 hashtagia, järjestettynä tarkan osuman ja sen jälkeen julkaisumäärän mukaan, kunkin post_count-arvon kanssa. Mentions-päätepiste /business/mention/hashtag/video/list/ palauttaa enintään 1 000 julkista julkaisua viimeisen 90 päivän ajalta, jotka käyttävät jotakin yrityksen aktivoimaa brändihashtagia, enintään 50 kappaletta, lajiteltuna ajan, tykkäysten, kommenttien tai jakojen mukaan. Se vaatii biz.brand.insights-scopen ja tilin, jolla on Advanced Access tai Verified Business Account.

Voiko Display API hakea?

Ei. Se lukee sovelluksen valtuuttaman käyttäjän: /v2/user/info/ palauttaa tämän käyttäjän profiilin, /v2/video/list/ hänen julkiset videonsa, uusimmat ensin ja enintään 20 sivua kohti, ja /v2/video/query/ tietyt videot ID:n perusteella user.info.basic- ja video.list-scopejen nojalla. Yksikään sen päätepisteistä ei ota avainsanaa tai hashtagia.

Mitä easyCoexistence voi hakea TikTokista?

Se, mihin yhdistetyn tilin oma API vastaa. list_social_posts listaa tilin viimeisimmät julkaisut ja list_social_comments julkaisun kommentit, kun taas oma koodisi kutsuu API for Business -polkuja, jotka ovat business/-alkuisia, get_social_credentials-työkalun tokenilla, hashtag-ehdotukset mukaan lukien. /discovery/-polut ottavat mainostajan tokenin, joten tilin token ei tavoita niitä, ja Research- ja Commercial Content API ovat erillisiä developers.tiktok.com-tuotteita, joilla on omat hakemuksensa.

Hashtag suggestions from your own code
GET https://business-api.tiktok.com/open_api/v1.3/business/hashtag/suggestion/
  ?business_id=<BUSINESS_ID>&keyword=cold%20brew&language=en
Access-Token: <ACCESS_TOKEN>

Yleiset virheet

  • Research API:n käyttöoikeuden hakeminen brändin seurantaan. TikTokin UKK vastaa kieltävästi sisällöntuottajille, mainostajille ja kaupallisille käyttäjille, ja hyväksyy vain ei-kaupalliset tutkimushankkeet.
  • Pitkän ajanjakson kysely yhdellä Research API -kutsulla. end_date voi olla enintään 30 päivää start_date:n jälkeen, joten jaa pidemmät ajanjaksot osiin.
  • Hashtag-ehdotusten lukeminen trendeinä. /business/hashtag/suggestion/ järjestää tarkan osuman ja julkaisumäärän mukaan, kun /discovery/trending_list/ järjestää suosion valitulta ajanjaksolta.
  • Trendaavien hakupäätepisteiden kutsuminen henkilökohtaiselle tilille. Ne vastaavat tileille, joilla on Advanced Access tai Verified Business Account ja tokenissa discovery.search.words.
Näin teet tämän EasyCoexistencen avulla

Jokainen yhteys valvotaan ympäri vuorokauden. US$ 9:stä US$ 0,75:een per yhteys kuukaudessa, hinta laskee lisättäessä yhteyksiä, ja ensimmäiset 3 päivää ovat ilmaisia.

Usein kysytyt kysymykset

Voinko hakea TikTok-videoita avainsanalla API:n kautta?

Research API:n kautta, kun TikTok on hyväksynyt tutkimushankkeesi: sen videokysely ottaa avainsana- ja hashtag_name-ehtoja julkisiin videoihin, enintään 100 pyyntöä kohti.

Onko TikTok-API trendaavia hashtageja varten?

Kyllä. /discovery/trending_list/ API for Business -rajapinnassa järjestää enintään 200 suosittua hashtagia maan ja kategorian mukaan, kukin katselu- ja julkaisumäärineen, mainostajan tokenilla.

Onko TikTok-API trendaavia videoita varten?

Kyllä. /discovery/video_list/ API for Business -rajapinnassa palauttaa 20 trendaavinta videota enintään 10 suositulle hashtagille, advertiser_id:n ja mainostajan access tokenin avulla.

Voiko TikTok-API löytää kommentteja, joissa mainitaan tilini?

Kyllä, tileille, joilla on Advanced Access tai Verified Business Account: Mentions API:n /business/mention/comment/list/ palauttaa enintään 1 000 kommenttia tai vastausta, jotka @mainitsevat tilin, biz.brand.insights- ja comment.list-scopejen nojalla.

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