Twitter Get Trends API

Retrieve the current trending topics from Twitter using the getTrends method from agent-twitter-client (no Twitter API key required).

Endpoint

GET https://api.recoupable.com/api/x/trends

Parameters

This endpoint does not require any parameters.

Request Examples

cURL

curl -X GET "https://api.recoupable.com/api/x/trends" \
  -H "Content-Type: application/json"

Example Response

{
  "status": "success",
  "trends": [
    "Tierra del Fuego",
    "Sofia Carson",
    "Macri",
    "$MAS",
    "Twenty One Capital",
    "$COCORO",
    "Terrorista",
    "Plan Platita",
    "#ArtTank",
    "Marilu",
    "Industria",
    "WonderFi",
    "Martes 13",
    "$BERT",
    "CORES",
    "Pepe Mujica",
    "$SKI",
    "Internet Capital Markets",
    "Sampdoria",
    "Latinoamérica"
  ]
}

Response Properties

Property	Type	Description
status	string	Status of the request ("success" or "error")
trends	string[]	List of current trending topics on Twitter

Workflow Guide

This endpoint is typically used as part of a workflow to:

Retrieve the current trending topics on Twitter
Display the list of trends to users or use them as search queries

Notes

This endpoint uses the getTrends method from agent-twitter-client and does not require a Twitter API key.
Rate limits may apply (see agent-twitter-client docs).
Results are real-time but may be subject to unofficial API limitations.
For advanced options, see the agent-twitter-client documentation.