Creator and CRM enrichment
Turn a known username into profile fields, recent posts, links, verification status, and a scrape timestamp your team can store.
Instagram Data API
Instagram Data API for profiles, posts, and video transcripts.
Retrieve current public Instagram data by username or shortcode with single and batch endpoints.
instagram-profile.ts
import Influship from 'influship';
const client = new Influship({
apiKey: process.env.INFLUSHIP_API_KEY,
});
const response = await client.raw.instagram.getProfile(
'natgeo',
{ include_posts: true, post_limit: 12 },
);
console.log(response.data.follower_count);
console.log(response.data.posts);$0.005
per live profile with an API key
20 posts
maximum post batch per request
10 transcripts
maximum transcript batch per request
5 endpoints
profiles, posts, and transcripts
One Instagram data API, five focused endpoints.
Start with a username for profile data or a shortcode for post-level work. Batch endpoints preserve per-item success and error details.
| Method | Endpoint | Use it for | API-key price |
|---|---|---|---|
| GET | /v1/raw/instagram/profile/{username} | Fetch public profile data and, when requested, recent posts available in the source response. | $0.005 / profile |
| GET | /v1/raw/instagram/post/{shortcode} | Fetch rich post-page metadata and fresh media URLs for one post or reel. | $0.01 / post |
| POST | /v1/raw/instagram/posts | Look up as many as 20 post shortcodes with per-item results. | $0.01 / success |
| GET | /v1/raw/instagram/transcript/{shortcode} | Transcribe spoken content from one public Instagram video post. | $0.05 / transcript |
| POST | /v1/raw/instagram/transcripts | Transcribe as many as 10 video post shortcodes with per-item results. | $0.05 / success |
Move from a profile to post-level data without changing clients.
Use the typed SDK for application code or call the public REST routes from any language. All API-key requests send X-API-Key.
instagram-posts.ts
const posts = await client.raw.instagram.getPosts({
shortcodes: ['C0ABC123xyz', 'D1DEF456uvw'],
});
for (const item of posts.data.items) {
if (item.success) {
console.log(item.data.post.caption);
console.log(item.data.post.video_url);
} else {
console.error(item.shortcode, item.error);
}
}instagram-transcript.sh
curl 'https://api.influship.com/v1/raw/instagram/transcript/C0ABC123xyz?language=en' -H "X-API-Key: $INFLUSHIP_API_KEY"Use the endpoint that matches the data grain.
Profiles summarize an account and its recent posts. Single-post lookups expose richer page fields. Transcript routes return spoken text and can include post context on a fresh extraction.
Profile fields
Build current profile summaries and monitor public account-level changes.
follower_count biography is_verified category_name bio_links[]
Post-page fields
Inspect content, engagement, collaborations, tags, products, audio, and media.
caption like_count coauthor_usernames[] music_attribution video_versions[]
Transcript fields
Store spoken content with language, duration, word count, and scrape time.
transcript full_text language duration_seconds word_count
example-response.json
{
"data": {
"username": "creator_handle",
"user_id": "17841400000000000",
"full_name": "Example Creator",
"biography": "Field notes and short documentaries.",
"follower_count": 125400,
"following_count": 612,
"media_count": 842,
"is_verified": false,
"is_private": false,
"category_name": "Digital creator",
"engagement_rate": 3.72,
"posts": [
{
"shortcode": "C0ABC123xyz",
"post_type": "video",
"caption": "A field report...",
"like_count": 4821,
"comment_count": 97
}
],
"scraped_at": "2026-07-19T15:38:38.366Z"
}
}A direct data layer for Instagram research and products.
Use current public data in workflows that need a repeatable schema instead of manual profile review.
Post and campaign monitoring
Resolve post shortcodes into captions, engagement counts, coauthors, sponsor metadata, tagged users, products, music, and locations where present.
Spoken-content analysis
Transcribe reels for claim detection, brand safety, product mentions, topic classification, sentiment, and searchable archives.
Media collection pipelines
Retrieve fresh media URLs and download promptly into storage you control before signed Instagram CDN URLs expire.
Discovery and raw data solve different parts of the workflow.
Use the creator-search guide when you are still finding relevant accounts. Use the raw post guide when you already have usernames or shortcodes and need source-level content.
Meter successful data returned, then track the headers.
One credit equals $0.01. API-key batch calls charge successful items, and response headers report the credits charged and remaining credit budgets.
- Live profile
- 0.5 credits
- Post lookup
- 1 credit
- Video transcript
- 5 credits
- Free-tier budgets
- 150/min, 1,500/hour
Handle errors by response type
400
validation_error
Fix an invalid username, shortcode, language, post limit, batch size, or unsupported media type.
401
unauthorized
Check the X-API-Key header. Do not expose keys in browser-side code.
403
scraping_failed
Treat private content as an inaccessible data outcome.
404
not_found
Treat missing or removed public content as a data outcome.
429
rate_limit_exceeded
Honor Retry-After or the rate reset headers, then retry with jitter.
503
service_unavailable
Retry temporary live-platform failures with bounded backoff and jitter.
Developer questions, answered
Exact behavior lives in the API reference. These answers cover the decisions teams make before integrating.
What Instagram data can I retrieve?
The raw API covers public profile data, recent posts, individual post-page data, batch post lookup, single video transcripts, and batch video transcripts. Returned fields vary by endpoint and by what Instagram exposes for the requested public content.
How is this different from the official Instagram API?
Meta APIs are permissioned integrations for connected professional accounts and their media, publishing, messaging, or insights. Influship raw endpoints retrieve current public profile and post data by username or shortcode, so a brand-side workflow does not require every public creator to connect an account first.
Can I fetch recent posts with a profile?
Yes. Set include_posts=true and choose a post_limit from 1 to 50. The profile response includes the recent posts available in Instagram's source response, up to that requested limit. For richer fields tied to one post page, call the single-post endpoint with its shortcode.
Can I retrieve Instagram video transcripts in bulk?
Yes. POST /v1/raw/instagram/transcripts accepts up to 10 shortcodes per request and returns one success or error item for each requested shortcode. API-key metering charges successful transcript items.
How much do Instagram data calls cost?
With an API key, a live profile costs $0.005, a post costs $0.01, and a video transcript costs $0.05. Batch post and transcript routes use the same per-successful-item prices.
Does Influship provide a Python SDK?
There is no official Python SDK. Use the REST API directly with requests or httpx. The official TypeScript and JavaScript SDK is available from npm as influship.
Make the first request with a free developer account.
Generate an API key, copy a working example, and inspect the response before you commit to production volume.