# List trend pool

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

The admitted trend candidates the editions draw from, with their observations.

Each candidate's normalised phrase, definition, head and seed words, open names on the founder and investor endings and its latest observations, figures only. Keyset on `canonical`; 100 rows a page unless `limit` asks fewer.

- Access: A member key (Founder or Investor) or a paid RapidAPI subscription to this API.
- Billing: One call.
- Formats: JSON
- API: Domain Trends API

## Request

| Field | Type | Needs | Where | Description |
| --- | --- | --- | --- | --- |
| `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/pool" \
  -H "Authorization: Bearer YOUR_MEMBER_KEY"
```

## Response

| Field | Type | Description |
| --- | --- | --- |
| `canonical` | string |  |
| `definition` | string \| null |  |
| `headWords` | string[] |  |
| `seedWords` | string[] |  |
| `openNamesFounder` | integer \| null |  |
| `openNamesInvestor` | integer \| null |  |
| `observations` | object[] |  |

## 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": [
    {
      "canonical": "padel",
      "definition": "A racket sport played in doubles.",
      "headWords": [
        "padel"
      ],
      "seedWords": [
        "court",
        "racket",
        "club"
      ],
      "openNamesFounder": 14,
      "openNamesInvestor": 3,
      "observations": []
    }
  ],
  "meta": {
    "asOf": "2026-11-05T08:00:00Z",
    "cursor": null,
    "limit": 20
  },
  "links": {
    "self": "https://api.unique.domains/v1/trends/pool",
    "next": null,
    "register": null,
    "product": null,
    "dataset": null
  }
}
```

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

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