Skip to content
AdCrunch
Esc
↑↓navigate↵open⌘Jpreview
On this page

list_advertisers

List the advertisers (ad accounts) in your organization, optionally filtered by provider.

Lists every advertiser connected to your organization. Use this first to find the advertiserIds you’ll pass to the other tools.

Input

Field Type Required Description
provider 'meta' | 'tiktok' | 'x' | 'snapchat' no Restrict to one provider.
status 'ACTIVE' | 'DISABLED' no Filter by sync status.

Output

An array of advertisers. Each entry has id (acc_*), provider, name, and status.

Example

“Show me my Meta advertisers.”

Claude calls list_advertisers({ provider: 'meta' }) and reads back the list with their AdCrunch IDs.

Errors

  • 401 or 403 — see Errors, which every tool shares. This one needs observe:read.

Was this page helpful?