LinkedIn Ads

Resolve LinkedIn targeting entities

Turns plain words into the LinkedIn targeting URNs a campaign actually accepts — job titles, industries, seniorities, company-size bands, locations, skills, interests, member behaviours, employers, degrees, fields of study and interface locales. Use when: before every create or update that touches targeting, without exception. A campaign payload takes URNs and nothing else, and there is no fuzzy match on the write path: an invented URN either errors or targets strangers. Do not guess a URN, reuse one from a demographic report (those are report labels), or copy one between accounts without checking it here first. Do not pass a user's phrase straight into a create tool — that is what this tool exists to prevent. Returns matching entities with their URN and display name — a location's name already carries its parents ("Sacramento, California, United States"). Seniorities, staffCountRanges and interfaceLocales are short fixed lists: when nothing matches the query, the whole list comes back for the user to choose from. interfaceLocales is the language members use LinkedIn in (one locale per language, e.g. urn:li:locale:en_US for all English), never a country. Costs nothing, so run it as many times as the audience needs facets. If a search returns nothing, try a shorter or more common phrasing (LinkedIn matches on its own canonical titles), and if it still fails tell the user that facet cannot be targeted rather than substituting something close.

post/api/v1/tools/linkedin_search_targeting/execute

Request

  • Base URL: https://adako.ai
  • URL: https://adako.ai/api/v1/tools/linkedin_search_targeting/execute
  • Auth: HTTP bearer

Headers

Idempotency-Keystring

Optional 8-128 character key. A successful envelope is cached for 24 hours; replaying the key with the same arguments returns it again with Idempotent-Replayed: true, and replaying it with different arguments answers 409.

Request body

Response

The tool ran. A write returns proposal_id and approve_url while the change waits for approval.

successunknown required
toolstring required
dataobject required

Machine-readable result.

markdownstring required

The same result written for a person or a model.

proposal_idstring

Present for writes. Nothing changes on the ad platform until it is approved.

approve_urlstring

Where a person approves the proposal.

request_idstring required

Changes

No recorded changes to this operation across all 1 revision of this API.