Create Facebook Native Criteria Audience
create_facebook_native_criteria_audienceCreate a Facebook native criteria audience using Facebook-supported targeting criteria. Build audiences based on Facebook native industries, geographic location, job titles, interests, and age range.
ESTIMATE-ONLY MODE:
Pass estimate_only=true to preview audience size WITHOUT creating the audience. In this mode the tool
returns expectedNumberOfContacts. Default is false.
ALSO KNOWN AS: Facebook audience, FB criteria audience, native Facebook targeting, Facebook lead audience
KEYWORDS: Facebook, native, criteria, audience, industry, location, job title, interest, age, lead, targeting
WHEN TO USE:
- Create targeted Facebook audiences using native Facebook criteria
- Target users by Facebook industry categories (e.g., IT and Technical Services, Sales, Management)
- Target by geographic countries, job titles, interests, and age range
- Build lead generation audiences for Facebook campaigns
INDUSTRIES:
Facebook native industry categories - provide the industry name as a string:
Administrative Services, Architecture and Engineering, Arts Entertainment Sports and Media,
Business and Finance, Business decision maker titles and interests, Cleaning and Maintenance Services,
Community and Social Services, Computation and Mathematics, Construction and Extraction,
Education and Libraries, Farming Fishing and Forestry, Food and Restaurants,
Government Employees (Global), Healthcare and Medical Services, Installation and Repair Services,
IT and Technical Services, Large business-to-business enterprise employees (500+ employees),
Legal Services, Life Physical and Social Sciences, Management,
Medium business-to-business enterprise employees (200 - 500 employees), Production, Sales,
Small business-to-business enterprise employees (10-200 employees), Transportation and Moving
PARAMETERS:
- name: Audience name (required)
- min_age: Minimum age for targeting (required) - must be between 21 and 65
- max_age: Maximum age for targeting (required) - must be between 21 and 65, and >= min_age
- industries: Array of Facebook native industry names (optional)
- countries: List of country names for location targeting (optional) - each must match a country from the platform's supported countries list
- job_titles: Array of free-text job title strings (optional) - e.g., ["Software Engineer", "Product Owner"]
- interests: Array of free-text interest strings (optional) - e.g., ["Java", "Python", "Cloud Computing"]
RETURNS:
Parsed audience criteria with resolved Facebook reference IDs and validated parameters.
IMPORTANT NOTES:
- name, min_age and max_age are required, all other parameters are optional
- Industries must be valid Facebook native industry names from the enum list
- Countries must be valid country names from the platform's supported countries list
- min_age and max_age must both be between 21 and 65, with min_age <= max_age
- Job titles and interests are free-text arrays
- Job titles and interests are validated by the backend API with the regex pattern [A-Za-z0-9 ]+ (only ASCII letters, digits, and spaces are allowed). Non-ASCII characters, hyphens, and special characters will be automatically replaced with spaces before resolving references (e.g., "co-founder" becomes "co founder"). When providing job titles or interests, use only alphanumeric characters and spaces.Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Audience name (required). | |
| max_age | Yes | Maximum age for audience targeting. Must be between 21 and 65, and greater than or equal to min_age. | |
| min_age | Yes | Minimum age for audience targeting. Must be between 21 and 65, and less than or equal to max_age. | |
| countries | No | List of country names to target. Each must be a valid country name (e.g., ['United States', 'Brazil']). Resolved to platform country IDs before submission. | |
| interests | No | Free-text interest strings for targeting. Example: ['Java', 'Python', 'Cloud Computing', 'Machine Learning'] | |
| industries | No | Facebook native industry categories for audience targeting. Valid values: Administrative Services, Architecture and Engineering, Arts, Entertainment, Sports and Media, Business and Finance, Business decision maker titles and interests, Cleaning and Maintenance Services, Community and Social Services, Computation and Mathematics, Construction and Extraction, Education and Libraries, Farming, Fishing and Forestry, Food and Restaurants, Government Employees (Global), Healthcare and Medical Services, Installation and Repair Services, IT and Technical Services, Large business-to-business enterprise employees (500+ employees), Legal Services, Life, Physical and Social Sciences, Management, Medium business-to-business enterprise employees (200 - 500 employees), Production, Sales, Small business-to-business enterprise employees (10-200 employees), Transportation and Moving. Example: ['IT and Technical Services', 'Sales'] | |
| job_titles | No | Free-text job title strings for targeting. Example: ['Software Engineer', 'Senior Developer', 'Product Owner'] | |
| estimate_only | No | If true, do NOT create the audience — only estimate its size and return the expected contact count. Use this when the user wants to preview Facebook audience size before committing. Defaults to false (audience is created). |