# Creator lists

URL: https://docs.sigment.ai/tools/creator-lists

Save shortlists, keep them on the current best set, and share them.

A creator list holds creators from one platform. For a brief, create the list first and keep it on the current best set with `set_creator_list`, so every run ends with a list the user can open in Sigment.

### list_creator_lists

The workspace's creator lists (shortlists).

Kind: read-only

| Parameter | Type | Required | Default | Limits |
|---|---|---|---|---|
| `workspace_id` | `string` | no |  | 1–100 chars |

### get_creator_list

A creator list with its members. Pass `handles` to analyze_creators (up to 50 per analysis) to vet it.

Kind: read-only

| Parameter | Type | Required | Default | Limits |
|---|---|---|---|---|
| `list_id` | `string` | yes |  | 1–100 chars |

### create_creator_list

Create an empty creator list (one platform per list). For a creator brief, create it first and keep it filled with the current best set (set_creator_list), so every run ends with a list.

Kind: write

| Parameter | Type | Required | Default | Limits |
|---|---|---|---|---|
| `name` | `string` | yes |  | 1–255 chars |
| `platform` | `"instagram" \| "youtube" \| "tiktok"` | no | "instagram" |  |
| `description` | `string` | no |  | ≤ 2000 chars |
| `workspace_id` | `string` | no |  | 1–100 chars |

### add_to_creator_list

Add creators (handles on the list's platform) to a list. Re-adding is a no-op.

Kind: write

| Parameter | Type | Required | Default | Limits |
|---|---|---|---|---|
| `list_id` | `string` | yes |  | 1–100 chars |
| `usernames` | `string[]` | yes |  | 1–100 items |

### set_creator_list

Make a list hold exactly these creators: adds the missing, removes the rest, and optionally sets the description (e.g. the set's core % and core reach).

Kind: write

| Parameter | Type | Required | Default | Limits |
|---|---|---|---|---|
| `list_id` | `string` | yes |  | 1–100 chars |
| `usernames` | `string[]` | yes |  | 1–100 items |
| `description` | `string` | no |  | ≤ 2000 chars |

### share_creator_list

PUBLIC link to a creator list: anyone with the URL can view it, live. Only share when the user asked to. Returns the list's existing active link if there is one. Revoke with revoke_share_link(list_id=...).

Kind: asks before running

| Parameter | Type | Required | Default | Limits |
|---|---|---|---|---|
| `list_id` | `string` | yes |  | 1–100 chars |

### revoke_share_link

Turn off a public link: link_id from share_analysis (one analysis link), or list_id to revoke every public link of that creator list. Anyone holding the URL loses access.

Kind: asks before running

| Parameter | Type | Required | Default | Limits |
|---|---|---|---|---|
| `link_id` | `string` | no |  | 1–100 chars |
| `list_id` | `string` | no |  | 1–100 chars |