Threads Search Users API

Endpoint

GET /v1/threads/users

Parameters

query *

Search keyword (max 500 characters)

Response fields

users

Array of matching user profiles

username

Threads username

full_name

Display name

user_id

Threads user ID

is_verified

Whether the user is verified

is_private

Whether the account is private

profile_pic_url

URL to profile picture

url

Link to the profile

count

Total results returned

Example Request

curl "https://apidirect.io/v1/threads/users?query=technology" \
  -H "X-API-Key: YOUR_API_KEY"

import requests

response = requests.get(
    "https://apidirect.io/v1/threads/users",
    headers={"X-API-Key": "YOUR_API_KEY"},
    params={"query": "technology"}
)
print(response.json())

Example Response

{
  "users": [
    {
      "username": "technologyreview",
      "full_name": "MIT Technology Review",
      "user_id": "63213270539",
      "is_verified": true,
      "is_private": false,
      "profile_pic_url": "https://scontent.cdninstagram.com/.../photo.jpg",
      "url": "https://www.threads.com/@technologyreview"
    }
  ],
  "count": 9
}

Frequently asked questions

What user data is returned?

Each result includes username, display name, user ID, verification status, privacy status, profile picture URL, and a direct link to the profile.

Can I see follower counts and bios?

Search Users returns basic discovery data only. For a full profile — biography, follower count, and bio links — use the User Profile endpoint.

How many users are returned?

Each request returns a single page of matching users (typically up to 15). There are no pagination parameters.

How does pricing work?

You only pay for successful requests. The Threads Search Users API costs $0.006 per request. There are no monthly fees or commitments. You get 50 free requests per endpoint every month.

Do I need a credit card to start?

No. You can sign up and use the free tier (50 requests/endpoint/month) without adding a payment method. You only need to add a card when you want to exceed the free tier.

Are there rate limits?

Yes, there's a concurrency limit of 5 simultaneous requests per endpoint per user. If you need more, just get in touch.