twitter.search

Search X posts: pay per use, no API key

Use TikHub from Claude, Claude Code, Cursor, ChatGPT, and other agents through one Cralo balance.

Search public X (Twitter) posts by keyword through TikHub and return the provider's full result data.

Price and execution

Price: $0.001
Pricing model: Fixed price per successful call
Execution class: fast

Limits

No additional limits are published for this tool.

Parameters

Fields twitter.search accepts as JSON input.

querystringRequired
Keyword or phrase to search for in public X posts.
cursorstringOptional
Opaque pagination cursor returned by a previous response; omit for the first page.
search_type"Top" | "Latest" | "Media" | "People"Optional
X search result category to return.

Raw input JSON Schema

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Keyword or phrase to search for in public X posts."
    },
    "cursor": {
      "type": "string",
      "maxLength": 500,
      "description": "Opaque pagination cursor returned by a previous response; omit for the first page."
    },
    "search_type": {
      "enum": [
        "Top",
        "Latest",
        "Media",
        "People"
      ],
      "type": "string",
      "default": "Top",
      "description": "X search result category to return."
    }
  },
  "additionalProperties": false
}

Returns

Fields a successful twitter.search call returns.

countintegerRequired
resultsanyRequired
retrieved_atstring (date-time)Required
provider_request_idstring | nullRequired

Raw output JSON Schema

{
  "type": "object",
  "required": [
    "results",
    "count",
    "provider_request_id",
    "retrieved_at"
  ],
  "properties": {
    "count": {
      "type": "integer",
      "minimum": 0
    },
    "results": {},
    "retrieved_at": {
      "type": "string",
      "format": "date-time"
    },
    "provider_request_id": {
      "type": [
        "string",
        "null"
      ]
    }
  },
  "additionalProperties": false
}

Run this tool

Copy this instruction to your agent to set up Cralo and call this tool with the example input.

Set up Cralo by following https://cralo.ai/SKILL.md, then call the twitter.search tool with this input: {"query":"agent tools","search_type":"Top"}

Start with $1 free See pricing

Safety notes

Side Effect: read_only
Public Sources Only: Yes
Authenticated Content: No

How this compares to using TikHub directly

You do not need a separate TikHub account or subscription for this call. Cralo uses one prepaid balance across all tools and shows the per-call price before you run the command.

Related tools

[Browse all tools]