Threads

Profile

A user's profile: name, bio, followers and links.

GET/v1/threads/profile1 credit
x-api-key*stringrequiredheader

Your API key, made in the dashboard.

Parameters

2
handlestringoptionalquery

A Threads handle, with or without the @. Give handle or url.

example: zuck

urlstringoptionalquery

A profile's link: threads.com/@<handle>, with anything after it. Give handle or url.

max 300 chars

Response fields

22
dataobject

The result: one object, or a list for the endpoints that return several.

data.idstring

Threads' id for the user.

data.usernamestring

The username, without the @.

data.urlstring

The profile's link.

data.namestringnullable

The display name.

data.biostringnullable

The bio.

data.followersintegernullable

Followers.

data.verifiedbooleannullable

Whether the user is verified.

data.privatebooleannullable

Whether the profile is private.

data.picturestringnullable

The profile picture's link. It is signed, and expires after a while.

data.linksstring[]nullable

The links on the profile.

pageobjectnullable

Paging, for the endpoints that page; null for the others.

page.next_cursorstringnullable

Send it as the cursor parameter, with the same other parameters, for the next page. Null on the last page.

page.has_morebooleanoptional

Whether another page follows.

default: false

metaobject

About this call.

meta.platformstring

The platform: reddit, threads, tiktok or youtube.

meta.endpointstring

The endpoint's name, such as channel_videos.

meta.paramsobject

The call's parameters, defaults included. Parameters without a value, and the cursor, are left out.

meta.request_idstring

This call's id. Quote it when you report a problem.

meta.api_versionstring

The API version that answered.

meta.fetched_atstring

When the data was fetched from the platform (UTC).

format: date-time

meta.cachedbooleanoptional

Whether it came from our cache; fetched_at says how old it is.

default: false

Code example

curl -X GET 'https://api.socialparse.dev/v1/threads/profile?handle=zuck' \  -H 'x-api-key: YOUR_API_KEY'

Responses

Successful Response

{  "data": {    "id": "string",    "username": "string",    "url": "string",    "name": "string",    "bio": "string",    "followers": 0,    "verified": true,    "private": true,    "picture": "string",    "links": [      "string"    ]  },  "page": {    "next_cursor": "string",    "has_more": false  },  "meta": {    "platform": "string",    "endpoint": "string",    "params": {      "property1": "string",      "property2": "string"    },    "request_id": "string",    "api_version": "string",    "fetched_at": "2019-08-24T14:15:22Z",    "cached": false  }}