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.

Supported Methods

GET ALL

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
$URN urn 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",
            "$URN": "urn:li:adTargetingFacet:employersPast",
            "availableEntityFinders": [
                "TYPEAHEAD",
                "SIMILAR_ENTITIES"
            ]
        },
        {
            "entityTypes": [
                "COMPANY"
            ],
            "facetName": "employers",
            "$URN": "urn:li:adTargetingFacet:employers",
            "availableEntityFinders": [
                "TYPEAHEAD",
                "SIMILAR_ENTITIES"
            ]
        },
        {
            "entityTypes": [
                "COMPANY"
            ],
            "facetName": "employersAll",
            "$URN": "urn:li:adTargetingFacet:employersAll",
            "availableEntityFinders": [
                "TYPEAHEAD",
                "SIMILAR_ENTITIES"
            ]
        },
        {
            "entityTypes": [
                "COMPANY"
            ],
            "facetName": "followedCompanies",
            "$URN": "urn:li:adTargetingFacet:followedCompanies",
            "availableEntityFinders": [
                "TYPEAHEAD",
                "SIMILAR_ENTITIES"
            ]
        },
        {
            "entityTypes": [
                "DEGREE"
            ],
            "facetName": "degrees",
            "$URN": "urn:li:adTargetingFacet:degrees",
            "availableEntityFinders": [
                "AD_TARGETING_FACET",
                "TYPEAHEAD"
            ]
        },
        {
            "entityTypes": [
                "SKILL"
            ],
            "facetName": "skills",
            "$URN": "urn:li:adTargetingFacet:skills",
            "availableEntityFinders": [
                "AD_TARGETING_FACET",
                "TYPEAHEAD",
                "SIMILAR_ENTITIES"
            ]
        },
        {
            "entityTypes": [
                "COUNTRY_GROUP",
                "COUNTRY",
                "STATE",
                "REGION"
            ],
            "facetName": "locations",
            "$URN": "urn:li:adTargetingFacet:locations",
            "availableEntityFinders": [
                "AD_TARGETING_FACET",
                "TYPEAHEAD"
            ]
        },
        {
            "entityTypes": [
                "$UNKNOWN"
            ],
            "facetName": "audienceMatchingSegments",
            "$URN": "urn:li:adTargetingFacet:audienceMatchingSegments",
            "availableEntityFinders": [
                "$UNKNOWN"
            ]
        },
        {
            "entityTypes": [
                "AGE"
            ],
            "facetName": "ageRanges",
            "$URN": "urn:li:adTargetingFacet:ageRanges",
            "availableEntityFinders": [
                "AD_TARGETING_FACET"
            ]
        },
        {
            "entityTypes": [
                "TITLE"
            ],
            "facetName": "titles",
            "$URN": "urn:li:adTargetingFacet:titles",
            "availableEntityFinders": [
                "AD_TARGETING_FACET",
                "TYPEAHEAD",
                "SIMILAR_ENTITIES"
            ]
        },
        {
            "entityTypes": [
                "FIRMOGRAPHIC"
            ],
            "facetName": "growthRate",
            "$URN": "urn:li:adTargetingFacet:growthRate",
            "availableEntityFinders": [
                "AD_TARGETING_FACET"
            ]
        },
        {
            "entityTypes": [
                "INTEREST"
            ],
            "facetName": "interests",
            "$URN": "urn:li:adTargetingFacet:interests",
            "availableEntityFinders": [
                "TYPEAHEAD"
            ]
        },
        {
            "entityTypes": [
                "LOCALE"
            ],
            "facetName": "interfaceLocales",
            "$URN": "urn:li:adTargetingFacet:interfaceLocales",
            "availableEntityFinders": [
                "AD_TARGETING_FACET"
            ]
        },
        {
            "entityTypes": [
                "COMPANY"
            ],
            "facetName": "firstDegreeConnectionCompanies",
            "$URN": "urn:li:adTargetingFacet:firstDegreeConnectionCompanies",
            "availableEntityFinders": [
                "TYPEAHEAD",
                "SIMILAR_ENTITIES"
            ]
        },
        {
            "entityTypes": [
                "COMPANY_SIZE"
            ],
            "facetName": "staffCountRanges",
            "$URN": "urn:li:adTargetingFacet:staffCountRanges",
            "availableEntityFinders": [
                "AD_TARGETING_FACET"
            ]
        },
        {
            "entityTypes": [
                "SENIORITY"
            ],
            "facetName": "seniorities",
            "$URN": "urn:li:adTargetingFacet:seniorities",
            "availableEntityFinders": [
                "AD_TARGETING_FACET"
            ]
        },
        {
            "entityTypes": [
                "$UNKNOWN"
            ],
            "facetName": "dynamicSegments",
            "$URN": "urn:li:adTargetingFacet:dynamicSegments",
            "availableEntityFinders": [
                "$UNKNOWN"
            ]
        },
        {
            "entityTypes": [
                "GENDER"
            ],
            "facetName": "genders",
            "$URN": "urn:li:adTargetingFacet:genders",
            "availableEntityFinders": [
                "AD_TARGETING_FACET"
            ]
        },
        {
            "entityTypes": [
                "SCHOOL"
            ],
            "facetName": "schools",
            "$URN": "urn:li:adTargetingFacet:schools",
            "availableEntityFinders": [
                "TYPEAHEAD"
            ]
        },
        {
            "entityTypes": [
                "TITLE"
            ],
            "facetName": "titlesPast",
            "$URN": "urn:li:adTargetingFacet:titlesPast",
            "availableEntityFinders": [
                "AD_TARGETING_FACET",
                "TYPEAHEAD",
                "SIMILAR_ENTITIES"
            ]
        },
        {
            "entityTypes": [
                "YEARS_OF_EXPERIENCE"
            ],
            "facetName": "yearsOfExperienceRanges",
            "$URN": "urn:li:adTargetingFacet:yearsOfExperienceRanges",
            "availableEntityFinders": [
                "AD_TARGETING_FACET"
            ]
        },
        {
            "entityTypes": [
                "FUNCTION"
            ],
            "facetName": "jobFunctions",
            "$URN": "urn:li:adTargetingFacet:jobFunctions",
            "availableEntityFinders": [
                "AD_TARGETING_FACET"
            ]
        },
        {
            "entityTypes": [
                "FIRMOGRAPHIC"
            ],
            "facetName": "companyCategory",
            "$URN": "urn:li:adTargetingFacet:companyCategory",
            "availableEntityFinders": [
                "AD_TARGETING_FACET",
                "TYPEAHEAD"
            ]
        },
        {
            "entityTypes": [
                "FIELD_OF_STUDY"
            ],
            "facetName": "fieldsOfStudy",
            "$URN": "urn:li:adTargetingFacet:fieldsOfStudy",
            "availableEntityFinders": [
                "AD_TARGETING_FACET",
                "TYPEAHEAD"
            ]
        },
        {
            "entityTypes": [
                "MEMBER_BEHAVIOR"
            ],
            "facetName": "memberBehaviors",
            "$URN": "urn:li:adTargetingFacet:memberBehaviors",
            "availableEntityFinders": [
                "AD_TARGETING_FACET",
                "TYPEAHEAD"
            ]
        },
        {
            "entityTypes": [
                "INDUSTRY"
            ],
            "facetName": "industries",
            "$URN": "urn:li:adTargetingFacet:industries",
            "availableEntityFinders": [
                "AD_TARGETING_FACET",
                "TYPEAHEAD",
                "SIMILAR_ENTITIES"
            ]
        },
        {
            "entityTypes": [
                "COUNTRY_GROUP",
                "COUNTRY",
                "STATE",
                "REGION"
            ],
            "facetName": "profileLocations",
            "$URN": "urn:li:adTargetingFacet:profileLocations",
            "availableEntityFinders": [
                "AD_TARGETING_FACET",
                "TYPEAHEAD"
            ]
        },
        {
            "entityTypes": [
                "TITLE"
            ],
            "facetName": "titlesAll",
            "$URN": "urn:li:adTargetingFacet:titlesAll",
            "availableEntityFinders": [
                "AD_TARGETING_FACET",
                "TYPEAHEAD",
                "SIMILAR_ENTITIES"
            ]
        },
        {
            "entityTypes": [
                "GROUP"
            ],
            "facetName": "groups",
            "$URN": "urn:li:adTargetingFacet:groups",
            "availableEntityFinders": [
                "TYPEAHEAD",
                "SIMILAR_ENTITIES"
            ]
        }
    ],
    "paging": {
        "count": 10,
        "links": [],
        "start": 0
    }
}