GTM.ai
Docs menu

Get Audience

Fetch one audience's column structure and an optional preview of its rows. Read-only and free.

Jagannath RameshJagannath RameshPrincipal Product Manager

Start building

100s of integrations

Overview

Look inside an audience before you act on it. Get Audience returns the full shape of one audience: every column and what type it holds. Turn on the row preview and you see the actual data too. Inspecting first means downstream work is grounded in what the audience really contains.

What You'll Get

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

Best For

  • Checking an audience's columns before building on it
  • Seeing which columns hold values before exporting
  • Spot-checking real values rather than trusting a record count
  • Understanding how an audience someone else built is structured

You need an audience id to call this. Get one from Browse Audiences.

How It Works

Row preview is off by default. Turn it on to see up to 25 rows, with 5 returned unless you ask for more. Scope the preview to specific columns when an audience is wide.

Each previewed cell returns its column ID and value. An empty value can mean the cell is blank or still enriching, so the model should not treat a sparse preview as final. Open the audience in ZoomInfo to see enrichment status.

Technical Details

Credits

Free. Get Audience is read-only and consumes no credits. See Credits & Billing.

Requirements

The audience id comes from Browse Audiences, and the model uses it verbatim rather than guessing.

Automatic Tool Selection

The AI reaches for Get Audience after Browse Audiences, once it knows which audience you mean. It reads the column schema to learn how the audience is built, then previews a few rows to see real data before planning anything downstream. The rowId and columnId values it returns are what Manage Audience Rows and Manage Audience Columns need for updates. No ID gets guessed. For analytical questions over the whole audience, such as breakdowns, rankings, or fill rates, the AI uses Audience Analysis instead of previewing rows.

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

"Which columns in this audience have data so far?"