POST
Following
/v1/threads/user/followingFetch up to 5,000 accounts that a Threads user follows. Returns full profile data for each followed account.
Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| username | string | Yes | Threads username |
| limit | int | No | Max results (1-5000) (default: 100) |
Example
curl -X POST https://query-data-api.notpeople.ai/v1/threads/user/following \
-H "X-API-Key: th_live_your_key" \
-H "Content-Type: application/json" \
-d '{"username": "zuck", "limit": 100}'Response Schema
All responses include success, data, and usage fields.
| Field | Type | Description |
|---|---|---|
| metadata.username | string | Username queried |
| metadata.type | string | Request type (following) |
| metadata.requested_limit | int | Limit requested |
| metadata.total_found | int | Total accounts returned |
| metadata.graphql_responses | int | Number of GraphQL responses fetched |
| metadata.scrolls | int | Number of pagination scrolls |
| metadata.elapsed_ms | int | Request duration in milliseconds |
| id | string | Unique Threads user ID |
| username | string | Threads handle |
| full_name | string | Display name |
| biography | string | Profile biography |
| follower_count | int | Number of followers |
| following_count | int | Number of accounts followed |
| is_verified | bool | Whether the user is verified |
| profile_pic_url | string | URL to the profile picture |
Example Response
{
"success": true,
"metadata": {
"username": "zuck",
"type": "following",
"requested_limit": 100,
"total_found": 1,
"graphql_responses": 13,
"scrolls": 0,
"elapsed_ms": 6431
},
"data": [
{
"id": "63055343223",
"username": "zuck",
"full_name": "Mark Zuckerberg",
"biography": "",
"follower_count": 0,
"following_count": 0,
"is_verified": true,
"profile_pic_url": "https://scontent.cdninstagram.com/.../photo.jpg"
}
],
"usage": {
"unique_posts": 85,
"limit": 6000,
"remaining": 5915
}
}Try this endpoint live
Sign up for free to try endpoints directly from the docs. No credit card required.
Create Free Account