Marketing API FAQ
Warning
Deprecation Notice
The Marketing Version 202308 (Marketing August 2023) and earlier versions (excluding 202306 and 202307) have been sunset. Additionally, the unversioned APIs will be sunset soon. We recommend that you migrate to the versioned APIs as well as migrate to the new Content and Community Management APIs to avoid disruptions. See the Migration page for more details.
If you haven’t yet migrated and have questions, submit a request on the LinkedIn Developer Support Portal.
This section covers the most frequently asked questions about the Marketing Developer Platform.
General
Do I need to upgrade my app to Standard tier?
The Advertising API and Community Management API each have two access tiers (Development, Standard) with different access criteria. All applications start with Development tier.
- For the Advertising API, you do not need to upgrade to Standard tier unless you plan to build a campaign management solution for multiple ad accounts.
- For the Community Management API, you do need to upgrade to Standard tier within twelve months of receiving API access to move your application to live production phase and to remove API call restrictions. If you do not apply for Standard tier within twelve months, we will remove your API access due to inactivity.
Why do my results differ from those presented in LinkedIn Campaign Manager?
If you are using a demographic pivot, LinkedIn will approximate data in order to protect member privacy at the more granular levels. The demographic metrics will be within three units (impressions, clicks, or conversions) of actual results in almost all cases.
If a campaign is queried at the daily level, noise (+/- 3) will be added to each result per day. If a campaign is queried at the week level noise will be added in once per week. Additionally, a minimum 3 threshold exists for reporting metrics such impressions, clicks, conversions, spend.
Because metrics are approximate for privacy protection, you may observe inconsistencies when:
- Comparing similar time ranges, for example, reporting on results over seven days vs. eight days
- Comparing the sum of daily metrics to the full corresponding time period
- Comparing reporting levels, for example, adding campaign level data and comparing it to account level data.
To minimize the effect of privacy approximation, we recommend you select:
- A full time period instead of adding up daily metrics for that time period
- The highest reporting level you want to view, for example, select account level data instead of adding up campaign level data
Learn more about Ads Reporting accuracy and Demographics for Your Ads
What time granularity should I use for demographic reporting?
LinkedIn’s Campaign Manager demographics reports are the result of a single API call for the specified date range and reporting level (creative, campaign, account etc.), so we recommend following the same practice and use timegranularity=ALL
and avoid aggregating data (i.e. from creative to campaign or account), to ensure your data is consistent with LinkedIn’s native results.
Can I create a social feed display with your APIs?
No - displaying a company page feed on your website or any other digital channel off LinkedIn is not an approved use case.
Permissions
How do I get access to r_full_profile
?
r_full_profile
is a closed permission, and we are not accepting access requests currently. Learn more about Profile API permissions.
How do I get access to r_member_social
?
r_member_social
is a closed permission, and we are not accepting access requests this time due to resource constraints. Learn more about available Marketing APIs and permissions.
How do I get access to rw_dmp_segments
?
These permissions are private, and we are not accepting access requests. If you’d like to be added to the wait list, please submit a Zendesk ticket with the following:
- Brief overview of the use case you’re trying to enable
- Description of your customer base (e.g. % B2B, % B2C, Enterprise, SMB, region or industry focused)
- Total customer base (# of customers)
- Total managed ad spend (if applicable)
- Number of customers requesting this LinkedIn feature in your platform
How do I get access to r_marketing_leadgen_automation
?
r_marketing_leadgen_automation
is available in the Lead Sync API product which can directly be requested for access from the Developer Portal. Check the Getting Access to Lead Sync API for pre-requisites and application process.
How do I get access to r_ads_leadgen_automation
?
r_ads_leadgen_automation
permission was deprecated in July 2023. New developments should request access to r_marketing_leadgen_automation
.
How do I get access to rw_offlineConversions
?
rw_offlineConversions
permission was deprecated in October 2023. New developments should request access to rw_conversions
.
How do I get access to rw_conversions
?
rw_conversions
is available in the Conversions API product which can directly be requested for access from the Developer Portal. Check the Getting Access to Conversions API for pre-requisites and application process.
How do I get access to Audience Insights API
product?
This API product is currently private and requires additional approval. If you meet the eligibility criteria and qualifications and wish to apply for access, submit a Zendesk ticket.
Who’s eligible to access the Audience Insights API: B2B marketing technology companies that are audience focused and support audience discovery, planning, activation, or campaign creation partners, or data platforms that aggregate and analyse audience interests and behavior to provide insights for campaign strategy.
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 LinkedIn's Audience Insights API in a reasonable timeframe.
- 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.
How do I get access to Media Planning API
product?
This API product is currently private and requires additional approval. If you meet the eligibility criteria and qualifications and wish to apply for access, submit a Zendesk ticket.
Who’s eligible to access the Media Planning API: B2B marketing technology companies that enables 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 LinkedIn's Audience Insights API in a reasonable timeframe.
- 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.
Is 2-legged OAuth
available?
All LinkedIn Marketing API Program permissions are three-legged permissions. Two-legged auth is not available for marketing use cases.
Error Handling
What does a 200 response status code with empty response from the adAnalytics API indicate?
An empty response is returned if there is no activity to report or if you do not have read access to the requested data. Read more about Ad Analytics.
What does a 200 response status code with an empty response from the Shares or UGC API indicate?
An empty response is returned if there is no activity to report or if you do not have read access to the requested data. Read more about the Share API and User Generated Content API.
What does a 403 error mean when creating or updating an ad account?
This indicates a member’s access token doesn’t have the right scope permissions. Often, if your app is on Developer access tier, it may indicate the ad account has not been added to your app in Developer Portal. To add an Ad Account to your app, select your app in the Developer Portal, then choose Products > View Ad Accounts, or request an upgrade to Standard access tier. Learn more about 403 error responses.