ログイン無料トライアルを開始
easyCoexistence 公式 API

API で TikTok アカウントの動画を一覧表示する

TikTok API for Business は、GET /business/video/list/ でアカウントの公開投稿を新しい順に、1 ページ最大 20 件まで返します。item_id、caption、share_url、video_views など返してほしいフィールドを指定し、has_more が true の間は cursor でページを送ってください。filters.video_ids で特定の投稿を絞り込めます。各 item_id は、コメント系の呼び出しで使う ID です。

easyCoexistence は、Claude、ChatGPT、または自作のコードから list_social_posts を使って TikTok アカウントの最近の投稿を一覧し、各投稿の item_id、キャプション、リンク、件数を取得できます。

20

/business/video/list/ が 1 ページで返す投稿数の上限を max_count で指定し、既定値は 10 です。

Milliseconds

cursor の単位は UTC の Unix タイムスタンプです。エンドポイントはその時刻より前に公開された投稿を返します。

item_id

既定のフィールドは、複数のフィールドを指定するリクエストに必ず含める必要があり、含めないとエラーが起きることがあります。

40/min

このエンドポイントの呼び出し上限は、認可されたアカウントごとに Accounts API の各エンドポイントと同じです。

このエンドポイントは何を返しますか?

アカウントの公開投稿です。プロフィールに表示される動画、写真とテキストの投稿、そしてプロフィールには表示されず広告としてだけ配信される「Only show in ads」の動画が含まれます。media_type で VIDEO と PHOTO を区別でき、PHOTO は写真とテキストの投稿を指します。音楽の著作権侵害など、TikTok が規約違反としてフィルタリングした投稿は一覧から除かれます。

どのように呼び出しますか?

GET メソッドと URL パラメーターを使います。business_id と fields(JSON 配列)を指定し、必要に応じて filters、cursor、max_count を加えられます。max_count の既定値は 10 です。トークンは Access-Token ヘッダーに入れ、開発者アプリには TikTok Accounts の「Get Account Media」権限が必要です:

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'

投稿を説明するフィールドはどれですか?

指標は video_views から impression_sources まで含まれ、そのほかに次のフィールドが一覧に含まれます。いずれも video.list スコープの対象です:

  • item_id: 投稿の ID です。コメント系の呼び出しや filters.video_ids で使います。
  • media_type: VIDEO か、写真やテキストの投稿を表す PHOTO です。
  • is_ad: 投稿が広告に使われているかどうかです。
  • create_time: 投稿された日時を、UTC の Unix 秒で表したものです。
  • caption: 投稿の説明文です。ハッシュタグも含まれます。
  • share_url: 共有用のリンクです。モバイルとデスクトップで挙動が異なります。
  • embed_url: 他のサイトに埋め込むためのプレーヤーリンクです。「友達」または「自分のみ」に設定された投稿は再生されません。
  • thumbnail_url: 一時的なプレビュー画像の URL です。有効期限は x-expires パラメーターにあります。
  • video_duration: 長さを秒単位で、小数点以下 3 桁まで表したものです。

結果の 1 ページはどのような形ですか?

TikTok が返す順の videos 配列と、次のページに使う値である cursor、次のページがあるかどうかを示す has_more が含まれます。create_time は Unix 秒を表す文字列として返されます。以下は TikTok の例を、説明用のフィールドと件数だけに絞ったものです:

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

ページネーションはどのように動きますか?

時刻を基準にします。cursor の既定値はミリ秒単位の現在時刻なので、最初のページには最新の投稿が含まれます。各レスポンスは次のリクエストに使う cursor を返すので、has_more が true の間はそれを渡してください。任意のタイムスタンプを指定すると、その時刻より前に公開された投稿を一覧できます。ただし TikTok の信頼と安全に関するルールにより、まだ投稿が残っていても、ページが max_count より少ない件数になることがあります。

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

特定の投稿だけを取得するには?

filters を使います。これは JSON オブジェクトで、video_ids には返してほしい投稿の ID を指定します。例えば投稿の公開ステータスから得た post_ids などです。ad_post_only は video_ids と一緒にのみ指定でき、Spark Ads で広告主に許可された投稿だけを残します。フィルター付きのリクエストも他のリクエストと同じフィールドを取得できるので、1 回の呼び出しで既知の数件の投稿について最新の数値を取得できます。

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

どのような上限がありますか?

Accounts API では、このエンドポイントについて認可されたアカウントごとに 1 分あたり 40 回まで呼び出せます。アプリ全体の Accounts API の呼び出しは、ベーシックレベルで 1 分あたり 600 回、それより上のレベルでは 1 分あたり 1,000 回までです。説明的なフィールドはリアルタイムで、件数は通常 24 から 48 時間遅れます。投稿のデータは、公開から 365 日後に更新されなくなります。

easyCoexistence は動画をどのように一覧しますか?

list_social_posts を使います。引数は account_id と、任意の limit です。TikTok では limit に 1 から 20 を指定できます。返されるのは TikTok の最初のページで、最新の投稿について item_id、create_time、caption、share_url、thumbnail_url、video_views、likes、comments、shares、さらに cursor と has_more が含まれます。以降のページやそのほかのフィールドは、get_social_credentials のトークンと business_id を使って、ご自身のコードから取得してください:

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>

よくある間違い

  • item_id を含めずにフィールドを指定すること。TikTok のリファレンスでは、item_id を含めずに複数のフィールドを指定したリクエストは失敗することがあると注意されています。
  • ページが少ない件数で返ってきたら止めること。has_more が true のままでも、TikTok は max_count より少ない投稿を返すことがあるため、代わりに has_more に従ってください。
  • thumbnail_url を後のために保存すること。これは一時的なリンクで、x-expires パラメーターの時刻に期限切れになるため、必要なときに改めて取得してください。
  • 非公開の投稿を一覧に探すこと。このエンドポイントが返すのは公開投稿だけです。
EasyCoexistence で実現する

以降のページやそのほかのフィールドについては、get_social_credentials が自作のコードにトークンを渡します。料金は接続 1 件あたり月額 US$ 9 から US$ 0.75 まで、接続を増やすほど下がります。最初の 3 日間は無料トライアルです。

よくある質問

TikTok API で一度に何件の動画を一覧できますか?

/business/video/list/ から 1 ページ最大 20 件です。max_count でページのサイズを指定でき、既定値は 10 です。さらに取得するには cursor をたどってください。

TikTok API は写真の投稿も一覧しますか?

はい。/business/video/list/ は公開された動画、写真、テキストの投稿を返し、media_type で VIDEO と PHOTO を区別できます。

TikTok の動画一覧に広告専用の投稿は含まれますか?

はい。/business/video/list/ は「Only show in ads」の動画も返します。これはプロフィールに表示されず広告としてだけ配信される動画で、is_ad で投稿が広告に使われているかどうかを確認できます。

TikTok の投稿が API の一覧にないのはなぜですか?

このエンドポイントは公開投稿を一覧し、音楽の著作権侵害など規約違反としてフィルタリングされた投稿は除外されるためです。

続きを読む

最初のチャンネルを 2 分で接続しましょう。

プラットフォームの審査を待つ必要はありません。WhatsApp、Instagram、TikTok などのチャンネルを接続して、AI に投稿、返信、レポートを任せてみてください。

  • 3 日間無料
  • いつでも解約可能
  • 公式 API のみ使用
  • 24/7 監視

確認日