---
title: "Fetch trending topics (by WOEID)"
method: POST
path: "/api/v1/twitter/trends"
tags: ["Twitter"]
---

# Fetch trending topics (by WOEID)

`POST /api/v1/twitter/trends`

## Request

- Base URL: `https://glim.sh`
- URL: `https://glim.sh/api/v1/twitter/trends`
- Auth: one of:
  - none
  - API key in header `x-api-key`
  - HTTP bearer
  - API key in query parameter `apiKey`

## Request body

- object
  - `woeid` integer: Yahoo Where On Earth ID. Defaults to 1 for worldwide trends.
  - `count` integer: Maximum trends to return

## Response `200`

Result

- object
  - `data` object[], required
    - `name` string, required
    - `target` string
    - `rank` integer
  - `meta` object, required
    - `result_count` integer, required

## Other responses

- `400`: Bad Request
- `402`: Payment Required
- `404`: Not Found
- `502`: Upstream error

---

[API](https://skmtc.dev/glim/apis/glim-sh.md) · [All operations](https://skmtc.dev/glim/apis/glim-sh/llms.txt) · [OpenAPI document](https://skmtc.dev/glim/apis/glim-sh/revisions/0094e5226d73?raw)