GET
/api/v2/profile/:id/:mode?
Profile
Fetch public profile data, cache the provider response, and optionally store the profile image with asset metadata.
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 request-id traceability built in.
- 3
- Instagram import endpoints
- REST
- Protocol
- JSON
- Response
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.
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.
Sign in, get a bearer token, generate an idempotency key for the paid request, and call the endpoint your workflow needs.
Read the full documentationcurl "/api/v2/profile/example_store" \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "X-Request-Id: import-2026-07-08-001"Why instro
Built for production imports, not throwaway scraping scripts.
Server-held provider credentials
HikerAPI 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 retry safety
Daily service-call limits and X-Request-Id checks make repeated imports easier to control.
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.
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 a HikerAPI key?
No. Clients authenticate with instro. Provider credentials stay server-side and are not returned in responses.
How are retries billed?
Billable requests require X-Request-Id. Reusing an already processed id returns a conflict instead of charging twice.
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.