InloggenGratis proefperiode starten
easyCoexistence Officiële API's

Videos van een TikTok-account ophalen via de API

De API for Business van TikTok geeft de openbare posts van een account terug via GET /business/video/list/, beginnend bij de nieuwste, tot 20 per pagina. Geef de velden op die je terug wilt, zoals item_id, caption, share_url en video_views, en blader met cursor zolang has_more waar is. filters.video_ids selecteert bepaalde posts, en elke item_id is de ID die de comment-aanroepen gebruiken.

easyCoexistence geeft de recente posts van een TikTok-account via list_social_posts vanuit Claude, ChatGPT of je eigen code, met de item_id, caption, link en tellingen van elke post, en get_social_credentials geeft je eigen code het token voor latere pagina's en andere velden.

20

Maximumaantal posts dat /business/video/list/ per pagina teruggeeft; max_count staat standaard op 10.

Milliseconds

Eenheid van cursor: een UTC Unix-tijdstempel; het endpoint geeft posts terug die vóór dat moment zijn gepubliceerd.

item_id

Het standaardveld, dat een verzoek met meerdere velden moet bevatten, anders kan er een fout optreden.

40/min

Aantal aanroepen toegestaan per geautoriseerd account op dit endpoint, net als bij elk endpoint van de Accounts API.

Wat geeft het endpoint terug?

De openbare posts van het account: video's die op het profiel worden getoond, foto- en tekstposts, en Only show in ads-video's, die als advertentie draaien zonder op het profiel te verschijnen. media_type onderscheidt VIDEO van PHOTO, wat foto- en tekstposts omvat. Posts die TikTok heeft gefilterd vanwege overtredingen, zoals auteursrechtelijk beschermde muziek, staan niet in de lijst.

Hoe roep je het aan?

Met een GET en URL-parameters: business_id, fields als JSON-array, en optioneel filters, cursor en max_count, dat standaard op 10 staat. Het token gaat in de Access-Token-header, en de developer-app heeft de Get Account Media-permissie nodig onder 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'

Welke velden beschrijven een post?

Naast de statistieken, die lopen van video_views tot impression_sources, bevat de lijst deze velden, allemaal onder de video.list-scope:

  • item_id: de ID van de post, gebruikt door comment-aanroepen en door filters.video_ids.
  • media_type: VIDEO, of PHOTO voor een foto- of tekstpost.
  • is_ad: of de post in een advertentie wordt gebruikt.
  • create_time: wanneer de post is gepubliceerd, als Unix-seconden in UTC.
  • caption: de beschrijving van de post, inclusief hashtags.
  • share_url: een deelbare link, die zich op mobiel en desktop anders gedraagt.
  • embed_url: een playerlink voor andere sites, die geen posts speelt die op Friends of Only you staan.
  • thumbnail_url: een tijdelijke voorbeeldafbeelding waarvan de vervaldatum in de parameter x-expires staat.
  • video_duration: de lengte in seconden, met drie decimalen.

Hoe ziet een pagina met resultaten eruit?

Een videos-array in de volgorde die TikTok teruggeeft, plus cursor, de waarde die je voor de volgende pagina meestuurt, en has_more, dat aangeeft of er een volgende pagina is. create_time komt binnen als string met Unix-seconden. Het voorbeeld van TikTok, ingekort tot de beschrijvende velden en de aantallen:

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

Hoe werkt paginering?

Op tijd. cursor staat standaard op het huidige moment in milliseconden, dus de eerste pagina bevat de nieuwste posts, en elk antwoord geeft de cursor voor het volgende verzoek terug. Geef die mee zolang has_more waar is. Een eigen tijdstempel geeft de posts die vóór dat moment zijn gepubliceerd. De regels voor vertrouwen en veiligheid van TikTok kunnen een pagina korter maken dan max_count, ook als er nog posts zijn.

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"]

Hoe haal je specifieke posts op?

Met filters, een JSON-object: video_ids somt de post-ID's op die moeten terugkomen, zoals de post_ids uit een publicatiestatus. ad_post_only, alleen geldig naast video_ids, houdt alleen de posts over die voor Spark Ads aan adverteerders zijn geautoriseerd. Een gefilterd verzoek krijgt dezelfde velden als elk ander verzoek, zodat één aanroep de nieuwste cijfers voor een handvol bekende posts kan teruggeven.

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

Welke limieten gelden?

De Accounts API staat 40 aanroepen per minuut toe per geautoriseerd account op dit endpoint, en de Accounts API-aanroepen van een app krijgen samen 600 per minuut op het Basic-niveau en 1.000 daarboven. Beschrijvende velden zijn realtime, tellingen lopen meestal 24 tot 48 uur achter, en de data van een post stopt met updaten 365 dagen na publicatie.

Hoe toont easyCoexistence de video's?

Met list_social_posts, dat het account_id en een optionele limit aanneemt, van 1 tot 20 voor TikTok. Het geeft de eerste pagina van TikTok terug: de meest recente posts met item_id, create_time, caption, share_url, thumbnail_url, video_views, likes, comments en shares, plus cursor en has_more. Latere pagina's en andere velden komen uit je eigen code, met het token en de business_id uit get_social_credentials:

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>

Veelgemaakte fouten

  • Velden opvragen zonder item_id. De referentie van TikTok waarschuwt dat een verzoek met meerdere velden zonder item_id kan mislukken.
  • Stoppen wanneer een pagina korter terugkomt. TikTok kan minder dan max_count posts teruggeven terwijl has_more nog waar is, dus volg in plaats daarvan has_more.
  • thumbnail_url opslaan voor later. Het is een tijdelijke link die verloopt op het tijdstip in de parameter x-expires, dus haal een nieuwe op wanneer je hem nodig hebt.
  • Privéposts in de lijst zoeken. Het endpoint geeft alleen openbare posts terug.
Dit doen met EasyCoexistence

US$ 9 tot US$ 0,75 per verbinding per maand, dalend naarmate je meer verbindingen toevoegt, met de eerste 3 dagen gratis.

Veelgestelde vragen

Hoeveel TikTok-video's kan de API in één keer ophalen?

Tot 20 per pagina via /business/video/list/. max_count bepaalt de paginagrootte en staat standaard op 10; volg cursor voor meer.

Haalt de TikTok-API ook fotoposts op?

Ja. /business/video/list/ geeft openbare video-, foto- en tekstposts terug, en media_type onderscheidt VIDEO van PHOTO.

Bevat de TikTok-videolijst ook posts die alleen in advertenties draaien?

Ja. /business/video/list/ geeft ook Only show in ads-video's terug, die als advertentie draaien zonder op het profiel te verschijnen, en is_ad geeft aan of een post in een advertentie wordt gebruikt.

Waarom ontbreekt een TikTok-post in de API-lijst?

Het endpoint toont openbare posts, en TikTok laat posts weg die gefilterd zijn vanwege overtredingen, zoals auteursrechtelijk beschermde muziek.

Lees verder

Koppel je eerste kanaal in twee minuten.

Geen platformbeoordelingen om op te wachten. Verbind WhatsApp, Instagram, TikTok of een ander kanaal, vraag je AI om te posten, te reageren of een rapport te maken, en zie het aan het werk.

  • 3 dagen gratis
  • Op elk moment opzegbaar
  • Alleen officiële API's
  • 24/7 bewaakt

Geverifieerd op