Marketing API FAQ

This section covers the most frequently asked questions about the LinkedIn Marketing Developer Platform.

General

Do I need to upgrade my app to Standard tier?

All applications start with the Development Tier which provides read-only access for unlimited ad accounts, and edit capabilities for up to five (5) Ad Accounts. Standard tier access is meant for solutions that support campaign management for multiple accounts and is not required for campaign reporting.

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 r_dmp_segments or r_ads_leadgen_automation?

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:

  1. Brief overview of the use case you’re trying to enable
  2. Description of your customer base (e.g. % B2B, % B2C, Enterprise, SMB, region or industry focused)
  3. Total customer base (# of customers)
  4. Total managed ad spend (if applicable)
  5. Number of customers requesting this LinkedIn feature in your platform

Is 2-legged OAuth available?

All Marketing Developer Platform permissions are three-legged permissions. Two-legged auth is not available for marketing use cases.

Error Handling

What does a 200 error or 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 error or 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 permissions. Often, 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. Learn more about 403 error responses.