Retrieve Threads Profiles

Retrieve a Threads User's Profile Information

Use the GET /{threads-user-id}?fields=id,username,... endpoint to return profile information about a Threads user.

Permissions

The Threads Profile API requires an appropriate access token and permissions based on the node you are targeting. While you are testing, you can easily generate tokens and grant your app permissions by using the Graph API Explorer.

  • threads_basic — Required for making any calls to all Threads API endpoints.

Limitations

  • You may only fetch the profile of the app-scoped user.

Fields

NameDescription

id

Threads user ID. This is returned by default.

username

Handle or unique username on Threads.

name

Display name of the user on Threads.

threads_profile_picture_url

URL of the user's profile picture on Threads.

threads_biography

Biography text on Threads profile.

Example Request

curl -s -X GET \
"https://graph.threads.net/v1.0/me?fields=id,username,name,threads_profile_picture_url,threads_biography&access_token=$THREADS_ACCESS_TOKEN"

Example Response

{
  "id": "1234567",
  "username": "threadsapitestuser",
  "name": "Threads API Test User",
  "threads_profile_picture_url": "https://scontent-sjc3-1.cdninstagram.com/link/to/profile/picture/on/threads/",
  "threads_biography": "This is my Threads bio."
}