Open in ChatGPT
Coding with AI?
Connect your agent to our MCP and let it integrate any endpoint for you in one shot.

Threads User Profile

Get the full profile for a single Threads user by username. Returns biography, follower count, verification status, profile picture (standard and high resolution), the external bio links displayed on the profile, and the topic tags shown on the profile.

Endpoint

GET /v1/threads/user

Price: $0.006 per request Free tier: 50 requests/month

Parameters

Parameter Required Description
username Yes Threads username, with or without leading @ (max 100 characters)

Response Fields

Field Type Description
user object Profile data object
user.username string Threads username
user.full_name string Display name
user.user_id string Threads user ID
user.biography string Profile biography text
user.follower_count integer Number of followers
user.is_verified boolean Whether the user is verified
user.is_private boolean Whether the account is private
user.profile_pic_url string URL to standard-resolution profile picture
user.profile_pic_url_hd string URL to high-resolution profile picture
user.bio_links array External bio link objects shown on the profile (url, title); empty array when the profile has no links
user.profile_tags array Topic tags shown on the profile (name, display_name); empty array when none
user.url string Link to the profile

Example Request

cURL

curl "https://apidirect.io/v1/threads/user?username=zuck" \
  -H "X-API-Key: YOUR_API_KEY"

Python

import requests

response = requests.get(
    "https://apidirect.io/v1/threads/user",
    headers={"X-API-Key": "YOUR_API_KEY"},
    params={"username": "zuck"}
)
print(response.json())

Example Response

{
  "user": {
    "username": "zuck",
    "full_name": "Mark Zuckerberg",
    "user_id": "63055343223",
    "biography": "Mostly superintelligence and MMA takes",
    "follower_count": 5673124,
    "is_verified": true,
    "is_private": false,
    "profile_pic_url": "https://scontent.cdninstagram.com/.../photo.jpg",
    "profile_pic_url_hd": "https://scontent.cdninstagram.com/.../photo_640x640.jpg",
    "bio_links": [
      {"url": "https://www.meta.com", "title": "meta.com"}
    ],
    "profile_tags": [
      {"name": "aithreads", "display_name": "AI Threads"}
    ],
    "url": "https://www.threads.com/@zuck"
  }
}