Ad Targeting Facets
The LinkedIn ads platform allows advertisers to target different types of audiences on the professional network.
Use the Ad Targeting Facets API to discover types of targeting available. Use in conjunction with the Ad Targeting Entities API .
Note
Please note that website retargeting facet was named retargetingSegments in the legacy Targeting object. However the name is changed to dynamicSegments in the TargetingCriteria object. Please start using the new facet name if you're managing ad campaigns that use this facet with TargetingCriteria. If you're still managing ad campaigns using Targeting object, old name should be used as before.
Note
In versions before the 202304, the adTargetingFacetUrn field was $URN and the type of the field was urn. Hence for older versions, the name and type should be used as before.
Supported Methods
Schema
| Field Name | Field Type | Description |
|---|---|---|
| availableEntityFinders | AdTargetingEntityFinderType | A list of Finder methods that are available for this facet via the Ad Targeting Entities API . |
| entityTypes | AdTargetingEntityType | A list of entity types available for targeting, represented by the resources that support them |
| facetName | string | String IDs matching the names of the different fields |
| adTragetingFacetUrn | AdTargetingFacetUrn | urn of the facet. Facet urns will be the preferred format to specify in targeting, forecasting and other APIs where facet names were previously used. |
GET ALL
GET https://api.linkedin.com/v2/adTargetingFacets
Sample Response
{
"elements": [
{
"entityTypes": [
"COMPANY"
],
"facetName": "employersPast",
"adTargetingFacetUrn": "urn:li:adTargetingFacet:employersPast",
"availableEntityFinders": [
"TYPEAHEAD",
"SIMILAR_ENTITIES"
]
},
{
"entityTypes": [
"COMPANY"
],
"facetName": "employers",
"adTargetingFacetUrn": "urn:li:adTargetingFacet:employers",
"availableEntityFinders": [
"TYPEAHEAD",
"SIMILAR_ENTITIES"
]
},
{
"entityTypes": [
"COMPANY"
],
"facetName": "employersAll",
"adTargetingFacetUrn": "urn:li:adTargetingFacet:employersAll",
"availableEntityFinders": [
"TYPEAHEAD",
"SIMILAR_ENTITIES"
]
},
{
"entityTypes": [
"COMPANY"
],
"facetName": "followedCompanies",
"adTargetingFacetUrn": "urn:li:adTargetingFacet:followedCompanies",
"availableEntityFinders": [
"TYPEAHEAD",
"SIMILAR_ENTITIES"
]
},
{
"entityTypes": [
"DEGREE"
],
"facetName": "degrees",
"adTargetingFacetUrn": "urn:li:adTargetingFacet:degrees",
"availableEntityFinders": [
"AD_TARGETING_FACET",
"TYPEAHEAD"
]
},
{
"entityTypes": [
"SKILL"
],
"facetName": "skills",
"adTargetingFacetUrn": "urn:li:adTargetingFacet:skills",
"availableEntityFinders": [
"AD_TARGETING_FACET",
"TYPEAHEAD",
"SIMILAR_ENTITIES"
]
},
{
"entityTypes": [
"COUNTRY_GROUP",
"COUNTRY",
"STATE",
"REGION"
],
"facetName": "locations",
"adTargetingFacetUrn": "urn:li:adTargetingFacet:locations",
"availableEntityFinders": [
"AD_TARGETING_FACET",
"TYPEAHEAD"
]
},
{
"entityTypes": [
"$UNKNOWN"
],
"facetName": "audienceMatchingSegments",
"adTargetingFacetUrn": "urn:li:adTargetingFacet:audienceMatchingSegments",
"availableEntityFinders": [
"$UNKNOWN"
]
},
{
"entityTypes": [
"AGE"
],
"facetName": "ageRanges",
"adTargetingFacetUrn": "urn:li:adTargetingFacet:ageRanges",
"availableEntityFinders": [
"AD_TARGETING_FACET"
]
},
{
"entityTypes": [
"TITLE"
],
"facetName": "titles",
"adTargetingFacetUrn": "urn:li:adTargetingFacet:titles",
"availableEntityFinders": [
"AD_TARGETING_FACET",
"TYPEAHEAD",
"SIMILAR_ENTITIES"
]
},
{
"entityTypes": [
"FIRMOGRAPHIC"
],
"facetName": "growthRate",
"adTargetingFacetUrn": "urn:li:adTargetingFacet:growthRate",
"availableEntityFinders": [
"AD_TARGETING_FACET"
]
},
{
"entityTypes": [
"INTEREST"
],
"facetName": "interests",
"adTargetingFacetUrn": "urn:li:adTargetingFacet:interests",
"availableEntityFinders": [
"TYPEAHEAD",
"AD_TARGETING_FACET"
]
},
{
"entityTypes": [
"LOCALE"
],
"facetName": "interfaceLocales",
"adTargetingFacetUrn": "urn:li:adTargetingFacet:interfaceLocales",
"availableEntityFinders": [
"AD_TARGETING_FACET"
]
},
{
"entityTypes": [
"COMPANY"
],
"facetName": "firstDegreeConnectionCompanies",
"adTargetingFacetUrn": "urn:li:adTargetingFacet:firstDegreeConnectionCompanies",
"availableEntityFinders": [
"TYPEAHEAD",
"SIMILAR_ENTITIES"
]
},
{
"entityTypes": [
"COMPANY_SIZE"
],
"facetName": "staffCountRanges",
"adTargetingFacetUrn": "urn:li:adTargetingFacet:staffCountRanges",
"availableEntityFinders": [
"AD_TARGETING_FACET"
]
},
{
"entityTypes": [
"SENIORITY"
],
"facetName": "seniorities",
"adTargetingFacetUrn": "urn:li:adTargetingFacet:seniorities",
"availableEntityFinders": [
"AD_TARGETING_FACET"
]
},
{
"entityTypes": [
"$UNKNOWN"
],
"facetName": "dynamicSegments",
"adTargetingFacetUrn": "urn:li:adTargetingFacet:dynamicSegments",
"availableEntityFinders": [
"$UNKNOWN"
]
},
{
"entityTypes": [
"GENDER"
],
"facetName": "genders",
"adTargetingFacetUrn": "urn:li:adTargetingFacet:genders",
"availableEntityFinders": [
"AD_TARGETING_FACET"
]
},
{
"entityTypes": [
"SCHOOL"
],
"facetName": "schools",
"adTargetingFacetUrn": "urn:li:adTargetingFacet:schools",
"availableEntityFinders": [
"TYPEAHEAD"
]
},
{
"entityTypes": [
"TITLE"
],
"facetName": "titlesPast",
"adTargetingFacetUrn": "urn:li:adTargetingFacet:titlesPast",
"availableEntityFinders": [
"AD_TARGETING_FACET",
"TYPEAHEAD",
"SIMILAR_ENTITIES"
]
},
{
"entityTypes": [
"YEARS_OF_EXPERIENCE"
],
"facetName": "yearsOfExperienceRanges",
"adTargetingFacetUrn": "urn:li:adTargetingFacet:yearsOfExperienceRanges",
"availableEntityFinders": [
"AD_TARGETING_FACET"
]
},
{
"entityTypes": [
"FUNCTION"
],
"facetName": "jobFunctions",
"adTargetingFacetUrn": "urn:li:adTargetingFacet:jobFunctions",
"availableEntityFinders": [
"AD_TARGETING_FACET"
]
},
{
"entityTypes": [
"FIRMOGRAPHIC"
],
"facetName": "companyCategory",
"adTargetingFacetUrn": "urn:li:adTargetingFacet:companyCategory",
"availableEntityFinders": [
"AD_TARGETING_FACET",
"TYPEAHEAD"
]
},
{
"entityTypes": [
"FIELD_OF_STUDY"
],
"facetName": "fieldsOfStudy",
"adTargetingFacetUrn": "urn:li:adTargetingFacet:fieldsOfStudy",
"availableEntityFinders": [
"AD_TARGETING_FACET",
"TYPEAHEAD"
]
},
{
"entityTypes": [
"MEMBER_BEHAVIOR"
],
"facetName": "memberBehaviors",
"adTargetingFacetUrn": "urn:li:adTargetingFacet:memberBehaviors",
"availableEntityFinders": [
"AD_TARGETING_FACET",
"TYPEAHEAD"
]
},
{
"entityTypes": [
"INDUSTRY"
],
"facetName": "industries",
"adTargetingFacetUrn": "urn:li:adTargetingFacet:industries",
"availableEntityFinders": [
"AD_TARGETING_FACET",
"TYPEAHEAD",
"SIMILAR_ENTITIES"
]
},
{
"entityTypes": [
"COUNTRY_GROUP",
"COUNTRY",
"STATE",
"REGION"
],
"facetName": "profileLocations",
"adTargetingFacetUrn": "urn:li:adTargetingFacet:profileLocations",
"availableEntityFinders": [
"AD_TARGETING_FACET",
"TYPEAHEAD"
]
},
{
"entityTypes": [
"TITLE"
],
"facetName": "titlesAll",
"adTargetingFacetUrn": "urn:li:adTargetingFacet:titlesAll",
"availableEntityFinders": [
"AD_TARGETING_FACET",
"TYPEAHEAD",
"SIMILAR_ENTITIES"
]
},
{
"entityTypes": [
"GROUP"
],
"facetName": "groups",
"adTargetingFacetUrn": "urn:li:adTargetingFacet:groups",
"availableEntityFinders": [
"TYPEAHEAD",
"SIMILAR_ENTITIES"
]
}
],
"paging": {
"count": 10,
"links": [],
"start": 0
}
}
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for