Threads Search Posts

4.13 credits/call
ae_threads_search_posts

Search Threads posts by keyword. Input: - `query` (required string): The keyword to search for, such as `bitcoin`. Returns: Search response data with a documented `results` list of matching posts. Entries may include post details such as identifiers, captions, like counts, and timestamps; author information such as usernames, profile images, and verification status; and image, video, or carousel media information when available. The detailed result structure is not fixed by the response schema, so available fields may vary. Example: `{"query":"bitcoin"}`

Social
4.13 credits/call

Pricing

4.13 credits/call
ConditionCharge
Each call4.13 credits/call

Each call has a fixed charge of 4.13 credits. Charges are per query. A successful query is billed even if it returns no results.

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
querystringYes搜索关键词/Search query—

Invocation example

Copy the request and explore its response example.

POST/agent-api/v1/tool/executeX-Api-Key
Request coderequest.sh
curl --request POST \
  --url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_threads_search_posts' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "query": "INMO"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "code": 200,
  "data": {
    "results": [
      {
        "node": {
          "__typename": "XDTSearchThread",
          "thread": {
            "id": "3996168462159370301",
            "thread_items": [],
            "thread_type": "thread"
          }
        }
      }
    ]
  },
  "docs": "https://api.tikhub.io/#/Threads-Web-API/search_posts_api_v1_threads_web_search_posts_get",
  "message": "Request successful. This request will incur a charge."
}

This example shows part of the response. Copied content is valid JSON.