Creator lists

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

list_creator_listsread-only

The workspace's creator lists (shortlists).

Parameter	Type	Default	Limits
`workspace_id`	`string`		1–100 chars

get_creator_list

get_creator_listread-only

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

Parameter	Type	Default	Limits
`list_id`required	`string`		1–100 chars

create_creator_list

create_creator_listwrite

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.

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

add_to_creator_list

add_to_creator_listwrite

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

Parameter	Type	Default	Limits
`list_id`required	`string`		1–100 chars
`usernames`required	`string[]`		1–100 items

set_creator_list

set_creator_listwrite

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).

Parameter	Type	Limits
`list_id`required	`string`	1–100 chars
`usernames`required	`string[]`	1–100 items
`description`	`string`	≤ 2000 chars

share_creator_list

share_creator_listasks before running

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=...).

Parameter	Type	Default	Limits
`list_id`required	`string`		1–100 chars

revoke_share_link

revoke_share_linkasks before running

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.

Parameter	Type	Default	Limits
`link_id`	`string`		1–100 chars
`list_id`	`string`		1–100 chars