List the LinkedIn Ads campaigns of a connected account
ads_visualizer.linkedin_ads.campaigns.list
LeituraIdempotenteDesde 2026-11-01
Lists the campaigns of a LinkedIn Ads account connected to the organization: account_id is the ad account id from ads_visualizer.accounts.list (digits, or its urn:li:sponsoredAccount URN). Only enabled and paused campaigns exist here (removed, archived or deleted ones never come); filter with status (enabled, paused, all by default) and search (part of the name or the exact id). Each campaign has id, name, status, state (the Delivery column of the ads managers: active, paused, finished or scheduled), start_at/end_at (its run schedule, epoch ms; end_at null = no end date) and delivery_state, derived from those dates when the request runs. LinkedIn has no ad groups: the creatives hang from the campaign (ads_visualizer.linkedin_ads.ads.list). It does not return metrics: use ads_visualizer.linkedin_ads.metrics.get or ads_visualizer.linkedin_ads.delivery.get. Sorted by name. Paginated by cursor (limit up to 200; follow next_cursor while has_more is true). Read live from LinkedIn Ads (the same data as the Ads Visualizer screen, cached for 5 minutes): it can take a few seconds and counts one unit of the organization's external quota for LinkedIn Ads. Requires view access to the Ads Visualizer. Errors: 404 external_account_not_linked (the account is not connected to this organization); 409 integration_not_connected, integration_reconnect_required (reconnect it in Settings → Integrations; details.reason says why) or external_rejected (details.provider_code and details.provider_message have the platform's own code and words); 429 external_rate_limited and 503 external_unavailable (retry after Retry-After). Through the API and the MCP it depends on the terms of LinkedIn: where they do not allow it, it answers 403 platform_terms_restricted (the permissions guide lists what each platform allows).
Instruções para agentes
Report state as the campaign's status: an enabled campaign past its end date reads finished, and paused wins over everything.
Escopo
ads_visualizer:read
Permissão
Ver o módulo
Tool do MCP
ads_visualizer_linkedin_ads_campaigns_listNa superfície completa; na compacta, mb_execute_operation com id: "ads_visualizer.linkedin_ads.campaigns.list".
Custo declarado: até 4 leituras e 0 escritas por chamada (contam na cota diária). Usa uma plataforma externa (linkedin): conta na cota de operações externas.
Parâmetros
account_idstringrotaobrigatório
The LinkedIn Ads account: the LinkedIn ad account id (digits, or its urn:li:sponsoredAccount URN). It must be connected to the organization (ads_visualizer.accounts.list).
statusenumqueryopcional
enabled (or active, the same), paused or all (both; the default). Removed, archived and deleted items never come.
Valores: all, enabled, paused, active · Padrão: "all"
searchstringqueryopcional
Part of the name (case-insensitive) or the exact id.
limitintegerqueryopcional
Page size, 1 to 200 (default 50).
Padrão: 50
cursorstringqueryopcional
next_cursor of the previous page, with the same filters.
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.
Returns how a LinkedIn Ads campaign of an account connected to the organization is set up (cached for 5 minutes): type (SPONSORED_UPDATES, TEXT_AD…), cost_type (CPC, CPM), format and objective_type. campaign_id is the id from ads_visualizer.linkedin_ads.campaigns.list, and it must be a campaign of that account (LinkedIn answers with its own error otherwise). It does not return metrics or budget pacing: use dashboards.data.query or ads_visualizer.linkedin_ads.metrics.get. account_id is the ad account id from ads_visualizer.accounts.list (digits, or its urn:li:sponsoredAccount URN). Read live from LinkedIn Ads (the same data as the Ads Visualizer screen, cached for 5 minutes): it can take a few seconds and counts one unit of the organization's external quota for LinkedIn Ads. Requires view access to the Ads Visualizer. Errors: 404 external_account_not_linked (the account is not connected to this organization); 409 integration_not_connected, integration_reconnect_required (reconnect it in Settings → Integrations; details.reason says why) or external_rejected (details.provider_code and details.provider_message have the platform's own code and words); 429 external_rate_limited and 503 external_unavailable (retry after Retry-After). Through the API and the MCP it depends on the terms of LinkedIn: where they do not allow it, it answers 403 platform_terms_restricted (the permissions guide lists what each platform allows).
Escopo
ads_visualizer:read
Permissão
Ver o módulo
Tool do MCP
ads_visualizer_linkedin_ads_campaigns_getNa superfície completa; na compacta, mb_execute_operation com id: "ads_visualizer.linkedin_ads.campaigns.get".
Custo declarado: até 4 leituras e 0 escritas por chamada (contam na cota diária). Usa uma plataforma externa (linkedin): conta na cota de operações externas.
Parâmetros
account_idstringrotaobrigatório
The ad account, as ads_visualizer.accounts.list gives it (it must be connected to the organization).
campaign_idstringrotaobrigatório
The campaign (id from the campaigns.list operation of the same platform).
enabled, paused, archived, removed or draft, the vocabulary of the lists (another platform state comes in lowercase); platform_status has the platform's own value.
platform_statusstring
The status as the platform names it (ENABLED, CAMPAIGN_STATUS_DISABLE…).
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.
Lists the creatives of one campaign of a LinkedIn Ads account connected to the organization (LinkedIn has no ad groups: campaign_id from ads_visualizer.linkedin_ads.campaigns.list; each creative's ad_group_id is its campaign). preview (kind linkedin) carries ad_type (SPONSORED_CONTENT, MESSAGE_AD, CONVERSATION_AD, TEXT_AD, SPOTLIGHT_AD, FOLLOWER_AD), headline, body, image_url, is_video and video_url, cta_type, destination_url, company_name and company_logo_url and, for message and conversation ads, sender_name, sender_photo_url, subject and cta_options. At most 100 creatives per campaign; filter with status and search; sorted by name. account_id: the ad account id from ads_visualizer.accounts.list (digits, or its urn:li:sponsoredAccount URN). Paginated by cursor (limit up to 200; follow next_cursor while has_more is true). Read live from LinkedIn Ads (the same data as the Ads Visualizer screen, cached for 5 minutes): it can take a few seconds and counts one unit of the organization's external quota for LinkedIn Ads. Requires view access to the Ads Visualizer. Errors: 404 external_account_not_linked (the account is not connected to this organization); 409 integration_not_connected, integration_reconnect_required (reconnect it in Settings → Integrations; details.reason says why) or external_rejected (details.provider_code and details.provider_message have the platform's own code and words); 429 external_rate_limited and 503 external_unavailable (retry after Retry-After). Through the API and the MCP it depends on the terms of LinkedIn: where they do not allow it, it answers 403 platform_terms_restricted (the permissions guide lists what each platform allows).
Escopo
ads_visualizer:read
Permissão
Ver o módulo
Tool do MCP
ads_visualizer_linkedin_ads_ads_listNa superfície completa; na compacta, mb_execute_operation com id: "ads_visualizer.linkedin_ads.ads.list".
Custo declarado: até 4 leituras e 0 escritas por chamada (contam na cota diária). Usa uma plataforma externa (linkedin): conta na cota de operações externas.
Parâmetros
account_idstringrotaobrigatório
The LinkedIn Ads account: the LinkedIn ad account id (digits, or its urn:li:sponsoredAccount URN). It must be connected to the organization (ads_visualizer.accounts.list).
campaign_idstringrotaobrigatório
The campaign (id from ads_visualizer.linkedin_ads.campaigns.list).
statusenumqueryopcional
enabled (or active, the same), paused or all (both; the default). Removed, archived and deleted items never come.
Valores: all, enabled, paused, active · Padrão: "all"
searchstringqueryopcional
Part of the name (case-insensitive) or the exact id.
limitintegerqueryopcional
Page size, 1 to 200 (default 50).
Padrão: 50
cursorstringqueryopcional
next_cursor of the previous page, with the same filters.
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.
Get the performance of each creative of a LinkedIn Ads campaign
ads_visualizer.linkedin_ads.metrics.get
LeituraIdempotenteDesde 2026-11-01
Returns the performance of each creative of one campaign of a LinkedIn Ads account connected to the organization: impressions, clicks, ctr (in %), cost, cpc and cpm (in the account's currency, returned in currency), conversions (website conversions), cost_per_conversion, conversion_rate, leads (Lead Gen form submissions), cost_per_lead and social_actions (likes + comments + shares). The campaign must be an active or paused campaign of that account (404 ad_campaign_not_found otherwise): LinkedIn reports by campaign, so MB Suite first confirms the campaign belongs to the account. Sorted by cost, highest first. Range: start_date and end_date (YYYY-MM-DD, together, at most 400 days) or period 7d, 14d or 30d (default 30d), complete days ending yesterday in the organization's reporting time zone; the response has the exact dates. Ads without impressions in the range are left out (an empty data means it did not deliver). account_id: the ad account id from ads_visualizer.accounts.list (digits, or its urn:li:sponsoredAccount URN). Read live from LinkedIn Ads (the same data as the Ads Visualizer screen, cached for 5 minutes): it can take a few seconds and counts two units (the campaign check and the report) of the organization's external quota for LinkedIn Ads. Requires view access to the Ads Visualizer. Errors: 404 external_account_not_linked (the account is not connected to this organization); 409 integration_not_connected, integration_reconnect_required (reconnect it in Settings → Integrations; details.reason says why) or external_rejected (details.provider_code and details.provider_message have the platform's own code and words); 429 external_rate_limited and 503 external_unavailable (retry after Retry-After). Through the API and the MCP it depends on the terms of LinkedIn: where they do not allow it, it answers 403 platform_terms_restricted (the permissions guide lists what each platform allows).
Instruções para agentes
Costs are in the account's currency (the currency field): name it. An ad missing from data had no impressions in the range.
Escopo
ads_visualizer:read
Permissão
Ver o módulo
Tool do MCP
ads_visualizer_linkedin_ads_metrics_getNa superfície completa; na compacta, mb_execute_operation com id: "ads_visualizer.linkedin_ads.metrics.get".
Custo declarado: até 4 leituras e 0 escritas por chamada (contam na cota diária). Usa uma plataforma externa (linkedin): conta na cota de operações externas.
Parâmetros
account_idstringrotaobrigatório
The LinkedIn Ads account: the LinkedIn ad account id (digits, or its urn:li:sponsoredAccount URN). It must be connected to the organization (ads_visualizer.accounts.list).
campaign_idstringrotaobrigatório
The campaign (id from ads_visualizer.linkedin_ads.campaigns.list).
periodenumqueryopcional
7d, 14d or 30d (default): that many complete days ending yesterday. Ignored when start_date and end_date come.
Valores: 7d, 14d, 30d · Padrão: "30d"
start_datestringqueryopcional
First day of the range (YYYY-MM-DD, in the account's time zone). Send it with end_date.
end_datestringqueryopcional
Last day of the range (YYYY-MM-DD, included). At most 400 days after start_date.
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.
Get the impressions of the last 7 days of each LinkedIn Ads campaign
ads_visualizer.linkedin_ads.delivery.get
LeituraIdempotenteDesde 2026-11-01
Returns the impressions of the last 7 days of each campaign of a LinkedIn Ads account connected to the organization that delivered in that window (campaigns with no impressions are left out), in one request: account_id is the ad account id from ads_visualizer.accounts.list (digits, or its urn:li:sponsoredAccount URN). It is the "only delivering" filter of the ads managers: a campaign can be enabled and within its dates and still not deliver (paused groups, no budget, rejected ads). The window is LinkedIn Ads's own last 7 days. Sorted by impressions, highest first. Read live from LinkedIn Ads (the same data as the Ads Visualizer screen, cached for 5 minutes): it can take a few seconds and counts one unit of the organization's external quota for LinkedIn Ads. Requires view access to the Ads Visualizer. Errors: 404 external_account_not_linked (the account is not connected to this organization); 409 integration_not_connected, integration_reconnect_required (reconnect it in Settings → Integrations; details.reason says why) or external_rejected (details.provider_code and details.provider_message have the platform's own code and words); 429 external_rate_limited and 503 external_unavailable (retry after Retry-After). Through the API and the MCP it depends on the terms of LinkedIn: where they do not allow it, it answers 403 platform_terms_restricted (the permissions guide lists what each platform allows).
Escopo
ads_visualizer:read
Permissão
Ver o módulo
Tool do MCP
ads_visualizer_linkedin_ads_delivery_getNa superfície completa; na compacta, mb_execute_operation com id: "ads_visualizer.linkedin_ads.delivery.get".
Custo declarado: até 4 leituras e 0 escritas por chamada (contam na cota diária). Usa uma plataforma externa (linkedin): conta na cota de operações externas.
Parâmetros
account_idstringrotaobrigatório
The LinkedIn Ads account: the LinkedIn ad account id (digits, or its urn:li:sponsoredAccount URN). It must be connected to the organization (ads_visualizer.accounts.list).
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.
