Salem Salleh
02/17/2026, 4:07 PMkapa.ai
02/17/2026, 4:07 PMads_insights, campaigns, ad_sets, ads, etc., and you can list or search insights records via the ads_insights entity. [[FB‑Mktg entities](https://docs.airbyte.com/ai-agents/connectors/facebook-marketing#full-documentation); [Ads insights search](https://docs.airbyte.com/ai-agents/connectors/facebook-marketing/REFERENCE#ads-insights-search)] However, the provided reference pages only describe generic query/filter parameters and do not enumerate the available metrics/dimensions or show any demographic fields. Because of that, I cannot confirm from these docs that age/gender breakdowns are currently available through this connector, nor how exactly you would specify them (e.g., which field names to use). What we can see is: - You can query ads_insights with filters and other conditions, for example: python await facebook_marketing.ads_insights.search( query={"filter": {"eq": {"account_id": "<str>"}}} ) [[Ads insights search](https://docs.airbyte.com/ai-agents/connectors/facebook-marketing/REFERENCE#ads-insights-search)] - The search API supports operators like eq, neq, gt, gte, lt, lte, in, like, fuzzy, keyword, not, and, or, and lets you specify fields to include in results. [[Ads insights search](https://docs.airbyte.com/ai-agents/connectors/facebook-marketing/REFERENCE#ads-insights-search)] But the docs here do not list which fields are valid for demographics. So, based only on the available knowledge sources: - It is clear you can query ads_insights. - It is not documented here whether demographic dimensions like age and gender are exposed, or what their exact field names are. - Therefore I cannot give a reliable, field‑level example for fetching age/gender via this connector. If you have access to the full connector reference outside these excerpts, you’d need to check the ads_insights response schema or field list there to see if demographic dimensions are supported and then pass them via the fields parameter in your ads_insights.list or ads_insights.search calls.kapa.ai
02/17/2026, 4:07 PMkapa.ai
02/17/2026, 4:08 PMads_insights entity in the Facebook‑Marketing agent connector, so I cannot confirm from these docs that age/gender is currently supported. What is documented: - The connector exposes an ads_insights entity with list and search actions for performance data. [[FB‑Mktg reference](https://docs.airbyte.com/ai-agents/connectors/facebook-marketing/REFERENCE#ads-insights-list)] - ads_insights.list lets you pass: - account_id (required) - optional fields (comma‑separated list of fields to return) - date range options (date_preset, time_range), level, time_increment, pagination, etc. [[Ads insights list](https://docs.airbyte.com/ai-agents/connectors/facebook-marketing/REFERENCE#ads-insights-list)] - ads_insights.search lets you filter and select fields from already‑synced insights data, but again the docs don’t enumerate demographic fields. [[Ads insights search](https://docs.airbyte.com/ai-agents/connectors/facebook-marketing/REFERENCE#ads-insights-search)] Because the available snippets don’t list any age/gender fields or breakdown parameters, I cannot reliably say that demographic breakdowns are exposed by this connector, nor provide the exact field names or breakdown options you’d need. If demographics are supported in your version of the connector, they would have to: 1. Appear in the ads_insights schema/field list in the full reference (not included in these excerpts), and 2. Be requested via the fields parameter in ads_insights.list or ads_insights.search. Example pattern (field names here are illustrative only, since the docs don’t confirm them): python await facebook_marketing.ads_insights.list( account_id="<your_account_id_without_act_prefix>", fields="account_id,impressions,clicks" # add any documented demographic fields here ) Given the current knowledge sources, the safest answer is: - You can fetch ads insights via ads_insights.list / search. - The docs provided do not confirm that age/gender demographic data is available, so I cannot guarantee it or show exact working field names.