Instagram Posts API

Get Instagram Posts via API

Pass a public Instagram username and get its media feed as JSON. The documented username endpoint handles the profile lookup and media request for you.

Code Examples

# Get recent posts for a public Instagram username
curl -H 'Authorization: Bearer gs_your_api_key' \
  'https://gramscraper.com/api/instagram/v1/user/medias/by/username?username=instagram'

import requests

url = "https://gramscraper.com/api/instagram/v1/user/medias/by/username"
headers = {"Authorization": "Bearer gs_your_api_key"}
params = {"username": "instagram"}

response = requests.get(url, headers=headers, params=params)
response.raise_for_status()
print(response.json())

const response = await fetch(
  'https://gramscraper.com/api/instagram/v1/user/medias/by/username?username=instagram',
  { headers: { 'Authorization': 'Bearer gs_your_api_key' } }
);

if (!response.ok) throw new Error(`HTTP ${response.status}`);
console.log(await response.json());

Common Media Fields

A media item can include fields like these. The enclosing response and available fields depend on the post type and current API schema.

{
  "id": "...",
  "media_type": 1,
  "code": "...",
  "caption_text": "Example caption",
  "like_count": 123,
  "comment_count": 12,
  "taken_at": "2026-08-16T12:00:00Z",
  "thumbnail_url": "https://..."
}

Post Fields Returned

Use Cases

• Build social media analytics and reporting dashboards
• Track content performance across Instagram accounts
• Monitor competitor posting activity and engagement
• Power influencer marketing platforms with post data
• Create content calendars from historical post data
• Analyze engagement patterns and optimal posting times

Frequently Asked Questions

How do I get Instagram posts via API?

Use GramScraper's /v1/user/medias/by/username endpoint. Pass a public Instagram username and receive that user's media feed as JSON.

What post data does the API return?

The API returns post captions, like counts, comment counts, media type (image, video, or carousel), media URLs at multiple resolutions, timestamps, shortcodes, and author information.

Can I get posts from any Instagram user?

The API returns publicly available posts from public Instagram accounts. Posts from private accounts are not accessible via the API.