meta_ads_targeting_categories
Retrieve the complete list of Meta targeting categories for a given class (behaviors, demographics, etc.) with IDs and audience sizes. Use for ad set targeting when keyword search is unsupported.
Instructions
Lists a full Meta targeting category catalogue for the given class — behaviors (e.g. 'Facebook Page admins'), demographics, life_events, industries, income, family_statuses, user_device, or user_os — with the internal IDs used in an ad set's targeting spec. Returns id, name, audience_size_lower_bound, audience_size_upper_bound, path, and an optional description per category. Read-only. Use this for behavior / demographic targeting, where keyword search (meta_ads_targeting_search) is not supported — the catalogue is finite, so this returns the whole class.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum categories returned. Default 200 — larger than search results because catalogues are finite but sizeable. | |
| locale | No | Optional Graph locale (e.g. 'ja_JP') to return localized category names. Omitted when unset. | |
| account_id | No | Meta Ads account ID in the format 'act_XXXXXXXXXX' (e.g. 'act_1234567890'). Optional — falls back to META_ADS_ACCOUNT_ID from the configured credentials. The leading 'act_' prefix is required. | |
| category_class | Yes | Targeting category class to enumerate. Maps to Graph's 'class' query param (renamed here because 'class' is a Python keyword). |