# List trends

`GET https://api.unique.domains/v1/trends`

Every published trend with its latest edition figures and its first and last edition day.

The trends behind the daily editions, one row per trend from its latest published edition. Ordered by slug, or by last edition day (newest first) with `sort=day`.

- Access: No key. Limited per address; a key adds the paid fields.
- Billing: One call.
- Formats: JSON, CSV (`.csv`)
- API: Domain Trends API

## Request

| Field | Type | Needs | Where | Description |
| --- | --- | --- | --- | --- |
| `category` | string | Optional | Query | A category slug (`GET /trends/categories`). |
| `lane` | string: weekly, yearly | Optional | Query | The editions' lane the trend was drawn from. |
| `since` | string | Optional | Query | Trends whose last edition day is on or after this UTC day. |
| `sort` | string: slug, day | Optional | Query | `slug`, or `day` for the last edition day, newest first. |
| `limit` | integer | Optional | Query | Rows a page: 20 by default, at most 20 without a key and 100 with a paid subscription; a larger value is clamped. |
| `cursor` | string | Optional | Query | The `meta.cursor` of the previous page; the last page answers `null`. |
| `fields` | string | Optional | Query | Comma-separated top-level keys to keep; an unknown key answers 400 `unsupported_field`. |

## Sample request

```bash
curl -X GET "https://api.unique.domains/v1/trends?category=sports"
```

## Response

| Field | Type | Description |
| --- | --- | --- |
| `slug` | string |  |
| `name` | string |  |
| `category` | string \| null |  |
| `definition` | string \| null |  |
| `volume` | integer \| null | Monthly searches at the latest edition. |
| `growth` | integer \| null | Signed whole percentage at the latest edition. |
| `lane` | string \| null |  |
| `headWord` | string \| null |  |
| `whyNow` | string \| null |  |
| `firstEditionOn` | string |  |
| `lastEditionOn` | string |  |
| `editionCount` | integer |  |

## Errors

| Code | Status | What it means |
| --- | --- | --- |
| [`rate_limited`](https://unique.domains/api/problems/rate_limited) | 429 | Too many requests |
| [`internal`](https://unique.domains/api/problems/internal) | 500 | Unexpected error |

## Example answer

200, application/json

```json
{
  "data": [
    {
      "slug": "padel",
      "name": "Padel",
      "category": "Sports",
      "definition": "A racket sport played in doubles on an enclosed court.",
      "volume": 246000,
      "growth": 87,
      "lane": "yearly",
      "headWord": "padel",
      "whyNow": "Clubs are opening faster than courts can be booked.",
      "firstEditionOn": "2026-10-03",
      "lastEditionOn": "2026-11-02",
      "editionCount": 4
    }
  ],
  "meta": {
    "asOf": "2026-11-05T08:00:00Z",
    "cursor": null,
    "limit": 20
  },
  "links": {
    "self": "https://api.unique.domains/v1/trends?category=sports",
    "next": null,
    "register": null,
    "product": null,
    "dataset": null
  }
}
```

API status: https://uniquedomains.instatus.com

Full reference: https://unique.domains/api