How are paid API calls traced?

The server generates a request identifier for every call and returns it in the response for billing and support tracing.

Home / APIs / Instagram

Instagram API

Import Instagram profiles, posts, reels, and media with one API.

instro gives your product a private server-to-server Instagram API for public profiles, post lists, post details, reels, and media assets, with prepaid wallet billing, quota checks, storage accounting, and server-side request tracing built in.

Open console View documentation

3: Instagram import endpoints
REST: Protocol
JSON: Response

const response = await fetch(
  "/api/v2/profile/nasa",
  {
    headers: {
      "Authorization": "Bearer YOUR_TOKEN"
    }
  }
);

const data = await response.json();
console.log(data.data.profile);

200 success profileImage stored

Endpoints

What you can do with the instro Instagram API

Every billable endpoint runs through the same account, wallet, quota, storage, and provider-failure pipeline before returning a documented response envelope.

GET /api/v2/profile/:id/:mode?

Profile

Fetch public profile data, cache the provider response, and optionally store the profile image with asset metadata.

POST /api/v2/postall

Posts

Load public posts for a numeric Instagram user id with cursor pagination and page-size validation.

GET /api/v2/postid/:id

Post detail

Retrieve a selected post or reel, import carousel thumbnails when available, and return deduplicated media assets.

Quick start

Make the first import request in minutes.

Read the full documentation

curl "/api/v2/profile/example_store" \
  -H "Authorization: Bearer YOUR_TOKEN"

Why instro

Built for production imports, not throwaway scraping scripts.

Server-held provider credentials

Upstream provider credentials stay behind the API boundary, so clients only use instro authentication.

Wallet-aware execution

Billable calls check balance before work starts and record wallet movements for finance and support.

Quota and request tracing

Daily service-call limits control usage, while server-generated identifiers make imports traceable.

Storage accounting

Imported media is measured in bytes, associated with the requesting account, and deduplicated by checksum.

Console

Operate instro from one internal dashboard.

Review wallet balance, daily quota, storage usage, profile imports, JSON responses, and usage records without jumping between tools.

instro dashboard preview with wallet, quota, storage, and Instagram import response panels

Use cases

Common workflows for Instagram imports

Store onboarding

Pull profile identity and media signals when a merchant connects an Instagram account.

Product drafting

Turn selected public posts or carousel images into internal product import candidates.

Creator research

Inspect public profiles and posts before approving creators or sellers.

Usage reporting

Track request volume, wallet charges, provider status, and storage consumption per account.

FAQ

Questions teams ask before integrating.

Is this an official Instagram API?

No. instro provides a private import API for public Instagram data and handles provider access on the server.

Do clients need an upstream provider key?

No. Clients authenticate with instro. Provider credentials stay server-side and are not returned in responses.

How are requests traced?

The server generates a unique identifier and returns it in both the response header and response metadata.

What does the API return?

Responses use a JSON envelope with status, data, and meta fields. Instagram imports return profile, post, and media asset data depending on the endpoint.

Get started

Start importing Instagram data through instro.

Open the console or jump straight into the API docs to test profile, post list, and post detail imports.

Open console View documentation