Support needed? Reach out! ๐Ÿ“ง

How to Scrape Threads User Search Results

This tutorial shows how to use Threads User Search Results API to scrape and crawl structured Threads data in real-time.
Identify relevant Threads creators and accounts with our user search API and retrieve matching profiles, follower counts, and bio data to streamline influencer vetting and outreach.

Access Threads Data in 3 Steps

Start crawling Threads user discovery data. Follow these steps to extract social media data in minutes.

1

Create Your Account

Go to our registration page and make an account. It's free, no credit card, and you get credits right away to play around with.

2

Verify Your Email Address

You'll get a verification email, click the link in it. Once that's done, you can grab your API token from the dashboard.

3

Make Your First API Call

Copy the code snippet below, swap in your API key, and run it. You'll get Threads data back as JSON within a few seconds.

Code Sample

Here's a JavaScript example to get you going. Swap out the token and you're good, works the same way in any language that can make HTTP requests. Start collecting user discovery data via our REST API!

javascript-logo JavaScript
Threads User Search
1 const root = 'https://ensembledata.com/apis'
2 const endpoint = '/threads/user/search'
3 const params = {
4   "name""orlandomagic",
5   "token""YOUR-TOKEN-HERE"
6 }
7  
8 const queryString = new URLSearchParams(params).toString();
9 const url = `${root}${endpoint}?${queryString}`;
10  
11 await fetch(url)
12   .then(response => response.json())
13   .then(data => console.log(data))
14   .catch(error => console.error(error));
15  

Parameters

name (string) Name of the user to search. REQUIRED
token (string) Private token assigned to each client to access the APIs. REQUIRED

Example Response

Explore the fields returned by this endpoint. Click a row to expand nested objects and arrays, hover a value to copy it, or use "Expand all" to see everything at once.

JSON
Threads User Search
dataarray1 item ยท schema from #0 1 item
nodeobject12 fields
usernamestring"orlandomagic"
pkstring"195178788"
is_active_on_text_post_appbooleantrue
full_namestring"Orlando Magic"
profile_pic_urlstring"https://scontent-scl2-1.cdninstagram.com/v/t51.2885-19/438868684_38491โ€ฆ"
is_verifiedbooleantrue
text_post_app_is_privatenullnull
friendship_statusnullnull
follower_countnumber276177
profile_context_facepile_usersnullnull
has_onboarded_to_text_post_appbooleantrue
idstring"195178788"

Response Codes

Status codes this endpoint can return, so you can handle errors before they surprise you in production.

200SuccessSuccessful Response
422Client ErrorValidation Error
491Client ErrorToken not found
492Client ErrorEmail not verified
493Client ErrorSubscription expired
495Client ErrorAll daily units used
500Server ErrorSomething went wrong

API Pricing

4 units Cost per successful call to this endpoint.

Fetch Threads Data at Scale

Crawl Threads user search results at scale for influencer outreach, competitor mapping, or building audience research datasets.

deco-icon

Profile Match

Find Threads user profiles matching any keyword you search.

deco-icon

Follower Counts

See follower counts returned for each matching profile.

deco-icon

Bio Data

Get bio text to quickly assess creator relevance at a glance.