Threads

Threads Profile API

Get a Threads user profile as JSON - numeric user id, handle, full name, biography, profile picture, follower count and verified flag. Costs 2 credits addressed by user_id and 4 credits addressed by username: the handle has to be resolved upstream first, so it buys a second call. Resolve a handle once, keep the user_id, and every later request stays on the cheap path.

POST/api/v1/threads/profile

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).

Body

application/json

user_idstring

Numeric Threads user id. The cheap path: 2 credits. Get one from the Threads User Search endpoint, or from the user object on any post.

Example: 63269174602

usernamestring

Threads handle without the leading @, 1 to 60 characters. Costs 4 credits instead of 2, because the upstream handle lookup is dead and the id is resolved through people search first. Provide user_id or username; sending neither is rejected.

Example: natgeo

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")

# 2 credits: addressed by numeric id
profile = client.threads.profile(user_id="63269174602")

# 4 credits: addressed by handle
# profile = client.threads.profile(username="natgeo")
print(profile)

Response

"user_id": "63269174602",

"username": "natgeo",

"full_name": "National Geographic",

"biography": "Step into wonder and find your inner explorer with National Geographic",

"profile_pic_url": "https://scontent-sea5-1.cdninstagram.com/v/t51.82787-19/684235167_17961318525110603_2950335531617183679_n.jpg?stp=dst-jp...",

"follower_count": 18211345,

"is_verified": true,

"is_private": null

"response_time": 1218,

"credits_used": 2,

"credits_remaining": 999

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") # 2 credits: addressed by numeric id profile = client.threads.profile(user_id="63269174602") # 4 credits: addressed by handle # profile = client.threads.profile(username="natgeo") print(profile)