Audience actions

1 actions. Every field marked Required must be sent; account, dryRun, idempotencyKey, confirmCredits and quoteId are the control fields every surface adds.

Audience dataset

audience.dataset · read

Collect a post’s repliers, quoters or reposters, or an X list’s members, as people you can filter, research and message.

• MCP tool: audience_dataset. Catalog: reach it with find_actions and run_read_action, or turn on the full toolset.
• REST: GET /v1/audience/dataset
• CLI: xholic audience dataset
• Scope: read
• Plan: Every plan, including the trial
• Cost: Live X lookup: no credits, counts toward the plan’s X data limits.
• Rate limit bucket: live_x

Input

Field	Type	Required	Description
source	“replies” \	“reposts” \	“list”
sourceId	string	Yes
usernames	array of string (max 100)	No
openDmsOnly	boolean	No	Default: false.
account	string ≤ 64 chars	No	X account to act on, as @handle. Leave it out to use the connection’s default account.