X trends

Get the top trending topics on X (Twitter) for a location (WOEID). Defaults to worldwide. Use when the user asks what's trending. X-only — Instagram has no equivalent.

Authorization

bearerAuth

AuthorizationBearer <token>

JWT token from authentication

In: header

Header Parameters

Endless-Api-Version?string

Pin the caller to an API major (1). Omit to accept the current version. A major this deployment cannot serve is refused with 400 unsupported_api_version.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

organization_id*string

Match^org_

max_credits?integer

Refuse the call when its quoted ceiling exceeds this many credits.

Range-9007199254740991 <= value <= 9007199254740991

tool_call_id?|

The tool call behind this read, for the ledger. Every read that runs is billed, a repeated id too.

conversation_id?|

The chat this call belongs to, for cost attribution.

message_id?|

The chat turn this call belongs to, for cost attribution.

input*

Response Body

`application/json`

curl -X POST "https://example.com/social/x_trends" \  -H "Content-Type: application/json" \  -d '{    "organization_id": "string",    "input": {}  }'

{  "operation": "instagram_profile",  "result": {    "summary": "string",    "woeid": -9007199254740991,    "count": -9007199254740991,    "trends": [      {        "name": "string",        "url": "string",        "tweet_volume": 0      }    ]  },  "requests": 0,  "credits_charged": 0}

X trends

Authorization

Header Parameters

Request Body

Response Body

200application/json

400application/json

401application/json

402application/json

403application/json

409application/json

429application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`