Threads Search Profiles
Search for Threads user profiles by keyword. Input: query is a required string containing the search keyword, for example "mark". Returns: Search result data containing a users list. Profiles may include a user ID (pk), username, full name (full_name), profile picture URL (profile_pic_url), verification status (is_verified), and follower count (follower_count). Available fields can vary; the result schema does not guarantee every listed profile field. Results identify matching profiles, not posts.
Pricing
| Condition | Charge |
|---|---|
| Each call | 4.13 credits/call |
4.13 credits/call Charges are per query. A successful query is billed even if it returns no results.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
query | string | Yes | 搜索关键词/Search query | — |
Invocation example
Parameter templateGenerated from the parameter configuration. Replace the sample values before use.
/agent-api/v1/tool/executeX-Api-Keycurl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_threads_search_profiles' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"query": "xxx"
}
}'No response example available yet.



