account | DynamicAccount | Yes | - | Select Meta Ads account, ask the user for it if not provided |
search_type | string or SelectableOption | Yes | - | The type of targeting to search for. Options: adgeolocation (countries, cities, regions, zips, etc.), adlocale (languages), adinterest (interests for audience targeting), adbehavior (browse all available behaviors), adeducationschool (schools/universities), adeducationmajor (fields of study), adworkemployer (companies), adworkposition (job titles), adincome (browse all available income ranges) |
search_query | string | No | - | Search term — e.g. a city name, language, interest, school name, job title, etc. Required for most types. Optional for Behaviors and Income (these browse all available options). |
location_types | array of string or SelectableOption | No | - | Only used when search_type is ‘adgeolocation’. Filter results to specific location types: country, country_group, region, city, zip, geo_market, electoral_district. Leave empty to search all location types. |
limit | integer | No | 25 | Maximum number of results to return (1-1000). Default: 25 |