---
title: "Get trending entities"
method: GET
path: "/trending/entities"
tags: ["Trending"]
---

# Get trending entities

`GET /trending/entities`

## Request

- Base URL: `https://studio.fintechstudios.com/api/v1`
- URL: `https://studio.fintechstudios.com/api/v1/trending/entities`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

Get trending entities (companies, people, regions, etc.) from the FTS Analytics API. Returns entities ranked by trend score over a 4-hour rolling window.

## Query parameters

- `group` 'company' | 'people' | 'person' | 'region' | 'industry' | 'topic' | 'agency' | 'currency'
- `count` integer

## Response `200`

Trending entities

- object
  - `data` object
    - `entities` object[]
      - `id` integer
      - `name` string
      - `type` string
      - `type_display` string
      - `trend_score` number
    - `group` string
    - `total` integer
  - `meta` Meta
    - `request_id` string
    - `credits_used` integer
    - `credits_remaining` integer
    - `rate_limit` object
      - `limit` integer
      - `remaining` integer
      - `reset` integer

## Other responses

- `400`: Invalid group parameter
- `401`: Invalid API key
- `402`: Insufficient credits
- `429`: Rate limit exceeded
- `502`: Upstream API error

---

[API](https://skmtc.dev/fintechstudios/apis/fts-studio-api.md) · [All operations](https://skmtc.dev/fintechstudios/apis/fts-studio-api/llms.txt) · [OpenAPI document](https://skmtc.dev/fintechstudios/apis/fts-studio-api/revisions/4886597d1d96?raw)