Search Meta Targeting
User wants to find targeting options for their Meta (Facebook/Instagram) ad campaigns.
This tool searches the Meta Marketing API to find targeting options including interests, behaviors, demographics, locations, and more.
Returns:
- List of targeting options with IDs, names, and audience sizes
- Category/path information for interests and behaviors
- Location details including country, region for geo-targeting
When to use this tool:
- “Find interests related to fitness”
- “What targeting options are available for travel?”
- “Search for locations in California”
- “Find behaviors for online shoppers”
- “What demographics can I target?”
- “Find job titles for marketing professionals”
- “Search for schools like Harvard”
Search Types Available:
- interest: Topics and activities (e.g., ‘fitness’, ‘cooking’, ‘travel’)
- behavior: User behaviors (e.g., ‘frequent travelers’, ‘online shoppers’)
- demographic: Demographics (e.g., ‘new parents’, ‘college educated’)
- life_event: Life events (e.g., ‘recently moved’, ‘newly engaged’)
- location: Geo-targeting (e.g., ‘New York’, ‘California’, ‘90210’)
- locale: Language targeting (e.g., ‘Spanish’, ‘French’)
- employer: Employer targeting (e.g., ‘Google’, ‘Microsoft’)
- job_title: Job title targeting (e.g., ‘Software Engineer’)
- school: Education school targeting (e.g., ‘Harvard’, ‘Stanford’)
- major: Education major targeting (e.g., ‘Computer Science’)
Parameters:
- search_type: Type of targeting to search (required)
- query: Search query string (required)
- limit: Maximum results (1-100, default: 50)
- locale: Locale for results (default: en_US)
- location_types: For location search - filter by types (country, region, city, zip)
- country_code: For location search - filter by country (e.g., ‘US’)
- ad_account_id: Required for multi-account users. Get from list_connected_accounts
Execution time: 1-3 seconds Data source: Meta Marketing API Targeting Search
Authorizations
API key from https://adspirer.ai/keys. Prefix sk_live_. Treat as a secret — never commit.
Headers
Client-generated UUID to make writes idempotent. Strongly recommended for write tools. A repeat call with the same key returns the cached result instead of re-executing. Example: 550e8400-e29b-41d4-a716-446655440000
Body
All tool arguments are wrapped in an arguments object. The fields accepted inside arguments are listed below — required fields are marked with a red asterisk.
Input schema for Meta targeting search
Response
Tool executed successfully. data.text carries the human-readable result (markdown-friendly). data.quota shows your current usage against the plan limit. data.structured appears when the tool emits machine-parseable structured content. data.content appears for tools that return non-text blocks (images, resources).
Returned on HTTP 200. data.text is the primary human-readable output. data.quota is always present for billable calls. data.structured is set only when the tool emits machine-parseable structured content. data.content is set only when the tool emits non-text content blocks.