Instagram

Posts

List an account’s posts, newest first, one page at a time.

Endpoint

GET
/s/instagram/posts

Send your API key in the X-API-Key header. instagram is the usual service slug; use the one shown on your subscription if it differs.

Query parameters

NameDescription
usernamerequired
Account name, with or without the leading @.Example: natgeo
cursoroptional
nextCursor from the previous page. Omit for the first page.
countoptional
Posts per page, up to 12 (Instagram’s page size). Default 12.Example: 12

Example request

curl '/s/instagram/posts?username=natgeo&count=12' \
  -H 'X-API-Key: YOUR_API_KEY'

Example response

The result is in data. Fields the platform didn't report are left out. Field reference: response shapes.

{
  "data": {
    "items": [
      {
        "platform": "instagram",
        "id": "3391234567890123456",
        "code": "C8xYz12AbCd",
        "url": "https://www.instagram.com/p/C8xYz12AbCd/",
        "type": "post",
        "text": "Into the canyon",
        "media": [
          {
            "type": "image",
            "url": "https://scontent.cdninstagram.example/1.jpg"
          }
        ],
        "stats": {
          "likes": 210000,
          "comments": 980
        }
      }
    ],
    "nextCursor": "p2:787132:QVFDcursor1",
    "hasMore": true
  }
}

Notes