---
title: "Return current public X/Twitter trends for a supported country"
method: GET
path: "/api/trends"
---

# Return current public X/Twitter trends for a supported country

`GET /api/trends`

## Request

- Base URL: `https://api.carryfeed.com`
- URL: `https://api.carryfeed.com/api/trends`
- Auth: none declared

## Query parameters

- `country` 'worldwide' | 'us' | 'ca' | 'gb' | 'de' | 'fr'
- `limit` integer

## Response `200`

Cached country trends with source timestamps and search links

## Other responses

- `400`: Unsupported country
- `429`: X upstream rate limit reached during a cache miss
- `503`: No usable snapshot and X trends collection is temporarily unavailable

---

[API](https://skmtc.dev/carryfeed/apis/carryfeed-api.md) · [All operations](https://skmtc.dev/carryfeed/apis/carryfeed-api/llms.txt) · [OpenAPI document](https://skmtc.dev/carryfeed/apis/carryfeed-api/revisions/00de1a6b965e?raw)