jsonscraper
← Developer toolsMODEL CONTEXT PROTOCOL

IG API.
Now in your assistant.

Connect public IG data to ChatGPT, Claude, Codex or another MCP client. Use your existing API key, plan and ready-to-use tools.

Connect MCP ↓Ready-to-use workflows ↓GitHub ↗
94 JSON toolsYour API keyStreamable HTTP · stdioMIT · 0.1.3
QUICK START

Choose where to work

Each product has its own connection. No additional license key is needed.

Contact support
MCP endpoint
https://jsonscraper.com/mcp/instagram/server

Choose a connection method

Open ChatGPT in a browser on your computer or phone. Have your existing IG API key ready.

Upload a ready-made ZIP package

  1. Download the IG API archive below.
  2. Plugins → Add → Upload plugin archive: choose the downloaded ZIP and add the plugin.
  3. Install the plugin and connect with OAuth: enter your API key on the jsonscraper page.
Download ZIP ↓Open Plugins ↗

If ChatGPT asks you to add the MCP server separately, use the manual settings below.

Connect manually
  1. 1

    Open the connection form

    Plugins → Add → Add custom MCP server

    Open ChatGPT ↗
  2. 2

    Complete the form

    jsonscraper Instagram API
    Icon · optional

    PNG · 256 × 256 · under 10 KB

    Download icon ↓

    Download the PNG and upload it using the plus in the icon field. Copy the remaining values below.

    Name
    jsonscraper Instagram API
    Description · optional
    Public Instagram profiles, media, comments and search through the jsonscraper API.
    Server URL
    https://jsonscraper.com/mcp/instagram/server
    Connection
    Server URL
    Authentication
    OAuth
    Advanced OAuth settings

    Paste the server URL first: OAuth settings are discovered automatically. Keep detected settings when they match the values below.

    Client registration
    Dynamic registration · DCR
    Client ID / Client Secret
    Leave empty
    Scope
    instagram:read
    Authorization URL
    https://jsonscraper.com/mcp/instagram/oauth/authorize
    Token URL
    https://jsonscraper.com/mcp/instagram/oauth/token
    Registration URL
    https://jsonscraper.com/mcp/instagram/oauth/register
    Authorization server · Issuer
    https://jsonscraper.com/mcp/instagram/oauth
    Resource
    https://jsonscraper.com/mcp/instagram/server

    Enter your API key on the jsonscraper authorization page after creating the connection.

  3. 3

    Save and authorize

    Acknowledge ChatGPT’s warning and select Create as a plugin. Open the new card and select Install. On the jsonscraper page, enter your IG API key and approve access.

    In chat, type @, select your connection and send a request.

Choose a ready-to-use workflow →

Try a first request
Message for ChatGPT
Read the public Instagram profile @apple and summarize the profile, follower count and biography. Use one API request.

Each tool call counts toward your normal API quota.

Connect in the desktop app

Settings → MCP servers → Add server → Streamable HTTP

Use the name and URL above. Select Save, then Restart and Authenticate. Enter your API key on the jsonscraper page.

If MCP servers is unavailable, follow the browser instructions above.

Desktop app guide ↗
Connect from your phone

Open ChatGPT in Safari, Chrome or another browser on your phone and follow the steps above. Add the server through the browser rather than the ChatGPT mobile app.

Missing a button or having trouble connecting?

Open Plugins in your browser. If the MCP creation option is absent, check account permissions or ask your workspace administrator.

If authorization fails, check that your key belongs to the IG API and is active. Reconnect after changing the key.

Get help in chat →

ChatGPT setup guide ↗

AFTER CONNECTING

Choose a task. Copy a prompt.

Enter a profile or topic, adjust the filters and send the prepared prompt to ChatGPT or Claude with your jsonscraper connector enabled.

Audit a profileFind top posts, content themes and practical improvements.

Up to 20 posts

Up to 4 API calls · public data

Ready-to-use prompt
Analyze the public Instagram profile apple using its 20 latest posts. Show 5 strong posts with available views, likes and comments. Explain which caption topics perform well and suggest 3 experiments.

Use jsonscraper Instagram API with at most 4 API calls. Include links, date and sample size; do not invent missing metrics.
Tools used
  • instagram_v1_user_by_username
  • instagram_v1_user_medias_chunk
  • instagram_v1_media_comments_chunk
Compare competitorsCompare public performance, topics and content differences.

Up to 3 profiles, 15 posts each

Up to 12 API calls · public data

Ready-to-use prompt
Compare up to 3 public Instagram profiles: apple, samsung. Use 15 recent posts per profile. Return a table of followers and median views, likes and comments, followed by 3 content-topic differences and 3 experiments.

Use jsonscraper Instagram API with at most 12 API calls. Include links, date and sample size; do not invent missing metrics.
Tools used
  • instagram_v1_user_by_username
  • instagram_v1_user_medias_chunk
  • instagram_v1_media_comments_chunk
Find relevant creatorsBuild a short list with evidence of topic relevance.

Up to 5 candidates

Up to 12 API calls · public data

Ready-to-use prompt
Find up to 5 public Instagram creators about skincare with 10000–100000 followers. Give a profile link, follower count, available post examples and a brief relevance explanation based on the bio and captions.

Use jsonscraper Instagram API with at most 12 API calls. Include links, date and sample size; do not invent missing metrics.
Tools used
  • instagram_v1_search_users
  • instagram_v1_user_by_username
  • instagram_v1_user_medias_chunk
Find videos with filtersFilter by keywords, views, likes and date; choose the sort order.

Up to 80 search results

Up to 4 API calls · public data

Sort results
Ready-to-use prompt
Find public Instagram videos about skincare from the last 30 days with at least 10000 views and 500 likes. Check up to 80 search results. Sort by views and show up to 10 matching videos with URL, creator, date and available metrics.

Use jsonscraper Instagram API with at most 4 API calls. Include links, date and sample size; do not invent missing metrics. Apply filters to the retrieved sample. Exclude records missing a required metric. If few match, ask which filter to relax.
Tools used
  • instagram_v2_fbsearch_reels
Understand commentsFind recurring questions, objections and response ideas.

Up to 100 comments

Up to 4 API calls · public data

Ready-to-use prompt
Analyze up to 100 public comments on [paste a public URL]. Identify recurring questions, objections and discussion themes. Give up to 5 short examples and 3 reply ideas. Do not post anything.

Use jsonscraper Instagram API with at most 4 API calls. Include links, date and sample size; do not invent missing metrics.
Tools used
  • instagram_v1_media_by_url
  • instagram_v1_media_comments_chunk
Find content ideasTurn caption themes and public performance into content tests.

20 posts, 5 ideas

Up to 4 API calls · public data

Ready-to-use prompt
Review up to 20 recent posts from Instagram profile apple. Use caption themes and available performance to suggest 5 content ideas. Give a topic, text hook, testable hypothesis and example link for each.

Use jsonscraper Instagram API with at most 4 API calls. Include links, date and sample size; do not invent missing metrics.
Tools used
  • instagram_v1_user_by_username
  • instagram_v1_user_medias_chunk
  • instagram_v1_media_comments_chunk
Create a comparison snapshotSave a current metrics table to compare with a later snapshot.

Snapshot of up to 20 posts

Up to 4 API calls · public data

Ready-to-use prompt
Prepare CSV text with the current public metrics for Instagram profile apple and up to 20 recent posts. Columns: UTC capture date, profile, post ID and URL, publication date, views, likes and comments. If I supplied a prior table, compare matching IDs; otherwise return only the current snapshot.

Use jsonscraper Instagram API with at most 4 API calls. Include links, date and sample size; do not invent missing metrics.
Tools used
  • instagram_v1_user_by_username
  • instagram_v1_user_medias_chunk
Get a precise result

Start with a small sample. Specify the topic, date range, metrics and output format. Numeric filters apply to retrieved data; missing metrics are reported separately. To compare over time, save a metrics snapshot and provide it in a later conversation.

CAPABILITIES

Clear tools for real tasks

Profiles, media, comments, search and other JSON API methods. Every tool includes its description and parameters.

instagram_v1_user_by_idGet user info by ID
GET /v1/user/by/id

Parameters: id, cache_timeout

instagram_v1_user_by_usernameGet user info by username (by ID is faster)
GET /v1/user/by/username

Parameters: username, cache_timeout

instagram_v1_user_by_urlGet user info by URL (by ID is faster)
GET /v1/user/by/url

Parameters: url, cache_timeout

instagram_v1_user_aboutGet info about user by ID
GET /v1/user/about

Parameters: id, cache_timeout

instagram_v1_user_medias_chunkGet posts (chunked)
GET /v1/user/medias/chunk

Parameters: user_id, end_cursor, cache_timeout

instagram_v1_user_medias_pinnedGet pinned posts
GET /v1/user/medias/pinned

Parameters: user_id, amount, cache_timeout

instagram_v1_user_clips_chunkGet reels (chunked)
GET /v1/user/clips/chunk

Parameters: user_id, end_cursor, cache_timeout

instagram_v1_user_tag_medias_chunkGet tagged (mentions) posts
GET /v1/user/tag/medias/chunk

Parameters: user_id, max_id, cache_timeout

Same key. Same plan.

Each tool call performs one API request. Normal plan limits and caching terms apply. MCP does not bypass quotas or automatically paginate.

Access and current pricing →

You control the requests

Tell your assistant which data and how many pages you need. Use the API or SDK for direct binary downloads; MCP returns JSON.

SDKs and complete examples →

Need the other product?

TikTok MCP →Get help connecting