taskType SOCIAL に platform instagram を指定し、action で読み取る対象を選びます。完了したリクエスト 1 件につき 0.5 クレジットです。
リクエスト
GET /v1/async/task/{id} をポーリングするか Webhook で受け取ります。非同期タスクを参照してください。
アクション
username にはユーザー名かプロフィール URL を指定します。postUrl には https://www.instagram.com/p/Df147tCiAyB/ のような投稿、リール、IGTV の URL を指定します。
パラメータ
query:searchでは必須。キーワード、ハッシュタグの語、ブランド名です。limit: 任意。searchは 1-30 でデフォルトは 10、postsは 1-12 でデフォルトは 12、commentsは 1-500 でデフォルトは 50 です。
レスポンス例
結果フィールド
- すべてのレスポンスは
platformとactionをそのまま返します。一覧にはreturnedCountがあります。 profileはid、username、displayName、biography、bioLinks、avatarUrl、profileUrl、isVerified、isPrivate、followerCount、followingCount、postCount、hasReels、highlights、threadsUsername、pronouns、recentPostsを返します。アカウントがストーリーを公開している間はlatestStoryAtが現れ、isMemorializedは追悼アカウントを示します。postsはpostsを返します。アカウントの最近の投稿 12 件で、各投稿のページから読み取ったlikeCount、commentCount、publishedAtが付きます。postはpostと投稿の最初のcommentsを返します。投稿にはid、code、url、mediaType(image、video、carousel)、caption、imageUrl、images、videoUrl、width、height、likeCount、commentCount、publishedAt、username、authorFullName、authorIsVerified、authorProfileImageUrl、coauthors、taggedUsers、topics、audio(楽曲か投稿者のオリジナル音源)、hasAudio、captionIsEdited、aiLabel、commentsDisabledがあります。commentsはcommentsを返します。各コメントにはid、text、username、likeCount、replyCount、publishedAtがあります。GIF のコメントにはgifUrlが付きます。availableCountは投稿のコメント数で、partial: trueは一覧がその数より短いことを示します。searchはpostsを返し、各投稿にはposition、投稿者のusername、authorId、authorIsVerified、authorProfileImageUrlがあり、リールにはplayCountがあります。Instagram にそのキーワードの検索ページがある場合、sourceはinstagramになり、そのページのtitle、relatedKeywords、キーワードについての Instagram のsummaryと、その脚注番号が指すsourcesが加わります。ほかのキーワードではsourceはwebで、postsには直近 30 日の公開投稿とリールが入ります。- Instagram はログアウトした訪問者に、プロフィールの最近の投稿 12 件と投稿のコメント 10 件ほどを表示し、
posts、post、commentsはその範囲を返します。検索結果の数値と公開日時はpostで読み取ります。 - 存在しないアカウントや投稿、非公開の投稿、Instagram がログインした訪問者にしか表示しないページは、タスクを
PAGE_UNAVAILABLEで終了させます。課金されるのは完了したリクエストだけです。