IngiaAnza kipindi cha majaribio bila malipo
easyCoexistence API rasmi

Kuorodhesha video za akaunti ya TikTok kupitia API

API ya TikTok for Business inaorodhesha machapisho ya umma ya akaunti kwa GET /business/video/list/, kuanzia la hivi karibuni, hadi 20 kwa ukurasa. Taja sehemu za kurudisha, kama item_id, caption, share_url na video_views, kisha pitia kurasa kwa cursor mradi has_more ni true. filters.video_ids huchagua machapisho mahususi, na kila item_id ni ID ambayo simu za maoni zinatumia.

easyCoexistence huorodhesha machapisho ya hivi karibuni ya akaunti ya TikTok kwa list_social_posts kutoka Claude, ChatGPT au msimbo wako mwenyewe, pamoja na item_id, caption, kiungo na hesabu ya kila chapisho, na get_social_credentials huipa msimbo wako mwenyewe token kwa kurasa zinazofuata na sehemu nyingine.

20

Idadi kubwa zaidi ya machapisho ambayo /business/video/list/ hurudisha kwa ukurasa; max_count huchukua 10 kama chaguo-msingi.

Milliseconds

Kipimo cha cursor ni muhuri wa muda wa Unix wa UTC; endpoint hii hurudisha machapisho yaliyochapishwa kabla ya muda huo.

item_id

Sehemu chaguo-msingi, ambayo ombi lenye sehemu kadhaa lazima liijumuishe, vinginevyo hitilafu inaweza kutokea.

40/min

Simu zinazoruhusiwa kwa kila akaunti iliyoidhinishwa kwenye endpoint hii, kama ilivyo kwa kila endpoint ya Accounts API.

Endpoint hii hurudisha nini?

Machapisho ya umma ya akaunti: video zinazoonekana kwenye wasifu wake, machapisho ya picha na maandishi, na video za "Only show in ads", zinazoendeshwa kama matangazo bila kuonekana kwenye wasifu. media_type inatofautisha VIDEO na PHOTO, ambayo inajumuisha machapisho ya picha na maandishi. Machapisho ambayo TikTok imeyachuja kwa ukiukaji, kama hakimiliki ya muziki, hayamo kwenye orodha.

Unaitumiaje endpoint hii?

Kwa GET na vigezo vya URL: business_id, fields kama JSON array, na hiari filters, cursor na max_count, ambayo huchukua 10 kama chaguo-msingi. Token huwekwa kwenye header ya Access-Token, na programu ya msanidi inahitaji ruhusa ya Get Account Media chini ya 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'

Ni sehemu gani zinaelezea chapisho?

Mbali na vipimo, vinavyoanzia video_views hadi impression_sources, orodha hii ina sehemu hizi, zote chini ya wigo wa video.list:

  • item_id: ID ya chapisho, inayotumiwa na simu za maoni pamoja na filters.video_ids.
  • media_type: VIDEO, au PHOTO kwa chapisho la picha au maandishi.
  • is_ad: kama chapisho linatumika kwenye tangazo.
  • create_time: wakati chapisho lilipochapishwa, kama sekunde za Unix kwa UTC.
  • caption: maelezo ya chapisho, pamoja na hashtag.
  • share_url: kiungo cha kushiriki, ambacho hufanya kazi tofauti kwenye simu na kompyuta ya mezani.
  • embed_url: kiungo cha kicheza video kwa tovuti nyingine; hakiwezi kucheza machapisho yaliyowekwa kwa "Friends" au "Only you".
  • thumbnail_url: picha ya onyesho la kukagua ya muda, ambayo muda wake wa kuisha upo kwenye kigezo chake cha x-expires.
  • video_duration: urefu kwa sekunde, hadi desimali tatu.

Ukurasa wa matokeo unaonekanaje?

Safu ya videos kwa mpangilio ambao TikTok inaurudisha, pamoja na cursor, thamani ya kutuma kwa ukurasa unaofuata, na has_more, ambayo inaonyesha kama kuna ukurasa huo. create_time hufika kama mfuatano wa sekunde za Unix. Mfano wa TikTok, ukiwa umepunguzwa hadi sehemu za maelezo na hesabu:

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

Kugawa kurasa kunafanyaje kazi?

Kwa muda. cursor huchukua sasa hivi kwa milisekunde kama chaguo-msingi, hivyo ukurasa wa kwanza una machapisho ya hivi karibuni, na kila jibu hurudisha cursor ya ombi lifuatalo. Ipitishe mradi has_more ni true. Muhuri wa muda uliobinafsishwa huorodhesha machapisho yaliyochapishwa kabla ya wakati huo, na kanuni za usalama na uaminifu za TikTok zinaweza kufanya ukurasa uwe mfupi kuliko max_count hata kama machapisho zaidi yapo.

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

Unapataje machapisho mahususi?

Kwa filters, kitu cha JSON: video_ids huorodhesha ID za machapisho ya kurudisha, kama post_ids kutoka kwenye hali ya uchapishaji. ad_post_only, halali pamoja na video_ids pekee, huhifadhi machapisho yaliyoidhinishwa kwa watangazaji kwa Spark Ads pekee. Ombi lililochujwa linachukua sehemu zile zile kama ombi lolote, hivyo simu moja inaweza kurudisha takwimu za hivi karibuni za machapisho machache yanayojulikana.

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

Vikomo vipi vinatumika?

Accounts API inaruhusu simu 40 kwa dakika kwa kila akaunti iliyoidhinishwa kwenye endpoint hii, na simu zote za Accounts API za programu moja zinapata 600 kwa dakika kwenye kiwango cha Basic na 1,000 kwa zaidi ya hapo. Sehemu za maelezo ni za wakati halisi, hesabu kwa kawaida huchelewa saa 24 hadi 48, na data ya chapisho huacha kusasishwa siku 365 baada ya kuchapishwa.

easyCoexistence inaorodhesha video vipi?

Kwa list_social_posts, ambayo huchukua account_id na limit ya hiari, kuanzia 1 hadi 20 kwa TikTok. Inarudisha ukurasa wa kwanza wa TikTok: machapisho ya hivi karibuni yenye item_id, create_time, caption, share_url, thumbnail_url, video_views, likes, comments na shares, pamoja na cursor na has_more. Kurasa zinazofuata na sehemu nyingine hutoka kwenye msimbo wako mwenyewe, kwa token na business_id kutoka 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>

Makosa ya kawaida

  • Kuomba sehemu bila item_id. Marejeo ya TikTok yanaonya kwamba ombi linalotaja sehemu kadhaa bila hiyo linaweza kushindwa.
  • Kusimama ukurasa unaporudi mfupi. TikTok inaweza kurudisha machapisho chini ya max_count huku has_more ikiwa bado true, kwa hiyo fuata has_more badala yake.
  • Kuhifadhi thumbnail_url kwa baadaye. Ni kiungo cha muda kinachoisha muda wake kwenye kigezo cha x-expires, kwa hiyo pata mpya inapohitajika.
  • Kutafuta machapisho ya faragha kwenye orodha. Endpoint hurudisha machapisho ya umma pekee.
Kufanya hili ukitumia EasyCoexistence

Kuanzia US$ 9 hadi US$ 0.75 kwa kila muunganisho kwa mwezi, bei ikishuka unapoongeza miunganisho, na siku 3 za kwanza ni bure.

Maswali yanayoulizwa mara kwa mara

API inaweza kuorodhesha video ngapi za TikTok kwa mara moja?

Hadi 20 kwa ukurasa kutoka /business/video/list/. max_count huweka ukubwa wa ukurasa na huchukua 10 kama chaguo-msingi; fuata cursor kupata zaidi.

API ya TikTok pia huorodhesha machapisho ya picha?

Ndiyo. /business/video/list/ hurudisha machapisho ya umma ya video, picha na maandishi, na media_type hutofautisha VIDEO na PHOTO.

Orodha ya video za TikTok inajumuisha machapisho ya matangazo pekee?

Ndiyo. /business/video/list/ pia hurudisha video za "Only show in ads", zinazoendeshwa kama matangazo bila kuonekana kwenye wasifu, na is_ad inaonyesha kama chapisho linatumika kwenye tangazo.

Kwa nini chapisho la TikTok halipo kwenye orodha ya API?

Endpoint hii huorodhesha machapisho ya umma, na TikTok huyaacha nje machapisho yaliyochujwa kwa ukiukaji kama hakimiliki ya muziki.

Endelea kusoma

Unganisha chaneli yako ya kwanza ndani ya dakika mbili.

Hakuna ukaguzi wa majukwaa wa kusubiri. Unganisha WhatsApp, Instagram, TikTok au chaneli nyingine, kisha mwombe AI wako achapishe, ajibu au atoe ripoti, na uone akifanya kazi.

  • Siku 3 bila malipo
  • Ghairi wakati wowote
  • API rasmi pekee
  • Hufuatiliwa saa 24/7

Imethibitishwa kwenye