Integration Requirements for Audience Insights

Warning

Deprecation Notice: The Marketing Version 202508 (Marketing August 2025) will be sunset on August 17, 2026. We recommend that you migrate to the latest versioned APIs to avoid disruptions. For information on all the supported versions, refer to the migrations documentation. If you haven’t yet migrated and have questions, submit a request on the LinkedIn Developer Support Portal.

LinkedIn is in the process of rolling out a Technical Sign Off process for the Audience Insights program. This ensures that our members get the best experience whether using LinkedIn's native UI or a partner product. The technical review and sign off also ensures that there are no gaps in integrations and that partner products keep up with the latest features and updates released by LinkedIn.

As an API partner, please go through the requirements listed below. These are the capabilities that an integrating partner is expected to build in their product. We request you to plan and incorporate these features early in your design. When you're nearing completion, you must initiate a Technical Sign Off request by contacting your LinkedIn POC on the Business Development team.

A demo will be scheduled during which you'll be asked to showcase all your product capabilities. During this evaluation, LinkedIn can suggest modifications which should be completed for the sign off. If all criteria are met (as per the envisioned scope), the technical sign-off is awarded.

Requirements

Rule	API capabilities to be demonstrated in Demo
	Basics
AI-001	Demonstrate OAuth 2.0 integration with minimum permission scopes and consent screen.
AI-002	Demonstrate ability to periodically verify that an access token is valid (heartbeat /me) and detect access token expiry.
AI-003	Demonstrate ability to detect access token expiry and ability to use refresh tokens to renew access tokens to extend beyond their expiry.
AI-004	Demonstrate ability to detect refresh token expiry and re-trigger OAuth Flow.
AI-005	Demonstrate ability to have consistent OAuth 2.0 scope permissions to avoid token conflicts.
	Audience Insights
AI-101	Demonstrate ability to retrieve all Sponsored Ad Accounts (id, name, status) for the logged in user.
AI-102	Demonstrate the ability to allow users to select one of the fetched ad accounts and the selected ad account should be then passed to subsequent API requests metadata.
AI-103	Demonstrate ability to input combination of at least five audience attributes as ad targeting facets, for example: industries, job functions, titles, skills, interests etc.
AI-104	Demonstrate ability that you require to input one or more geo location urn and throw validation error if no geo location selected.
AI-105	Demonstrate ability to allow AND and OR operations between different attributes (ad facets).
AI-106	Demonstrate ability to select one of the available facets as the segment to group the insights by that facet in the response.
AI-107	Demonstrate ability to return 5 or more entity segments in response with entity percentage/value of each segment and total audience count.
AI-108	Demonstrate ability to allow the user to select existing matched audience ad segments (company/contact lists) as input.
AI-109	Demonstrate ability to setup exclusion criteria along with inclusion targeting criteria.
AI-110	Demonstrate error handling and user input validation, especially when no insights are available due to low audience count (under 300 or over 100M); or low number of segments returned when segment count is under 30.
	Saved Audience Templates
AI-201	Demonstrate ability to save the ad targeting criteria (used to fetch insights) in a new template in the selected ad account and allow user to input its name and description.
AI-202	Demonstrate ability to read all available previously saved ad targeting templates in the selected ad account with name, desc and targeting criteria.
AI-203	Demonstrate ability to update the ad targeting criteria (used to fetch insights) in an existing template saved in the selected ad account with name, desc, targetingCriteria.
AI-204	Demonstrate that saved templates are ready for activation in campaigns.