[← Back to tools]
twitter.trending

Get X trending topics: pay per use, no API key

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

Fetch public X (Twitter) trending topics for a country through TikHub.

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.trending accepts as JSON input.

  • countrystringOptional

    TikHub country name such as `UnitedStates`, `UnitedKingdom`, or `India`.

Raw input JSON Schema
{
  "type": "object",
  "required": [],
  "properties": {
    "country": {
      "type": "string",
      "default": "UnitedStates",
      "maxLength": 40,
      "minLength": 2,
      "description": "TikHub country name such as `UnitedStates`, `UnitedKingdom`, or `India`."
    }
  },
  "additionalProperties": false
}

Returns

Fields a successful twitter.trending call returns.

  • countintegerRequired
  • resultsanyRequired

    Raw TikHub payload. List endpoints usually nest rows under keys such as `itemList`.

  • 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": {
      "description": "Raw TikHub payload. List endpoints usually nest rows under keys such as `itemList`."
    },
    "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.trending tool with this input: {"country":"UnitedStates"}
Start with $1 freeSee 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]