# TargetingSpec
## Properties
Name | Type | Description | Notes
------------ | ------------- | ------------- | -------------
**user_os** | Option<**Vec<String>**> | Meta only. Operating systems and version ranges, such as iOS_ver_14.0_and_above or Android. Emitted as user_os. May also be supplied inside targeting. | [optional]
**user_device** | Option<**Vec<String>**> | Meta only. Device models such as iPhone. Emitted as user_device. May also be supplied inside targeting. | [optional]
**countries** | Option<**Vec<String>**> | ISO 3166-1 alpha-2 country codes (e.g. ['US']). | [optional]
**regions** | Option<[**Vec<models::CreateStandaloneAdRequestZipsInner>**](CreateStandaloneAdRequestZipsInner.md)> | Region/state targeting. `key` is the platform location ID from /v1/ads/targeting/search?dimension=geo&geoType=region. An entry may also be that id as a plain string (`\"20321\"` is `{ key: \"20321\" }`). | [optional]
**cities** | Option<[**Vec<models::TargetingSpecCitiesInner>**](TargetingSpecCitiesInner.md)> | City targeting. Optional `radius` + `distanceUnit` extend beyond the city limits; both must be set together or both omitted. `radius` is only honoured on platforms whose capability map allows city radius (Meta). An entry may also be the city id as a plain string (`\"1006410\"` is `{ key: \"1006410\" }`). | [optional]
**zips** | Option<[**Vec<models::UpdateCampaignTargetingRequestTargetingLocationsOneOfRegionsInnerOneOf>**](UpdateCampaignTargetingRequestTargetingLocationsOneOfRegionsInnerOneOf.md)> | Postal/ZIP targeting. `key` is the platform's postal location ID (e.g. Meta `US:94304`). Supported on Meta, Google, TikTok, Pinterest, X. | [optional]
**metros** | Option<[**Vec<models::UpdateCampaignTargetingRequestTargetingLocationsOneOfRegionsInnerOneOf>**](UpdateCampaignTargetingRequestTargetingLocationsOneOfRegionsInnerOneOf.md)> | DMA / metro-area targeting. `key` is the platform's metro ID (e.g. Meta `DMA:807`). | [optional]
**country_groups** | Option<**Vec<CountryGroups>**> | Meta only. Continents and trade blocs (`geo_locations.country_groups`), for targeting a whole region without listing its countries. Combines with `countries` rather than replacing it, and is also accepted under `excludedLocations`. Discoverable via `GET /v1/ads/targeting/search?dimension=geo&geoType=country_group`. (enum: africa, asia, europe, north_america, south_america, oceania, central_america, caribbean, eea, euro_area, nafta, mercosur, afta, apec, gcc, cisfta, emerging_markets, itunes_app_store, android_free_store, android_paid_store) | [optional]
**custom_locations** | Option<[**Vec<models::TargetingSpecCustomLocationsInner>**](TargetingSpecCustomLocationsInner.md)> | Point-radius (lat/lng) targeting (Meta custom_locations / Google proximity). Honoured on Meta and Google; ignored on platforms without radius support. | [optional]
**excluded_locations** | Option<[**models::TargetingSpecExcludedLocations**](TargetingSpecExcludedLocations.md)> | | [optional]
**age_min** | Option<**i32**> | Minimum age. - Applied on Meta, TikTok, Pinterest, LinkedIn, X and Google Search/Display (Google excludes the age ranges outside the request). - Rejected with 400 on OpenAI, Reddit and Google Performance Max / Demand Gen. Each platform clamps to its own range: - Meta and Pinterest: effectively cap at 65 (65 = 65+). - Pinterest: no under-18 bucket, so an ageMin below 18 starts at 18. - TikTok: maps up to 100. - LinkedIn: rounds out to its buckets (18-24, 25-34, 35-54, 55+) and has no under-18 audience. - X: rounds out to the narrowest of its fixed ranges (e.g. 25-34 becomes 25-49, 18-65 becomes 18+). | [optional]
**age_max** | Option<**i32**> | Maximum age. Same per-platform application and clamping as ageMin. | [optional]
**gender** | Option<**Gender**> | Restrict by gender. 'all' (default) targets everyone. Applied on Meta, TikTok, Pinterest, LinkedIn, X, Reddit and Google Search/Display (Google excludes the other gender); rejected with 400 on OpenAI and on Google Performance Max / Demand Gen. (enum: all, male, female) | [optional]
**income_tier** | Option<**IncomeTier**> | Normalized household-income tier (ZIP/percentile based). Meta and TikTok express all four. Google maps only `top_10` (its INCOME_RANGE_90_UP); other tiers on Google, and any income tier on LinkedIn / X / Pinterest, are rejected. On Meta, income/zip targeting requires the relevant `specialAdCategories` to be unset (housing/employment/credit ads cannot use it). (enum: top_5, top_10, top_10_25, top_25_50) | [optional]
**languages** | Option<**Vec<String>**> | Language codes restricting the audience by language. Applied on Meta, Google, TikTok, LinkedIn, X, Pinterest and Reddit; rejected with 400 on OpenAI. A code the platform cannot target returns 400 listing the ones it can. On Meta: ISO 639-1 codes (e.g. ['en']). A bare code targets all regional variants (\"en\" = all English); use a region-qualified code (\"en_GB\", \"pt_BR\") for a specific one. Meta numeric locale ids (e.g. \"24\" for English UK) are also accepted. Unknown values are rejected. POST /v1/ads/create and POST /v1/ads/boost take the same format. | [optional]
**interests** | Option<[**Vec<models::CreateStandaloneAdRequestBehaviorsInner>**](CreateStandaloneAdRequestBehaviorsInner.md)> | Interest entities from /v1/ads/targeting/search?dimension=interest. Each carries the platform's opaque id. - Google: applied as ad-group interest criteria (affinity and in-market categories) on Display and Search ad groups the request creates. Interests are create-only. - Google rejections (400): on Performance Max, on Demand Gen (use the Demand Gen audience `userInterests` there), and when attaching to an existing ad group (`adSetId`). - OpenAI: rejected with 400. - TikTok: bare numeric ids are interest categories (`interest_category_ids`); ids like `keyword:123456` from `dimension=interestKeyword` are additional interests (`interest_keyword_ids`). Any other id returns 422 naming `targeting.interests`. - TikTok matching: people who fit ANY selected interest, additional interest or behavior (one OR'd group). That group is ANDed with location, age, gender and the other dimensions. | [optional]
**behaviors** | Option<[**Vec<models::CreateStandaloneAdRequestBehaviorsInner>**](CreateStandaloneAdRequestBehaviorsInner.md)> | Behaviour entities from /v1/ads/targeting/search?dimension=behavior (Meta, TikTok and LinkedIn). **On TikTok** they target people who, in the picked categories: - interacted with videos (watched to the end, liked, commented or shared, last 15 days); - interacted with creators (followed or viewed the profile); - or viewed videos with a picked hashtag (`hashtag:<id>` ids from `dimension=hashtag`, sent as a `HASHTAG_RELATED` action with `VIEW_HASHTAG`). The ad group then uses the TikTok placement only. Behaviors are OR'd with interests and additional interests. | [optional]
**work_positions** | Option<[**Vec<models::CreateStandaloneAdRequestBehaviorsInner>**](CreateStandaloneAdRequestBehaviorsInner.md)> | Meta only. Job title entities from /v1/ads/targeting/search?dimension=workPosition. Not interchangeable with the LinkedIn `jobTitles` URN fragments. | [optional]
**work_employers** | Option<[**Vec<models::CreateStandaloneAdRequestBehaviorsInner>**](CreateStandaloneAdRequestBehaviorsInner.md)> | Meta only. Employer entities from /v1/ads/targeting/search?dimension=workEmployer. | [optional]
**work_industries** | Option<[**Vec<models::CreateStandaloneAdRequestBehaviorsInner>**](CreateStandaloneAdRequestBehaviorsInner.md)> | Meta only. Work-industry entities from /v1/ads/targeting/search?dimension=workIndustry. Not interchangeable with the LinkedIn `industries` URN fragments. | [optional]
**industries** | Option<**Vec<String>**> | LinkedIn B2B only. Industry URN id fragments, or the full urn:li:industry:* URN from /v1/ads/targeting/search?dimension=industry. | [optional]
**company_sizes** | Option<**Vec<String>**> | LinkedIn B2B only. Single-letter size codes (A to I), or the full urn:li:staffCountRange:* URN from /v1/ads/targeting/search?dimension=companySize. | [optional]
**seniorities** | Option<**Vec<String>**> | LinkedIn B2B only. Seniority URN id fragments, or the full urn:li:seniority:* URN from /v1/ads/targeting/search?dimension=seniority. | [optional]
**job_functions** | Option<**Vec<String>**> | LinkedIn B2B only. Function URN id fragments, or the full urn:li:function:* URN from /v1/ads/targeting/search?dimension=jobFunction. | [optional]
**skills** | Option<**Vec<String>**> | LinkedIn B2B only. Member skills (e.g. Python, Recruiting): skill URN id fragments, or the full urn:li:skill:* URN from /v1/ads/targeting/search?dimension=skill. Values are ORed; the facet is ANDed with the other facets. On an ad set update an empty list removes the skills. | [optional]
**audience_include** | Option<**Vec<String>**> | Platform audience IDs to include, as returned by GET /v1/ads/audiences: - Meta: custom audience ids. - TikTok: audience ids. - Pinterest: customer list ids. - LinkedIn: segment ids (the platformAudienceId from GET /v1/ads/audiences). Zernio resolves it to the targetable LinkedIn ad segment; an unknown id returns 400. - Google: user list ids. - X: custom audience ids. - Reddit: ids of custom audiences built in Reddit Ads Manager (GET /v1/ads/audiences does not list Reddit audiences). - OpenAI: not supported (400). | [optional]
**audience_exclude** | Option<**Vec<String>**> | Platform audience IDs to exclude; same ID formats as audienceInclude. Not supported on OpenAI (400). | [optional]
**communities** | Option<**Vec<String>**> | Reddit only (400 elsewhere). Subreddits to target, by name, with or without the `r/` prefix (e.g. `['marketing', 'r/startups']`), as returned by /v1/ads/targeting/search?dimension=community. | [optional]
**excluded_communities** | Option<**Vec<String>**> | Reddit only (400 elsewhere). Subreddits to exclude, named like `communities`. | [optional]
**conversation_keywords** | Option<**Vec<String>**> | Reddit only (400 elsewhere). Keywords that place the ad in Reddit conversations about them, as returned by /v1/ads/targeting/search?dimension=conversationKeyword. | [optional]
**excluded_conversation_keywords** | Option<**Vec<String>**> | Reddit only (400 elsewhere). Conversation keywords to keep the ad away from. | [optional]
[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)