Get today's monitoring snapshot of an account
monitors.cross_account.get
The workspace's daily check of one of its accounts: for every platform connected to the account (Google Ads, Meta Ads, GA4, Search Console, Business Profile, TikTok, LinkedIn, Facebook, Instagram, YouTube), its key metrics by day (the last 7 days), week (Search Console) and month (the last 6), with the totals of each period, plus the pacing of the account's active media plans. Each platform brings its metric definitions once (id, label, type, higher_is_better) and each period its rows and totals, keyed by metric id (numbers with 6 significant digits); platform_account_id is the account's id on the platform. Optional filters platforms and granularity trim the answer (the snapshot is read whole anyway). Live read: the first call of the day for an account reads every connected platform (one request per period) and stores the snapshot for the day; later calls are served from that snapshot (from_cache) and only retry the platforms that had failed. A platform or period that failed carries its error and no rows. Call it on the workspace with the account id (one it reaches: platform.orgs.list; any other is 404 account_not_found). It counts against the organization's Google Ads external quota (the scarcest provider quota): one unit per call, or one per Google Ads request made live. Requires view access to Monitors. With Google Ads, Google Business Profile, LinkedIn, TikTok or YouTube, their terms limit it through the API and the MCP: what they do not allow answers 403 platform_terms_restricted, and their records are left out of the response (the permissions guide lists what each platform allows).
- Escopo
monitors:read- Permissão
- Ver o módulo
- Tool do MCP
monitors_cross_account_getNa superfície completa; na compacta,mb_execute_operationcomid: "monitors.cross_account.get".
Custo declarado: até 80 leituras e 1 escritas por chamada (contam na cota diária). Usa uma plataforma externa (google_ads): conta na cota de operações externas.
Parâmetros
account_idstringrotaThe account (a child organization of the workspace) to check: an id from platform.orgs.list.
platformsarray<enum>queryopcionalOnly these platforms (platform_id values), in the answer and in pacing. Without it, every platform connected to the account. It trims the answer, not the read: the day's snapshot always covers every connected platform.
Valores: google_analytics, google_ads, meta_ads, tiktok_ads, tiktok, instagram, facebook_page, youtube, google_search_console, google_business_profile, linkedin_ads, linkedin_page
granularityenumqueryopcionalOnly the periods of this granularity: daily (the last 7 days, up to yesterday), weekly (the last 8 weeks, from Monday; Search Console has only this one) or monthly (the last 6 months, YYYY-MM). Without it, every period of each platform.
Valores: daily, weekly, monthly
Resposta
account_idstringThe account.
account_namestringIts name.
account_logostring | nullIts logo (an https URL that opens without a session), or null.
fetched_atnumberWhen the platforms were read (epoch ms).
from_cachebooleanServed from the day's snapshot (only the platforms that had failed were tried again).
platformsarray<object>One entry per connected account of each platform.
pacingarray<object>The pacing of the account's active media plans, by platform.
Erros
Exemplo
curl "https://api.mb-suite.com/v1/monitors/cross-account/{account_id}" \
-H "Authorization: Bearer $MB_API_KEY"Testar com a sua API key de teste
Com uma API key de teste o pedido vai sempre para a sua organização de prática: dados de exemplo que você pode reiniciar. Na prática esta operação não é simulada (usa outra plataforma): responde 409 sandbox_external_unavailable.