InstagramアカウントインサイトAPI
APIの稼働状況
- 24時間の稼働状況
- 正常
- 24時間の平均応答時間
- —
- 良好/正常
- 利用可能
- 制限あり
- ほぼ停止
過去24時間
過去30日間
公開プロフィールをもとに、Instagramハンドルのアカウント概要を取得します。自己紹介、カテゴリ、フォロワー数、投稿数、アカウント種別のフラグ、最近の投稿が含まれます。レスポンスには、年齢、性別、興味関心などの属性や購入者情報は含まれず、それらを推測することもありません。
profileと同じパラメータとフィールドです。レスポンスにはトップレベルのpersonaオブジェクトも含まれます。これはプロフィール情報と最近の投稿をもとにAIが作成したアカウントのプロフィールです。
料金は1,000リクエストあたり$0.56(1回あたり$0.000556)です。失敗した呼び出しと空の結果には課金されません。 同期処理です。時間のかかるジョブでは、ボディに"mode": "async"を追加し、job_idを取得してポーリングしてください。
AIプロンプト
EveryInfraのInstagram アカウントインサイトエンドポイント(instagram/persona)を使ったデータ収集スクリプトの作成を手伝ってください。
エンドポイントの仕組み:
- リクエスト:ヘッダーにAuthorization: Bearer <API key>を指定して、https://api.everyinfra.com/api/v1/socialにPOSTします。APIキーは環境変数EVERYINFRA_API_KEYから読み込み、ハードコードしないでください。
- リクエストボディでplatformにinstagram、actionにpersonaを指定し、パラメータはparamsの中に入れます。
- 必須パラメータ:
- username: Instagramアカウントのハンドル(@なし)または完全なプロフィールURLを指定します。profile、persona、user_posts、reelsでアカウントデータの取得に使用します。followersアクションはフォロワーの総数のみを返し、followers_listとfollowing_listはアカウントの一覧を返します。
- 1つのオブジェクトを返します。主なフィールド: username、display_name、bio、follower_count、following_count、post_count、is_private、is_verified、is_business、is_professional、category、external_url。フィールドは全部で19個です。一覧はhttps://api.everyinfra.com/api/v1/social/catalog?platform=instagramを参照してください。.
- レスポンスにはトップレベルのpersonaオブジェクト(industry, niche, authenticity, summary)も含まれます。AIが英語で作成したアカウントのプロフィールで、生成できない場合はnullになります。
- リクエストボディの例:
{
"platform": "instagram",
"action": "persona",
"params": {
"username": "nasa"
}
}
- 料金:1,000リクエストあたり$0.56。失敗時および結果が空の場合は課金されません。
- 対象が数十〜数百件ある場合は、ボディに"mode": "async"を追加します。すぐにjob_idが返されるので、GET https://api.everyinfra.com/api/v1/jobs/{job_id}をポーリングして結果を取得します。
- 422の場合は、エラーに含まれる推奨パラメータ名と指定可能な値を使ってリクエストを修正します。429または503の場合は、Retry-Afterの指定に従って待ってから再試行します。
コードを書く前に、必要な対象とその件数、必要なフィールド、希望する出力形式を私に質問してください。そのうえで、計画と概算費用を私に確認してください。リクエストパラメータ
| 名前 | 場所 | 型 | 必須 | デフォルト | 説明 |
|---|---|---|---|---|---|
Authorization | header | string | はい | - | Bearerの後にAPIキーを続けます。APIキーはコンソールで作成してください。URLやコードリポジトリには絶対に含めないでください。 |
platform | body | string | はい | instagram | プラットフォームの識別子です。値は固定です。 |
action | body | string | はい | persona | 機能の識別子です。値は固定です。 |
username | body.params | string | はい | - | Instagramアカウントのハンドル(@なし)または完全なプロフィールURLを指定します。profile、persona、user_posts、reelsでアカウントデータの取得に使用します。followersアクションはフォロワーの総数のみを返し、followers_listとfollowing_listはアカウントの一覧を返します。 |
コードサンプル
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
-H "Authorization: Bearer $EVERYINFRA_API_KEY" \
-H 'Content-Type: application/json' \
--data-raw '{
"platform": "instagram",
"action": "persona",
"params": {
"username": "nasa"
}
}'OpenAPI定義(JSON)サンプルは環境変数EVERYINFRA_API_KEYからAPIキーを読み込みます。コピーしたコードにAPIキーが含まれることはありません。
レスポンス例
September 26, 2026 at 08:56(UTC)に、上のコードサンプルのパラメータでこのAPIを呼び出して取得しました。resultsとcountはその呼び出しの実際のレスポンスから個人情報(名前、ハンドル、アバター、プロフィールリンク、連絡先)を削除したものです。id、billing、quotaは呼び出しごとに異なるため、構造のみを示しています。
{
"id": "req_…",
"platform": "instagram",
"action": "persona",
"results": {
"username": "nasa",
"display_name": "NASA",
"bio": "Making the seemingly impossible, possible. ✨",
"follower_count": 104336090,
"following_count": 89,
"post_count": 4934,
"is_private": false,
"is_verified": true,
"is_business": false,
"is_professional": false,
"external_url": "https://www.nasa.gov",
"avatar_url": "https://scontent.cdninstagram.com/•••",
"recent_posts": [
{
"post_id": "DdHyaYAifb6",
"url": "https://www.instagram.com/p/DdHyaYAifb6",
"text": "Cementing their names in history.\n\nThe Artemis III crew is leaving their mark — literally. The astronauts recently signed their names on the hardware that will be inside their Orion spacecraft during their low Earth orbit mission, launching in 2027.\n\nImage descriptions:\n\n1. The A…",
"media_type": "image",
"like_count": 0,
"comment_count": 0,
"view_count": 0,
"author_username": "nasa",
"posted_at": "2026-09-10T00:00:00+00:00"
},
{
"post_id": "DdWyDLcGiqo",
"url": "https://www.instagram.com/p/DdWyDLcGiqo",
"text": "Southern Hemisphere Milky Way galaxy view from the @••• cupola. This 3s exposure series captured two of my favorite cupola views, the particularly dense Milky Way galaxy as seen from the Southern Hemisphere, and the bright, colorful lights of squid fishing boats (here, the brig…",
"media_type": "image",
"like_count": 0,
"comment_count": 0,
"view_count": 0,
"author_username": "•••",
"posted_at": "2026-09-16T00:00:00+00:00"
},
{
"post_id": "DdT_4GMka0z",
"url": "https://www.instagram.com/p/DdT_4GMka0z",
"text": "In a class of their own\n\nHidden within this star-forming nebula (captured by our Webb telescope in one of its largest images to date) are strange objects called brown dwarfs. Generally less massive than stars and more massive than planets, they are neither. They form the same way…",
"media_type": "image",
"like_count": 0,
"comment_count": 0,
"view_count": 0,
"author_username": "•••",
"posted_at": "2026-09-15T00:00:00+00:00"
}
]
},
"persona": {
"industry": …,
"niche": …,
"authenticity": …,
"summary": …
},
"billing": {
"charged": …,
"charged_usd": …,
"balance_after_usd": …,
…
},
"quota": { … }
}レスポンスフィールド
業務データはresultsに含まれます。この表はレコードに含まれうるフィールドの一覧です。プラットフォームに表示されない値を作り出すことはありません。
| フィールド | 意味 |
|---|---|
username | ユーザー名(@ハンドル)です。 |
display_name | 表示名です。usernameとは異なる場合があります。 |
bio | アカウント自身が記載したプロフィール文です。改行や絵文字を含む場合があります。 |
follower_count | フォロワー数です。nullは0ではなく、非公開であることを示します。 |
following_count | フォロー中のアカウント数です。nullは0ではなく、非公開であることを示します。 |
post_count | 総投稿数です。nullは0ではなく、非公開であることを示します。 |
is_private | プラットフォーム上の意味のまま |
is_verified | プラットフォームがアカウントを認証済みかどうかを示します。nullは判定できないことを示します。 |
is_business | プラットフォーム上の意味のまま |
is_professional | プラットフォーム上の意味のまま |
category | プラットフォーム独自の分類体系におけるカテゴリ名です。プラットフォーム間で正規化されていません。 |
external_url | プラットフォーム上の意味のまま |
avatar_url | アバター画像のリンクです。一部のプラットフォームでは、サイズ指定付きで有効期限が切れる可能性のあるCDNリンクが返されます。 |
user_id | プラットフォーム上でのユーザーの一意なIDです。 |
avatar_hd_url | プラットフォーム上の意味のまま |
external_urls | プラットフォーム上の意味のまま |
has_reels | プラットフォーム上の意味のまま |
highlight_count | プラットフォーム上の意味のまま |
recent_posts | プラットフォーム上の意味のまま |
同期呼び出しと非同期ジョブ(mode: async)のどちらでも、レスポンスのトップレベルにはresultsと並んでpersonaオブジェクトも含まれます。これはプロフィール情報と直近の投稿(最大6件)をもとにAIが英語で作成したアカウントのプロフィールです。生成できない場合はnullになり、resultsは通常どおり返されます。
| フィールド | 意味 |
|---|---|
persona.industry | アカウントが属する業界です。 |
persona.niche | その業界内のニッチ分野です。 |
persona.authenticity | 真正性の評価です。通常は簡潔な理由が添えられます。 |
persona.summary | アカウントの概要を数文でまとめたものです。 |
エラーと課金
- 401
- キーが未指定か無効です。
- 402
- 残高が不足しています。先にチャージしてください。
- 422
- パラメータ名または値が無効です。エラーに含まれる候補を参考に修正してください。課金はされません。
- 429
- 1分あたりのリクエスト上限に達しました。Retry-Afterの指定に従って待ってから再試行してください。
- 503
- 処理を完了できませんでした。保留中の請求額は残高に戻されます。結果が不明な場合は、再試行する前に確認してください。
- 200(空)
- データがありません。課金はされません。