Instagram Public Read API
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.
Endpoint health
Loading verification…
Connect your agent
Connect through MCP so your agent can find this API, read its docs, and call its endpoints.
Add the server from your terminal.
claude mcp add --transport http agent-data https://agent-data.motie.dev/mcpIn 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 keySign 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.
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 · stringInstagram shortcode returned by a profile-post result; it identifies one public post.
Example: Dfc1mYxFevS
Response
media?objectmedia.relay_id?string | nullmedia.typename?string | nullmedia.product_type?string | nullmedia.original_width?integer | nullmedia.original_height?integer | nullmedia.carousel_media_count?integer | nullmedia.accessibility_caption?string | nullauthor?objectauthor.id?string | nullauthor.pk?string | nullauthor.username?string | nullauthor.profile_url?string | nullsource?string, default: instagramcaptionstring | nullis_videobooleanlocation?object | nullhas_audio?boolean | nullimage_urlstring | nullpermalinkstringshortcodestringsource_id?string | nulllike_count?integer | nullmedia_type?integer | nullposted_timestring | nullcomment_count?integer | nullcaption_is_edited?boolean | nullFields marked ? are optional.
GETProfiles by username/v1/profiles/{username}
Profile Summary
Input
usernameRequiredPath · stringPublic Instagram username to resolve. The value is used as the source profile path.
Example: nasa
Response
source?string, default: instagramuser_idstringusernamestringposts_urlstringprofile_urlstringposts_availableintegerfirst_page_cursorstring | nullFields marked ? are optional.
GETProfiles by username posts/v1/profiles/{username}/posts
Profile Posts
Input
usernameRequiredPath · stringPublic Instagram username. Use the username returned by the profile-resolution operation.
Example: nasa
cursorOptionalQuery · string | nullOpaque next_cursor from the preceding response. Omit it for the first source page; pass it unchanged for the next page.
Response
postsobject[]posts[].media?objectposts[].media.relay_id?string | nullposts[].media.typename?string | nullposts[].media.product_type?string | nullposts[].media.original_width?integer | nullposts[].media.original_height?integer | nullposts[].media.carousel_media_count?integer | nullposts[].media.accessibility_caption?string | nullposts[].author?objectposts[].author.id?string | nullposts[].author.pk?string | nullposts[].author.username?string | nullposts[].author.profile_url?string | nullposts[].captionstring | nullposts[].is_videobooleanposts[].location?object | nullposts[].has_audio?boolean | nullposts[].image_urlstring | nullposts[].permalinkstringposts[].shortcodestringposts[].source_id?string | nullposts[].like_count?integer | nullposts[].media_type?integer | nullposts[].posted_timestring | nullposts[].comment_count?integer | nullposts[].caption_is_edited?boolean | nullusernamestringtransport?string, default: curl_cffi_residentialnext_cursorstring | nullhas_next_pagebooleansource_node_idstringprofile_user_idstringFields 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.
An account is required to submit an extension. Prepare your request, then sign in to build.