Threads User Profile API

Endpoint

GET /v1/threads/user

Parameters

username *

Threads username, with or without leading @ (max 100 characters)

Response fields

user

Profile data object

username

Threads username

full_name

Display name

user_id

Threads user ID

biography

Profile biography text

follower_count

Number of followers

is_verified

Whether the user is verified

is_private

Whether the account is private

profile_pic_url

URL to standard-resolution profile picture

profile_pic_url_hd

URL to high-resolution profile picture

bio_links

External bio link objects shown on the profile (url, title); empty array when the profile has no links

profile_tags

Topic tags shown on the profile (name, display_name); empty array when none

url

Link to the profile

Example Request

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

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"
  }
}

Frequently asked questions

What profile data is included?

You get the username, display name, user ID, biography, follower count, verification status, profile picture (standard and high resolution), the external bio links shown on the profile, and the profile's topic tags.

What are bio_links?

bio_links is the list of external links a user adds to their Threads profile, each with a url and title. It is an empty array when the profile has no links.

How do I pass the username?

Provide the username with or without a leading @ (e.g. zuck or @zuck).

What happens if the username doesn't exist?

The endpoint returns 404 with code: "not_found". You are not charged for not_found responses.

How does pricing work?

You only pay for successful requests. The Threads User Profile API costs $0.006 per request. There are no monthly fees or commitments. You get 50 free requests per endpoint every month.

Do I need a credit card to start?

No. You can sign up and use the free tier (50 requests/endpoint/month) without adding a payment method. You only need to add a card when you want to exceed the free tier.

Are there rate limits?

Yes, there's a concurrency limit of 5 simultaneous requests per endpoint per user. If you need more, just get in touch.