InsightSocial API
Instagram

Instagram Post API reference

Your first 10 calls are free, no card needed. Pricing and FAQ

Get a free API key
Example request
curl "https://api.insightsocial.app/v1/instagram/post?url=https%3A%2F%2Fwww.instagram.com%2Fp%2FDcCH2ZygIiP%2F" \
  -H "x-api-key: $INSIGHTSOCIAL_API_KEY"

Step-by-step: Read on-screen text from TikTok and Instagram posts

GET
/v1/instagram/post

Returns one post's details: caption, view count on videos and reels, like and comment counts, media URLs, media type, the author, and any tagged users.

Use it for the standard single post lookup, views included on video; use post/stats only when you also need the share count.

10 credits per call.

Authorization

apiKey
x-api-key<token>

Your key from the dashboard. It starts with isk_.

In: header

Query Parameters

url*string

Full URL of the Instagram post

region?string

2 letter country code to set the proxy in

trim?boolean

Set to true to get a trimmed response

download_media?boolean

Set to true to also download the video/images and get back durable hosted media URLs under data.post.ext.download_media_urls ([{ post_id, cdn_url, type, cached }]). Use these for archiving; the raw media_urls are short-lived signed CDN links that expire. Adds a few seconds of latency while the media is fetched.

dry_run?"1"

Set to 1 to get the price of this call without making it: data.dry_run carries credits_min and credits_max. Nothing is charged.

Value in

  • "1"

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.insightsocial.app/v1/instagram/post?url=string"
{  "success": true,  "platform": "string",  "endpoint": "string",  "schema_version": "2",  "pagination": {    "next_cursor": "string",    "has_more": true,    "page_size": 0,    "stopped_at": "since"  },  "unavailable": [    "string"  ],  "credits_used": 0,  "credits_remaining": 0,  "request_id": "string",  "cached": true,  "idempotent_replay": true,  "charge_reason": "string",  "free_call": true,  "data": {    "post": {      "id": "string",      "url": "http://example.com",      "kind": "string",      "content": {        "text": "string",        "media_urls": [          "http://example.com"        ],        "thumbnail_url": "http://example.com",        "duration_seconds": 0      },      "author": {        "id": "string",        "username": "string",        "display_name": "string",        "avatar_url": "http://example.com",        "verified": true      },      "engagement": {        "views": 0,        "likes": 0,        "comments": 0,        "shares": 0,        "saves": 0      },      "flags": {        "nsfw": true,        "spoiler": true,        "pinned": true,        "deleted": true,        "likes_hidden": true,        "comments_hidden": true,        "shares_hidden": true,        "views_hidden": true,        "saves_hidden": true      },      "published_at": "2019-08-24T14:15:22Z",      "language": "string",      "ext": {        "property1": null,        "property2": null      }    }  }}

Post › Stats GET

Returns one post's engagement: likes, comments, and, on video posts only, the play count and the share count shown by the paper plane icon. Collab posts also list co-authors under ext.coauthors.

Profile › About GET

Returns Instagram's "About this account" details for a public account (country, month joined, published contact) plus its follower count and lifetime post count.