linkedin_ads_get_budget_pricing

Get LinkedIn Budget & Pricing

Linkedin

Description

Get bid ranges and daily budget limits for a LinkedIn campaign type and audience. Call this before creating a campaign to understand recommended bids. DYNAMIC campaign type is not supported by this endpoint.

Read-onlyOpen-world

Usage

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "linkedin_ads_get_budget_pricing",
    "arguments": {
      "account_id": "123456789",
      "campaign_type": "SPONSORED_UPDATES",
      "bid_type": "CPM",
      "match_type": "EXACT",
      "currency": "USD",
      "location_urns": [
        "urn:li:geo:103644278"
      ],
      "reason": "User wants to know bid ranges before creating a campaign"
    }
  }
}
hopkin linkedin budget-pricing get
FlagTypeRequiredDescription
--accountstringRequiredAd account ID (numeric, without URN prefix).
--campaign-typestringRequiredCampaign type. DYNAMIC is not supported by this endpoint.
--bid-typestringRequiredBid type. CPV is only valid for SPONSORED_UPDATES video campaigns.
--match-typestringRequired
--currencystringRequiredISO-4217 currency code (e.g. USD, GBP).
--location-urnsarrayRequiredTarget location URNs (e.g. urn:li:geo:103644278 for USA).
--seniority-urnsarrayOptionalTarget seniority URNs (e.g. urn:li:seniority:4 for Senior).
--job-function-urnsarrayOptionalTarget job function URNs.
--industry-urnsarrayOptionalTarget industry URNs.
--company-size-urnsarrayOptionalTarget company size range URNs (e.g. urn:li:staffCountRange:(51,200)).
--objective-typestringOptionalAffects suggested bid.
--daily-budget-amountnumberOptionalCurrent or target daily budget (influences suggested bid calculation).
{
  "mcpServers": {
    "linkedin-ads": {
      "url": "https://mcp.hopkin.ai/linkedin-ads/mcp",
      "transport": "sse"
    }
  }
}
  • Sponsored Content CPM
  • Text Ad CPC

Parameters

NameTypeRequiredDescription
account_id string Required Ad account ID (numeric, without URN prefix).minLength: 1
campaign_type string Required Campaign type. DYNAMIC is not supported by this endpoint.
TEXT_AD SPONSORED_UPDATES SPONSORED_INMAILS
bid_type string Required Bid type. CPV is only valid for SPONSORED_UPDATES video campaigns.
CPM CPC CPV
match_type string Required
EXACT AUDIENCE_EXPANDED
currency string Required ISO-4217 currency code (e.g. USD, GBP).minLength: 3, maxLength: 3
location_urns array Required Target location URNs (e.g. urn:li:geo:103644278 for USA).
reason string Required Why this tool call is neededminLength: 1, maxLength: 500
Optional parameters (6)
NameTypeRequiredDescription
seniority_urns array Optional Target seniority URNs (e.g. urn:li:seniority:4 for Senior).
job_function_urns array Optional Target job function URNs.
industry_urns array Optional Target industry URNs.
company_size_urns array Optional Target company size range URNs (e.g. urn:li:staffCountRange:(51,200)).
objective_type string Optional Affects suggested bid.
daily_budget_amount number Optional Current or target daily budget (influences suggested bid calculation).

Examples

Sponsored Content CPM

{
  "account_id": "123456789",
  "campaign_type": "SPONSORED_UPDATES",
  "bid_type": "CPM",
  "match_type": "EXACT",
  "currency": "USD",
  "location_urns": [
    "urn:li:geo:103644278"
  ],
  "reason": "User wants to know bid ranges before creating a campaign"
}

hopkin linkedin budget-pricing get --account 123456789 --campaign-type SPONSORED_UPDATES --bid-type CPM --match-type EXACT --currency USD --location-urns urn:li:geo:103644278

Text Ad CPC

{
  "account_id": "123456789",
  "campaign_type": "TEXT_AD",
  "bid_type": "CPC",
  "match_type": "BROAD",
  "currency": "USD",
  "location_urns": [
    "urn:li:geo:103644278"
  ],
  "reason": "Get text ad pricing for US audience"
}

hopkin linkedin budget-pricing get --account 123456789 --campaign-type TEXT_AD --bid-type CPC --match-type BROAD --currency USD --location-urns urn:li:geo:103644278