### Account Intelligence: Filter by Last 365 Days Lookback Window Source: https://learn.microsoft.com/en-us/linkedin/marketing/account-intel/account-intel-api?view=li-lms-2026-01&tabs=http This example shows how to fetch account intelligence data using a 365-day lookback window. Ensure your request includes the necessary authentication and API version headers. ```http GET https://api.linkedin.com/rest/accountIntelligence?q=account&start=0&count=10&account=urn%3Ali%3AsponsoredAccount%3A123456789&filterCriteria=(lookbackWindow:LAST_365_DAYS) ``` ```curl curl -X GET 'https://api.linkedin.com/rest/accountIntelligence?q=account&start=0&count=10&account=urn%3Ali%3AsponsoredAccount%3A123456789&filterCriteria=(lookbackWindow:LAST_365_DAYS)' \ -H 'Authorization: Bearer {INSERT_TOKEN}' \ -H 'Linkedin-Version: {version number in the format YYYYMM}' \ -H 'Content-Type: application/json' \ -H 'X-Restli-Protocol-Version: 2.0.0' ``` -------------------------------- ### Account Intelligence Sample Response (with Video Views) Source: https://learn.microsoft.com/en-us/linkedin/marketing/account-intel/account-intel-api?view=li-lms-2026-01&tabs=http This snippet includes additional video view metrics (paidVideoViews) in the account intelligence response. The lookback window remains LAST_180_DAYS. ```json { "elements": [ { "companyPageUrl": "https://www.linkedin.com/company/microsoft", "companyWebsite": "http://www.microsoft.com", "paidClicks": 40, "organicEngagements": 100, "companyName": "Microsoft", "paidLeads": 80, "paidEngagements": 600, "paidImpressions": 266, "organicImpressions": 100, "engagementLevel": "VERY_LOW", "paidQualifiedLeads": 8, "conversions": 18, "paidVideoViews": 160 } // ... ], "paging": { "count": 10, "start": 0, "total": 30, "links": [ { "rel": "next", "type": "application/json", "href": "/rest/accountIntelligence?q=account&filterCriteria=(lookbackWindow:LAST_180_DAYS)&start=10&count=10&account=urn%3Ali%3AsponsoredAccount%3A123456789" } ] } } ``` -------------------------------- ### Account Intelligence Sample Response (Extended Lookback) Source: https://learn.microsoft.com/en-us/linkedin/marketing/account-intel/account-intel-api?view=li-lms-2026-01&tabs=http This response demonstrates account intelligence data with a different lookback window (LAST_180_DAYS). It includes the same core fields as the basic response. ```json { "elements": [ { "companyPageUrl": "https://www.linkedin.com/company/microsoft", "companyWebsite": "http://www.microsoft.com", "paidClicks": 40, "organicEngagements": 100, "companyName": "Microsoft", "paidLeads": 80, "paidEngagements": 600, "paidImpressions": 266, "organicImpressions": 100, "engagementLevel": "VERY_LOW", "paidQualifiedLeads": 8, "conversions": 18 } // ... ], "paging": { "count": 10, "start": 0, "total": 30, "links": [ { "rel": "next", "type": "application/json", "href": "/rest/accountIntelligence?q=account&filterCriteria=(lookbackWindow:LAST_180_DAYS)&start=10&count=10&account=urn%3Ali%3AsponsoredAccount%3A123456789" } ] } } ``` -------------------------------- ### Account Intelligence Sample Response (with Company Details) Source: https://learn.microsoft.com/en-us/linkedin/marketing/account-intel/account-intel-api?view=li-lms-2026-01&tabs=http This comprehensive response includes detailed company information such as company size, industry, country code, and cost per paid qualified lead. The lookback window is set to LAST_365_DAYS. ```json { "elements": [ { "companyPageUrl": "https://www.linkedin.com/company/microsoft", "companyWebsite": "http://www.microsoft.com", "paidClicks": 40, "organicEngagements": 100, "companyName": "Microsoft", "paidLeads": 80, "paidEngagements": 600, "paidImpressions": 266, "organicImpressions": 100, "engagementLevel": "VERY_LOW", "paidQualifiedLeads": 8, "conversions": 18, "paidVideoViews": 160, "companySize": "SIZE_10001_OR_MORE", "industry": "urn:li:industry:4", "countryCode": "US", "costInLocalCurrencyPerPaidQualifiedLead": 145.5 } // ... ], "paging": { "count": 10, "start": 0, "total": 30, "links": [ { "rel": "next", "type": "application/json", "href": "/rest/accountIntelligence?q=account&filterCriteria=(lookbackWindow:LAST_365_DAYS)&start=10&count=10&account=urn%3Ali%3AsponsoredAccount%3A123456789" } ] } } ``` -------------------------------- ### Account Intelligence Sample Response (Basic) Source: https://learn.microsoft.com/en-us/linkedin/marketing/account-intel/account-intel-api?view=li-lms-2026-01&tabs=http This snippet shows a basic response structure for account intelligence, including company details and basic engagement metrics. It uses a default lookback window. ```json { "elements": [ { "companyPageUrl": "https://www.linkedin.com/company/microsoft", "companyWebsite": "http://www.microsoft.com", "paidClicks": 20, "organicEngagements": 50, "companyName": "Microsoft", "paidLeads": 40, "paidEngagements": 300, "paidImpressions": 133, "organicImpressions": 50, "engagementLevel": "VERY_LOW", "paidQualifiedLeads": 5, "conversions": 12 } // ... ], "paging": { "count": 10, "start": 0, "total": 30, "links": [ { "rel": "next", "type": "application/json", "href": "/rest/accountIntelligence?q=account&filterCriteria=(lookbackWindow:LAST_90_DAYS,adSegments:List())&start=10&count=10&account=urn%3Ali%3AsponsoredAccount%3A123456789" } ] } } ``` -------------------------------- ### Lookback Window Filter (Last 90 Days) Source: https://learn.microsoft.com/en-us/linkedin/marketing/account-intel/account-intel-api?view=li-lms-2026-01&tabs=http Retrieve account intelligence data with a lookback window of the last 90 days. ```APIDOC ## GET /rest/accountIntelligence ### Description Retrieves account intelligence data, allowing filtering by various criteria. ### Method GET ### Endpoint https://api.linkedin.com/rest/accountIntelligence ### Query Parameters - **q** (string) - Required - Specifies the query type, e.g., 'account'. - **start** (integer) - Optional - The starting index for pagination. - **count** (integer) - Optional - The number of results to return per page. - **account** (string) - Required - The URN of the sponsored account. - **filterCriteria** (string) - Optional - Criteria for filtering results. Example: `(lookbackWindow:LAST_90_DAYS)` ### Request Example ```http GET https://api.linkedin.com/rest/accountIntelligence?q=account&start=0&count=10&account=urn%3Ali%3AsponsoredAccount%3A123456789&filterCriteria=(lookbackWindow:LAST_90_DAYS) ``` ### Response #### Success Response (200) - The response will contain account intelligence data based on the specified filters. ``` -------------------------------- ### Lookback Window Filter (Last 180 Days) Source: https://learn.microsoft.com/en-us/linkedin/marketing/account-intel/account-intel-api?view=li-lms-2026-01&tabs=http Retrieve account intelligence data with a lookback window of the last 180 days. ```APIDOC ## GET /rest/accountIntelligence ### Description Retrieves account intelligence data, allowing filtering by various criteria. ### Method GET ### Endpoint https://api.linkedin.com/rest/accountIntelligence ### Query Parameters - **q** (string) - Required - Specifies the query type, e.g., 'account'. - **start** (integer) - Optional - The starting index for pagination. - **count** (integer) - Optional - The number of results to return per page. - **account** (string) - Required - The URN of the sponsored account. - **filterCriteria** (string) - Optional - Criteria for filtering results. Example: `(lookbackWindow:LAST_180_DAYS)` ### Request Example ```http GET https://api.linkedin.com/rest/accountIntelligence?q=account&start=0&count=10&account=urn%3Ali%3AsponsoredAccount%3A123456789&filterCriteria=(lookbackWindow:LAST_180_DAYS) ``` ### Response #### Success Response (200) - The response will contain account intelligence data based on the specified filters. ``` -------------------------------- ### Lookback Window Filter (Last 365 Days) Source: https://learn.microsoft.com/en-us/linkedin/marketing/account-intel/account-intel-api?view=li-lms-2026-01&tabs=http Retrieve account intelligence data with a lookback window of the last 365 days. ```APIDOC ## GET /rest/accountIntelligence ### Description Retrieves account intelligence data, allowing filtering by various criteria. ### Method GET ### Endpoint https://api.linkedin.com/rest/accountIntelligence ### Query Parameters - **q** (string) - Required - Specifies the query type, e.g., 'account'. - **start** (integer) - Optional - The starting index for pagination. - **count** (integer) - Optional - The number of results to return per page. - **account** (string) - Required - The URN of the sponsored account. - **filterCriteria** (string) - Optional - Criteria for filtering results. Example: `(lookbackWindow:LAST_365_DAYS)` ### Request Example ```http GET https://api.linkedin.com/rest/accountIntelligence?q=account&start=0&count=10&account=urn%3Ali%3AsponsoredAccount%3A123456789&filterCriteria=(lookbackWindow:LAST_365_DAYS) ``` ### Response #### Success Response (200) - The response will contain account intelligence data based on the specified filters. ``` -------------------------------- ### Account Intelligence: Filter by Last 90 Days Lookback Window Source: https://learn.microsoft.com/en-us/linkedin/marketing/account-intel/account-intel-api?view=li-lms-2026-01&tabs=http Use this endpoint to retrieve account intelligence data filtered by a 90-day lookback window. Ensure you include the correct authorization token and API version. ```http GET https://api.linkedin.com/rest/accountIntelligence?q=account&start=0&count=10&account=urn%3Ali%3AsponsoredAccount%3A123456789&filterCriteria=(lookbackWindow:LAST_90_DAYS) ``` ```curl curl -X GET 'https://api.linkedin.com/rest/accountIntelligence?q=account&start=0&count=10&account=urn%3Ali%3AsponsoredAccount%3A123456789&filterCriteria=(lookbackWindow:LAST_90_DAYS)' \ -H 'Authorization: Bearer {INSERT_TOKEN}' \ -H 'Linkedin-Version: {version number in the format YYYYMM}' \ -H 'Content-Type: application/json' \ -H 'X-Restli-Protocol-Version: 2.0.0' ``` -------------------------------- ### Account Intelligence: Filter by Last 180 Days Lookback Window Source: https://learn.microsoft.com/en-us/linkedin/marketing/account-intel/account-intel-api?view=li-lms-2026-01&tabs=http Retrieve account intelligence data filtered by a 180-day lookback window. This request requires valid authorization headers and specifies the API version. ```http GET https://api.linkedin.com/rest/accountIntelligence?q=account&start=0&count=10&account=urn%3Ali%3AsponsoredAccount%3A123456789&filterCriteria=(lookbackWindow:LAST_180_DAYS) ``` ```curl curl -X GET 'https://api.linkedin.com/rest/accountIntelligence?q=account&start=0&count=10&account=urn%3Ali%3AsponsoredAccount%3A123456789&filterCriteria=(lookbackWindow:LAST_180_DAYS)' \ -H 'Authorization: Bearer {INSERT_TOKEN}' \ -H 'Linkedin-Version: {version number in the format YYYYMM}' \ -H 'Content-Type: application/json' \ -H 'X-Restli-Protocol-Version: 2.0.0' ``` -------------------------------- ### Account Intelligence: Filter by Ad Segments Source: https://learn.microsoft.com/en-us/linkedin/marketing/account-intel/account-intel-api?view=li-lms-2026-01&tabs=http Use this endpoint to filter account intelligence data by specific ad segments within a 7-day lookback window. Provide the URNs for the desired ad segments. ```http GET https://api.linkedin.com/rest/accountIntelligence?q=account&start=0&count=10&account=urn%3Ali%3AsponsoredAccount%3A123456789&filterCriteria=(lookbackWindow:LAST_7_DAYS,adSegments:List(urn%3Ali%3AadSegment%3A1234,urn%3Ali%3AadSegment%3A5678)) ``` ```curl curl -X GET 'https://api.linkedin.com/rest/accountIntelligence?q=account&start=0&count=10&account=urn%3Ali%3AsponsoredAccount%3A123456789&filterCriteria=(lookbackWindow:LAST_7_DAYS,adSegments:List(urn%3Ali%3AadSegment%3A1234,urn%3Ali%3AadSegment%3A5678))' \ -H 'Authorization: Bearer {INSERT_TOKEN}' \ -H 'Linkedin-Version: {version number in the format YYYYMM}' \ -H 'Content-Type: application/json' \ -H 'X-Restli-Protocol-Version: 2.0.0' ``` -------------------------------- ### Account Intel API Endpoint Source: https://learn.microsoft.com/en-us/linkedin/marketing/account-intel/account-intel-api?view=li-lms-2026-01&tabs=http This endpoint retrieves account intelligence data for target companies, offering insights into engagement, performance, and company attributes. ```APIDOC ## GET /account-intel ### Description Retrieves account intelligence data for target companies, including engagement metrics, company details, and lead generation information. ### Method GET ### Endpoint /account-intel ### Parameters #### Query Parameters - **skipCompanyDecoration** (boolean) - Optional - If set to true, company details like name, URL, and website will not be returned. - **version** (string) - Required - Specifies the API version (e.g., 2026-01). ### Response #### Success Response (200) - **companyName** (string) - Name of the engaged member’s company (target company). - **companyPageUrl** (string) - URL of the target company's company page on linkedin.com. - **companyWebsite** (string) - URL of the target company’s website domain. - **engagementLevel** (string) - The engagement level of the target company (LOW, VERY_LOW, MEDIUM, HIGH, VERY_HIGH). - **organicImpressions** (long) - Number of visits to the advertiser's LinkedIn company page, feed impressions, and product page impressions from members in the target company. - **organicEngagements** (long) - Number of interactions with page posts and product pages on the advertiser's LinkedIn company page from members in the target company. - **paidImpressions** (long) - Number of times sponsored ads were shown to members from the target company. - **paidClicks** (long) - Number of clicks on sponsored ads and ads virally shared from the members of the target company. - **paidEngagements** (long) - Sum of all social actions, clicks to ad landing page, and clicks to LinkedIn company page. - **paidLeads** (long) - Number of leads collected from the target company. - **paidQualifiedLeads** (long) - Number of qualified leads from Conversions API (CAPI) attributed to the target company. Applicable only from API versions 202603 and later. - **conversions** (long) - The count of conversions based on actions performed by a member after viewing or clicking on an ad. Applicable only from API versions 202603 and later. - **paidVideoViews** (long) - Number of paid video ad views from target company members within the lookback window. Applicable only from API versions 202605 and later. - **companySize** (string) - The range of the number of staff employed by the target company. Possible values: `SIZE_1`, `SIZE_2_TO_10`, `SIZE_11_TO_50`, `SIZE_51_TO_200`, `SIZE_201_TO_500`, `SIZE_501_TO_1000`, `SIZE_1001_TO_5000`, `SIZE_5001_TO_10000`, `SIZE_10001_OR_MORE`. Applicable only from API versions 202606 and later. - **industry** (IndustryUrn) - URN of the industry the target company is associated with. Applicable only from API versions 202606 and later. - **countryCode** (string) - ISO country code of the target company's headquarters. Applicable only from API versions 202606 and later. - **costInLocalCurrencyPerPaidQualifiedLead** (double) - Cost per paid qualified lead (CPQL) attributed to the target company, in the advertiser's local currency. Applicable only from API versions 202606 and later. #### Response Example { "companyName": "Example Corp", "companyPageUrl": "http://linkedin.com/company/example-corp", "companyWebsite": "https://www.example.com", "engagementLevel": "HIGH", "organicImpressions": 1500, "organicEngagements": 200, "paidImpressions": 5000, "paidClicks": 150, "paidEngagements": 300, "paidLeads": 10, "paidQualifiedLeads": 5, "conversions": 25, "paidVideoViews": 1000, "companySize": "SIZE_501_TO_1000", "industry": "urn:li:industry:1", "countryCode": "US", "costInLocalCurrencyPerPaidQualifiedLead": 10.50 } ``` -------------------------------- ### Account Intelligence: Filter by Campaign Source: https://learn.microsoft.com/en-us/linkedin/marketing/account-intel/account-intel-api?view=li-lms-2026-01&tabs=http Retrieve account intelligence data filtered by a specific campaign within a 30-day lookback window. Ensure the campaign URN is correctly formatted. ```http GET https://api.linkedin.com/rest/accountIntelligence?q=account&start=0&count=10&account=urn%3Ali%3AsponsoredAccount%3A123456789&filterCriteria=(lookbackWindow:LAST_30_DAYS,campaign:urn%3Ali%3AsponsoredCampaign%3A12345678) ``` ```curl curl -X GET 'https://api.linkedin.com/rest/accountIntelligence?q=account&start=0&count=10&account=urn%3Ali%3AsponsoredAccount%3A123456789&filterCriteria=(lookbackWindow:LAST_30_DAYS,campaign:urn%3Ali%3AsponsoredCampaign%3A12345678)' \ -H 'Authorization: Bearer {INSERT_TOKEN}' \ -H 'Linkedin-Version: {version number in the format YYYYMM}' \ -H 'Content-Type: application/json' \ -H 'X-Restli-Protocol-Version: 2.0.0' ``` -------------------------------- ### Campaign Filter Source: https://learn.microsoft.com/en-us/linkedin/marketing/account-intel/account-intel-api?view=li-lms-2026-01&tabs=http Retrieve account intelligence data filtered by a specific campaign and lookback window. ```APIDOC ## GET /rest/accountIntelligence ### Description Retrieves account intelligence data, allowing filtering by a specific campaign and lookback window. ### Method GET ### Endpoint https://api.linkedin.com/rest/accountIntelligence ### Query Parameters - **q** (string) - Required - Specifies the query type, e.g., 'account'. - **start** (integer) - Optional - The starting index for pagination. - **count** (integer) - Optional - The number of results to return per page. - **account** (string) - Required - The URN of the sponsored account. - **filterCriteria** (string) - Optional - Criteria for filtering results. Example: `(lookbackWindow:LAST_30_DAYS,campaign:urn%3Ali%3AsponsoredCampaign%3A12345678)` ### Request Example ```http GET https://api.linkedin.com/rest/accountIntelligence?q=account&start=0&count=10&account=urn%3Ali%3AsponsoredAccount%3A123456789&filterCriteria=(lookbackWindow:LAST_30_DAYS,campaign:urn%3Ali%3AsponsoredCampaign%3A12345678) ``` ### Response #### Success Response (200) - The response will contain account intelligence data based on the specified filters. ``` -------------------------------- ### Account Intelligence API Request Schema Source: https://learn.microsoft.com/en-us/linkedin/marketing/account-intel/account-intel-api?view=li-lms-2026-01&tabs=http Defines the structure for requests to the Account Intelligence API, including required fields and their types. ```APIDOC ## Request Schema ### Request Body - **account** (SponsoredAccountUrn) - Required - Ad Account URN of the advertiser requesting the account intelligence data. The format is `urn:li:sponsoredAccount:1234`. The authenticated user must have a valid role on this ad account. For more information, see Find Ad Accounts by Authenticated User API. - **filterCriteria** (Array [Company Intelligence Filter Criteria]) - Required - Contains filters to apply to the request as described in Company Intelligence Filter Criteria. - **skipCompanyDecoration** (boolean) - Optional (defaults to false) - Indicates whether to skip fetching `companyName` in response. Currently returns `companyName` even if specified true due to an API issue. ``` -------------------------------- ### Company Intelligence API Overview Source: https://learn.microsoft.com/en-us/linkedin/marketing/account-intel/account-intel-api?view=li-lms-2026-01&tabs=http The Company Intelligence API provides company-level data including engagement scores, paid and organic impressions, clicks, leads, conversions, and firmographic attributes. It is designed to support attribution tools by offering accurate company-level data for insights, targeting, and performance measurement. ```APIDOC ## Company Intelligence API ### Description 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, paid qualified leads, conversions, paid video views, cost per paid qualified lead (CPQL), organic impressions, and organic engagements, along with firmographic attributes such as company size, industry, and headquarters country. Designed to support attribution tools, the API offers accurate company-level data. Use it to gain insights, improve targeting, and measure how companies across your ad accounts interact with your brand on LinkedIn effectively. ### Metrics Supported (Version Dependent) - **Engagement Score** - **Paid Impressions** - **Paid Clicks** - **Leads** - **Paid Qualified Leads** (Supported from March 2026 onwards) - **Conversions** (Supported from March 2026 onwards) - **Paid Video Views** (Supported from May 2026 onwards) - **Cost per Paid Qualified Lead (CPQL)** - **Organic Impressions** - **Organic Engagements** ### Firmographic Attributes Supported (Version Dependent) - **Company Size** (Supported from June 2026 onwards) - **Industry** (Supported from June 2026 onwards) - **Headquarters Country** (Supported from June 2026 onwards) ### Notes - The Marketing Version 202506 (Marketing June 2025) has been sunset. Migration to the latest versioned APIs is recommended. - Specific metrics and firmographic attributes have version dependencies. Refer to the documentation for exact support timelines. ``` -------------------------------- ### Ad Segment Filter Source: https://learn.microsoft.com/en-us/linkedin/marketing/account-intel/account-intel-api?view=li-lms-2026-01&tabs=http Retrieve account intelligence data filtered by ad segments and a lookback window. ```APIDOC ## GET /rest/accountIntelligence ### Description Retrieves account intelligence data, allowing filtering by ad segments and a lookback window. ### Method GET ### Endpoint https://api.linkedin.com/rest/accountIntelligence ### Query Parameters - **q** (string) - Required - Specifies the query type, e.g., 'account'. - **start** (integer) - Optional - The starting index for pagination. - **count** (integer) - Optional - The number of results to return per page. - **account** (string) - Required - The URN of the sponsored account. - **filterCriteria** (string) - Optional - Criteria for filtering results. Example: `(lookbackWindow:LAST_7_DAYS,adSegments:List(urn%3Ali%3AadSegment%3A1234,urn%3Ali%3AadSegment%3A5678))` ### Request Example ```http GET https://api.linkedin.com/rest/accountIntelligence?q=account&start=0&count=10&account=urn%3Ali%3AsponsoredAccount%3A123456789&filterCriteria=(lookbackWindow:LAST_7_DAYS,adSegments:List(urn%3Ali%3AadSegment%3A1234,urn%3Ali%3AadSegment%3A5678)) ``` ### Response #### Success Response (200) - The response will contain account intelligence data based on the specified filters. ``` === COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.