Catalog / Instagram Public Read

Instagram Public Read API

instagram.com

Read-only access to anonymous public Instagram profile grids and individual public posts. Start with a username, follow the returned opaque cursor for source pagination, or use a returned shortcode with the explicit post-detail operation. Tagged-posts pages currently redirect anonymous HTTP to login and are declared unavailable rather than represented by ordinary profile posts.

  • Social & video
  • instagram
  • profiles
  • posts
  • social
3 endpointsDocs updated

Endpoint health

Loading verification…

Connect your agent

Connect through MCP so your agent can find this API, read its docs, and call its endpoints.

Setup guide

Add the server from your terminal.

Claude Code · terminal
claude mcp add --transport http agent-data https://agent-data.motie.dev/mcp

In Claude Code, run /mcp, select agent-data, then Authenticate. Sign in to your agent-data account in the browser.

Then ask your agent to use the Instagram Public Read API for your task.

Call it over HTTP

Get an API key

Sign up free, generate an API key, and set it as AGENT_DATA_API_KEY in your environment. Your first 100 calls each month are free.

Post Detail

Instagram shortcode returned by a profile-post result; it identifies one public post.

View call pricing
cURL · Posts by shortcode
curl --request GET --get 'https://3kpkg0jfvk.execute-api.us-east-2.amazonaws.com/prod/e3db96d3-3dca-4907-a209-3388b89d0077/v1/posts/Dfc1mYxFevS' \
  --header "Authorization: Bearer $AGENT_DATA_API_KEY"

Endpoints

Inputs and response fields for every endpoint in this API.

GETPosts by shortcode/v1/posts/{shortcode}

Post Detail

Input

shortcodeRequiredPath · string

Instagram shortcode returned by a profile-post result; it identifies one public post.

Example: Dfc1mYxFevS

Response

media?object
media.relay_id?string | null
media.typename?string | null
media.product_type?string | null
media.original_width?integer | null
media.original_height?integer | null
media.carousel_media_count?integer | null
media.accessibility_caption?string | null
author?object
author.id?string | null
author.pk?string | null
author.username?string | null
author.profile_url?string | null
source?string, default: instagram
captionstring | null
is_videoboolean
location?object | null
has_audio?boolean | null
image_urlstring | null
permalinkstring
shortcodestring
source_id?string | null
like_count?integer | null
media_type?integer | null
posted_timestring | null
comment_count?integer | null
caption_is_edited?boolean | null

Fields marked ? are optional.

GETProfiles by username/v1/profiles/{username}

Profile Summary

Input

usernameRequiredPath · string

Public Instagram username to resolve. The value is used as the source profile path.

Example: nasa

Response

source?string, default: instagram
user_idstring
usernamestring
posts_urlstring
profile_urlstring
posts_availableinteger
first_page_cursorstring | null

Fields marked ? are optional.

GETProfiles by username posts/v1/profiles/{username}/posts

Profile Posts

Input

usernameRequiredPath · string

Public Instagram username. Use the username returned by the profile-resolution operation.

Example: nasa

cursorOptionalQuery · string | null

Opaque next_cursor from the preceding response. Omit it for the first source page; pass it unchanged for the next page.

Response

postsobject[]
posts[].media?object
posts[].media.relay_id?string | null
posts[].media.typename?string | null
posts[].media.product_type?string | null
posts[].media.original_width?integer | null
posts[].media.original_height?integer | null
posts[].media.carousel_media_count?integer | null
posts[].media.accessibility_caption?string | null
posts[].author?object
posts[].author.id?string | null
posts[].author.pk?string | null
posts[].author.username?string | null
posts[].author.profile_url?string | null
posts[].captionstring | null
posts[].is_videoboolean
posts[].location?object | null
posts[].has_audio?boolean | null
posts[].image_urlstring | null
posts[].permalinkstring
posts[].shortcodestring
posts[].source_id?string | null
posts[].like_count?integer | null
posts[].media_type?integer | null
posts[].posted_timestring | null
posts[].comment_count?integer | null
posts[].caption_is_edited?boolean | null
usernamestring
transport?string, default: curl_cffi_residential
next_cursorstring | null
has_next_pageboolean
source_node_idstring
profile_user_idstring

Fields marked ? are optional.

For the next page, pass next_cursor from the response as cursor. Leave it empty on the first call.

Don’t see the endpoint you need?

Ask agent-data to add an endpoint or return more fields. Extensions are free and keep existing endpoints working.