API Direct

Instagram User Posts

GET /v1/instagram/user/posts

Get a user's recent posts and reels (their feed) by profile URL or username. Returns post captions, engagement metrics (likes, comments, shares, views), author metadata, hashtags, and mentions. Supports fetching multiple pages of results in a single API call.

Cost

$0.006 per page

Free tier

50 requests/month

Parameters

url

Instagram profile URL, e.g. https://instagram.com/natgeo (max 500 characters). Provide either url or username.

username

Instagram username, with or without leading @ (max 100 characters). Provide either url or username.

pages

Number of pages to fetch, 1-10 (default: 1). Each page returns up to 12 posts.

get_sentiment

Set to true to add AI emotion analysis (+$0.001/page)

Example Request

curl "https://apidirect.io/v1/instagram/user/posts?url=https://instagram.com/natgeo&pages=2" \
  -H "X-API-Key: YOUR_API_KEY"

import requests

response = requests.get(
    "https://apidirect.io/v1/instagram/user/posts",
    headers={"X-API-Key": "YOUR_API_KEY"},
    params={
        "url": "https://instagram.com/natgeo",
        "pages": 2
    }
)
print(response.json())

Example Response

{
  "posts": [
    {
      "title": "@natgeo on Instagram",
      "url": "https://instagram.com/p/DZkn1f0Flsc",
      "date": "2026-06-14 16:00:06",
      "author": "natgeo",
      "source": "Instagram",
      "domain": "instagram.com",
      "snippet": "Photograph by @petelas | A curious fox in the snow...",
      "likes": 530176,
      "comments": 5608,
      "shares": 9536,
      "reposts": 4353,
      "views": null,
      "is_video": false,
      "media_type": "carousel_container",
      "author_verified": true,
      "author_name": "National Geographic",
      "hashtags": [],
      "mentions": ["petelas"],
      "media_id": "3520497851234567890",
      "thumbnail_url": "https://scontent.cdninstagram.com/v/t51.82787-15/cover.jpg",
      "video_url": "",
      "video_duration": null,
      "width": 1080,
      "height": 1350,
      "carousel_media_count": 3,
      "is_paid_partnership": false,
      "location": {
        "name": "Serengeti National Park",
        "city": "Arusha",
        "lat": -2.3333,
        "lng": 34.8333
      },
      "tagged_users": [
        {"username": "natgeotv", "full_name": "National Geographic TV", "user_id": "18091046"}
      ],
      "coauthors": [],
      "carousel_media": [
        {"media_id": "3520497851234567891", "is_video": false, "image_url": "https://scontent.cdninstagram.com/v/t51.82787-15/slide1.jpg", "video_url": "", "width": 1080, "height": 1350},
        {"media_id": "3520497851234567892", "is_video": false, "image_url": "https://scontent.cdninstagram.com/v/t51.82787-15/slide2.jpg", "video_url": "", "width": 1080, "height": 1350},
        {"media_id": "3520497851234567893", "is_video": true, "image_url": "https://scontent.cdninstagram.com/v/t51.82787-15/slide3.jpg", "video_url": "https://scontent.cdninstagram.com/o1/v/t2/slide3.mp4", "width": 1080, "height": 1920}
      ],
      "audio": null,
      "is_pinned": false
    }
  ],
  "pages": 2,
  "count": 24
}

Your Usage

Free tier this month

Recent Activity