Get Audience

What it does

Takes an audience id and returns the full shape of that audience. You get its metadata and every column definition: name, data type, source, and whether each column is filterable, sortable, editable, or exportable. You can also pull an optional preview of the rows.

Row preview is off by default. Turn it on to see up to 25 rows, with 5 returned unless you ask for more, and scope the preview to specific columns when an audience is wide. Each previewed cell reports a processing state, so you can tell a populated value from one that is still enriching or came back empty.

The audience id comes from Browse Audiences. The model uses that id verbatim rather than guessing one.

Credits

Free. Get Audience is read-only and consumes no credits.

When the AI uses it

The AI invokes Get Audience after Browse Audiences, once it knows which audience you mean. It reads the column schema to understand how the audience is built, then previews a handful of rows to see the real data before planning anything downstream. Inspecting first leads to better-grounded next steps.

What's returned

• Audience metadata: name, type, origin, record count, folder.
• Column definitions: id, name, data type, source, and properties.
• An optional row preview with each cell's value and state.

Cell states tell you where each value stands. A RESULT cell holds valid data. A BLANK cell was never populated. The rest cover enrichment: LOADING is still running, NO_RESULT ran and found nothing, and ERROR failed for that cell. When several cells read LOADING or ERROR, the audience is still processing, and the model should say so rather than treat partial data as final.

Example prompts

"What columns are in my Dreamforce audience?"

"Show me a few rows from that audience."

"Preview the email and title columns for my SaaStr list."