---
title: "Read what is trending in a country"
method: GET
path: "/trending"
tags: ["Trending"]
---

# Read what is trending in a country

`GET /trending`

## Request

- Base URL: `https://api.socially.run/v1`
- URL: `https://api.socially.run/v1/trending`
- Auth: HTTP bearer

One country's board: Google's rising searches, each with the news behind it and an approximate volume, or YouTube's most popular videos. A board stays fresh in the cache for ten minutes. A cached board costs 0 credits. When the source refuses us, the last good board is served instead, flagged `stale` with the time it was captured, and it costs nothing either: you are charged for a reading, never for an attempt.

## Query parameters

- `source` 'google' | 'youtube': Which board to read: `google` for what a country is searching, `youtube` for what it is watching.
- `geo` string, required: The country, ISO 3166-1 alpha-2 (US, BR, ES). REQUIRED: a board is one country's board, and there is no honest default for whose. This used to fall back to `US`, which meant a caller in São Paulo was quietly handed the American one. A country the source does not publish answers 400 and says so. For a subject rather than a country, see `search_news` and `search_youtube`. A trending board takes no query.
- `category` string: YouTube's video category id: `10` is Music, `17` Sport. YouTube only: Google Trends publishes no categories.
- `limit` integer: Entries to return, 1–50. Google publishes ten per country.

## Response `200`

Read what is trending in a country

- object
  - `data` unknown, required

## Other responses

- `400`: VALIDATION_ERROR / INVALID_TARGET / SSRF_BLOCKED: the issues, never the values.
- `401`: UNAUTHORIZED / INVALID_TOKEN: the key is missing or wrong.
- `402`: PAYMENT_REQUIRED / PLAN_GATE: clears by upgrading or buying credits, never by waiting.
- `429`: RATE_LIMIT_EXCEEDED / QUOTA_EXCEEDED: Retry-After says when it clears.
- `default`: Any other failure.

---

[API](https://skmtc.dev/socially/apis/socially-run-send-a-profile-link-get-its-public-data-as-json.md) · [All operations](https://skmtc.dev/socially/apis/socially-run-send-a-profile-link-get-its-public-data-as-json/llms.txt) · [OpenAPI document](https://skmtc.dev/socially/apis/socially-run-send-a-profile-link-get-its-public-data-as-json/revisions/5a0b24534b90?raw)