Posts
List an account’s posts, newest first, one page at a time.
Endpoint
GET
/s/instagram/postsSend 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
| Name | Description |
|---|---|
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
- Keep calling with the returned nextCursor while hasMore is true, up to 3 pages in total: the third page has no nextCursor. Private accounts return 403.