# Rank the members

> 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/collections/{id}/members`

The members ranked, highest first, on their latest Snapshot and Scores, with each member's Tracker and its state. Nothing is fetched: a member that has not cycled yet ranks last with nulls.

## Price

Free.

## Parameters

| Name | In | Type | Required | Default | Description |
| --- | --- | --- | --- | --- | --- |
| `id` | path | `string` | Required | — | Collection id. |
| `order_by` | query | `string` one of `followers`, `median_views`, `outlier`, `views` | Optional | — | `followers`, `median_views`, `outlier` or `views`. Defaults to `followers` for a creator Collection, `views` otherwise. Ties keep the order members were added. |
| `platforms` | query | `string` | Optional | — | Comma-separated, or repeated. Omit for every Platform. |
| `limit` | query | `integer` min 1; max 100 | Optional | `25` | Items per page. |
| `cursor` | query | `string` | Optional | — | Opaque `next_cursor` from the previous page. |

## Responses

### 200 OK

`{ order_by, 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
  - `rank` integer required 1-based, across the whole filtered ranking rather than the page.
  - `tracker` object required The member, state included.
    - `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
  - `name` string required nullable Creators: their display name. Null on other kinds and before a creator's first cycle.
  - `avatar_url` string required nullable Creators: our archived avatar when there is one, else the platform's URL, which may expire. Null on other kinds and before a creator's first cycle.
  - `snapshot_at` string required nullable When the numbers were taken. Null when it has not cycled yet.
  - `followers` number required nullable Creators: followers at the latest Snapshot.
  - `views` number required nullable Creators: views across their last 20 videos. Videos, hashtags and sounds: views at the latest Snapshot.
  - `median_views` number required nullable The creator's baseline median; for a video, its creator's.
  - `outlier` number required nullable Creators: the best `views / median_views` among their last 20 videos. Videos: their own.
- `order_by` string required one of `followers`, `median_views`, `outlier`, `views` The metric the ranking used.

### 400 Bad Request

`invalid_request` (or `unsupported_platform` for an unknown entry in `platforms`) — an unknown `order_by`, or a `cursor` that is not a previous `next_cursor`.

Codes: `invalid_request`, `unsupported_platform`. 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

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.

## Request samples

curl:

```bash
curl "https://www.shortsintel.com/v1/collections/col_7d20e1b5c4/members?order_by=followers&platforms=tiktok%2Cinstagram&limit=25" \
  -H "Authorization: Bearer sk_live_YOUR_KEY"
```

TypeScript:

```typescript
const response = await fetch(
  "https://www.shortsintel.com/v1/collections/col_7d20e1b5c4/members?order_by=followers&platforms=tiktok%2Cinstagram&limit=25",
  {
    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/collections/col_7d20e1b5c4/members?order_by=followers&platforms=tiktok%2Cinstagram&limit=25",
    headers={
        "Authorization": "Bearer sk_live_YOUR_KEY",
    },
)
response.raise_for_status()

data = response.json()
```

200 · `{ order_by, items, next_cursor }`.

```json
{
  "order_by": "followers",
  "items": [
    {
      "rank": 1,
      "tracker": {
        "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"
      },
      "name": "Someone",
      "avatar_url": "https://p16-sign.tiktokcdn.com/obj/tos-avatar-someone.jpeg",
      "snapshot_at": "2026-09-08T04:00:11.402Z",
      "followers": 1284000,
      "views": 9812400,
      "median_views": 212000,
      "outlier": 6.06
    }
  ],
  "next_cursor": null
}
```

[Previous Delete a collection, optionally its trackers](https://www.shortsintel.com/docs/reference/collections/delete-collection)[Next Read members' change reports](https://www.shortsintel.com/docs/reference/collections/list-collection-changes)
