Skip to main content
GET
/
v1
/
scrape
/
threads
/
search-users
Search Users
curl --request GET \
  --url https://api.sociavault.com/v1/scrape/threads/search-users \
  --header 'X-API-Key: <api-key>'
{
  "success": true,
  "data": {
    "success": true,
    "users": {
      "0": {
        "username": "shams",
        "pk": "5951152863",
        "is_active_on_text_post_app": true,
        "full_name": "Shams Charania",
        "profile_pic_url": "https://scontent-cdg4-2.cdninstagram.com/v/t51.2885-19/482795192_3376548399146227_6340123271493467395_n.jpg?stp=dst-jpg_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=scontent-cdg4-2.cdninstagram.com&_nc_cat=1&_nc_oc=Q6cZ2QHI7mSzofIgFZ2_AMpd54G3_GVtUAWp77gmo0avA_HjzGY7GzfYnG9g850fTfZOdus&_nc_ohc=r6TKetrhjckQ7kNvwFUyP78&_nc_gid=na2q8pERMMC0rsngcGi1NQ&edm=AHhEZX8BAAAA&ccb=7-5&oh=00_Aft8obJkYyVD5Q0Cg5vsC9o3hx6BZK6PJluiu1CPs1xWeg&oe=698F8AA0&_nc_sid=e8efdc",
        "is_verified": true,
        "has_onboarded_to_text_post_app": true,
        "id": "5951152863"
      }
    }
  },
  "credits_used": 1,
  "endpoint": "search-users"
}
💳 1 credit per request

Authorizations

​
X-API-Key
string
header
required

API key for authentication. Format: sk_live_xxxxxxxxxxxxx

Get your API key from the Dashboard.

Query Parameters

​
query
string
required

Username to search for

Example:

"shams"

Response

Successful response

Key Response Fields:

  • data.users[n].username: Threads handle
  • data.users[n].pk: User unique ID
  • data.users[n].full_name: Display name
  • data.users[n].is_verified: Verification status
  • data.users[n].profile_pic_url: Profile picture URL
  • data.users[n].is_active_on_text_post_app: Whether user is active on Threads
  • data.users[n].has_onboarded_to_text_post_app: Whether user has set up Threads