LinkedIn Ad Targeting Entities API

APIs to discover and retrieve ad targeting facets and entities

Operations 2

GET /adTargetingFacets LinkedIn Get List of Available Ad Targeting Facets #
GET /adTargetingEntities LinkedIn Get Ad Targeting Entities Using Typeahead Search #

Documentation

📖
Documentation
https://learn.microsoft.com/en-us/linkedin/marketing/
📖
GettingStarted
https://learn.microsoft.com/en-us/linkedin/marketing/getting-started
📖
Documentation
https://learn.microsoft.com/en-us/linkedin/learning/
📖
GettingStarted
https://learn.microsoft.com/en-us/linkedin/learning/getting-started
📖
Documentation
https://learn.microsoft.com/en-us/linkedin/learning/getting-started/terminology
📖
Documentation
https://learn.microsoft.com/en-us/linkedin/learning/integrations/xapi
📖
APIReference
https://learn.microsoft.com/en-us/linkedin/learning/reporting/reporting-docs/reporting-api
📖
Documentation
https://learn.microsoft.com/en-us/linkedin/talent/
📖
GettingStarted
https://learn.microsoft.com/en-us/linkedin/talent/getting-started
📖
Documentation
https://learn.microsoft.com/en-us/linkedin/talent/versioning
📖
Documentation
https://learn.microsoft.com/en-us/linkedin/compliance/
📖
GettingStarted
https://learn.microsoft.com/en-us/linkedin/compliance/getting-started
📖
Documentation
https://learn.microsoft.com/en-us/linkedin/compliance/compliance-api/overview
📖
Documentation
https://learn.microsoft.com/en-us/linkedin/sales/
📖
APIReference
https://learn.microsoft.com/en-us/linkedin/sales/display-services/
📖
APIReference
https://learn.microsoft.com/en-us/linkedin/sales/analytics-services/
📖
APIReference
https://learn.microsoft.com/en-us/linkedin/sales/sync-services/
📖
Documentation
https://learn.microsoft.com/en-us/linkedin/dma/
📖
Documentation
https://learn.microsoft.com/en-us/linkedin/dma/member-data-portability/
📖
Documentation
https://learn.microsoft.com/en-us/linkedin/dma/pages-data-portability-overview
📖
Documentation
https://learn.microsoft.com/en-us/linkedin/dma/transparency/advertiser-transparency

Specifications

Other Resources

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/linkedin-ad-targeting-entities-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

linkedin-ad-targeting-entities-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Linkedin Ad Targeting Entities API
  version: 1.0.0
  description: 'Operations tagged Ad Targeting Entities across 2 of this provider''s published API definitions: linkedin-marketing-audience-insights.yml, linkedin-marketing-media-planning.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.linkedin.com/rest
  description: LinkedIn REST API Server
- url: https://api.linkedin.com
  description: LinkedIn Marketing API Production Server
tags:
- name: Ad Targeting Entities
  description: APIs to discover and retrieve ad targeting facets and entities
paths:
  /adTargetingFacets:
    get:
      tags:
      - Ad Targeting Entities
      summary: LinkedIn Get List of Available Ad Targeting Facets
      description: Retrieve the list of available ad targeting facets. Facets are high-level categories of targeting types available for ad campaigns.
      operationId: getAdTargetingFacets
      x-microcks-operation:
        dispatcher: FALLBACK
        dispatcherRules: ''
      parameters:
      - name: LinkedIn-Version
        in: header
        required: true
        schema:
          type: string
        description: LinkedIn API version
        example: '202401'
      - name: X-Restli-Protocol-Version
        in: header
        required: true
        schema:
          type: string
        description: RestLi protocol version
        example: 2.0.0
      responses:
        '200':
          description: Successfully retrieved ad targeting facets
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AdTargetingFacetsResponse'
              examples:
                SuccessResponse:
                  $ref: '#/components/examples/AdTargetingFacetsResponseExample'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
      - OAuth2Auth:
        - r_ads
    servers:
    - url: https://api.linkedin.com/rest
      description: LinkedIn REST API Server
  /adTargetingEntities:
    get:
      tags:
      - Ad Targeting Entities
      summary: LinkedIn Get Ad Targeting Entities Using Typeahead Search
      description: Search for ad targeting entities within a facet using typeahead search. Returns entities matching the search query.
      operationId: searchAdTargetingEntities
      x-microcks-operation:
        dispatcher: FALLBACK
        dispatcherRules: ''
      parameters:
      - name: LinkedIn-Version
        in: header
        required: true
        schema:
          type: string
        description: LinkedIn API version
        example: '202401'
      - name: X-Restli-Protocol-Version
        in: header
        required: true
        schema:
          type: string
        description: RestLi protocol version
        example: 2.0.0
      - name: q
        in: query
        required: true
        schema:
          type: string
          enum:
          - typeahead
        description: Query type
        example: typeahead
      - name: query
        in: query
        required: true
        schema:
          type: string
        description: Search query string (URL encoded)
        example: united%20states
      - name: facet
        in: query
        required: true
        schema:
          type: string
        description: Facet URN to search within (URL encoded)
        example: urn%3Ali%3AadTargetingFacet%3Alocations
      - name: queryVersion
        in: query
        required: false
        schema:
          type: string
          enum:
          - QUERY_USES_URNS
        description: Query version format
        example: QUERY_USES_URNS
      - name: start
        in: query
        required: false
        schema:
          type: integer
          default: 0
        description: Starting index for pagination
        example: 0
      - name: count
        in: query
        required: false
        schema:
          type: integer
          default: 10
          maximum: 100
        description: Number of results to return
        example: 10
      responses:
        '200':
          description: Successfully retrieved ad targeting entities
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AdTargetingEntitiesResponse'
              examples:
                SuccessResponse:
                  $ref: '#/components/examples/AdTargetingEntitiesResponseExample'
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
      - OAuth2Auth:
        - r_ads
    servers:
    - url: https://api.linkedin.com/rest
      description: LinkedIn REST API Server
components:
  schemas:
    Paging:
      type: object
      properties:
        start:
          type: integer
          description: Starting index
          example: 0
        count:
          type: integer
          description: Number of results returned
          example: 10
        total:
          type: integer
          description: Total number of results
          example: 100
        links:
          type: array
          items:
            $ref: '#/components/schemas/PagingLink'
    AdTargetingEntity:
      type: object
      properties:
        name:
          type: string
          description: Display name of the entity
          example: United States
        urn:
          type: string
          description: URN identifier for the entity
          example: urn:li:geo:103644278
        facetUrn:
          type: string
          description: URN of the parent facet
          example: urn:li:adTargetingFacet:locations
      required:
      - name
      - urn
      - facetUrn
    ErrorResponse:
      type: object
      properties:
        status:
          type: integer
          description: HTTP status code
          example: 400
        message:
          type: string
          description: Error message
          example: Invalid request parameters
        code:
          type: string
          description: Error code
          example: INVALID_PARAMS
    PagingLink:
      type: object
      properties:
        rel:
          type: string
          example: next
        href:
          type: string
          example: /rest/adTargetingEntities?q=typeahead&query=united%20states&start=10&count=10
        type:
          type: string
          example: application/json
    AdTargetingEntitiesResponse:
      type: object
      properties:
        elements:
          type: array
          items:
            $ref: '#/components/schemas/AdTargetingEntity'
        paging:
          $ref: '#/components/schemas/Paging'
    AdTargetingFacet:
      type: object
      properties:
        facetName:
          type: string
          description: Name of the targeting facet
          example: jobFunctions
        urn:
          type: string
          description: URN identifier for the facet
          example: urn:li:adTargetingFacet:jobFunctions
        entityTypes:
          type: array
          items:
            type: string
          description: Types of entities in this facet
          example:
          - FUNCTION
        availableEntityFinders:
          type: array
          items:
            type: string
            enum:
            - AD_TARGETING_FACET
            - TYPEAHEAD
            - SIMILAR_ENTITIES
          description: Available methods to find entities
          example:
          - AD_TARGETING_FACET
      required:
      - facetName
      - urn
      - entityTypes
    AdTargetingFacetsResponse:
      type: object
      properties:
        elements:
          type: array
          items:
            $ref: '#/components/schemas/AdTargetingFacet'
        paging:
          $ref: '#/components/schemas/Paging'
    GetBingGeoLocationsResponse200:
      type: object
      properties:
        paging:
          type: object
          properties:
            start:
              type: integer
            count:
              type: integer
            links:
              type: array
              items:
                type: object
                properties:
                  type:
                    type: string
                  rel:
                    type: string
                  href:
                    type: string
        elements:
          type: array
          items:
            type: object
            properties:
              name:
                type: string
              urn:
                type: string
              facetUrn:
                type: string
    GetAListOfResponse200:
      type: object
      properties:
        paging:
          type: object
          properties:
            start:
              type: integer
            count:
              type: integer
            links:
              type: array
              items: {}
        elements:
          type: array
          items:
            type: object
            properties:
              entityTypes:
                type: array
                items:
                  type: string
              facetName:
                type: string
              availableEntityFinders:
                type: array
                items:
                  type: string
  examples:
    AdTargetingFacetsResponseExample:
      summary: List of ad targeting facets
      value:
        paging:
          start: 0
          count: 10
          links: []
        elements:
        - entityTypes:
          - FUNCTION
          facetName: jobFunctions
          urn: urn:li:adTargetingFacet:jobFunctions
          availableEntityFinders:
          - AD_TARGETING_FACET
        - entityTypes:
          - AGE
          facetName: ageRanges
          urn: urn:li:adTargetingFacet:ageRanges
          availableEntityFinders:
          - AD_TARGETING_FACET
        - entityTypes:
          - GROUP
          facetName: groups
          urn: urn:li:adTargetingFacet:groups
          availableEntityFinders:
          - TYPEAHEAD
          - SIMILAR_ENTITIES
        - entityTypes:
          - COMPANY
          facetName: employers
          urn: urn:li:adTargetingFacet:employers
          availableEntityFinders:
          - TYPEAHEAD
          - SIMILAR_ENTITIES
        - entityTypes:
          - INDUSTRY
          facetName: industries
          urn: urn:li:adTargetingFacet:industries
          availableEntityFinders:
          - AD_TARGETING_FACET
          - TYPEAHEAD
          - SIMILAR_ENTITIES
        - entityTypes:
          - SENIORITY
          facetName: seniorities
          urn: urn:li:adTargetingFacet:seniorities
          availableEntityFinders:
          - AD_TARGETING_FACET
        - entityTypes:
          - COUNTRY_GROUP
          - COUNTRY
          - STATE
          - REGION
          facetName: locations
          urn: urn:li:adTargetingFacet:locations
          availableEntityFinders:
          - AD_TARGETING_FACET
          - TYPEAHEAD
        - entityTypes:
          - INTEREST
          facetName: interests
          urn: urn:li:adTargetingFacet:interests
          availableEntityFinders:
          - TYPEAHEAD
          - AD_TARGETING_FACET
    AdTargetingEntitiesResponseExample:
      summary: Location targeting entities
      value:
        paging:
          start: 0
          count: 10
          links:
          - type: application/json
            rel: next
            href: /rest/adTargetingEntities?q=typeahead&query=united%20states&start=10&count=10&facet=urn%3Ali%3AadTargetingFacet%3Alocations&queryVersion=QUERY_USES_URNS
        elements:
        - name: United States
          urn: urn:li:geo:103644278
          facetUrn: urn:li:adTargetingFacet:locations
        - name: California, United States
          urn: urn:li:geo:102095887
          facetUrn: urn:li:adTargetingFacet:locations
        - name: Texas, United States
          urn: urn:li:geo:102748797
          facetUrn: urn:li:adTargetingFacet:locations
        - name: New York, United States
          urn: urn:li:geo:105080838
          facetUrn: urn:li:adTargetingFacet:locations
        - name: Florida, United States
          urn: urn:li:geo:101318387
          facetUrn: urn:li:adTargetingFacet:locations
        - name: Los Angeles County, California, United States
          urn: urn:li:geo:103104382
          facetUrn: urn:li:adTargetingFacet:locations
        - name: New York, New York, United States
          urn: urn:li:geo:102571732
          facetUrn: urn:li:adTargetingFacet:locations
        - name: Illinois, United States
          urn: urn:li:geo:101949407
          facetUrn: urn:li:adTargetingFacet:locations
        - name: Pennsylvania, United States
          urn: urn:li:geo:102986501
          facetUrn: urn:li:adTargetingFacet:locations
        - name: Georgia, United States
          urn: urn:li:geo:103950076
          facetUrn: urn:li:adTargetingFacet:locations
    GetBingGeoLocationsResponse200Example:
      summary: Example 200 response for GetBingGeoLocations
      value:
        paging:
          start: 0
          count: 10
          links:
          - type: application/json
            rel: next
            href: /rest/adTargetingEntities?q=typeahead&query=united%20states&start=10&count=10&facet=urn%3Ali%3AadTargetingFacet%3Alocations&queryVersion=QUERY_USES_URNS
        elements:
        - name: United States
          urn: urn:li:geo:103644278
          facetUrn: urn:li:adTargetingFacet:locations
        - name: California, United States
          urn: urn:li:geo:102095887
          facetUrn: urn:li:adTargetingFacet:locations
        - name: Texas, United States
          urn: urn:li:geo:102748797
          facetUrn: urn:li:adTargetingFacet:locations
        - name: New York, United States
          urn: urn:li:geo:105080838
          facetUrn: urn:li:adTargetingFacet:locations
        - name: Florida, United States
          urn: urn:li:geo:101318387
          facetUrn: urn:li:adTargetingFacet:locations
        - name: Los Angeles County, California, United States
          urn: urn:li:geo:103104382
          facetUrn: urn:li:adTargetingFacet:locations
        - name: New York, New York, United States
          urn: urn:li:geo:102571732
          facetUrn: urn:li:adTargetingFacet:locations
        - name: Illinois, United States
          urn: urn:li:geo:101949407
          facetUrn: urn:li:adTargetingFacet:locations
        - name: Pennsylvania, United States
          urn: urn:li:geo:102986501
          facetUrn: urn:li:adTargetingFacet:locations
        - name: Georgia, United States
          urn: urn:li:geo:103950076
          facetUrn: urn:li:adTargetingFacet:locations
    GetAListOfResponse200Example:
      summary: Example 200 response for GetAListOf
      value:
        paging:
          start: 0
          count: 10
          links: []
        elements:
        - entityTypes:
          - FUNCTION
          facetName: jobFunctions
          $URN: urn:li:adTargetingFacet:jobFunctions
          availableEntityFinders:
          - AD_TARGETING_FACET
        - entityTypes:
          - AGE
          facetName: ageRanges
          $URN: urn:li:adTargetingFacet:ageRanges
          availableEntityFinders:
          - AD_TARGETING_FACET
        - entityTypes:
          - GROUP
          facetName: groups
          $URN: urn:li:adTargetingFacet:groups
          availableEntityFinders:
          - TYPEAHEAD
          - SIMILAR_ENTITIES
        - entityTypes:
          - COMPANY
          facetName: employers
          $URN: urn:li:adTargetingFacet:employers
          availableEntityFinders:
          - TYPEAHEAD
          - SIMILAR_ENTITIES
        - entityTypes:
          - $UNKNOWN
          facetName: dynamicSegments
          $URN: urn:li:adTargetingFacet:dynamicSegments
          availableEntityFinders:
          - $UNKNOWN
        - entityTypes:
          - COUNTRY_GROUP
          - COUNTRY
          - STATE
          - REGION
          facetName: profileLocations
          $URN: urn:li:adTargetingFacet:profileLocations
          availableEntityFinders:
          - AD_TARGETING_FACET
          - TYPEAHEAD
        - entityTypes:
          - GENDER
          facetName: genders
          $URN: urn:li:adTargetingFacet:genders
          availableEntityFinders:
          - AD_TARGETING_FACET
        - entityTypes:
          - COMPANY
          facetName: firstDegreeConnectionCompanies
          $URN: urn:li:adTargetingFacet:firstDegreeConnectionCompanies
          availableEntityFinders:
          - TYPEAHEAD
          - SIMILAR_ENTITIES
        - entityTypes:
          - FIRMOGRAPHIC
          facetName: companyCategory
          $URN: urn:li:adTargetingFacet:companyCategory
          availableEntityFinders:
          - AD_TARGETING_FACET
          - TYPEAHEAD
        - entityTypes:
          - TITLE
          facetName: titlesAll
          $URN: urn:li:adTargetingFacet:titlesAll
          availableEntityFinders:
          - AD_TARGETING_FACET
          - TYPEAHEAD
          - SIMILAR_ENTITIES
        - entityTypes:
          - LOCALE
          facetName: interfaceLocales
          $URN: urn:li:adTargetingFacet:interfaceLocales
          availableEntityFinders:
          - AD_TARGETING_FACET
        - entityTypes:
          - FIRMOGRAPHIC
          facetName: growthRate
          $URN: urn:li:adTargetingFacet:growthRate
          availableEntityFinders:
          - AD_TARGETING_FACET
        - entityTypes:
          - INDUSTRY
          facetName: industries
          $URN: urn:li:adTargetingFacet:industries
          availableEntityFinders:
          - AD_TARGETING_FACET
          - TYPEAHEAD
          - SIMILAR_ENTITIES
        - entityTypes:
          - TITLE
          facetName: titles
          $URN: urn:li:adTargetingFacet:titles
          availableEntityFinders:
          - AD_TARGETING_FACET
          - TYPEAHEAD
          - SIMILAR_ENTITIES
        - entityTypes:
          - COMPANY
          facetName: followedCompanies
          $URN: urn:li:adTargetingFacet:followedCompanies
          availableEntityFinders:
          - TYPEAHEAD
          - SIMILAR_ENTITIES
        - entityTypes:
          - SCHOOL
          facetName: schools
          $URN: urn:li:adTargetingFacet:schools
          availableEntityFinders:
          - TYPEAHEAD
        - entityTypes:
          - COMPANY_SIZE
          facetName: staffCountRanges
          $URN: urn:li:adTargetingFacet:staffCountRanges
          availableEntityFinders:
          - AD_TARGETING_FACET
        - entityTypes:
          - COMPANY
          facetName: employersPast
          $URN: urn:li:adTargetingFacet:employersPast
          availableEntityFinders:
          - TYPEAHEAD
          - SIMILAR_ENTITIES
        - entityTypes:
          - SKILL
          facetName: skills
          $URN: urn:li:adTargetingFacet:skills
          availableEntityFinders:
          - AD_TARGETING_FACET
          - TYPEAHEAD
          - SIMILAR_ENTITIES
        - entityTypes:
          - MEMBER_BEHAVIOR
          facetName: memberBehaviors
          $URN: urn:li:adTargetingFacet:memberBehaviors
          availableEntityFinders:
          - AD_TARGETING_FACET
          - TYPEAHEAD
        - entityTypes:
          - $UNKNOWN
          facetName: audienceMatchingSegments
          $URN: urn:li:adTargetingFacet:audienceMatchingSegments
          availableEntityFinders:
          - $UNKNOWN
        - entityTypes:
          - FIELD_OF_STUDY
          facetName: fieldsOfStudy
          $URN: urn:li:adTargetingFacet:fieldsOfStudy
          availableEntityFinders:
          - AD_TARGETING_FACET
          - TYPEAHEAD
        - entityTypes:
          - YEARS_OF_EXPERIENCE
          facetName: yearsOfExperienceRanges
          $URN: urn:li:adTargetingFacet:yearsOfExperienceRanges
          availableEntityFinders:
          - AD_TARGETING_FACET
        - entityTypes:
          - DEGREE
          facetName: degrees
          $URN: urn:li:adTargetingFacet:degrees
          availableEntityFinders:
          - AD_TARGETING_FACET
          - TYPEAHEAD
        - entityTypes:
          - SENIORITY
          facetName: seniorities
          $URN: urn:li:adTargetingFacet:seniorities
          availableEntityFinders:
          - AD_TARGETING_FACET
        - entityTypes:
          - COUNTRY_GROUP
          - COUNTRY
          - STATE
          - REGION
          facetName: locations
          $URN: urn:li:adTargetingFacet:locations
          availableEntityFinders:
          - AD_TARGETING_FACET
          - TYPEAHEAD
        - entityTypes:
          - TITLE
          facetName: titlesPast
          $URN: urn:li:adTargetingFacet:titlesPast
          availableEntityFinders:
          - AD_TARGETING_FACET
          - TYPEAHEAD
          - SIMILAR_ENTITIES
        - entityTypes:
          - COMPANY
          facetName: employersAll
          $URN: urn:li:adTargetingFacet:employersAll
          availableEntityFinders:
          - TYPEAHEAD
          - SIMILAR_ENTITIES
        - entityTypes:
          - FIRMOGRAPHIC
          facetName: revenue
          $URN: urn:li:adTargetingFacet:revenue
          availableEntityFinders:
          - AD_TARGETING_FACET
        - entityTypes:
          - INTEREST
          facetName: interests
          $URN: urn:li:adTargetingFacet:interests
          availableEntityFinders:
          - TYPEAHEAD
          - AD_TARGETING_FACET
  securitySchemes:
    OAuth2Auth:
      type: oauth2
      flows:
        authorizationCode:
          authorizationUrl: https://www.linkedin.com/oauth/v2/authorization
          tokenUrl: https://www.linkedin.com/oauth/v2/accessToken
          scopes:
            r_ads: Read advertising data
x-refined-from:
- linkedin-marketing-audience-insights.yml
- linkedin-marketing-media-planning.yml