GET/v1/instagram/user/posts
Get user posts
Retrieve paginated post feed for a user.
Parameters
| Name | Type | Description |
|---|---|---|
| username_or_urlrequired | string | — e.g. instagram |
| cursor | string | Pagination cursor from previous response |
Request
Shell
curl -G "https://social-api.airaa.xyz/v1/instagram/user/posts" \ -H "X-API-KEY: YOUR_KEY" \ -d "username_or_url=instagram" \ -d "cursor=cursor"
Try it
Live requestRuns against the real API
X-API-KEY
username_or_urlrequired
cursor
Response example
200 OKapplication/json
{
"posts": [
{
"node": {
"code": "DXH5RlTDy8N",
"pk": "3875317901306048269",
"id": "3875317901306048269_25025320",
"media_type": 2,
"like_count": 34107,
"comment_count": 1664,
"taken_at": 1776194225,
"caption": {
"text": "Kawaii core, but on a canvas 🎨💫",
"pk": "18455545261110056"
},
"original_width": 1080,
"original_height": 1920,
"image_versions2": {
"candidates": [
{
"url": "https://scontent.cdninstagram.com/v/...",
"width": 1080,
"height": 1920
}
]
}
}
}
],
"pagination_token": "3865085029567979517_25025320"
}Response codes
200Posts list
400Missing or invalid query parameter
401Missing or invalid `X-API-KEY` header
429Request quota exceeded — contact light@airaa.xyz to upgrade your plan
500Server misconfiguration — API key environment variable not set
502Airaa service temporarily unavailable — please try again
504Request timed out — please try again
All error responses follow the shape
{ "error": "message" }