Giriş yapınÜcretsiz denemeyi başlatın
easyCoexistence Resmi API'ler

TikTok hesabının videolarını API ile listeleme

TikTok API for Business, bir hesabın herkese açık gönderilerini GET /business/video/list/ ile listeler; en yenisinden başlayarak sayfa başına en fazla 20 gönderi döndürür. Döndürülmesini istediğiniz alanları, örneğin item_id, caption, share_url ve video_views, adlandırın; has_more true olduğu sürece cursor ile sayfalara ilerleyin. filters.video_ids belirli gönderileri seçer; her item_id ise yorum çağrılarının kullandığı ID'dir.

easyCoexistence; Claude, ChatGPT veya kendi kodunuzdan list_social_posts ile bir TikTok hesabının son gönderilerini, her birinin item_id, açıklama, bağlantı ve sayılarıyla listeler; sonraki sayfalar ve diğer alanlar için get_social_credentials kendi kodunuza token'ı verir.

20

/business/video/list/ uç noktasının sayfa başına döndürdüğü en fazla gönderi sayısı; max_count varsayılan olarak 10'dur.

Milliseconds

cursor'ın birimi, UTC Unix zaman damgasıdır; uç nokta bu andan önce yayımlanmış gönderileri döndürür.

item_id

Birden çok alan adlandıran bir istekte bulunması gereken varsayılan alan; bulunmazsa hata oluşabilir.

40/min

Bu uç noktada yetkili hesap başına izin verilen çağrı sayısı; her Accounts API uç noktasında olduğu gibi.

Uç nokta ne döndürür?

Hesabın herkese açık gönderileri: profilinde görünen videolar, fotoğraf ve metin gönderileri ile profilde görünmeden reklam olarak yayımlanan Only show in ads videoları. media_type, VIDEO ile PHOTO'yu ayırt eder; PHOTO fotoğraf ve metin gönderilerini kapsar. Müzik telif hakkı gibi ihlaller nedeniyle TikTok'un filtrelediği gönderiler listeye dahil edilmez.

Nasıl çağrılır?

GET isteğiyle ve URL parametreleriyle çağrılır: business_id, JSON dizisi olarak fields ve isteğe bağlı olarak filters, cursor ve max_count (varsayılan 10). Token, Access-Token başlığında gönderilir; geliştirici uygulamasının TikTok Accounts altındaki Get Account Media iznine sahip olması gerekir:

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'

Bir gönderiyi tanımlayan alanlar hangileridir?

video_views ile impression_sources arasındaki metriklerin yanında, liste bu alanları da içerir; hepsi video.list kapsamındadır:

  • item_id: gönderinin ID'si; yorum çağrıları ve filters.video_ids tarafından kullanılır.
  • media_type: VIDEO veya fotoğraf ya da metin gönderisi için PHOTO.
  • is_ad: gönderinin bir reklamda kullanılıp kullanılmadığı.
  • create_time: gönderinin yayımlandığı zaman, UTC saatiyle Unix saniyesi olarak.
  • caption: gönderinin açıklaması, hashtag'ler dahil.
  • share_url: paylaşılabilir bağlantı; mobil ve masaüstünde farklı davranır.
  • embed_url: diğer sitelere gömmek için oynatıcı bağlantısı; Friends veya Only you olarak ayarlanmış gönderileri oynatmaz.
  • thumbnail_url: geçici bir önizleme görseli; son kullanma tarihi x-expires parametresindedir.
  • video_duration: saniye cinsinden uzunluk, üç ondalık basamağa kadar.

Bir sayfa sonucu nasıl görünür?

Yanıt, TikTok'un döndürdüğü sırayla bir videos dizisi içerir; ayrıca bir sonraki istekte gönderilecek değer olan cursor ve bir sonraki sayfanın olup olmadığını söyleyen has_more alanını da içerir. create_time, Unix saniyesi olarak bir dize (string) biçiminde gelir. TikTok'un örneği, açıklayıcı alanlar ve sayaçlarla kırpılmış hâliyle:

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

Sayfalama nasıl çalışır?

Zamana göre. cursor varsayılan olarak milisaniye cinsinden şu anı alır; böylece ilk sayfa en yeni gönderileri içerir ve her yanıt bir sonraki istek için cursor değerini döndürür. has_more true iken bu değeri gönderin. Özel bir zaman damgası, o andan önce yayımlanan gönderileri listeler; TikTok'un güven ve güvenlik kuralları ise daha fazla gönderi kalsa bile bir sayfanın max_count değerinden kısa olmasına yol açabilir.

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

Belirli gönderileri nasıl getirirsiniz?

filters ile, bir JSON nesnesi olarak: video_ids döndürülecek gönderi ID'lerini listeler; örneğin bir yayımlama durumundan gelen post_ids gibi. Yalnızca video_ids ile birlikte geçerli olan ad_post_only, Spark Ads için reklam verenlere yetkilendirilmiş gönderileri tutar. Filtreli bir istek diğerleri gibi aynı alanları alır; böylece tek bir çağrı, birkaç bilinen gönderi için en güncel sayıları döndürebilir.

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

Hangi sınırlar geçerlidir?

Accounts API, bu uç noktada yetkili hesap başına dakikada 40 çağrıya izin verir; bir uygulamanın Accounts API çağrıları toplamda Basic seviyede dakikada 600, bunun üzerinde ise 1.000 kadar çağrı alır. Açıklayıcı alanlar gerçek zamanlıdır, sayaçlar genellikle 24 ila 48 saat gecikir ve bir gönderinin verisi yayımlandıktan 365 gün sonra güncellenmeyi durdurur.

easyCoexistence videoları nasıl listeler?

list_social_posts ile; bu araç account_id ve isteğe bağlı limit alır, TikTok için 1 ila 20 arası. TikTok'un ilk sayfasını döndürür: item_id, create_time, caption, share_url, thumbnail_url, video_views, likes, comments ve shares alanlarıyla en yeni gönderiler; ayrıca cursor ve has_more. Sonraki sayfalar ve diğer alanlar, get_social_credentials'tan gelen token ve business_id ile kendi kodunuzdan alınır:

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>

Yaygın hatalar

  • item_id olmadan alan istemek. TikTok'un referansı, item_id içermeyen birden çok alanlı bir isteğin başarısız olabileceğini uyarır.
  • Sayfa eksik geldiğinde durmak. TikTok, has_more hâlâ true iken max_count değerinden az gönderi döndürebilir; bu yüzden bunun yerine has_more alanını izleyin.
  • thumbnail_url'i sonra kullanmak üzere saklamak. Bu geçici bir bağlantıdır; x-expires parametresindeki zamanda sona erer, bu yüzden ihtiyaç duyulduğunda yeni bir tane alın.
  • Listede özel gönderiler aramak. Uç nokta yalnızca herkese açık gönderileri döndürür.
Bunu EasyCoexistence'la yapmak

Bağlantı başına ayda US$ 9 ile US$ 0,75 arasında, bağlantı sayısı arttıkça düşer; ilk 3 gün ücretsiz.

Sık sorulan sorular

TikTok API'si bir seferde kaç video listeleyebilir?

/business/video/list/ ile sayfa başına 20'ye kadar. max_count sayfa boyutunu belirler ve varsayılan değeri 10'dur; daha fazlası için cursor'ı izleyin.

TikTok API'si fotoğraf gönderilerini de listeler mi?

Evet. /business/video/list/ herkese açık video, fotoğraf ve metin gönderilerini döndürür; media_type, VIDEO ile PHOTO'yu ayırt eder.

TikTok video listesi yalnızca reklam için olan gönderileri de içerir mi?

Evet. /business/video/list/ ayrıca profilde görünmeden reklam olarak yayımlanan Only show in ads videoları döndürür; is_ad ise bir gönderinin reklamda kullanılıp kullanılmadığını söyler.

Neden bir TikTok gönderisi API listesinde eksik?

Uç nokta yalnızca herkese açık gönderileri listeler; TikTok, müzik telif hakkı gibi ihlaller nedeniyle filtrelediği gönderileri dışarıda bırakır.

Okumaya devam edin

İlk kanalınızı iki dakikada bağlayın.

Beklemeniz gereken platform incelemesi yok. WhatsApp, Instagram, TikTok veya başka bir kanalı bağlayın, ardından yapay zekânızdan paylaşım yapmasını, yanıtlamasını ya da rapor vermesini isteyin ve işini izleyin.

  • 3 gün ücretsiz
  • İstediğiniz zaman iptal
  • Yalnızca resmi API'ler
  • 7/24 izleniyor

Doğrulama tarihi