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).
- Alcance
monitors:read- Permiso
- Ver el módulo
- Tool del MCP
monitors_cross_account_getEn la superficie completa; en la compacta,mb_execute_operationconid: "monitors.cross_account.get".
Costo declarado: hasta 80 lecturas y 1 escrituras por llamada (cuentan en el cupo diario). Toca una plataforma externa (google_ads): cuenta en el cupo de operaciones externas.
Parámetros
account_idstringrutaThe 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
Respuesta
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.
Errores
Ejemplo
curl "https://api.mb-suite.com/v1/monitors/cross-account/{account_id}" \
-H "Authorization: Bearer $MB_API_KEY"Probar con tu API key de prueba
Con una API key de prueba el pedido va siempre a tu organización de práctica: datos de ejemplo que puedes reiniciar. En la práctica esta operación no se simula (toca otra plataforma): responde 409 sandbox_external_unavailable.