Company Intelligence - Overview

Warning

Deprecation Notice: The Marketing Version 202510 (Marketing October 2025) will be sunset on October 15, 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.

The Company Intelligence API delivers company (target account)-level data for all companies engaged through LinkedIn. It provides metrics such as engagement score, paid impressions, paid clicks, leads, organic impressions, and organic engagements.

Use Cases

  • CRM Outcome Reporting: Report on LinkedIn’s specific influence on company engagement and CRM outcomes (e.g., number of MQLs, pipeline value, revenue won) via an approach that does not blend data across channels—and either offers a LinkedIn-only view, or LinkedIn and other channels side by side.

  • Cross-Channel Attribution: Customers increasingly need to measure the influence of multiple channels in driving pipeline and revenue outcomes in a centralized source of truth. This API unlocks the ability for customers to ingest valuable data points into their cross-channel attribution tools by reporting on LinkedIn’s specific influence on company engagement and CRM outcomes (e.g., number of MQLs, pipeline value, revenue won) via an approach that blends data across channel engagements.

  • Bridge Partners: Third-party services that assist in transferring Company Intelligence API data to large advertisers who wish to run their attribution modeling in-house without building direct integrations themselves.

  • In-House Advertisers: Large organizations (e.g., Amazon) that prefer to conduct attribution and analytics internally using their own teams instead of relying on third-party platforms.

Access

Note

We are not currently accepting new applications for the Company Intelligence API. This is a private API available only to previously approved developers, so there are currently no other workarounds for access. Use the Ad Analytics API for your reporting needs. We will update our recent changes documentation when we are ready to accept new applications.

Note

Applications must be authorized and authenticated before they can fetch data from LinkedIn or get access to LinkedIn member data. To learn more about the OAuth flows, see Authentication.

Postman Collection

Try in Postman

Versioning

LinkedIn's Marketing API Program supports versioning so API partners can release changes over time. For more information on how to use versioned APIs, see Versioning.

Frequently Asked Questions

  1. How do I generate a token for the Company Intelligence API?

    The Company Intelligence API requires a 3-legged OAuth member token, and your developer application must be provisioned with the Advertising API and Company Intelligence API. Once approved, the authenticated member must have consented to the r_ads_reporting permission of the Advertising API product for your developer app. If the member has already consented through an existing integration (for example, Ad Analytics API), you can use their existing member access token and do not need to require re-authentication.

  2. Who is eligible to access the Company Intelligence API?

    B2B marketing technology companies that support attribution and reporting solutions—enabling marketers to have a better understanding of company-level engagement and investment delivery against valuable audiences and objectives.

    Review the eligibility criteria and the following qualifications. The Company Intelligence API is a private API, and we are not currently accepting new applications (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're 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.
    • Demonstrate your data management practices, where applicable.
    • Demonstrate engineering readiness and the ability to complete integration with the Company Intelligence API in a reasonable time frame.
    • You're able to dedicate go-to-market resources to launch your solution to customers.

    We will update our recent changes documentation when we are ready to accept new applications.

  3. What permissions are required?

    The authenticated member must have consented to the r_ads_reporting permission. No additional permission scope is needed beyond what is already granted through an existing Advertising API integration. For more details, see Increasing Access.

  4. What ad account roles are required?

    The authenticated member must have a valid user role of VIEWER or above on the requested ad account. For more information, see Ad Account Roles.

  5. What lookback windows are supported?

    The API supports the following lookback windows: LAST_7_DAYS, LAST_30_DAYS, LAST_60_DAYS, and LAST_90_DAYS. If no lookback window is specified, a default of 90 days is applied. For more information, see Company Intelligence API.

  6. Are organic metrics available?

    Yes. The API returns both paid metrics (impressions, clicks, engagements, leads) and organic metrics (impressions, engagements) at the company level. Note that organic metrics will be 0 when a campaign filter is applied.

  7. How are engagement levels calculated?

    The engagementLevel field is calculated based on the number of paid and organic member engagements, normalized over the selected time range. Possible values are VERY_LOW, LOW, MEDIUM, HIGH, and VERY_HIGH.

  8. Are there privacy thresholds applied to the metrics?

    Yes. All impression, engagement, and click metrics must meet specific number thresholds to protect member privacy. If that threshold isn't met, you'll see a 0 value for those metrics in the response.

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 learn 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 support ticket.
  • Last updated on