プラットフォームの稼働状況
- 24時間の稼働状況
- 正常
過去30日間
利用可能な機能
Toutiaoの各アクションについて、内容、料金、過去24時間の稼働状況を掲載しています。アクションを開くと、パラメータ、レスポンスフィールド、コードサンプルを確認できます。
| 機能 | できること | 1,000リクエストあたり | 24時間の稼働状況 |
|---|---|---|---|
記事詳細article | URLからToutiaoの記事または動画を読み取ります。タイトル、本文、カバー画像、閲覧数または再生数、いいね数、コメント数、シェア数、投稿者の認証情報を取得できます。全文や文字起こしは、ページに表示されている場合にのみ含まれます。 | 1,000リクエストあたり$0.56 | 正常 |
プロフィールprofile | Toutiaoアカウントのニックネーム、自己紹介、アバター、プロフィールリンク、認証状態とその説明を取得します。user_idには、通常MS4wで始まるアカウントトークンか、プロフィールの完全なURLを指定します。ニックネームや短い数値IDは使用できません。 | 1,000リクエストあたり$0.56 | 正常 |
ユーザーの投稿user_posts | Toutiaoの投稿者の記事、動画、短文投稿を一覧で取得します。タイトル、本文、閲覧数または再生数、いいね数、コメント数、シェア数、公開日時を取得できます。tabでプロフィールのセクションを選択します。1回の取得ですべての過去投稿を網羅できるとは限りません。 | 1,000リクエストあたり$0.56 | 正常 |
プロフィール検索profile_search | Toutiaoの特定アカウントの投稿内をキーワードで検索します。一致した記事と動画を、本文、閲覧数または再生数、エンゲージメント数とともに取得できます。user_idとkeywordはどちらも必須です。ユーザーの検索やプラットフォーム全体の検索は行いません。 | 1,000リクエストあたり$0.56 | 正常 |
コメントcomments | Toutiaoの記事または動画のトップレベルコメントを、1ページあたり20件取得します。各コメントには本文、いいね数、返信数、投稿日時、コメント投稿者の名前、アバター、認証情報、IP地域、記事または動画の投稿者がいいねしたかどうかが含まれます。記事または動画のリンクか数値IDを指定し、next_page_tokenで次のページを取得します。返信そのものは返されませんが、reply_countで返信の件数がわかります。 | 1,000リクエストあたり$0.81 | 正常 |
動画の詳細video | リンクまたは数値IDを指定して、Toutiaoの動画1本を検索します。タイトル、長さ、再生数、いいね数、コメント数、シェア数、保存数、公開日時、カバー画像、署名付きの動画ファイルリンク、投稿者名を取得できます。横長動画では、インプレッション数、投稿者のプロフィールトークン、フォロワー数も追加されます。縦型のショート動画にも対応しています。 | 1,000リクエストあたり$0.81 | 正常 |
機能を開くと、パラメータ、レスポンスフィールド、コードサンプル、トライアルを確認できます。
Toutiaoの各アクションではどのような入力を指定できますか？
以下の各回答では、呼び出し可能なアクション1つとその実際の入力を対応付けています。パラメータの意味と指定可能な値はアクションごとに異なります。同じ名前でも、すべてのプラットフォームで同じ意味になるとは限りません。
公式情報源へのリンクは、横に記載したプラットフォーム用語を説明する目的でのみ掲載しています。プラットフォームによる認可や推奨を意味するものではありません。また、このページに記載がない限り、公式サイトの機能はEveryInfra APIには含まれません。
| アクション | 必須 | 任意 | 提供方式 | 上限 | 1,000件あたり | レスポンスフィールド |
|---|---|---|---|---|---|---|
article記事詳細 URLからToutiaoの記事または動画を読み取ります。タイトル、本文、カバー画像、閲覧数または再生数、いいね数、コメント数、シェア数、投稿者の認証情報を取得できます。全文や文字起こしは、ページに表示されている場合にのみ含まれます。 | url | — | Sync配信 | — | 1,000リクエストあたり$0.56 | id · url · type · title · text · content_text · cover · read_count · play_count · like_count · comment_count · share_count · source · author_name · author_id · author_verified · author_auth_info · region · posted_at · platform · duration_sec · duration_seconds · image_urls |
profileプロフィール Toutiaoアカウントのニックネーム、自己紹介、アバター、プロフィールリンク、認証状態とその説明を取得します。 | user_id | — | Sync配信 | — | 1,000リクエストあたり$0.56 | user_id · nickname · bio · url · avatar_url · is_verified · verify_reason · platform |
user_postsユーザーの投稿 Toutiaoの投稿者の記事、動画、短文投稿を一覧で取得します。タイトル、本文、閲覧数または再生数、いいね数、コメント数、シェア数、公開日時を取得できます。 | user_id | tab | Sync配信 | カタログ値：defaultLimit=20、maxLimit=100。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$0.56 | id · url · type · title · text · content_text · cover · read_count · play_count · like_count · comment_count · share_count · source · author_name · author_id · author_verified · author_auth_info · region · posted_at · platform · duration_sec · duration_seconds · image_urls |
profile_searchプロフィール検索 Toutiaoの特定アカウントの投稿内をキーワードで検索します。一致した記事と動画を、本文、閲覧数または再生数、エンゲージメント数とともに取得できます。 | user_id, keyword | — | Sync配信 | カタログ値：defaultLimit=20、maxLimit=100。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$0.56 | id · url · type · title · text · content_text · cover · read_count · play_count · like_count · comment_count · share_count · source · author_name · author_id · author_verified · author_auth_info · region · posted_at · platform · duration_sec · duration_seconds · image_urls |
commentsコメント Toutiaoの記事または動画のトップレベルコメントを、1ページあたり20件取得します。各コメントには本文、いいね数、返信数、投稿日時、コメント投稿者の名前、アバター、認証情報、IP地域、記事または動画の投稿者がいいねしたかどうかが含まれます。記事または動画のリンクか数値IDを指定し、 | url | page_token | Sync配信 | 1回の呼び出しで最大20行の1ページを返します。次のページを取得するには、レスポンスのトップレベルにあるnext_page_tokenをpage_tokenとして渡します。limitは指定できますが、効果はありません。 | 1,000リクエストあたり$0.81 | id · text · like_count · reply_count · posted_at · author_id · author_name · author_avatar_url · author_verified · author_auth_info · ip_location · liked_by_author · platform |
video動画の詳細 リンクまたは数値IDを指定して、Toutiaoの動画1本を検索します。タイトル、長さ、再生数、いいね数、コメント数、シェア数、保存数、公開日時、カバー画像、署名付きの動画ファイルリンク、投稿者名を取得できます。横長動画では、インプレッション数、投稿者のプロフィールトークン、フォロワー数も追加されます。縦型のショート動画にも対応しています。 | url | — | Sync配信 | — | 1,000リクエストあたり$0.81 | id · url · video_type · title · duration_sec · duration_seconds · play_count · like_count · comment_count · share_count · collect_count · impression_count · posted_at · cover_url · video_url · author_id · author_name · author_avatar_url · author_follower_count · author_verified · author_auth_info · platform |
Toutiaoのarticleのパラメータはそれぞれどういう意味ですか？
URLからToutiaoの記事または動画を読み取ります。タイトル、本文、カバー画像、閲覧数または再生数、いいね数、コメント数、シェア数、投稿者の認証情報を取得できます。全文や文字起こしは、ページに表示されている場合にのみ含まれます。
完全なAPIリファレンス：パラメータ、コードサンプル、レスポンス例、稼働状況url必須articleアクションで使用する、特定の記事または動画の完全なURLです。ユーザー単位のアクションでurlとuser_idの両方を指定した場合、プロフィールページの特定にはurlが優先されます。
Toutiaoのprofileのパラメータはそれぞれどういう意味ですか？
Toutiaoアカウントのニックネーム、自己紹介、アバター、プロフィールリンク、認証状態とその説明を取得します。user_idには、通常MS4wで始まるアカウントトークンか、プロフィールの完全なURLを指定します。ニックネームや短い数値IDは使用できません。
user_id必須- 対象ユーザーのプロフィールトークンまたは
secUidで、通常はMS4wで始まります。このフィールドにはToutiaoのプロフィールの完全なURLも指定できます。表示ニックネームや短い数値UIDは使用できません。
Toutiaoのuser_postsのパラメータはそれぞれどういう意味ですか？
Toutiaoの投稿者の記事、動画、短文投稿を一覧で取得します。タイトル、本文、閲覧数または再生数、いいね数、コメント数、シェア数、公開日時を取得できます。tabでプロフィールのセクションを選択します。1回の取得ですべての過去投稿を網羅できるとは限りません。
user_id必須- 対象ユーザーのプロフィールトークンまたは
secUidで、通常はMS4wで始まります。このフィールドにはToutiaoのプロフィールの完全なURLも指定できます。表示ニックネームや短い数値UIDは使用できません。 tab任意user_postsで、プロフィールフィードのタブを選択します。指定できる値はall（デフォルト）、article、video、ugc、short_videoです。アイテム詳細の種類は変わりません。Toutiao：Micro-Toutiaoと記事は別のコンテンツタイプ — Toutiaoクリエイターヘルプセンターでは、Micro-Toutiaoを短いソーシャルコンテンツとして説明し、その投稿と編集の手順を別途紹介しています。このAPIは上記の列の仕様に従って投稿を読み取るものであり、これらの手順を参照しているからといって、投稿、編集、トピックへの参加、クリエイター収益の獲得ができるようになるわけではありません。 · 確認日
Toutiaoのprofile_searchのパラメータはそれぞれどういう意味ですか？
Toutiaoの特定アカウントの投稿内をキーワードで検索します。一致した記事と動画を、本文、閲覧数または再生数、エンゲージメント数とともに取得できます。user_idとkeywordはどちらも必須です。ユーザーの検索やプラットフォーム全体の検索は行いません。
user_id必須- 対象ユーザーのプロフィールトークンまたは
secUidで、通常はMS4wで始まります。このフィールドにはToutiaoのプロフィールの完全なURLも指定できます。表示ニックネームや短い数値UIDは使用できません。 keyword必須profile_searchで、user_idで指定した対象プロフィール内の投稿を検索するためのクエリ文字列です。Toutiao全体の検索は行いません。
Toutiaoのcommentsのパラメータはそれぞれどういう意味ですか？
Toutiaoの記事または動画のトップレベルコメントを、1ページあたり20件取得します。各コメントには本文、いいね数、返信数、投稿日時、コメント投稿者の名前、アバター、認証情報、IP地域、記事または動画の投稿者がいいねしたかどうかが含まれます。記事または動画のリンクか数値IDを指定し、next_page_tokenで次のページを取得します。返信そのものは返されませんが、reply_countで返信の件数がわかります。
url必須- Toutiaoの記事または動画のリンク（https://www.toutiao.com/article/<ID>/ または https://www.toutiao.com/video/<ID>/。旧形式の /i<ID>/、/a<ID>/、/item/<ID>/ のリンクも使用できます）、またはリンク内の数値IDを指定します。1回の呼び出しで、トップレベルのコメントを最大20件、1ページ分返します。
page_token任意commentsのページトークンです。次のページを取得するには前回のレスポンスのnext_page_tokenを渡し、最初のページから始めるには省略します。urlはトークンを返した呼び出しと同じ値にしてください。トークンの有効期限は24時間で、1ページにつき1回の呼び出しになります。
Toutiaoのvideoのパラメータはそれぞれどういう意味ですか？
リンクまたは数値IDを指定して、Toutiaoの動画1本を検索します。タイトル、長さ、再生数、いいね数、コメント数、シェア数、保存数、公開日時、カバー画像、署名付きの動画ファイルリンク、投稿者名を取得できます。横長動画では、インプレッション数、投稿者のプロフィールトークン、フォロワー数も追加されます。縦型のショート動画にも対応しています。
完全なAPIリファレンス：パラメータ、コードサンプル、レスポンス例、稼働状況url必須- Toutiaoの動画リンク（https://www.toutiao.com/video/<ID>/。/item/<ID>/ と /group/<ID>/ のリンクも使用できます）、またはリンク内の数値IDを指定します。記事のIDを指定すると空の結果が返ります。
Toutiao APIの使い方
- 01公開カタログからプラットフォームのアクションを選択します。
- 02プラットフォーム、アクション、必須パラメータをPOST /api/v1/socialに送信します。
- 03レスポンスから結果を読み取ります。非同期のアクションの場合は、返されたジョブIDをポーリングします。
- 04アプリケーションで必要なレスポンスフィールドを保存します。
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"toutiao","action":"article","params":{"url":"<url>"}}'
Toutiao APIに関する質問
Toutiao APIでは何を取得できますか？
platformをtoutiaoに設定します。現在のカタログには記事詳細、プロフィール、ユーザーの投稿、プロフィール検索、コメント、moreが掲載されています。これらのアクション名はそれぞれ異なるToutiaoのオブジェクトやビューを表すもので、互いに置き換えられる検索モードではありません。
Toutiaoのarticleリクエストを開始するには、どの入力を使用しますか？
articleアクションで使用する、特定の記事または動画の完全なURLです。ユーザー単位のアクションでurlとuser_idの両方を指定した場合、プロフィールページの特定にはurlが優先されます。params内のurlとして送信してください。
Toutiaoのarticleはどのフィールドを返しますか？
宣言されたスキーマにはtype、title、text、content_textが含まれます。宣言されたフィールドでも個々のレコードには含まれない場合があり、他のアクションにはそれぞれ独自のフィールド一覧があります。
Toutiaoのアクションはすべて即座に結果を返しますか？
非同期と表示されたアクションはジョブIDを返すので、そのIDをポーリングします。それ以外のすべてのアクションも非同期で実行できます。リクエストボディに"mode": "async"を追加するとすぐにジョブIDが返されるため、時間のかかるタスクや上限値を大きく設定する場合に便利です。現在のカタログにはsync配信が含まれています。