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.6
QUICK START

Choose where to work

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

Contact support

Connect ChatGPT

Use your existing API key

  1. 1

    Open the connection form

    Plugins → Add → Add custom MCP server

    Open ChatGPT ↗
  2. 2

    Complete the form

    jsonscraper IG API
    Icon · optional

    PNG · 256 × 256 · under 10 KB

    Download icon ↓
    Name
    jsonscraper IG API
    Description · optional
    Public IG profiles, media, comments and search through the jsonscraper API.
    Server URL
    https://jsonscraper.com/mcp/instagram/server
    Connection
    Server URL
    Authentication
    OAuth
  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.

Additional information

Connection options

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.

Install a ready-made ZIP plugin

If your ChatGPT interface supports plugin uploads, download the archive below and select it in the import menu without unpacking. After installation, authorize with OAuth using your API key.

Download ChatGPT ZIP · v1.0.10 ↓

Try it out

Choose a ready-to-use workflow
Try a first request
Message for ChatGPT
Read the public IG profile @apple and summarize the profile, follower count and biography. Use one API request.

Each tool call counts toward your normal API quota.

Help and documentation

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 IG 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 IG 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 IG 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 IG 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 IG 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 IG 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 IG 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 IG 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 IG 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 IG 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 IG 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 IG 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 IG 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

Project team