メインコンテンツへスキップ
公開されている Threads のデータを非同期タスク API で JSON として読み取ります。taskType SOCIAL に platform threads を指定し、action で読み取る対象を選びます。完了したリクエスト 1 件につき 0.5 クレジットです。

リクエスト

タスクを送信したあと、GET /v1/async/task/{id} をポーリングするか Webhook で受け取ります。非同期タスクを参照してください。

アクション

username にはユーザー名かプロフィール URL を指定します。postUrl には https://www.threads.com/@natgeo/post/Dfzi22JJSYp のような投稿 URL を指定します。

パラメータ

  • query: search では必須です。
  • limit: 任意。search と profile は 1-50 でデフォルトは 10、replies は 1-500 でデフォルトは 50 です。

レスポンス例

結果フィールド

  • すべてのレスポンスは platform と action をそのまま返します。一覧には returnedCount があります。
  • 投稿には id、code、url、text、author、authorVerified、publishedAt、mediaType (text、image、video、carousel)、images、videoUrl、likeCount、replyCount、repostCount、quoteCount、shareCount、isReply があります。返信には、返信先のユーザー名を示す replyTo が加わります。
  • search は Threads が表示する順に posts を最大 50 件ほど返します。
  • profile は id、username、displayName、biography、bioLinks、avatarUrl、profileUrl、isVerified、isPrivate、followerCount、threadCount、recentPosts を返します。recentPosts はプロフィールページに表示される最近の投稿 4-13 件です。
  • post は post を返します。replies は replies を返し、投稿 1 件につき 10 件ほどです。availableCount は投稿の返信数で、partial: true は投稿者が返信を非表示にした場合など、一覧がその数より短いことを示します。
  • 存在しないか公開されていないプロフィールや投稿は、タスクを PAGE_UNAVAILABLE で終了させます。課金されるのは完了したリクエストだけです。

関連