LinkedIn Ads Audiences: Targeting Entities

Resolve targeting names to the URNs targetingCriteria requires: typeahead search within a facet (titles, locations, employers, skills), full dumps of small.

Tool ID: linkedin_ads_audiences_targeting_entities

Run this action

Use the TypeScript SDK for a single call. Put ctx.tools.execute(...) inside a Play when the call should be durable, scheduled, or run across a CSV.

import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'linkedin_ads_audiences_targeting_entities',
  {
    "finder": "typeahead"
  },
);

console.log(result.toolResponse.raw);

CLI

deepline tools execute linkedin_ads_audiences_targeting_entities --input '{
  "finder": "typeahead"
}' --json

Example response

The SDK exposes this shape at result.toolResponse.raw. Values below are representative.

{
  "data": {
    "entities": [
      {
        "urn": "example",
        "name": "Example",
        "facet_urn": "example"
      }
    ]
  }
}

Use deepline tools get linkedin_ads_audiences_targeting_entities --json for the latest machine-readable contract.

Input reference

Name	Type	Required	Default	Details
`payload.finder`	`"typeahead" \| "ad_targeting_facet" \| "similar_entities" \| "urns"`	Yes	—	Which adTargetingEntities finder to run: ‘typeahead’ searches a facet by text (LinkedIn’s recommended finder for titles, locations, employers, skills, industries); ‘ad_targeting_facet’ dumps every entity in a small facet (jobFunctions, seniorities, staffCountRanges); ‘similar_entities’ expands from known entity URNs; ‘urns’ resolves entity URNs back to names. Allowed: `typeahead`, `ad_targeting_facet`, `similar_entities`, `urns`.
`payload.facet`	`string`	No	—	Targeting facet, as a short name (‘titles’, ‘locations’, ‘jobFunctions’) or full urn:li:adTargetingFacet:* URN. Required for every finder except ‘urns’. Minimum length: 1.
`payload.query`	`string`	No	—	Search text. Required for the ‘typeahead’ finder. Minimum length: 1.
`payload.entities`	`array`	No	—	Entity URNs to expand from. Required for the ‘similar_entities’ finder. Minimum items: 1.
`payload.urns`	`array`	No	—	Entity URNs to resolve to names. Required for the ‘urns’ finder. Minimum items: 1.
`payload.entity_type`	`string`	No	—	Optional LinkedIn entityType filter such as TITLE, SKILL, FUNCTION, SENIORITY, INDUSTRY, COMPANY. Minimum length: 1.
`payload.locale_language`	`string`	No	`"en"`	Minimum length: 2. Maximum length: 2.
`payload.locale_country`	`string`	No	`"US"`	Minimum length: 2. Maximum length: 2.

Output reference

Name	Type	Required	Default	Details
`result.data`	`object`	Yes	—	—
`result.data.entities`	`array`	Yes	—	—
`result.data.entities[].urn`	`string`	Yes	—	—
`result.data.entities[].name`	`string \| null`	Yes	—	—
`result.data.entities[].facet_urn`	`string \| null`	Yes	—	—

Deepline cost

Pricing model: fixed (per call).
Estimated Deepline credits: 0 per pricing unit.

Getting Started

GTM is code

Features

Deepline SDK beta

Integrations

API Reference

LinkedIn Ads Audiences: Targeting Entities

Run this action

CLI

Example response

Input reference

Output reference

Deepline cost

​Run this action

​CLI

​Example response

​Input reference

​Output reference

​Deepline cost

​Related documentation

Run this action

CLI

Example response

Input reference

Output reference

Deepline cost

Related documentation