POST

Following

/v1/threads/user/following

Fetch up to 5,000 accounts that a Threads user follows. Returns full profile data for each followed account.

Request Parameters

ParameterTypeRequiredDescription
usernamestringYesThreads username
limitintNoMax 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.

FieldTypeDescription
metadata.usernamestringUsername queried
metadata.typestringRequest type (following)
metadata.requested_limitintLimit requested
metadata.total_foundintTotal accounts returned
metadata.graphql_responsesintNumber of GraphQL responses fetched
metadata.scrollsintNumber of pagination scrolls
metadata.elapsed_msintRequest duration in milliseconds
idstringUnique Threads user ID
usernamestringThreads handle
full_namestringDisplay name
biographystringProfile biography
follower_countintNumber of followers
following_countintNumber of accounts followed
is_verifiedboolWhether the user is verified
profile_pic_urlstringURL 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