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. |
