Media Planning - Overview
Media Planning API helps media planners to maximize their return on ad spend before making decisions on the advertising platform by forecasting the reach, impression (and more in future, like leads, clicks) curve over the budget, based on inputs provided like targeted audience, campaign start/end date and more. It allows them to make budget allocation recommendations with confidence and know how to improve the results—even before spending the first dollar.
Media Planning API Product has one API /mediaPlanning
with ACTION method see here that you can use for forecasting reach, impressions and leads by specifying action=forecastReaches
and action=forecastImpressions
respectively.
There are 2 main use cases for Media Planning APIs:
- Cross-Channel Planning. Use common attributes like age and gender to plan across channels.
- Deeper B2B focused planning. Where LinkedIn has been identified as an interest and the API can be used to fine tune the planning.
Apply for Access
API product | Availability | How to Request |
---|---|---|
Media Planning | Available to qualified developers who meet additional criteria for access. | Submit a request through Developer Support. Note: You must also have access to the Advertising API to access the Media Planning API. |
Note
Applications must be authorized and authenticated before they can fetch data from LinkedIn or get access to LinkedIn member data. To know more about the OAuth flows, see here.
Postman Collection
Frequently Asked Questions
How to generate a token for Media Planning API use?
Media Planning API requires a 3-legged OAuth member token, and your developer application needs to be provisioned with the Media Planning API product. Once you have been approved to access, you can use any valid member access token associated with the authenticated user with any valid scope permissions for member authentication. If there is no valid member token for the relevant user from any previous integration, we recommend using the bare minimum scope permissions like
r_ads
which will be required to fetch authenticated user's ad accounts. This API is application-specific; hence, explicit member consent is not required. Any valid member access token associated with the authenticated user can be used, and you do not need to add any additional permission in the scope of your OAuth2 flow for authorization.Who’s eligible to access the Media Planning API:
B2B marketing technology companies that enable marketers to have a better understanding of investment delivery against valuable audiences and objectives.
You are encouraged to apply if you meet the eligibility criteria and the following qualifications (although access remains subject to LinkedIn’s approval and any other program requirements):
- You have a B2B marketing company with an established use case for the API.
- You have access to LinkedIn Advertising APIs. If you are new to our APIs, get started by applying for Advertising API access.
- You agree to comply with the LinkedIn Marketing API Program Terms of Use.
- You can demonstrate your data management practices, where applicable.
- You can demonstrate Engineering readiness and the ability to complete integration with Media Planning API in a reasonable time frame.
- You are able to dedicate go-to-market resources to launch your solution to customers.
- You plan to join the LinkedIn Marketing Partner Program by completing the certification.
Once you’ve submitted a Zendesk ticket, you will receive an application survey in response. Complete the survey to the best of your ability. You will receive a response from the LinkedIn team with the status of your application.
Why is the input budget defined in micros?
To give the developers precision flexibility. 1000000 micros = 1USD.
What are the supported currencies as input to the API?
Only USD currently, defaults to USD if not provided explicitly as input. The conversion to other currency types must be handled on the client side.
Stay Informed and Get Support
These resources can help you stay on top of new features, migrations, and deprecations:
- Check out the Recent Changes page to see the latest API releases.
- Check out the Developer Portal to know more about our API products.
- Use the Migrations page to stay on top of breaking changes.
- Need help? Reach out to Developer Support by submitting a Zendesk ticket.