Costos · Media Planner · Referencia de la API

GET/v1/media-planner/plans/{plan_id}/costs/breakdown

Get the per-campaign spend breakdown of a plan

media_planner.costs.breakdown

LecturaIdempotenteDesde 2026-11-01

Returns the spend breakdown that the last cost sync of a platforms-mode or account-mode plan stored: per platform, its currency and the real campaigns of the connected accounts with their spend (sorted by spend, up to 100 per platform; truncated says how many more and their spend), with the status when the platform returns it (Google Ads). null if the plan was never synced in those modes (campaigns-mode plans have no breakdown: each row is already a campaign). It does not call any platform. Requires view access to the Media Planner. With Google Ads, LinkedIn or TikTok, their terms limit it through the API and the MCP: what they do not allow answers 403 platform_terms_restricted, and their fields are left out of the response (the permissions guide lists what each platform allows).

Alcance: media_planner:read
Permiso: Ver el módulo
Tool del MCP: media_planner_costs_breakdownEn la superficie completa; en la compacta, mb_execute_operation con id: "media_planner.costs.breakdown".

Costo declarado: hasta 2 lecturas y 0 escrituras por llamada (cuentan en el cupo diario).

Parámetros

plan_idstringrutarequerido

Media plan id (from media_planner.plans.list).

Respuesta

breakdownobject | null

null until the plan's costs are synced.

Errores

media_plan_not_found invalid_input unknown_field authentication_required scope_insufficient module_access_denied operation_not_found rate_limited quota_exceeded

Ejemplo

curl "https://api.mb-suite.com/v1/media-planner/plans/{plan_id}/costs/breakdown" \
  -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.

curl "https://api.mb-suite.com/v1/media-planner/plans/{plan_id}/costs/breakdown" \
  -H "Authorization: Bearer $MB_TEST_KEY"