# List your trackers

> For the complete documentation index, see [llms.txt](https://www.shortsintel.com/llms.txt). Every docs page is also available as markdown: add .md to its URL. To connect, read [agents.md](https://www.shortsintel.com/agents.md).

GET `/v1/trackers`

The Customer's Trackers, newest first.

## Price

Free.

## Parameters

| Name | In | Type | Required | Default | Description |
| --- | --- | --- | --- | --- | --- |
| `limit` | query | `integer` min 1; max 100 | Optional | `25` | Items per page. |
| `cursor` | query | `string` | Optional | — | Opaque `next_cursor` from the previous page. |
| `state` | query | `string` one of `active`, `paused` | Optional | — | `active` or `paused`. |
| `kind` | query | `string` one of `creator`, `hashtag`, `sound`, `advertiser`, `keyword`, `video` | Optional | — | `creator`, `hashtag`, `sound` or `advertiser`; `video` (deprecated) lists any remaining Video Trackers. |

## Responses

### 200 OK

`{ items, next_cursor }`.

object

A page of a list. `items` holds the page; pass `next_cursor` back as `cursor` for the next one.

- `next_cursor` string required nullable Pass back as `cursor`. Null on the last page.
- `items` array of object required Trackers, newest first.
  - `id` string required
  - `kind` string required one of `creator`, `hashtag`, `sound`, `advertiser`, `keyword`, `video` `video` is deprecated (ADR 0024): existing Video Trackers keep working, new ones are refused with 400 `kind_deprecated`.
  - `platform` string required `meta` or `tiktok` for an advertiser Tracker.
  - `target` string required
  - `intelligence` boolean required Whether each new video (or Ad) the cycle finds is analysed.
  - `state` string required one of `active`, `paused`, `deleted`
  - `last_cycle_at` string required nullable
  - `last_run_id` string required nullable
  - `created_at` string required
  - `updated_at` string required
  - `coverage` string one of `library_regions_only`, `partial` `GET /v1/trackers/{id}`. TikTok advertiser: `library_regions_only` when its latest observation found no Ads in the TikTok ad library, which holds only Ads delivered in the EU/EEA, Switzerland, the UK and Turkey. Google advertiser: `partial` when it runs more Ads than a cycle lists. Keyword on Instagram or Facebook: `partial`, their search being a best-effort index. Absent otherwise.
  - `coverage_note` string The regions the TikTok ad library covers, beside `coverage`.
  - `focus` object The Tracker's Focus: which Videos are relevant to you. Terms are stored lowercased. Absent when it has none.
    - `text` string required
    - `must_mention` array of string required

### 400 Bad Request

`invalid_request` for a `cursor` that is not a `next_cursor` this API issued. Nothing is charged.

Code: `invalid_request`. The problem body and every code are on [Errors](https://www.shortsintel.com/docs/reference/errors).

### 401 Unauthorized

Codes: `missing_authorization`, `invalid_key`, `key_revoked`, `key_expired`, `invalid_token`. The problem body and every code are on [Errors](https://www.shortsintel.com/docs/reference/errors).

### 404 Not Found

`not_found` — including anything belonging to another Customer.

Code: `not_found`. The problem body and every code are on [Errors](https://www.shortsintel.com/docs/reference/errors).

## Related guides

- [Pagination](https://www.shortsintel.com/docs/concepts/pagination): Following `next_cursor` through a list.
- [Trackers](https://www.shortsintel.com/docs/concepts/trackers): Standing watches on a creator or an Advertiser: how a cycle runs, when it reports a change, and how to pause one.

## Request samples

curl:

```bash
curl "https://www.shortsintel.com/v1/trackers?limit=25&state=active&kind=creator" \
  -H "Authorization: Bearer sk_live_YOUR_KEY"
```

TypeScript:

```typescript
const response = await fetch(
  "https://www.shortsintel.com/v1/trackers?limit=25&state=active&kind=creator",
  {
    method: "GET",
    headers: {
      "Authorization": "Bearer sk_live_YOUR_KEY",
    },
  },
);

if (!response.ok) {
  throw new Error(`ShortsIntel ${response.status}`);
}

const data = await response.json();
```

Python:

```python
import requests

response = requests.get(
    "https://www.shortsintel.com/v1/trackers?limit=25&state=active&kind=creator",
    headers={
        "Authorization": "Bearer sk_live_YOUR_KEY",
    },
)
response.raise_for_status()

data = response.json()
```

200 · `{ items, next_cursor }`.

```json
{
  "items": [
    {
      "id": "trk_4b1e90c7aa",
      "kind": "creator",
      "platform": "tiktok",
      "target": "someone",
      "intelligence": true,
      "state": "active",
      "last_cycle_at": "2026-09-08T04:00:11.402Z",
      "last_run_id": "run_c07a41bb92",
      "created_at": "2026-09-01T11:20:03.118Z",
      "updated_at": "2026-09-08T04:00:11.402Z"
    }
  ],
  "next_cursor": null
}
```

[Previous Start tracking a target](https://www.shortsintel.com/docs/reference/trackers/create-tracker)[Next Read one tracker](https://www.shortsintel.com/docs/reference/trackers/get-tracker)
