Audience Counts
Warning
Deprecation Notice
The Marketing Version 202311 (Marketing November 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.
The Audience Count API provides the number of member accounts that fit your targeting criteria. As your campaign serves ads, the number of member accounts that you reach will be lower than the target audience size.
Since 300 is the minimum audience size in order to run a campaign, this endpoint is also useful to ensure your target audience is large enough.
Permissions
Any application approved for the LinkedIn Marketing API Program can make these API calls using any 3-legged access token. No additional permissions are requested during the OAuth flow.
Schema
| Field Name | Description |
|---|---|
| active | Active audience count for the given targeting criteria. Active audience includes members that are more likely to visit LinkedIn sites. |
| total | Total audience count for the given targeting criteria. To protect member privacy, this value is 0 when the audience size is less than 300. The total is a rounded approximation, and the degree of approximation depends upon the size of the audience segment. |
Find Count by CriteriaV2
This finder gets the audience count for a given set of targeting criteria. For more information refer to Targeting Criteria.
The parameter q=targetingCriteriaV2 is always required as it represents the Finder targetingCriteriaV2 request.
All API requests are represented in protocol 2.0.0 and require the header X-Restli-Protocol-Version: 2.0.0.
Restli 2.0 requires URNs in query params to be URL encoded. For example, urn:li:skill:17 would become urn%3Ali%3Askill%3A17.
Note that Postman or similar API tools may not support these types of calls. Testing with curl is recommended if you encounter a 400 error with message Invalid query parameters passed to request.
Calls to this endpoint are structured as follows:
GET https://api.linkedin.com/rest/audienceCounts?q=targetingCriteriaV2&targetingCriteria=(include:(and:List((or:({encoded facet_URN_1}:List({encoded facet_URN_1_value_1}, {encoded facet_URN_1_value_2}))),(or:({encoded facet_URN_2}:List({encoded facet_URN_2_value_1},{encoded facet_URN_2_value_2}))))))
GET https://api.linkedin.com/v2/audienceCountsV2?q=targetingCriteriaV2&targetingCriteria=(include:(and:List((or:({encoded facet_URN_1}:List({encoded facet_URN_1_value_1}, {encoded facet_URN_1_value_2}))),(or:({encoded facet_URN_2}:List({encoded facet_URN_2_value_1},{encoded facet_URN_2_value_2}))))))
Parameters
| Field Name | Required | Type | Description |
|---|---|---|---|
| q | This field should always be targetingCriteriaV2 |
String | Yes |
| targetingCriteria | Yes | targetingCriteria object | Specifies the targeting criteria that the member should match. |
Sample Request
The following shows a sample request forecasting the audience count for members living in North America and skill type “Engineering”.
Any URNs included in the parameters must be URL encoded. An unencoded sample request has also been provided for readability.
Unencoded Sample Request
Encoded Sample Request
Sample Response
The API returns a list of AudienceCount results based on targetingCriteria parameters.
{
"elements": [
{
"active": 0,
"total": 25312600
}
],
"paging": {
"count": 10,
"links": [],
"start": 0
}
}