Skip to content
ScraperSocial API

Instagram API

Nine endpoints under /v1/instagram/*. All are GET, authenticated with Authorization: Bearer sk_live_..., and return the standard { data, meta?, request_id } envelope. Reel transcription is audio-based, so it costs more credits than TikTok’s subtitle-backed transcripts.

GET /v1/instagram/transcript

Full transcript of an Instagram reel with timestamped segments.

Credits: 40 per reel · Caching: Cached forever

Parameters

Name Description
url required Public Instagram content URL.
fresh optional true bypasses the cache at the same credit price.
format optional json (default), csv or text where applicable.

Request

Terminal window
curl "https://api.scrapersocial.com/v1/instagram/transcript?url=https%3A%2F%2Fwww.instagram.com%2Freel%2FC8xQvZ2sVAb%2F" \
  -H "Authorization: Bearer sk_live_..."

Response

{
  "data": {
    "platform": "instagram",
    "entity_id": "C8xQvZ2sVAb",
    "language": "en",
    "source": "audio",
    "text": "Today I want to show you the three settings everyone ignores when they set this up for the first time...",
    "segments": [
      {
        "start": 0,
        "end": 3.2,
        "text": "Today I want to show you the three settings"
      },
      {
        "start": 3.2,
        "end": 5.9,
        "text": "everyone ignores when they set this up"
      }
    ]
  },
  "request_id": "req_01JZX4M8Q2TE9W"
}

GET /v1/instagram/summary

Short AI summary of an Instagram reel, built on its transcript.

Credits: 42 per reel · Caching: Cached forever

Parameters

Name Description
url required Public Instagram content URL.
fresh optional true bypasses the cache at the same credit price.
format optional json (default), csv or text where applicable.

Request

Terminal window
curl "https://api.scrapersocial.com/v1/instagram/summary?url=https%3A%2F%2Fwww.instagram.com%2Freel%2FC8xQvZ2sVAb%2F" \
  -H "Authorization: Bearer sk_live_..."

Response

{
  "data": {
    "platform": "instagram",
    "entity_id": "C8xQvZ2sVAb",
    "language": "en",
    "summary": "A quick tutorial covering three commonly missed configuration steps, with a before/after comparison and a call to check the pinned comment for the full guide."
  },
  "request_id": "req_01JZX4M8Q2TE9W"
}

GET /v1/instagram/stats

Likes, comments and view counts for an Instagram post or reel.

Credits: 1 per post · Caching: Age-aware cache (15 min - 7 days)

Parameters

Name Description
url required Public Instagram content URL.
fresh optional true bypasses the cache at the same credit price.
format optional json (default), csv or text where applicable.

Request

Terminal window
curl "https://api.scrapersocial.com/v1/instagram/stats?url=https%3A%2F%2Fwww.instagram.com%2Freel%2FC8xQvZ2sVAb%2F" \
  -H "Authorization: Bearer sk_live_..."

Response

{
  "data": {
    "platform": "instagram",
    "entity_id": "C8xQvZ2sVAb",
    "url": "https://www.instagram.com/reel/C8xQvZ2sVAb/",
    "author": {
      "handle": "instagram",
      "name": "Example Creator"
    },
    "posted_at": "2026-06-30T14:05:00Z",
    "metrics": {
      "views": 1204593,
      "likes": 88410,
      "comments": 2314,
      "shares": 10092
    }
  },
  "request_id": "req_01JZX4M8Q2TE9W"
}

GET /v1/instagram/comments

Paginated comments on an Instagram post; charged per comment returned.

Credits: 3 per comment · Caching: Age-aware cache (15 min - 7 days) · Paginated (cursor/limit)

Parameters

Name Description
url required Public Instagram content URL.
limit optional Items per page (default 20, max 50 sync; larger via async jobs).
cursor optional Opaque cursor from the previous page's meta.cursor.
fresh optional true bypasses the cache at the same credit price.
format optional json (default), csv or text where applicable.

Request

Terminal window
curl "https://api.scrapersocial.com/v1/instagram/comments?url=https%3A%2F%2Fwww.instagram.com%2Freel%2FC8xQvZ2sVAb%2F" \
  -H "Authorization: Bearer sk_live_..."

Response

{
  "data": [
    {
      "id": "c_9021",
      "text": "This fixed it for me, thank you",
      "author": {
        "handle": "dev.casey"
      },
      "likes": 412,
      "posted_at": "2026-07-01T09:12:00Z"
    },
    {
      "id": "c_9022",
      "text": "Can you do a follow-up on the advanced settings?",
      "author": {
        "handle": "mariana.codes"
      },
      "likes": 96,
      "posted_at": "2026-07-01T10:44:00Z"
    }
  ],
  "meta": {
    "count": 2,
    "limit": 50,
    "cursor": "eyJvZmZzZXQiOjUwfQ",
    "has_more": true
  },
  "request_id": "req_01JZX4M8Q2TE9W"
}

GET /v1/instagram/channel-stats

Follower counts, bio and profile metadata for an Instagram account.

Credits: 3 per profile · Caching: Cached 12 hours

Parameters

Name Description
handle required Public Instagram handle (without @).
fresh optional true bypasses the cache at the same credit price.
format optional json (default), csv or text where applicable.

Request

Terminal window
curl "https://api.scrapersocial.com/v1/instagram/channel-stats?handle=instagram" \
  -H "Authorization: Bearer sk_live_..."

Response

{
  "data": {
    "platform": "instagram",
    "handle": "instagram",
    "name": "Example Creator",
    "bio": "Tutorials and behind-the-scenes. New video every Tuesday.",
    "verified": true,
    "metrics": {
      "followers": 2450318,
      "following": 132,
      "posts": 842
    }
  },
  "request_id": "req_01JZX4M8Q2TE9W"
}

GET /v1/instagram/channel-posts

Latest posts from an Instagram account with per-post metrics.

Credits: 2 per post · Caching: Cached 3 hours (page 1: 1 hour) · Paginated (cursor/limit)

Parameters

Name Description
handle required Public Instagram handle (without @).
limit optional Items per page (default 20, max 50 sync; larger via async jobs).
cursor optional Opaque cursor from the previous page's meta.cursor.
fresh optional true bypasses the cache at the same credit price.
format optional json (default), csv or text where applicable.

Request

Terminal window
curl "https://api.scrapersocial.com/v1/instagram/channel-posts?handle=instagram" \
  -H "Authorization: Bearer sk_live_..."

Response

{
  "data": [
    {
      "id": "C8xQvZ2sVAb",
      "url": "https://www.instagram.com/reel/C8xQvZ2sVAb/",
      "caption": "Three settings you should change today",
      "posted_at": "2026-07-03T12:00:00Z",
      "metrics": {
        "likes": 55210,
        "comments": 981
      }
    },
    {
      "id": "C8xQvZ2sVAb1",
      "url": "https://www.instagram.com/reel/C8xQvZ2sVAb/",
      "caption": "Three settings you should change today",
      "posted_at": "2026-07-03T12:00:00Z",
      "metrics": {
        "likes": 55210,
        "comments": 981
      }
    }
  ],
  "meta": {
    "count": 2,
    "limit": 20,
    "cursor": "eyJwYWdlIjoyfQ",
    "has_more": true,
    "item": "post"
  },
  "request_id": "req_01JZX4M8Q2TE9W"
}

GET /v1/instagram/channel-reels

Latest reels from an Instagram account with per-reel metrics.

Credits: 3 per reel · Caching: Cached 3 hours (page 1: 1 hour) · Paginated (cursor/limit)

Parameters

Name Description
handle required Public Instagram handle (without @).
limit optional Items per page (default 20, max 50 sync; larger via async jobs).
cursor optional Opaque cursor from the previous page's meta.cursor.
fresh optional true bypasses the cache at the same credit price.
format optional json (default), csv or text where applicable.

Request

Terminal window
curl "https://api.scrapersocial.com/v1/instagram/channel-reels?handle=instagram" \
  -H "Authorization: Bearer sk_live_..."

Response

{
  "data": [
    {
      "id": "C8xQvZ2sVAb",
      "url": "https://www.instagram.com/reel/C8xQvZ2sVAb/",
      "caption": "POV: your setup finally works",
      "posted_at": "2026-07-05T15:30:00Z",
      "metrics": {
        "views": 421009,
        "likes": 38112,
        "comments": 640
      }
    },
    {
      "id": "C8xQvZ2sVAb1",
      "url": "https://www.instagram.com/reel/C8xQvZ2sVAb/",
      "caption": "POV: your setup finally works",
      "posted_at": "2026-07-05T15:30:00Z",
      "metrics": {
        "views": 421009,
        "likes": 38112,
        "comments": 640
      }
    }
  ],
  "meta": {
    "count": 2,
    "limit": 20,
    "cursor": "eyJwYWdlIjoyfQ",
    "has_more": true,
    "item": "reel"
  },
  "request_id": "req_01JZX4M8Q2TE9W"
}

Keyword search over Instagram reels.

Credits: 3 per result · Caching: Age-aware cache (15 min - 7 days) · Paginated (cursor/limit)

Parameters

Name Description
query required Search keywords.
limit optional Items per page (default 20, max 50 sync; larger via async jobs).
cursor optional Opaque cursor from the previous page's meta.cursor.
fresh optional true bypasses the cache at the same credit price.
format optional json (default), csv or text where applicable.

Request

Terminal window
curl "https://api.scrapersocial.com/v1/instagram/reels-search?query=coffee%20brewing" \
  -H "Authorization: Bearer sk_live_..."

Response

{
  "data": [
    {
      "id": "v_77120",
      "url": "https://example-result-url",
      "caption": "How I plan a week of posts in 30 minutes",
      "author": {
        "handle": "plannerpro"
      },
      "metrics": {
        "views": 88210,
        "likes": 5120
      },
      "posted_at": "2026-07-08T16:20:00Z"
    },
    {
      "id": "v_771201",
      "url": "https://example-result-url",
      "caption": "How I plan a week of posts in 30 minutes",
      "author": {
        "handle": "plannerpro"
      },
      "metrics": {
        "views": 88210,
        "likes": 5120
      },
      "posted_at": "2026-07-08T16:20:00Z"
    }
  ],
  "meta": {
    "count": 2,
    "limit": 20,
    "cursor": "eyJwYWdlIjoyfQ",
    "has_more": true,
    "item": "result"
  },
  "request_id": "req_01JZX4M8Q2TE9W"
}

GET /v1/instagram/download

Resolves a downloadable media URL for an Instagram reel (URL expires within 1h).

Credits: 40 per video · Caching: Cached 7 days (media URLs max 1h)

Parameters

Name Description
url required Public Instagram content URL.
fresh optional true bypasses the cache at the same credit price.
format optional json (default), csv or text where applicable.

Request

Terminal window
curl "https://api.scrapersocial.com/v1/instagram/download?url=https%3A%2F%2Fwww.instagram.com%2Freel%2FC8xQvZ2sVAb%2F" \
  -H "Authorization: Bearer sk_live_..."

Response

{
  "data": {
    "platform": "instagram",
    "entity_id": "C8xQvZ2sVAb",
    "media_url": "https://cdn.example/video/master.mp4?sig=...",
    "mime_type": "video/mp4",
    "expires_at": "2026-07-15T13:00:00Z",
    "warning": "media_url is short-lived (max 1h) — download promptly or re-request."
  },
  "request_id": "req_01JZX4M8Q2TE9W"
}

Related: TikTok API · Facebook API · Output formats