Get user posts — Instagram API

Returns a paginated list of posts from an Instagram user's profile feed. Maximum 12 posts per page. Includes photos, videos, carousels, and engagement counts.

Get free API key View the docs

GET/v1/instagram/users/{username}/posts1 credit per request

Example response200OK

{
  "data": {
    "@context": [
      "https://www.w3.org/ns/activitystreams#",
      "https://konbiniapi.com/ns/social#"
    ],
    "type": "OrderedCollectionPage",
    "partOf": "https://api.konbiniapi.com/v1/instagram/users/khaby00/posts",
    "totalItems": 1309,
    "cursor": null,
    "nextCursor": "abc123",
    "next": "https://api.konbiniapi.com/v1/instagram/users/khaby00/posts?cursor=abc123&count=12",
    "itemCount": 30,
    "orderedItems": [
      {
        "type": "Video",
        "id": "https://www.instagram.com/p/CybWViruta1/",
        "url": "https://www.instagram.com/p/CybWViruta1/",
        "entityId": "CybWViruta1",
        "content": "When you realize there is a simpler way #learnfromkhaby",
        "published": "2026-02-27T18:36:42.000Z",
        "likeCount": 2800000,
        "commentCount": 29200,
        "attributedTo": {
          "type": "Person",
          "id": "https://www.instagram.com/khaby00/",
          "url": "https://www.instagram.com/khaby00/",
          "entityId": "779085683",
          "preferredUsername": "khaby00",
          "name": "Khabane Lame",
          "icon": {
            "type": "Image",
            "url": "https://scontent.cdninstagram.com/v/t51.2885-19/avatar.jpg"
          },
          "role": "collaborator"
        },
        "location": {
          "type": "Place",
          "id": "213385402",
          "name": "Los Angeles, California",
          "url": "https://www.instagram.com/explore/locations/213385402/",
          "latitude": 34.0522,
          "longitude": -118.2437
        },
        "tag": [
          {
            "type": "Tag",
            "name": "learnfromkhaby",
            "href": "https://www.instagram.com/explore/tags/learnfromkhaby/"
          }
        ],
        "language": "en",
        "isEdited": false,
        "isSponsored": false,
        "viewCount": 42600000,
        "duration": 23,
        "contentFormat": "reel",
        "attachment": [
          {
            "type": "Video",
            "url": [
              "https://scontent.cdninstagram.com/v/t50.2886-16/video.mp4"
            ],
            "mediaType": "video/mp4",
            "width": 576,
            "height": 1024
          }
        ],
        "image": [
          {
            "type": "Image",
            "url": "https://scontent.cdninstagram.com/v/t51.2885-19/avatar.jpg",
            "width": 1080,
            "height": 1920
          }
        ],
        "audio": {
          "type": "Audio",
          "id": "https://www.instagram.com/reels/audio/293394603591002/",
          "entityId": "293394603591002",
          "name": "Original audio",
          "artist": "khaby00",
          "isOriginal": true,
          "duration": 85.216
        },
        "name": "Photo of Khabane Lame",
        "totalItems": 5,
        "items": [
          {
            "type": "Image",
            "entityId": "3214260996432123574",
            "image": [
              {
                "type": "Image",
                "url": "https://scontent.cdninstagram.com/v/t51.2885-19/avatar.jpg",
                "width": 1080,
                "height": 1920
              }
            ],
            "attachment": [
              {
                "type": "Video",
                "url": [
                  "https://scontent.cdninstagram.com/v/t50.2886-16/video.mp4"
                ],
                "mediaType": "video/mp4",
                "width": 576,
                "height": 1024
              }
            ],
            "name": "Photo of Khabane Lame"
          }
        ]
      }
    ]
  }
}

Make the request.

One authenticated GET to /v1/instagram/users/{username}/posts. Authentication and error conventions stay consistent across endpoints. This page shows the path, parameters, response shape, limits, and credit rule for this operation.

Built for

Post performance analysis and engagement rate benchmarking
Content cadence and publishing strategy research
Competitor feed monitoring for creative and campaign insights

Full reference for this endpoint

const response = await fetch("https://api.konbiniapi.com/v1/instagram/users/khaby00/posts", {
  headers: { "Authorization": "Bearer YOUR_API_KEY" }
});

const data = await response.json();

Parameters3

usernamerequiredIn · PathType · stringInstagram username (with or without @ symbol)
countIn · QueryType · integerNumber of posts to fetch (maximum: 12)1–12default 12
cursorIn · QueryType · stringPagination cursor

What you will probably call next.

The Instagram endpoints around this one — the same object at a different depth, or the same kind of read.

All Instagram endpoints Browse every platform

Try it on your own data.

Get a free API key and make this request in minutes. Failed and timed-out requests are automatically refunded.

Get free API key Endpoint reference