API Documentation
Introduction
Welcome to the InScrape API documentation. The REST API returns public Instagram profiles, posts, reels, stories, comments, followers and discovery results as JSON through 20 endpoints.
Quickstart guide
Get a free API key and make your first live request in under a minute. No SDK or Meta app review required.
API authentication
Include your API key in the x-api-key header on every request. Keep the key on your server because it authorizes requests against your team's credit balance.
Need a key? Create an account in the dashboard and receive 100 free credits. No card is required.
First request
Call the profile endpoint
curl "https://api.socialscrape.dev/v1/instagram/profile?handle=natgeo" \
-H "x-api-key: $INSCRAPE_KEY"
# {
# "success": true,
# "credits_charged": 1,
# "credits_remaining": 99,
# "processing_time_ms": 1842,
# "requested_at": "2026-09-13T14:32:18Z",
# "query": { "username": "natgeo" },
# "data": { "handle": "natgeo", "follower_count": 279000000, ... }
# }Core contract
Learn it once. Use it everywhere.
One API key
Every request uses the same x-api-key header. There is no OAuth flow, refresh token or Instagram login.
One response envelope
Success, cost, remaining balance, timing and query metadata use the same shape on every endpoint.
One cursor model
List endpoints continue from the opaque cursor returned by the previous response. No page-number math.
Integrations
Machine-readable by default.
Use the same source of truth in client generators, Postman, coding agents and your own tools. The OpenAPI specification and llms.txt are generated from the live endpoint catalogue.