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で終了させます。課金されるのは完了したリクエストだけです。