> ## Documentation Index
> Fetch the complete documentation index at: https://docs.markifact.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Search Targeting

> Search, browse, and resolve LinkedIn Ads targeting categories and values

Search, browse, and resolve LinkedIn Ads targeting categories and values. Use this before creating ad sets to find valid targeting URNs for targeting\_criteria.

|                      |                                 |
| -------------------- | ------------------------------- |
| **App**              | LinkedIn Ads                    |
| **Operation ID**     | `linkedin_ads_search_targeting` |
| **Type**             | Action                          |
| **Connection**       | `linkedin_ads` (required)       |
| **Credits per run**  | Free                            |
| **Agent / MCP tool** | Yes                             |

## Inputs

| Field             | Type                       | Required | Default                                            | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| ----------------- | -------------------------- | -------- | -------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `search_mode`     | string or SelectableOption | Yes      | -                                                  | How to discover LinkedIn targeting values. Use facets to list available audience categories. Use typeahead to search user-entered text for locations, job titles, companies, schools, skills, interests, and similar searchable categories. Use entities\_by\_facet to browse fixed lists such as seniorities, job functions, company sizes, age ranges, member behaviors, and interface languages. Use urns to resolve known URNs to names. Use similar\_entities to find related entities from seed URNs. |
| `facet`           | string or SelectableOption | No       | -                                                  | Targeting category, also called a LinkedIn facet. This is the audience bucket to search inside and the key used later in create ad set targeting\_criteria. Examples: locations, industries, titles, employers, seniorities, jobFunctions, staffCountRanges, skills, schools, or urn:li:adTargetingFacet:locations. Required for typeahead, entities\_by\_facet, and similar\_entities. Do not use entity\_type instead of facet; entity\_type only narrows results inside a facet.                         |
| `query`           | string                     | No       | -                                                  | Search text for typeahead mode, for example United States, Dubai, marketing manager, software, HubSpot, or economics. Required only when the selected facet supports LinkedIn typeahead, such as locations, titles, employers, skills, schools, industries, or interests. Optional for browse-only facets such as jobFunctions, seniorities, staffCountRanges, ageRanges, interfaceLocales, and yearsOfExperienceRanges; those are listed from LinkedIn and filtered locally when query is present.         |
| `urns`            | string                     | No       | -                                                  | One or more LinkedIn entity URNs for urns or similar\_entities mode. Accepts a JSON array, comma-separated text, or one URN per line. Examples: urn:li:geo:103644278, urn:li:title:25170, urn:li:organization:1035.                                                                                                                                                                                                                                                                                         |
| `entity_type`     | string or SelectableOption | No       | -                                                  | Optional result-type filter, not the targeting category. Use only to narrow typeahead or similar\_entities results inside the selected facet. Examples: TITLE, COMPANY, INDUSTRY, SKILL, SCHOOL, SENIORITY, FUNCTION, FIELD\_OF\_STUDY, MEMBER\_BEHAVIOR, LOCALE. Usually leave empty. If the user asks for job titles, set facet=titles; entity\_type=TITLE is optional. If the user asks for companies, set facet=employers; entity\_type=COMPANY is optional.                                            |
| `locale_language` | string                     | No       | `en`                                               | Two-letter lowercase response locale language. Defaults to en.                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| `locale_country`  | string                     | No       | `US`                                               | Two-letter uppercase response locale country. Defaults to US.                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| `fetch_type`      | string or SelectableOption | No       | `{'value': 'SINGLE_NODE', 'label': 'Single node'}` | URN resolution only. SINGLE\_NODE resolves exactly the requested URNs. LAZY can include descendants when LinkedIn supports it.                                                                                                                                                                                                                                                                                                                                                                              |
| `limit`           | integer                    | No       | `100`                                              | Maximum normalized results to return. Defaults to 100.                                                                                                                                                                                                                                                                                                                                                                                                                                                      |

### SelectableOption

| Field   | Type   | Required | Default | Description |
| ------- | ------ | -------- | ------- | ----------- |
| `value` | string | Yes      | -       |             |
| `label` | string | Yes      | -       |             |

## Output

**Type**: `List[Dict]`

Returns normalized LinkedIn targeting facets or entity values with URNs that can be used in create ad set targeting\_criteria.

**Fields**: `urn`, `id`, `name`, `facet_urn`, `facet_name`, `targeting_criteria_key`, `targeting_criteria_value`, `example_targeting_criteria`