GETInsights3 credits

Analyze image (vision)

GET https://api.instagramapi.dev/v1/insights/post/image

Runs an account-safe vision model over a post's image(s) and returns structured tags: subjects, scene, objects, dominant colors, any text in the image, mood, an aesthetic score, brand-safety flags, and suggested alt text. Carousels analyze up to the first few images. Cost: 3 credits.

Build this with an AI agent

Paste this prompt into Claude, Codex, or any coding agent.

Parameters

Name	Type	Required	Description
post	string	yes	An Instagram post/reel. Accepts a media id, a shortcode (`C1a2b3c4d5e`), or a full post/reel URL. We resolve it automatically.

Example request

curl "https://api.instagramapi.dev/v1/insights/post/image?post=https%3A%2F%2Fwww.instagram.com%2Fp%2FC1a2b3c4d5e%2F" \
  -H "Authorization: Bearer $INSTAGRAMAPI_KEY"

const res = await fetch("https://api.instagramapi.dev/v1/insights/post/image?post=https%3A%2F%2Fwww.instagram.com%2Fp%2FC1a2b3c4d5e%2F", {
  headers: { Authorization: `Bearer ${process.env.INSTAGRAMAPI_KEY}` },
});

res = requests.get("https://api.instagramapi.dev/v1/insights/post/image?post=https%3A%2F%2Fwww.instagram.com%2Fp%2FC1a2b3c4d5e%2F",
    headers={"Authorization": f"Bearer {INSTAGRAMAPI_KEY}"})

Try it

Live request · uses 3 credits

API key

post *string

Example responses

Switch tabs to see the body shape for success and each error status.

{
  "data": {
    "post": "https://www.instagram.com/p/DZK3iOsRlWX/",
    "caption": "Just Do It.",
    "analysis": {
      "subjects": [
        "athlete",
        "running shoe"
      ],
      "scene": "outdoor track at sunrise",
      "objects": [
        "sneakers",
        "track",
        "starting blocks"
      ],
      "dominant_colors": [
        "orange",
        "black",
        "grey"
      ],
      "text_in_image": "JUST DO IT",
      "mood": "energetic",
      "aesthetic_score": 8.5,
      "brand_safe": true,
      "brand_safety_notes": "No unsafe content.",
      "suggested_alt_text": "A sprinter on a track at sunrise wearing orange Nike shoes."
    }
  },
  "meta": {
    "endpoint": "insights/post/image",
    "request_id": "req_3f8a1c9e",
    "credits_charged": 3,
    "credits_remaining": 4987,
    "ms": 412
  }
}

{
  "error": {
    "code": "missing_parameter",
    "message": "Missing required parameter \"post\".",
    "docs": "/docs/insights/post/image"
  },
  "meta": {
    "request_id": "req_3f8a1c9e"
  }
}

{
  "error": {
    "code": "invalid_api_key",
    "message": "This API key is invalid or has been revoked.",
    "docs": "/docs#authentication"
  },
  "meta": {
    "request_id": "req_3f8a1c9e"
  }
}

{
  "error": {
    "code": "insufficient_credits",
    "message": "You're out of credits. Top up to continue.",
    "docs": "/dashboard/billing"
  },
  "meta": {
    "request_id": "req_3f8a1c9e"
  }
}

{
  "error": {
    "code": "not_found",
    "message": "No public data for that request (private, deleted, or nonexistent). This is a billed request. We queried Instagram on your behalf.",
    "docs": "/docs/insights/post/image"
  },
  "meta": {
    "request_id": "req_3f8a1c9e",
    "endpoint": "insights/post/image",
    "credits_charged": 3,
    "credits_remaining": 4985
  }
}

{
  "error": {
    "code": "upstream_error",
    "message": "Upstream data provider error. You were not charged. Please retry.",
    "docs": "/docs/insights/post/image"
  },
  "meta": {
    "request_id": "req_3f8a1c9e"
  }
}

Response fields

Fields returned under data on a 200 response. Every response also includes a meta object with billing info.

Field	Type	Description
post	string	The post URL that was analyzed.
caption	string	The post's caption.
analysis	object	The vision model's structured findings.
analysis.subjects	array<string>	Main subjects detected in the image.
analysis.scene	string	Description of the overall scene.
analysis.objects	array<string>	Notable objects detected in the image.
analysis.dominant_colors	array<string>	The image's dominant colors.
analysis.text_in_image	string	Any text read from the image.
analysis.mood	string	Overall mood/feel of the image.
analysis.aesthetic_score	number	Aesthetic quality score (0–10).
analysis.brand_safe	boolean	Whether the image is safe for brand use.
analysis.brand_safety_notes	string	Notes explaining the brand-safety judgment.
analysis.suggested_alt_text	string	Suggested alt text describing the image.