threads

Search › Users

Returns Threads accounts matching a query, with handle, display name, avatar and verification status. Follower count, bio and the private flag stay null unless you send include=profile.

Use it to find accounts by name or topic; search looks for posts instead of people. Send include=profile when you need follower count and bio on the same rows, per account filled.

Metered: 10–130 credits. We reserve the ceiling when the call starts and charge what it actually used when it finishes.

get/v1/threads/search/users

Request

  • Base URL: https://api.insightsocial.app
  • URL: https://api.insightsocial.app/v1/threads/search/users
  • Auth: API key in header x-api-key

Query parameters

querystring required
Example:tech

Search keyword or phrase to find Threads users

include'profile'

Send profile to fill author.followers, author.bio, author.private and external_url on each account by looking it up on /v1/threads/profile in the same call. Adds 3 to 6 seconds, never more than 12. One token only: profile.

limitinteger

Take the top N accounts of the page, 1 to 12.

include_detailsboolean

Prefer include=profile in new code.

dry_run'1'

Set to 1 to get the price of this call without making it: data.dry_run carries credits_min and credits_max. Nothing is charged.

Response

Success.

successtrue required
platformstring required
endpointstring required
schema_version'2' required
unavailablestring[] required
credits_usedinteger required
credits_remaininginteger required
request_idstring required
cachedboolean required
idempotent_replayboolean required
charge_reasonstring required
free_callboolean required

Changes

No recorded changes to this operation across all 1 revision of this API.