API CodexAPI Codex
WebsiteDashboardGet API Key
  • Documentation
  • All APIs
  • Changelog
Resources
  • Docs Home
  • API Catalog
  • API Codex Website
Platform
  • Get a free API key
  • Dashboard
  • APIs & Pricing

© 2026 API Codex. All rights reserved.

Information
Other endpoints
    Scrape an Instagram profile by URL or usernamegetScrape an Instagram post or reel by URLgetScrape an Instagram reel by URLgetList comments of an Instagram post or reelgetList recent posts of an Instagram profilegetFetch a pending scrape resultget
Schemas
powered by Zudoku
Advanced Instagram API
Advanced Instagram API

Other endpoints


Scrape an Instagram profile by URL or username

GET
https://api.apicodex.io/instagram
/v1/profile

Returns structured JSON for a profile. Pass either url or username (username builds https://www.instagram.com//). A fresh scrape usually returns in ~5-45s; if it exceeds the sync window you get a snapshot_id to fetch from /v1/result.

Scrape an Instagram profile by URL or username › query Parameters

url
​string

The profile URL to scrape. Required unless username is given.

Example: https://www.instagram.com/nasa
username
​string

Instagram username instead of a URL (with or without a leading @).

Example: nasa
fields
​string

Comma-separated top-level fields to keep in data.

Example: followers,posts_count,biography

Scrape an Instagram profile by URL or username › Responses

Scraped data.

type
​string
url
​string
​object
GET/v1/profile
curl 'https://api.apicodex.io/instagram/v1/profile?apikey=<api-key>'
Example Responses
{ "type": "profile", "url": "url", "data": {} }
json
application/json

Scrape an Instagram post or reel by URL

GET
https://api.apicodex.io/instagram
/v1/post

Returns structured JSON for a post / reel URL. A fresh scrape usually returns in ~5-45s; if it exceeds the sync window you get a snapshot_id to fetch from /v1/result.

Scrape an Instagram post or reel by URL › query Parameters

url
​string · required

The post / reel URL to scrape (instagram.com/p/... or /reel/...).

Example: https://www.instagram.com/p/DZz4bjIjhdm
fields
​string

Comma-separated top-level fields to keep in data.

Example: caption,likes,num_comments

Scrape an Instagram post or reel by URL › Responses

Scraped data.

type
​string
url
​string
​object
GET/v1/post
curl 'https://api.apicodex.io/instagram/v1/post?url=<string>&apikey=<api-key>'
Example Responses
{ "type": "post", "url": "url", "data": {} }
json
application/json

Scrape an Instagram reel by URL

GET
https://api.apicodex.io/instagram
/v1/reel

Returns structured JSON for a reel URL with reel-specific fields (views, plays, audio, etc). A fresh scrape usually returns in ~5-45s; if it exceeds the sync window you get a snapshot_id to fetch from /v1/result.

Scrape an Instagram reel by URL › query Parameters

url
​string · required

The reel URL to scrape (instagram.com/reel/...).

Example: https://www.instagram.com/reel/DZz4bjIjhdm
fields
​string

Comma-separated top-level fields to keep in data.

Example: views,plays,audio

Scrape an Instagram reel by URL › Responses

Scraped data.

type
​string
url
​string
​object
GET/v1/reel
curl 'https://api.apicodex.io/instagram/v1/reel?url=<string>&apikey=<api-key>'
Example Responses
{ "type": "reel", "url": "url", "data": {} }
json
application/json

List comments of an Instagram post or reel

GET
https://api.apicodex.io/instagram
/v1/comments

Returns the comments of a post / reel as an array of comment objects (comment_user, comment, likes, replies, ...). Often exceeds the sync window and returns a snapshot_id; results are typically ready within 1-2 minutes via /v1/result.

List comments of an Instagram post or reel › query Parameters

url
​string · required

The post / reel URL whose comments to list (instagram.com/p/... or /reel/...).

Example: https://www.instagram.com/p/DZz4bjIjhdm
limit
​integer · min: 1 · max: 50

Max comments to return (1-50, default 10).

Example: 10
Default: 10
fields
​string

Comma-separated top-level fields to keep on each comment object.

Example: comment_user,comment,likes

List comments of an Instagram post or reel › Responses

Comments list.

type
​string
url
​string
​object[]
GET/v1/comments
curl 'https://api.apicodex.io/instagram/v1/comments?url=<string>&apikey=<api-key>'
Example Responses
{ "type": "comments", "url": "url", "data": [ {} ] }
json
application/json

List recent posts of an Instagram profile

GET
https://api.apicodex.io/instagram
/v1/profile-posts

Discovers the recent posts of a profile and returns them as an array. Pass either url or username. Often exceeds the sync window and returns a snapshot_id; results are typically ready within 1-2 minutes via /v1/result.

List recent posts of an Instagram profile › query Parameters

url
​string

The profile URL whose posts to list. Required unless username is given.

Example: https://www.instagram.com/natgeo
username
​string

Instagram username instead of a URL (with or without a leading @).

Example: natgeo
limit
​integer · min: 1 · max: 50

Max posts to return (1-50, default 10).

Example: 10
Default: 10
start_date
​string

Only posts on/after this date (passthrough filter).

Example: 2026-01-01
end_date
​string

Only posts on/before this date (passthrough filter).

Example: 2026-06-30
post_type
​string

Filter by post type (passthrough filter).

Example: reel
fields
​string

Comma-separated top-level fields to keep on each post object.

Example: url,caption,likes

List recent posts of an Instagram profile › Responses

Posts list.

type
​string
url
​string
​object[]
GET/v1/profile-posts
curl 'https://api.apicodex.io/instagram/v1/profile-posts?apikey=<api-key>'
Example Responses
{ "type": "profile_posts", "url": "url", "data": [ {} ] }
json
application/json

Fetch a pending scrape result

GET
https://api.apicodex.io/instagram
/v1/result

Retrieve the result of a scrape that exceeded the sync window, using its snapshot_id. data is an array when the snapshot has multiple records (comments, profile-posts), otherwise a single object.

Fetch a pending scrape result › query Parameters

snapshot_id
​string · required

Fetch a pending scrape result › Responses

Result ready.

status
​string
snapshot_id
​string
​
GET/v1/result
curl 'https://api.apicodex.io/instagram/v1/result?snapshot_id=<string>&apikey=<api-key>'
Example Responses
{ "status": "ready", "snapshot_id": "snapshot_id", "data": {} }
json
application/json