How to Call the Instagram Posts API
Simple REST API endpoint. Just make a GET request with your API key and get structured data back.
GETCode Examples
cURL
curl -X GET 'https://api.parseium.com/v1/instagram-posts?username=billieeilish&api_key=YOUR_API_KEY'TypeScript
const response = await fetch(`https://api.parseium.com/v1/instagram-posts?username=billieeilish&api_key=${process.env.PARSEIUM_API_KEY}`, {
method: 'GET',
});
const data = await response.json();
console.log(data);Python
import requests
import os
api_key = os.environ['PARSEIUM_API_KEY']
response = requests.get(
f'https://api.parseium.com/v1/instagram-posts?username=billieeilish&api_key={api_key}'
)
data = response.json()
print(data)Query Parameters
Pass parameters in the URL query string:
username=billieeilishResponse Schema
The API returns structured JSON data with the following schema:
{
"user_id": {
"type": "string"
},
"posts": [
{
"id": {
"type": "string"
},
"shortcode": {
"type": "string"
},
"display_url": {
"type": "string"
},
"is_video": {
"type": "boolean"
},
"likes": {
"type": "number"
},
"comments": {
"type": "number"
},
"timestamp": {
"type": "number"
},
"caption": {
"type": "string"
}
}
],
"total_count": {
"type": "number"
},
"pagination": {
"end_cursor": {
"type": "string"
},
"has_next_page": {
"type": "boolean"
}
}
}Need more details? Check out our full API documentation for authentication, error handling, rate limits, and advanced options.
Use Cases for Instagram Posts
See how developers use this API in production applications.
Content Archival
Backup entire Instagram feeds, archive posts with metadata, and preserve content history for portfolios or compliance.
Engagement Analytics
Track post performance over time, analyze engagement patterns, and identify top-performing content types.
Competitor Monitoring
Monitor competitor content strategies, posting frequency, and audience engagement trends systematically.
Simple, Transparent Pricing
Every API call to Instagram Posts costs 1 credit
Choose a plan based on your monthly usage. All plans include access to all APIs.
150,000 API calls/mo
$0.33 per 1K requests
- 150,000 credits/month
- 3 Concurrent Requests
- Email support
- Priority processing
700,000 API calls/mo
$0.14 per 1K requests
- 700,000 credits/month
- 10 Concurrent Requests
- Priority support
- Advanced features
3,000,000 API calls/mo
$0.10 per 1K requests
- 3M credits/month
- 30 Concurrent Requests
- Dedicated support
- Custom integrations
Need more? Check out our for enterprise options and custom plans.
Frequently Asked Questions
Common questions about the Instagram Posts API.
How does pagination work?
First request: use query param `?username=handle` to get the first 12 posts plus `user_id` and `cursor`. For subsequent pages, use `?user_id=...&cursor=...` to fetch the next batch. Each request returns up to 50 posts. Continue until `has_next_page` is false.
How many posts per request?
The first request returns 12 posts. Pagination requests return up to 50 posts per call. Use the `end_cursor` and `has_next_page` fields to retrieve the complete feed.
What does pagination cost?
Each API request costs 1 credit, whether it's the initial call or a pagination request. To fetch 1000 posts, you'll need ~20 credits (1 initial + 19 paginated requests).
Can I fetch posts from private accounts?
No, the API only returns publicly available posts. Private accounts will return an empty posts array or limited metadata.
Can I test the API risk-free?
Yes! When you sign up you get 1,000 free credits — no credit card required. Try the API with real requests before committing.
What if I need help integrating?
We offer documentation, code examples in multiple languages, and email support. Most questions are answered within 24 hours.
How long does integration take?
Minutes. It's a simple REST API — make an HTTP request, get JSON back. No SDKs to install, no complex auth flows.
Related APIs
Explore other ready-to-use APIs that might interest you.