docs / instagram

Instagram Public Data API

base /instagram/v114 endpoints

post/instagram/v1/profile1 credit

public profile facts and first-page recent posts

Parameter		Allowed / range	Description
username	required	—	Instagram handle without the @ (the name in instagram.com/<username>).

Try in playground →

post/instagram/v1/posts1 credit

public profile timeline posts from feed/user with max_id pagination

Parameter		Allowed / range	Description
username	required	—	Instagram handle without the @ (the name in instagram.com/<username>).
limit = 12	optional	1–50	Max items to return (1-50). Larger values are clamped to 50.
max_id	optional	—	Pagination cursor from a previous response's page_info.next_max_id (also accepted as 'cursor'). Omit for the first page.

Try in playground →

post/instagram/v1/reels1 credit

public profile reels from clips/user with max_id pagination

Parameter		Allowed / range	Description
username	required	—	Instagram handle without the @ (the name in instagram.com/<username>).
limit = 12	optional	1–50	Max items to return (1-50). Larger values are clamped to 50.
max_id	optional	—	Pagination cursor from a previous response's page_info.next_max_id (also accepted as 'cursor'). Omit for the first page.

Try in playground →

post/instagram/v1/similar_accounts1 credit

public related profiles from web_profile_info

Parameter		Allowed / range	Description
username	required	—	Instagram handle without the @ (the name in instagram.com/<username>).
limit	optional	1–	Max related accounts to return (Instagram returns up to ~80).

Try in playground →

post/instagram/v1/search1 credit

topsearch blended public users, hashtags, and places

Parameter		Allowed / range	Description
query	required	—	Free-text search term (matches users / hashtags / places).

Try in playground →

post/instagram/v1/users_search1 credit

topsearch public users only

Parameter		Allowed / range	Description
query	required	—	Free-text search term (matches users / hashtags / places).

Try in playground →

post/instagram/v1/hashtag_search1 credit

topsearch public hashtags only

Parameter		Allowed / range	Description
query	required	—	Free-text search term (matches users / hashtags / places).

Try in playground →

post/instagram/v1/post_info1 credit

public media info by media_id or decoded shortcode

Parameter		Allowed / range	Description
shortcode	optional	—	Post shortcode — the code in instagram.com/p/<shortcode>/ or /reel/<shortcode>/ (a full post/reel URL is also accepted). Provide shortcode OR media_id.
media_id	optional	—	Numeric media id (from a post's media_id field). Provide media_id OR shortcode.

Try in playground →

post/instagram/v1/post_comments1 credit

public media comments by media_id or decoded shortcode when available logged-out

Parameter		Allowed / range	Description
shortcode	optional	—	Post shortcode — the code in instagram.com/p/<shortcode>/ or /reel/<shortcode>/ (a full post/reel URL is also accepted). Provide shortcode OR media_id.
media_id	optional	—	Numeric media id (from a post's media_id field). Provide media_id OR shortcode.
limit	optional	1–	Max comments to return (caps the public first-page comments).

Try in playground →

post/instagram/v1/related_posts1 credit

related public media candidates from media info when exposed logged-out

Parameter		Allowed / range	Description
shortcode	optional	—	Post shortcode — the code in instagram.com/p/<shortcode>/ or /reel/<shortcode>/ (a full post/reel URL is also accepted). Provide shortcode OR media_id.
media_id	optional	—	Numeric media id (from a post's media_id field). Provide media_id OR shortcode.
limit	optional	1–	Max related posts to return.

Try in playground →

post/instagram/v1/highlights1 credit

account-gated highlights tray; flagged after logged-out endpoint returned login redirect

Parameter		Allowed / range	Description
username	optional	—	Instagram handle without the @ (the name in instagram.com/<username>).
user_id	optional	—	Numeric Instagram user id (a profile's user_id). Alternative to username for id-based lookups.
limit	optional	1–	Max highlight trays to return.

Try in playground →

post/instagram/v1/followers1 credit

account-gated followers list; flagged for account-pool decision

Parameter		Allowed / range	Description
username	optional	—	Instagram handle without the @ (the name in instagram.com/<username>).
user_id	optional	—	Numeric Instagram user id (a profile's user_id). Alternative to username for id-based lookups.

Try in playground →

post/instagram/v1/following1 credit

account-gated following list; flagged for account-pool decision

Parameter		Allowed / range	Description
username	optional	—	Instagram handle without the @ (the name in instagram.com/<username>).
user_id	optional	—	Numeric Instagram user id (a profile's user_id). Alternative to username for id-based lookups.

Try in playground →

post/instagram/v1/likes1 credit

account-gated media likes list; flagged for account-pool decision

Parameter		Allowed / range	Description
shortcode	optional	—	Post shortcode — the code in instagram.com/p/<shortcode>/ or /reel/<shortcode>/ (a full post/reel URL is also accepted). Provide shortcode OR media_id.
media_id	optional	—	Numeric media id (from a post's media_id field). Provide media_id OR shortcode.

Try in playground →

Example request · profile

curl -X POST https://api.reefapi.com/instagram/v1/profile \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"username":"nike"}'

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}