InsightSocial API
Threads

Search › Users

GET
/v1/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: 20–260 credits. We reserve the ceiling when the call starts and charge what it actually used when it finishes.

Re-running the exact same call within 1h is free.

Authorization

apiKey
x-api-key<token>

Your key from the dashboard. It starts with isk_.

In: header

Query Parameters

query*string

Search keyword or phrase to find Threads users

include?"profile"

Send profile to fill author.followers, author.bio, author.private and author.ext.bio_link 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.

Value in

  • "profile"
limit?integer

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

Range1 <= value <= 12
include_details?boolean

Prefer include=profile in new code.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/threads/search/users?query=string"
{  "success": true,  "platform": "instagram",  "endpoint": "/v1/instagram/profile/posts",  "data": {    "items": [      "…"    ],    "dropped": 0  },  "pagination": {    "next_cursor": "is2.eyJwIjoyfQ",    "has_more": true,    "page_size": 12  },  "credits_used": 20,  "credits_remaining": 9980,  "request_id": "req_1a2b3c4d5e6f",  "cached": false,  "idempotent_replay": false,  "charge_reason": "miss",  "free_call": false}

Profile GET

Returns a Threads account's public profile: bio, the external link set in that bio, follower count, profile picture URL, and verification status. Use it when you have a handle and want the account itself; user/posts returns what that account has posted. **20 credits** per call. Re-running the exact same call within 24h is free.

Search GET

Returns Threads posts matching a keyword, each with its text, like count, author, creation time, and the topic tag it was filed under at post.ext.topic_tag, plus a cursor for the next window. Use it to find posts by topic across Threads. Follow pagination.next_cursor to page deeper, or set limit (up to 100) to collect several windows in one call; start_date and end_date bound the period. **Metered: 20–680 credits.** We reserve the ceiling when the call starts and charge what it actually used when it finishes. Re-running the exact same call within 1h is free. Paginates by `cursor` — see [Pagination](/docs/pagination).