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

TikTok-tilin videoiden listaaminen API:n kautta

TikTok API for Business listaa tilin julkiset julkaisut GET-pyynnöllä osoitteesta /business/video/list/, uusimmasta alkaen, enintään 20 julkaisua sivulla. Nimeä palautettavat kentät, kuten item_id, caption, share_url ja video_views, ja selaa sivuja cursorin avulla niin kauan kuin has_more on true. filters.video_ids rajaa tiettyihin julkaisuihin, ja jokainen item_id on tunnus, jonka kommenttikutsut ottavat vastaan.

easyCoexistence listaa TikTok-tilin viimeisimmät julkaisut list_social_posts-työkalulla Claudesta, ChatGPT:stä tai omasta koodistasi.

20

Sivulla palautettavien julkaisujen enimmäismäärä /business/video/list/-päätepisteessä; max_count on oletuksena 10.

Milliseconds

Cursorin yksikkö on UTC-aikaleima Unix-muodossa; päätepiste palauttaa julkaisut, jotka on julkaistu ennen sitä.

item_id

Oletuskenttä, joka on mukana pyynnössä, jossa nimetään useita kenttiä; muuten voi syntyä virhe.

40/min

Sallitut kutsut valtuutettua tiliä kohden tässä päätepisteessä, kuten jokaisessa Accounts API -päätepisteessä.

Mitä päätepiste palauttaa?

Tilin julkiset julkaisut: profiilissa näkyvät videot, kuva- ja tekstijulkaisut sekä Only show in ads -videot, jotka näkyvät mainoksina ilman profiilissa esiintymistä. media_type erottaa VIDEO-julkaisut PHOTO-julkaisuista, joihin kuuluvat kuva- ja tekstijulkaisut. Julkaisut, jotka TikTok on suodattanut pois rikkomusten vuoksi, kuten musiikin tekijänoikeusrikkomukset, jätetään listasta pois.

Miten päätepistettä kutsutaan?

GET-pyynnöllä ja URL-parametreilla: business_id, fields JSON-taulukkona ja valinnaisesti filters, cursor ja max_count, jonka oletus on 10. Token välitetään Access-Token-otsakkeessa, ja kehittäjäsovelluksella on oltava Get Account Media -oikeus kohdassa TikTok Accounts:

List the latest posts
curl -G 'https://business-api.tiktok.com/open_api/v1.3/business/video/list/' \
  -H 'Access-Token: <ACCESS_TOKEN>' \
  --data-urlencode 'business_id=<OPEN_ID>' \
  --data-urlencode 'fields=["item_id","create_time","media_type","caption","share_url","thumbnail_url","video_views","likes","comments","shares"]' \
  --data-urlencode 'max_count=20'

Mitkä kentät kuvaavat julkaisua?

Mittareiden lisäksi, jotka ulottuvat video_views-kentästä impression_sourcesiin, lista sisältää nämä kaikki video.list-oikeusalueen alla:

  • item_id: julkaisun tunnus, jota kommenttikutsut ja filters.video_ids käyttävät.
  • media_type: VIDEO tai PHOTO kuva- tai tekstijulkaisulle.
  • is_ad: onko julkaisua käytetty mainoksessa.
  • create_time: julkaisun ajankohta UTC-aikana Unix-sekunteina.
  • caption: julkaisun kuvaus, hashtagit mukaan lukien.
  • share_url: jaettava linkki, joka toimii eri tavalla mobiilissa ja työpöydällä.
  • embed_url: soitinlinkki muille sivustoille; se ei toista julkaisuja, jotka on asetettu Friends- tai Only you -tilaan.
  • thumbnail_url: tilapäinen esikatselukuva, jonka vanhenemisaika on x-expires-parametrissa.
  • video_duration: pituus sekunteina kolmella desimaalilla.

Miltä tulossivu näyttää?

videos-taulukko siinä järjestyksessä, jossa TikTok sen palauttaa, sekä cursor, jonka arvo lähetetään seuraavaa sivua varten, ja has_more, joka kertoo, onko seuraavaa sivua. create_time tulee merkkijonona Unix-sekunneista. TikTokin esimerkki, karsittuna kuvaaviin kenttiin ja lukuihin:

A page from /business/video/list/
{
  "code": 0,
  "message": "OK",
  "request_id": "2021080307532501024502410704A7306F",
  "data": {
    "videos": [
      {
        "item_id": "6990565363377392901",
        "create_time": "1627617835",
        "caption": "little coco",
        "share_url": "https://www.tiktok.com/@feather_in_the_w1nd/video/6990565363377392901?utm_campaign=tt4d_open_api&utm_source=6979330045630218242",
        "likes": 10,
        "comments": 2,
        "shares": 0,
        "video_views": 1231
      }
    ],
    "cursor": 0,
    "has_more": false
  }
}

Miten sivutus toimii?

Aikaperusteisesti. cursor on oletuksena nykyhetki millisekunteina, joten ensimmäinen sivu sisältää uusimmat julkaisut, ja jokainen vastaus palauttaa cursorin seuraavaa pyyntöä varten. Lähetä se niin kauan kuin has_more on true. Oma aikaleima listaa julkaisut, jotka on julkaistu ennen sitä hetkeä, ja TikTokin luottamus- ja turvallisuussäännöt voivat tehdä sivusta lyhyemmän kuin max_count, vaikka julkaisuja olisi vielä jäljellä.

Every page, in Python
import json, requests

API = "https://business-api.tiktok.com/open_api/v1.3"

def all_posts(token: str, business_id: str, fields: list[str]):
    params = {"business_id": business_id, "fields": json.dumps(fields), "max_count": 20}
    while True:
        r = requests.get(f"{API}/business/video/list/", headers={"Access-Token": token},
                         params=params, timeout=30).json()
        if r["code"] != 0:
            raise RuntimeError(f"{r['code']}: {r['message']}")
        yield from r["data"].get("videos", [])
        if not r["data"].get("has_more"):
            return
        params["cursor"] = r["data"]["cursor"]

Miten haet tietyt julkaisut?

Suodattimilla, jotka ovat JSON-objekti: video_ids listaa palautettavat julkaisutunnukset, kuten post_ids julkaisun tilasta. ad_post_only, joka on sallittu vain video_idsin rinnalla, pitää mukana vain julkaisut, jotka on valtuutettu mainostajille Spark Ads -mainontaa varten. Suodatettu pyyntö saa samat kentät kuin mikä tahansa muu, joten yksi kutsu voi palauttaa viimeisimmät luvut muutamalle tunnetulle julkaisulle.

The filters parameter
filters={"video_ids":["6995316737801538821","8015388216995316737"]}

Mitkä rajat pätevät?

Accounts API sallii 40 kutsua minuutissa valtuutettua tiliä kohden tässä päätepisteessä, ja sovelluksen Accounts API -kutsut saavat yhteensä 600 minuutissa Basic-tasolla ja 1 000 sen yläpuolella. Kuvaavat kentät ovat reaaliaikaisia, luvut viivästyvät yleensä 24–48 tuntia, ja julkaisun tiedot lakkaavat päivittymästä 365 päivää julkaisemisen jälkeen.

Miten easyCoexistence listaa videot?

list_social_posts-työkalun avulla, joka ottaa vastaan account_id-kentän ja valinnaisen limit-arvon, TikTokille 1–20. Se palauttaa TikTokin ensimmäisen sivun: uusimmat julkaisut kentillä item_id, create_time, caption, share_url, thumbnail_url, video_views, likes, comments ja shares sekä cursor ja has_more. Myöhemmät sivut ja muut kentät haetaan omasta koodistasi, käyttäen get_social_credentials-työkalun palauttamaa tokenia ja business_id:tä:

The next page from your own code
GET https://business-api.tiktok.com/open_api/v1.3/business/video/list/
  ?business_id=<BUSINESS_ID>
  &fields=["item_id","media_type","caption","embed_url"]
  &cursor=1793404800000
  &max_count=20
Access-Token: <ACCESS_TOKEN>

Yleiset virheet

  • Kenttien pyytäminen ilman item_id-kenttää. TikTokin viitemateriaali varoittaa, että pyyntö, joka nimeää useita kenttiä ilman sitä, voi epäonnistua.
  • Lopettaminen, kun sivu palautuu lyhyenä. TikTok voi palauttaa vähemmän kuin max_count julkaisua, vaikka has_more on yhä true, joten seuraa has_moreta.
  • thumbnail_url:n tallentaminen myöhempää käyttöä varten. Se on tilapäinen linkki, joka vanhenee x-expires-parametrissa ilmoitettuun aikaan, joten hae tarvittaessa uusi.
  • Yksityisten julkaisujen etsiminen listalta. Päätepiste palauttaa vain julkisia julkaisuja.
Näin teet tämän EasyCoexistencen avulla

Jokaisella julkaisulla on item_id, kuvaus, linkki ja luvut, ja get_social_credentials antaa omalle koodillesi tokenin myöhempiä sivuja ja muita kenttiä varten. US$ 9:stä US$ 0,75:een yhteyttä kohden kuukaudessa, halvempaa mitä enemmän yhteyksiä lisäät, ensimmäiset 3 päivää ilmaisella kokeilulla.

Usein kysytyt kysymykset

Montako TikTok-videota API voi listata kerralla?

Enintään 20 sivulla /business/video/list/-päätepisteestä. max_count asettaa sivun koon ja on oletuksena 10; hae lisää cursorin avulla.

Listaako TikTok-API myös kuvajulkaisut?

Kyllä. /business/video/list/ palauttaa julkiset video-, kuva- ja tekstijulkaisut, ja media_type erottaa VIDEO- ja PHOTO-julkaisut toisistaan.

Sisältääkö TikTok-videolista pelkästään mainoksiin tarkoitettuja julkaisuja?

Kyllä. /business/video/list/ palauttaa myös Only show in ads -videot, jotka näkyvät mainoksina ilman profiilissa esiintymistä, ja is_ad kertoo, onko julkaisua käytetty mainoksessa.

Miksi TikTok-julkaisu puuttuu API-listalta?

Päätepiste listaa julkisia julkaisuja, ja TikTok jättää pois rikkomusten vuoksi suodatetut julkaisut, kuten musiikin tekijänoikeusrikkomukset.

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