# X trending API

trending on X: 0.1 credits per successful call, with clear inputs, source data and billing.

Canonical: https://socialtoai.com/x-trending-api/

## One request

0.1 credits per successful or empty call. Failed calls cost 0.

Replace any PASTE_PUBLIC placeholder with a supported public identifier. This is a request template; it does not run automatically.

```
curl --request POST 'https://api.socialtoai.com/v1/trending' \
  --header "X-API-Key: $SOCIALTOAI_API_KEY" \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: REPLACE_WITH_A_UNIQUE_REQUEST_ID' \
  --data '{"platform":"x"}'
```

## Native support

Result shape: leaderboard. Pagination: not supported.

Categories: no category selector.

These values describe the reference card. Additional restrictions can apply to user discovery or a content subtype. Inspect applied_params and warnings instead of assuming an unsupported filter was honored.

## A schema-checked example

Illustrative result with one invented value and an example trial balance. It shows the response shape; it is not a live response or a production availability measurement.

```
{
  "request_id": "example_only_not_a_live_call",
  "schema_version": "v1",
  "fetched_at": "2026-09-05T00:00:00Z",
  "status": "ok",
  "applied_params": {},
  "warnings": [],
  "items": [
    {
      "kind": "leaderboard",
      "rank": 1,
      "title": "Illustrative trending topic",
      "heat": 982000
    }
  ],
  "platform": "x",
  "billing": {
    "cost": 0.1,
    "balance": 1.9,
    "unit": "credits",
    "pricing": "standard"
  }
}
```

## Platform limitations

Search count is limited to 1–20 before any upstream request. Source pagination can be unstable; continuation failure is reported rather than silently returning the first page.

Only relevance and latest are native sorts. Other popularity sorts are approximations with warnings. Time and media filters use advanced-search operators.

Trending is Worldwide only, without location, count or pagination parameters.

Comments contain direct replies to the requested post or reply branch.

Profiles require a username or profile URL; numeric IDs are not silently used as usernames. Creator posts also accept a user ID.

[All X actions →](https://socialtoai.com/platforms/x/)