Sign in

v2

latestOpenAPI 3.1.02026-08-075421692.0 MB
Ad Targeting

Impressions, clicks and spend forecast

LinkedIn-only. Forecasted impressions, clicks, spend and ~20 other metrics for a targeting spec over a time range. Wraps LinkedIn's adSupplyForecasts finder.

Each returned series carries a metricType (IMPRESSION, CLICK, SPENDING, MAX_POTENTIAL_BUDGET, COST_PER_MILLION_IMPRESSIONS, ...) and a granularity (DAILY, SEVEN_DAY, THIRTY_DAY, CUSTOM). LinkedIn caps the daily spending forecast at 1.2x the daily budget and returns 0 once the total budget is exhausted.

Non-LinkedIn accounts return available: false.

post/v1/ads/targeting/supply-forecast

Request body

accountIdstring required
adAccountIdstring required
campaignType'SPONSORED_UPDATES' | 'SPONSORED_INMAILS' | 'DYNAMIC'

Defaults to SPONSORED_UPDATES.

timeRangeStartinteger required

Unix ms. Must be in the future.

timeRangeEndinteger required

Unix ms. Must be after start and within LinkedIn's max horizon.

objectiveTypestring
optimizationTargetstring

When set, the forecast assumes auto-bidding. When unset, competingBid is required.

dailyBudgetnumber

Either dailyBudget or totalBudget is required.

totalBudgetnumber
currencystring

ISO 4217, defaults to USD.

enableAudienceNetworkboolean

Defaults to false. Required true for connectedTelevisionOnly.

enableAudienceExpansionboolean

Defaults to false.

connectedTelevisionOnlyboolean

Defaults to false.

Response

Forecast series

availableboolean required