# Get trend

`GET https://api.unique.domains/v1/trends/{slug}`

One trend: its latest row, its head words, its figures at every edition and its latest observations.

The editions are one row per published edition that carried the trend, oldest first. The observations are the latest reading of each measurement, figures only; `TrendObservation` keeps no day series.

- Access: No key. Limited per address; a key adds the paid fields.
- Billing: One call.
- Formats: JSON
- API: Domain Trends API

## Request

| Field | Type | Needs | Where | Description |
| --- | --- | --- | --- | --- |
| `slug` | string | Required | Path | The trend's slug. |
| `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/padel"
```

## 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 |  |
| `headWords` | string[] |  |
| `editions` | object[] |  |
| `observations` | object[] |  |

## Errors

| Code | Status | What it means |
| --- | --- | --- |
| [`not_found`](https://unique.domains/api/problems/not_found) | 404 | Not found |
| [`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,
    "headWords": [
      "padel"
    ],
    "editions": [
      {
        "date": "2026-11-02",
        "persona": "founder",
        "searches": 246000,
        "growth": 87
      }
    ],
    "observations": [
      {
        "volume": 246000,
        "growth": 87,
        "growthWindow": "1y",
        "observedAt": "2026-11-01T04:12:00.000Z"
      }
    ]
  },
  "meta": {
    "asOf": "2026-11-05T08:00:00Z",
    "cursor": null,
    "limit": null
  },
  "links": {
    "self": "https://api.unique.domains/v1/trends/padel",
    "next": null,
    "register": null,
    "product": null,
    "dataset": null
  }
}
```

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

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