Changelog
Every change to the InsightSocial API that affects what you send, what comes back, or what a call costs. Newest first.
Changes that affect your integration are listed here with the date they took effect. Anything that changes what a call costs is marked Billing.
September 26, 2026
Billing: repeat calls are now charged. Repeating a call you had already paid for used to be free for a while afterwards. A repeat is now charged like the first call, because it can return newer data. Store responses you need again on your side. Retries with the same Idempotency-Key still cost 0 and come back with charge_reason: "replay". owned is no longer a charge_reason; you will still see it on Activity Log rows from before this date. See Credits.
Required inputs on three Instagram endpoints. The reference listed no required parameters for these, but they cannot answer without one:
| Endpoint | Required |
|---|---|
GET /v1/instagram/basic-profile | userId |
GET /v1/instagram/highlight/detail | id |
GET /v1/instagram/comment | one of comment_url or post_url |
The whole reference on one page. /docs/api-reference.md lists every endpoint with its path, a one-line description and its required parameters. Give it to an AI assistant along with your key. See AI agents.
September 24, 2026
Not-found errors no longer read like outages. A 404 sometimes ended with an extra sentence saying the endpoint was temporarily unavailable. It now says only that nothing exists at that identifier, and that you were not charged.
September 23, 2026
The API is live at https://api.insightsocial.app/v1. Public data from Instagram, TikTok, Facebook, LinkedIn, Twitter/X, Threads, YouTube, Reddit and Pinterest, authenticated with one x-api-key header and paid from the same credit balance as InsightSocial exports. Every account gets 10 free calls. Start with the Quickstart, or run a call without code in the Explorer.
Pagination on every list endpoint. List responses return a pagination block (next_cursor, has_more, page_size) next to data. See Pagination.
Using an AI agent
Point Claude, ChatGPT, Cursor or any coding agent at the InsightSocial API with one paste-in prompt and the free endpoint catalogue, so it reads the real paths, parameters and prices instead of guessing.
Response schema
The InsightSocial API envelope, pagination, response headers, idempotent replays and fresh fetches.