Mag-log inMagsimula ng Libreng Trial
easyCoexistence Mga Official API

Pag-list ng mga video ng TikTok account gamit ang API

Inilista ng API for Business ng TikTok ang mga public post ng account gamit ang GET /business/video/list/, mula sa pinakabago, hanggang 20 kada page. Tukuyin ang mga field na ibabalik, gaya ng item_id, caption, share_url at video_views, at mag-page gamit ang cursor habang true ang has_more. Pinipili ng filters.video_ids ang partikular na post, at ang bawat item_id ay ang ID na ginagamit ng mga comment call.

Inilista ng easyCoexistence ang mga kamakailang post ng isang TikTok account gamit ang list_social_posts mula sa Claude, ChatGPT o sarili ninyong code, kasama ang item_id, caption, link at bilang ng bawat post.

20

Bilang ng post na ibinabalik ng /business/video/list/ kada page; ang default ng max_count ay 10.

Milliseconds

Yunit ng cursor ay UTC Unix timestamp; ibinabalik ng endpoint ang mga post na na-publish bago ito.

item_id

Ang default na field ay dapat isama ng request na may maraming field, kung hindi ay maaaring magkaroon ng error.

40/min

Bilang ng call na pinapayagan bawat authorized account sa endpoint na ito, gaya ng sa bawat endpoint ng Accounts API.

Ano ang ibinabalik ng endpoint?

Ang mga public post ng account: mga video na lumalabas sa profile nito, photo at text post, at mga Only show in ads video, na tumatakbo bilang ad nang hindi lumalabas sa profile. Sinasabi ng media_type kung VIDEO o PHOTO, na sumasaklaw sa photo at text post. Hindi kasama sa listahan ang mga post na inalis ng TikTok dahil sa paglabag, gaya ng copyright ng musika.

Paano ito tinatawag?

Gamit ang GET at URL parameter: business_id, fields bilang JSON array, at opsyonal na filters, cursor at max_count, na default sa 10. Ilalagay sa Access-Token header ang token, at kailangan ng developer app ang permission na Get Account Media sa ilalim ng 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'

Aling field ang naglalarawan sa post?

Bukod sa mga metric, mula video_views hanggang impression_sources, may kasama ang listahang ito, na lahat ay nasa ilalim ng video.list scope:

  • item_id: ang ID ng post, ginagamit ng comment call at ng filters.video_ids.
  • media_type: VIDEO, o PHOTO para sa photo o text post.
  • is_ad: kung ginagamit ang post sa ad.
  • create_time: kailan na-publish ang post, bilang Unix seconds sa UTC.
  • caption: ang paglalarawan ng post, kasama ang hashtag.
  • share_url: shareable na link, na iba ang kilos sa mobile at desktop.
  • embed_url: player link para sa ibang site, na hindi nagpe-play ng post na naka-set sa Friends o Only you.
  • thumbnail_url: pansamantalang preview image na ang expiry ay nasa parameter nitong x-expires.
  • video_duration: haba sa segundo, hanggang tatlong decimal.

Ano ang itsura ng isang pahina ng resulta?

Isang videos array na nasa pagkakasunod-sunod na ibinalik ng TikTok, kasama ang cursor, ang halagang ipapadala para sa susunod na page, at has_more, na nagsasabi kung mayroon pang susunod. Dumarating ang create_time bilang string ng Unix seconds. Halimbawa ng TikTok, pinaikli sa mga descriptive field at mga bilang:

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

Paano gumagana ang pagpe-page?

Batay sa oras. Ang default ng cursor ay ang kasalukuyang sandali sa milliseconds, kaya ang unang page ay naglalaman ng pinakabagong post, at ang bawat sagot ay nagbabalik ng cursor para sa susunod na request. Ipasa ito habang true ang has_more. Ang custom na timestamp ay naglilista ng mga post na na-publish bago ang sandaling iyon, at ang trust and safety rules ng TikTok ay maaaring gawing mas maikli ang isang page kaysa max_count kahit may natitira pang post.

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

Paano kukunin ang partikular na post?

Gamit ang filters, isang JSON object: inililista ng video_ids ang mga post ID na ibabalik, gaya ng post_ids mula sa publishing status. Ang ad_post_only, na valid lang kasama ng video_ids, ay nagtitira lang ng mga post na awtorisado para sa advertiser para sa Spark Ads. Ang filtered request ay tumatanggap ng parehong field gaya ng iba, kaya maaaring magbalik ang isang call ng pinakabagong numero para sa ilang kilalang post.

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

Anong mga limit ang nalalapat?

Pinapayagan ng Accounts API ang 40 call kada minuto para sa bawat authorized account sa endpoint na ito, at ang mga Accounts API call ng isang app ay pinagsama-samang 600 kada minuto sa Basic level at 1,000 pataas nito. Real time ang mga descriptive field, karaniwang 24 hanggang 48 oras ang bilang na nahuhuli, at humihinto sa pag-update ang data ng post 365 araw matapos itong ma-publish.

Paano nililista ng easyCoexistence ang mga video?

Gamit ang list_social_posts, na tumatanggap ng account_id at opsyonal na limit, mula 1 hanggang 20 para sa TikTok. Ibinabalik nito ang unang page ng TikTok: ang pinakabagong post na may item_id, create_time, caption, share_url, thumbnail_url, video_views, likes, comments at shares, pati cursor at has_more. Ang mga susunod na page at iba pang field ay galing sa sarili ninyong code, gamit ang token at business_id mula sa 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>

Mga karaniwang pagkakamali

  • Paghiling ng field nang walang item_id. Nagbababala ang reference ng TikTok na maaaring pumalya ang request na nagtutukoy ng maraming field kung wala ito.
  • Pagtigil kapag kulang ang isang page. Maaaring magbalik ang TikTok ng mas kaunti sa max_count na post habang true pa ang has_more, kaya sundin ang has_more.
  • Pag-iimbak ng thumbnail_url para sa susunod na gamit. Pansamantala lang ang link na ito at nag-e-expire sa oras na nasa parameter nitong x-expires, kaya kumuha ng bagong link kapag kailangan.
  • Paghahanap ng private na post sa listahan. Mga public post lang ang ibinabalik ng endpoint.
Ginagawa ito gamit ang EasyCoexistence

Ibinibigay ng get_social_credentials sa sarili ninyong code ang token para sa mga susunod na page at iba pang field. Mula US$ 9 hanggang US$ 0.75 kada koneksyon kada buwan, bumababa habang dumarami ang koneksyon, at may unang 3 araw na free trial.

Mga madalas itanong

Ilan ang TikTok video na kayang ilista ng API nang sabay?

Hanggang 20 kada page mula sa /business/video/list/. Itinatakda ng max_count ang laki ng page at default ito sa 10; sundan ang cursor para sa susunod pa.

Kasama ba sa listahan ng TikTok API ang photo post?

Oo. Ibinabalik ng /business/video/list/ ang mga public video, photo at text post, at sinasabi ng media_type kung VIDEO o PHOTO.

Kasama ba sa listahan ng TikTok video ang mga ad-only na post?

Oo. Ibinabalik din ng /business/video/list/ ang mga Only show in ads video, na tumatakbo bilang ad nang hindi lumalabas sa profile, at sinasabi ng is_ad kung ginagamit ang post sa ad.

Bakit nawawala sa listahan ng API ang isang TikTok post?

Mga public post lang ang inililista ng endpoint, at inaalis ng TikTok ang mga post na na-filter dahil sa paglabag, gaya ng copyright ng musika.

Magpatuloy sa pagbabasa

I-connect ang inyong unang channel sa loob ng dalawang minuto.

Walang review ng platform na hihintayin. I-connect ang WhatsApp, Instagram, TikTok o iba pang channel, pagkatapos ay utusan ang inyong AI na mag-post, mag-reply o gumawa ng report, at panoorin itong gumana.

  • 3 araw na libre
  • Mag-cancel anumang oras
  • Official API lang
  • Minomonitor 24/7

Na-verify noong