search_linkedin_targeting

LinkedIn Ads Read

User needs to find targeting URNs for LinkedIn campaigns

Endpoint

POST https://api.adspirer.ai/api/v1/tools/search_linkedin_targeting/execute

Headers

Authorization: Bearer sk_live_... — your Adspirer API key (required)
Content-Type: application/json (required)
Idempotency-Key: <uuid> — recommended for write operations to make retries safe

Description

User needs to find targeting URNs for LinkedIn campaigns.

Search for targeting entities like job titles, industries, skills, locations, etc.

Facet Types:
- job_titles, industries, skills, locations
- seniorities, company_sizes, job_functions
- interests, degrees, fields_of_study
- employers, groups

Returns:
- List of matching entities with URNs and names
- URNs can be used in campaign targeting

Example Prompts:
- "Find LinkedIn targeting for software engineers"
- "Search for marketing job titles on LinkedIn"
- "Find LinkedIn industry targeting for SaaS"

Execution time: 2-3 seconds

Request body

All tool arguments are wrapped in an arguments object.

Field	Type	Description
`facet_type`	`string` required	Type of targeting to search: job_titles, industries, skills, locations, seniorities, company_sizes, job_functions, interests, etc.
`query`	`string` required	Search query
`limit`	`integer` optional	Maximum results to return (default: 25) default: `25`
`account_id`	`string` optional	LinkedIn Ad Account ID. Required for multi-account users. Get from list_connected_accounts.

Example request

{
  "arguments": {
    "facet_type": "string",
    "query": "string",
    "limit": 25,
    "account_id": "string"
  }
}

Example responses

200 — Success

{
  "success": true,
  "data": {
    "text": "(tool-specific textual output for search_linkedin_targeting)",
    "quota": {
      "used": 42,
      "limit": 150,
      "tier": "plus",
      "period_end": "2026-05-01"
    }
  },
  "tool": "search_linkedin_targeting"
}

400 — Tool-level error (bad arguments / multi-account selection)

{
  "success": false,
  "error": "You have 25 meta_ads accounts connected. Please specify which account to use by passing the ad_account_id parameter:\n  - Acme Holdings (ad_account_id=\"act_123456789\")\n  - Acme EU (ad_account_id=\"act_987654321\")",
  "is_error": true,
  "tool": "search_linkedin_targeting"
}

402 — Quota exhausted

{
  "success": false,
  "error": "\ud83d\udea8 Monthly limit reached (150/150 tool calls on Plus tier).\nUpgrade to Pro at https://adspirer.ai to keep building.",
  "is_error": true,
  "tool": "search_linkedin_targeting",
  "quota": {
    "used": 150,
    "limit": 150,
    "tier": "plus",
    "period_end": "2026-05-01",
    "upgrade_url": "https://adspirer.ai"
  }
}

Try it live

Interactive: Swagger UI

Machine-readable: OpenAPI 3.1 spec · llms-full.txt

More tools: LinkedIn Ads · All tools

Adspirer REST API — get an API key at adspirer.ai/keys · adspirer.ai