extractr docs
Instagram

Public posts by username (paginated)

GET
/instagram/get_posts

A page of a public account's posts, newest first — the same grid the profile page loads and pages through. Each post has its media, caption, and engagement. Pass the returned next_cursor back as cursor to fetch the next page. Scraped anonymously — no login. Private accounts return no posts.

Costs 2 credits per request.

Authorization

ApiKeyAuth
X-API-Key<token>

API key created in the extractr dashboard (ext_live_...). Also accepted as Authorization: Bearer.

In: header

Query Parameters

username*string

Instagram handle, with or without a leading @.

Match^@?[A-Za-z0-9._]+$
Length1 <= length <= 30
count?integer

Posts per page (1–50).

Range1 <= value <= 50
Default12
cursor?string

Opaque pagination cursor from a previous response’s next_cursor. Omit for the first page.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/instagram/get_posts?username=instagram"
{  "username": "nasa",  "user_id": "528817151",  "is_private": true,  "total_posts": 4856,  "count": 12,  "next_cursor": "string",  "has_more": true,  "posts": [    {      "id": "3312345678901234567",      "shortcode": "C1a2b3c4d5e",      "url": "https://www.instagram.com/p/C1a2b3c4d5e/",      "type": "image",      "caption": "New drop out now 🔥",      "display_url": "https://instagram.fxxx.fna.fbcdn.net/v/...",      "thumbnail_url": "string",      "is_video": true,      "video_url": "string",      "likes": 10432,      "comments": 214,      "video_views": 88400,      "taken_at": "2026-05-11T18:04:00.000Z",      "width": 1080,      "height": 1350,      "accessibility_caption": "string"    }  ]}
{  "error": {    "code": "invalid_api_key",    "message": "The provided API key is invalid or has been revoked."  }}
{  "error": {    "code": "invalid_api_key",    "message": "The provided API key is invalid or has been revoked."  }}
{  "error": {    "code": "invalid_api_key",    "message": "The provided API key is invalid or has been revoked."  }}
{  "error": {    "code": "invalid_api_key",    "message": "The provided API key is invalid or has been revoked."  }}
{  "error": {    "code": "invalid_api_key",    "message": "The provided API key is invalid or has been revoked."  }}
{  "error": {    "code": "invalid_api_key",    "message": "The provided API key is invalid or has been revoked."  }}
{  "error": {    "code": "invalid_api_key",    "message": "The provided API key is invalid or has been revoked."  }}