Menu

Referência da API · Dashboards

Fontes de dados

dashboards · data_sources · 1 operação

GET/v1/dashboards/data-sources

List the data sources a dashboard can use

dashboards.data_sources.list

LeituraIdempotenteDesde 2026-11-01

Lists the data sources this organization can map into a dashboard: every connected ad account, analytics property, page or channel (own or inherited from the workspace) with the exact id to put in data_source_mapping or a reconnection (platform:id), its platform and display name, plus the internal CRM source. Optionally filter by platform (google_ads, meta_ads, google_analytics, tiktok…). Its ids and platforms are the dashboards' own; dashboards.data.sources (the reader of dashboards.data.query) names the same accounts by their bare id (act_…) and TikTok as tiktok_organic. Either form works as input on both sides: the platform filter here takes tiktok_organic, data_source_mapping and a reconnection take the bare account id, and dashboards.data.query takes these platform:id ids and tiktok. What each one returns does not change. Reads nothing from the platforms. 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
dashboards:read
Permissão
Ver o módulo
Tool do MCP
dashboards_data_sources_listNa superfície completa; na compacta, mb_execute_operation com id: "dashboards.data_sources.list".

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

Parâmetros

platformstringqueryopcional

Only this platform (google_ads, meta_ads, google_analytics, tiktok…). The platform ids of dashboards.data.sources work too (tiktok and tiktok_organic are the same platform).

Resposta

dataarray<object>

The sources, all of them (the list is not paginated).

Erros

Exemplo

curl "https://api.mb-suite.com/v1/dashboards/data-sources" \
  -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/dashboards/data-sources" \
  -H "Authorization: Bearer $MB_TEST_KEY"