Custos

Get the per-campaign spend breakdown of a plan

media_planner.costs.breakdown

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

Escopo

media_planner:read

Permissão

Ver o módulo

Tool do MCP

media_planner_costs_breakdownNa superfície completa; na compacta, mb_execute_operation com id: "media_planner.costs.breakdown".

Custo declarado: até 2 leituras e 0 escritas por chamada (contam na cota diária).

Parâmetros

Resposta

Erros

Exemplo

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

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