How much does a call cost?

Each endpoint has its own price in credits. A fixed endpoint, such as an Instagram profile at 20 credits, always costs the same. A metered endpoint quotes a range and charges only what the call actually read. Calls that fail or find nothing cost nothing, and repeating a call you already paid for is free for a window of 1 to 24 hours.

Is there a free tier?

Yes. Your first 10 calls priced at 200 credits or less are free, and the free plan includes 500 credits every month. No credit card is needed to get a key.

Do I need an Instagram, TikTok or X developer account?

No. There is no app review, no OAuth flow and no per-platform setup. One API key in the x-api-key header works for every platform.

Is the API the same account as the Chrome extension?

Yes. The API and the extension share one login and one credit balance. Credits you buy for exports can be spent on API calls, and the other way round.

What are the rate limits?

Each API key can send 60 requests per minute with 10 in flight at once. A rejected request costs nothing. Beyond that, your credit balance is the only limit, and you can create up to 25 keys per account.

Can an AI agent use it?

Yes. The endpoint catalogue at GET /v1/endpoints is public, free and needs no key. It lists every path, parameter and price, so Claude, ChatGPT, Cursor or any coding agent can plan calls and estimate cost before it spends anything.

How much does a call cost?

Each endpoint has its own price in credits. A fixed endpoint, such as an Instagram profile at 20 credits, always costs the same. A metered endpoint quotes a range and charges only what the call actually read. Calls that fail or find nothing cost nothing, and repeating a call you already paid for is free for a window of 1 to 24 hours.

Is there a free tier?

Yes. Your first 10 calls priced at 200 credits or less are free, and the free plan includes 500 credits every month. No credit card is needed to get a key.

Do I need an Instagram, TikTok or X developer account?

No. There is no app review, no OAuth flow and no per-platform setup. One API key in the x-api-key header works for every platform.

Is the API the same account as the Chrome extension?

Yes. The API and the extension share one login and one credit balance. Credits you buy for exports can be spent on API calls, and the other way round.

What are the rate limits?

Each API key can send 60 requests per minute with 10 in flight at once. A rejected request costs nothing. Beyond that, your credit balance is the only limit, and you can create up to 25 keys per account.

Can an AI agent use it?

Yes. The endpoint catalogue at GET /v1/endpoints is public, free and needs no key. It lists every path, parameter and price, so Claude, ChatGPT, Cursor or any coding agent can plan calls and estimate cost before it spends anything.

Your first 10 calls are free

Social media data APIfor developers

Profiles, posts, comments, followers and search from 9 platforms. One API key, one JSON shape, priced per call.

Get a free API key Read the docs

238 endpoints · 9 platforms · no credit card

curl -G "https://api.insightsocial.app/v1/tiktok/profile" \
-d handle=khaby.lame \
-H "x-api-key: $INSIGHTSOCIAL_API_KEY"

200 OKJSON

{
"success": true,
"endpoint": "/v1/tiktok/profile",
"data": {
"author": {
"username": "khaby.lame",
"followers": 162000000
}
},
"credits_used": 0,
"charge_reason": "miss",
"free_call": true
}

9 platforms, one request shape

238 endpoints. Switching platform means changing the path; the auth header, the envelope and the errors stay the same.

Instagram

38 endpoints

/profile20 cr
/profile/about20 cr
/profile/posts20–340 cr
/post20 cr

Instagram API docs

TikTok

36 endpoints

/profile20 cr
/profile/videos20–100 cr
/post20 cr
/post/comments20–140 cr

TikTok API docs

Facebook

29 endpoints

/profile20 cr
/profile/posts20–80 cr
/post20 cr
/post/comments20–100 cr

Facebook API docs

68 endpoints

/profile100 cr
/company100 cr
/company/by-domain100 cr
/profile/similar100 cr

LinkedIn API docs

Twitter/X

15 endpoints

/profile20 cr
/user/tweets20–100 cr
/tweet20 cr
/community20 cr

Twitter/X API docs

Threads

6 endpoints

/profile20 cr
/user/posts20–3,300 cr
/post20 cr
/search20–680 cr

Threads API docs

YouTube

26 endpoints

/channel20 cr
/channel/about500 cr
/channel/videos20–40 cr
/video20 cr

YouTube API docs

14 endpoints

/subreddit20–100 cr
/subreddit/details20 cr
/search20–680 cr
/post20 cr

Reddit API docs

6 endpoints

/search20–520 cr
/pin20 cr
/url-stats20 cr
/board20–320 cr

Pinterest API docs

What teams build with it

The same few calls, pointed at different questions.

Creator vetting

Vet a creator before you pay them

Pull the profile, the last 30 posts and their comments, then compute real engagement instead of trusting a media kit.

Brand monitoring

Hear about a mention the same hour

Run keyword search on TikTok, Reddit and X from a cron job. Repeat calls inside the window cost nothing, so polling stays cheap.

Competitor tracking

Watch what competitors publish

Schedule profile and post reads for a list of accounts and diff them day over day: new posts, follower moves, what took off.

Audience research

Read what people actually say

Collect comments and replies under the posts that matter, then feed them to your own model for themes and sentiment.

Connect with AI agents

Paste one prompt into Claude Code, Cursor, Codex or Windsurf, or point your agent at the docs as Markdown. It is plain HTTPS, so there is nothing to install.

PromptWorks in any coding agent

One prompt, and your agent does the setup

It reads the catalogue, checks your key and makes the first calls, and asks before it spends more than you set.

Claude Code
Cursor
Codex
Windsurf
GitHub Copilot
Cline

Prompt

Set up the InsightSocial API in this project and make a first call.

- Base URL: https://api.insightsocial.app/v1
- Auth: send x-api-key: $INSIGHTSOCIAL_API_KEY. Never Bearer. Never print the key.
- Read GET /v1/endpoints?platform=<platform> first. It is free and needs no key.
- Use only the paths and params it lists.
- Tell me the price before any call over 100 credits.
- On INSUFFICIENT_CREDITS, stop and tell me.

Full guide: https://www.insightsocial.app/docs/ai-agents.md

Read the full agent guide

Docsllms.txt · Markdown

The whole docs in one file

Every page as Markdown, for an agent that can fetch a URL. Add .md to any docs page for just that page.

Terminal

curl -s https://www.insightsocial.app/docs/llms-full.txt

Cataloguepublic · free · no key

Agents price a job before they spend

Every path, parameter and price as JSON, so an agent never invents a parameter.

Terminal

curl -s "https://api.insightsocial.app/v1/endpoints?platform=instagram"

Replace a folder of scrapers with one key

238: API endpoints; one envelope for all
9: platforms; Instagram to Pinterest
0: credits for failures; failed and empty calls are free
10: free calls; no credit card

Why not the official APIs?

They are built for managing accounts you own. This is built for reading public data across platforms.

	InsightSocial API	Official platform APIs
Approval	None. Sign in and copy a key	App review per platform, often weeks
Whose data	Any public profile, post or comment	Often limited to accounts you manage
Setup	One key and one request shape for 9 platforms	One app, token flow and SDK per platform
Cost	Per call, published per endpoint. Failed and empty calls are free	Free tiers are tight; paid tiers are contracts
Response	The same JSON envelope on every platform	A different schema per platform

Pay for what a call reads

Every endpoint has a published price in credits. The balance is the same one the Chrome extension uses.

Priced per endpoint

A fixed endpoint always costs the same, like 20 credits for an Instagram profile. A metered one quotes a range and settles at what it used, never above the ceiling.

Repeat calls are free

Call the same thing again inside its window, 1 to 24 hours depending on the endpoint, and it costs 0. Failed calls and empty results are free too.

One balance for everything

API calls and extension exports draw from the same credits. The free plan includes 500 a month; top up with a plan or a credit pack.

See plans and credit packs Price of every endpoint

Not writing code?

The Chrome extension reads the same platforms from your browser, on the same account and credits.

Chrome extension

For marketers and researchers. Open a page, click scrape, export to Excel, CSV or Google Sheets.

Explore the extension

Developer API

For developers and agents. Call it from a backend, a cron job or a pipeline, at any volume your credits cover.

Get your API key

Social media API: frequently asked questions

Public data only: profiles, posts, reels and videos, comments and replies, followers and following lists, search results, hashtags and transcripts, across Instagram, TikTok, Facebook, LinkedIn, X, Threads, YouTube, Reddit and Pinterest. Every endpoint, with its parameters and price, is listed in the docs and in the free GET /v1/endpoints catalogue.

Make your first call in a minute

curl "https://api.insightsocial.app/v1/instagram/profile?handle=natgeo" \
  -H "x-api-key: $INSIGHTSOCIAL_API_KEY"

Get a free API key Browse the docs