Instagram API
User Followers
Get a list of followers for an Instagram user.
POST
$0.01/call/v1/instagram/user-followersUsage
const res = await fetch('https://api.yepapi.com/v1/instagram/user-followers', {
method: 'POST',
headers: {
'x-api-key': 'YOUR_API_KEY',
'Content-Type': 'application/json',
},
body: JSON.stringify({ username: 'natgeo' }),
});
const { data } = await res.json();
console.log(data);curl -X POST https://api.yepapi.com/v1/instagram/user-followers \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"username": "natgeo"}'Request Body
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
username | string | Yes | Instagram username | — |
end_cursor | string | No | Pagination cursor from previous response | — |
Response
{
"ok": true,
"data": {
"has_next_page": true,
"end_cursor": "QVFDcE...",
"followers": [
{
"id": "12345678901",
"username": "photo_enthusiast",
"full_name": "Photo Enthusiast",
"profile_pic_url": "https://scontent.cdninstagram.com/...",
"is_verified": false,
"is_private": false
}
]
}
}Response Fields
| Field | Type | Description |
|---|---|---|
ok | boolean | Whether the request succeeded |
data.has_next_page | boolean | Whether more followers are available |
data.end_cursor | string | Cursor for fetching the next page |
data.followers | object[] | Array of follower user objects |
data.followers[].id | string | Unique user identifier |
data.followers[].username | string | Instagram username |
data.followers[].full_name | string | User's display name |
data.followers[].profile_pic_url | string | Profile picture URL |
data.followers[].is_verified | boolean | Whether the user is verified |
data.followers[].is_private | boolean | Whether the account is private |
Use the end_cursor value from the response to paginate through followers.