---
title: "Meta Ad Library metrics and dimensions"
slug: "meta-ad-library-fields"
updated: 2026-11-03T12:01:13Z
published: 2026-11-03T12:01:13Z
canonical: "docs.supermetrics.com/meta-ad-library-fields"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.supermetrics.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Meta Ad Library metrics and dimensions

> Supermetrics brings all your Meta Ad Library data into [Google Sheets](https://workspace.google.com/marketplace/app/supermetrics/523876908005), [Looker Studio](https://supermetrics.com/products/looker-studio), [Power BI](https://supermetrics.com/products/power-bi), [Excel](https://supermetrics.com/products/excel), [BigQuery](https://supermetrics.com/products/bigquery), [Snowflake](https://supermetrics.com/products/snowflake), [Redshift](https://supermetrics.com/products/amazon-redshift), [Azure](https://supermetrics.com/products/azure-synapse)

11 metrics35 dimensionsSearch fields

### AD

| \| ad_library_id \| \| --- \| \| \\| Field label \\| Ad library ID \\| \\| --- \\| --- \\| \\| Description \\| Unique Ad Library ID \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Ad library ID \| \| Description \| Unique Ad Library ID \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| |
| --- |
| ad_library_id |
| \| Field label \| Ad library ID \| \| --- \| --- \| \| Description \| Unique Ad Library ID \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| |
| Field label | Ad library ID |
| Description | Unique Ad Library ID |
| Field type | dimension |
| Data type | [string.text.value](/apidocs/field-data-types#text) |
| \| ad_creation_date \| \| --- \| \| \\| Field label \\| Ad creation date \\| \\| --- \\| --- \\| \\| Description \\| Date when the ad was created \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.time.date](/apidocs/field-data-types#time) \\| \| \| Field label \| Ad creation date \| \| Description \| Date when the ad was created \| \| Field type \| dimension \| \| Data type \| [string.time.date](/apidocs/field-data-types#time) \| |
| ad_creation_date |
| \| Field label \| Ad creation date \| \| --- \| --- \| \| Description \| Date when the ad was created \| \| Field type \| dimension \| \| Data type \| [string.time.date](/apidocs/field-data-types#time) \| |
| Field label | Ad creation date |
| Description | Date when the ad was created |
| Field type | dimension |
| Data type | [string.time.date](/apidocs/field-data-types#time) |
| \| delivery_start_date \| \| --- \| \| \\| Field label \\| Delivery start date \\| \\| --- \\| --- \\| \\| Description \\| Date when ad delivery started \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.time.date](/apidocs/field-data-types#time) \\| \| \| Field label \| Delivery start date \| \| Description \| Date when ad delivery started \| \| Field type \| dimension \| \| Data type \| [string.time.date](/apidocs/field-data-types#time) \| |
| delivery_start_date |
| \| Field label \| Delivery start date \| \| --- \| --- \| \| Description \| Date when ad delivery started \| \| Field type \| dimension \| \| Data type \| [string.time.date](/apidocs/field-data-types#time) \| |
| Field label | Delivery start date |
| Description | Date when ad delivery started |
| Field type | dimension |
| Data type | [string.time.date](/apidocs/field-data-types#time) |
| \| delivery_stop_date \| \| --- \| \| \\| Field label \\| Delivery stop date \\| \\| --- \\| --- \\| \\| Description \\| Date when ad delivery stopped. Empty if still running \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.time.date](/apidocs/field-data-types#time) \\| \| \| Field label \| Delivery stop date \| \| Description \| Date when ad delivery stopped. Empty if still running \| \| Field type \| dimension \| \| Data type \| [string.time.date](/apidocs/field-data-types#time) \| |
| delivery_stop_date |
| \| Field label \| Delivery stop date \| \| --- \| --- \| \| Description \| Date when ad delivery stopped. Empty if still running \| \| Field type \| dimension \| \| Data type \| [string.time.date](/apidocs/field-data-types#time) \| |
| Field label | Delivery stop date |
| Description | Date when ad delivery stopped. Empty if still running |
| Field type | dimension |
| Data type | [string.time.date](/apidocs/field-data-types#time) |
| \| ad_snapshot_url \| \| --- \| \| \\| Field label \\| Ad snapshot URL \\| \\| --- \\| --- \\| \\| Description \\| Link to the ad in Meta Ad Library \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.url](/apidocs/field-data-types#text) \\| \| \| Field label \| Ad snapshot URL \| \| Description \| Link to the ad in Meta Ad Library \| \| Field type \| dimension \| \| Data type \| [string.text.url](/apidocs/field-data-types#text) \| |
| ad_snapshot_url |
| \| Field label \| Ad snapshot URL \| \| --- \| --- \| \| Description \| Link to the ad in Meta Ad Library \| \| Field type \| dimension \| \| Data type \| [string.text.url](/apidocs/field-data-types#text) \| |
| Field label | Ad snapshot URL |
| Description | Link to the ad in Meta Ad Library |
| Field type | dimension |
| Data type | [string.text.url](/apidocs/field-data-types#text) |
| \| page_id \| \| --- \| \| \\| Field label \\| Page ID \\| \\| --- \\| --- \\| \\| Description \\| Facebook Page ID of the advertiser \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Page ID \| \| Description \| Facebook Page ID of the advertiser \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| |
| page_id |
| \| Field label \| Page ID \| \| --- \| --- \| \| Description \| Facebook Page ID of the advertiser \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| |
| Field label | Page ID |
| Description | Facebook Page ID of the advertiser |
| Field type | dimension |
| Data type | [string.text.value](/apidocs/field-data-types#text) |
| \| page_name \| \| --- \| \| \\| Field label \\| Page name \\| \\| --- \\| --- \\| \\| Description \\| Facebook Page name of the advertiser \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Page name \| \| Description \| Facebook Page name of the advertiser \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| |
| page_name |
| \| Field label \| Page name \| \| --- \| --- \| \| Description \| Facebook Page name of the advertiser \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| |
| Field label | Page name |
| Description | Facebook Page name of the advertiser |
| Field type | dimension |
| Data type | [string.text.value](/apidocs/field-data-types#text) |
| \| publisher_platforms \| \| --- \| \| \\| Field label \\| Publisher platforms \\| \\| --- \\| --- \\| \\| Description \\| Meta platforms where the ad appeared (e.g. facebook, instagram) \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Publisher platforms \| \| Description \| Meta platforms where the ad appeared (e.g. facebook, instagram) \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| |
| publisher_platforms |
| \| Field label \| Publisher platforms \| \| --- \| --- \| \| Description \| Meta platforms where the ad appeared (e.g. facebook, instagram) \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| |
| Field label | Publisher platforms |
| Description | Meta platforms where the ad appeared (e.g. facebook, instagram) |
| Field type | dimension |
| Data type | [string.text.value](/apidocs/field-data-types#text) |
| \| languages \| \| --- \| \| \\| Field label \\| Languages \\| \\| --- \\| --- \\| \\| Description \\| Languages of the ad creative (e.g. en, es) \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Languages \| \| Description \| Languages of the ad creative (e.g. en, es) \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| |
| languages |
| \| Field label \| Languages \| \| --- \| --- \| \| Description \| Languages of the ad creative (e.g. en, es) \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| |
| Field label | Languages |
| Description | Languages of the ad creative (e.g. en, es) |
| Field type | dimension |
| Data type | [string.text.value](/apidocs/field-data-types#text) |

### CREATIVE

| \| ad_creative_bodies \| \| --- \| \| \\| Field label \\| Ad creative bodies \\| \\| --- \\| --- \\| \\| Description \\| Main text content of the ad \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Ad creative bodies \| \| Description \| Main text content of the ad \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| |
| --- |
| ad_creative_bodies |
| \| Field label \| Ad creative bodies \| \| --- \| --- \| \| Description \| Main text content of the ad \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| |
| Field label | Ad creative bodies |
| Description | Main text content of the ad |
| Field type | dimension |
| Data type | [string.text.value](/apidocs/field-data-types#text) |
| \| ad_creative_link_captions \| \| --- \| \| \\| Field label \\| Ad creative link captions \\| \\| --- \\| --- \\| \\| Description \\| Call-to-action captions in the ad \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Ad creative link captions \| \| Description \| Call-to-action captions in the ad \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| |
| ad_creative_link_captions |
| \| Field label \| Ad creative link captions \| \| --- \| --- \| \| Description \| Call-to-action captions in the ad \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| |
| Field label | Ad creative link captions |
| Description | Call-to-action captions in the ad |
| Field type | dimension |
| Data type | [string.text.value](/apidocs/field-data-types#text) |
| \| ad_creative_link_descriptions \| \| --- \| \| \\| Field label \\| Ad creative link descriptions \\| \\| --- \\| --- \\| \\| Description \\| Link descriptions in the ad call-to-action \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Ad creative link descriptions \| \| Description \| Link descriptions in the ad call-to-action \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| |
| ad_creative_link_descriptions |
| \| Field label \| Ad creative link descriptions \| \| --- \| --- \| \| Description \| Link descriptions in the ad call-to-action \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| |
| Field label | Ad creative link descriptions |
| Description | Link descriptions in the ad call-to-action |
| Field type | dimension |
| Data type | [string.text.value](/apidocs/field-data-types#text) |
| \| ad_creative_link_titles \| \| --- \| \| \\| Field label \\| Ad creative link titles \\| \\| --- \\| --- \\| \\| Description \\| Link titles in the ad call-to-action \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Ad creative link titles \| \| Description \| Link titles in the ad call-to-action \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| |
| ad_creative_link_titles |
| \| Field label \| Ad creative link titles \| \| --- \| --- \| \| Description \| Link titles in the ad call-to-action \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| |
| Field label | Ad creative link titles |
| Description | Link titles in the ad call-to-action |
| Field type | dimension |
| Data type | [string.text.value](/apidocs/field-data-types#text) |

### DATASOURCE

| \| dataSourceName \| \| --- \| \| \\| Field label \\| Data source \\| \\| --- \\| --- \\| \\| Description \\| The name of the source for this data, as listed on supermetrics.com/docs \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \\| Destinations \\| API, Data warehouse \\| \| \| Field label \| Data source \| \| Description \| The name of the source for this data, as listed on supermetrics.com/docs \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| \| Destinations \| API, Data warehouse \| |
| --- |
| dataSourceName |
| \| Field label \| Data source \| \| --- \| --- \| \| Description \| The name of the source for this data, as listed on supermetrics.com/docs \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| \| Destinations \| API, Data warehouse \| |
| Field label | Data source |
| Description | The name of the source for this data, as listed on supermetrics.com/docs |
| Field type | dimension |
| Data type | [string.text.value](/apidocs/field-data-types#text) |
| Destinations | API, Data warehouse |
| \| system_metadata.data_source_logins \| \| --- \| \| \\| Field label \\| Data source logins \\| \\| --- \\| --- \\| \\| Description \\| The data source login accounts that were used to authenticate against the data source \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.json](/apidocs/field-data-types#text) \\| \| \| Field label \| Data source logins \| \| Description \| The data source login accounts that were used to authenticate against the data source \| \| Field type \| dimension \| \| Data type \| [string.text.json](/apidocs/field-data-types#text) \| |
| system_metadata.data_source_logins |
| \| Field label \| Data source logins \| \| --- \| --- \| \| Description \| The data source login accounts that were used to authenticate against the data source \| \| Field type \| dimension \| \| Data type \| [string.text.json](/apidocs/field-data-types#text) \| |
| Field label | Data source logins |
| Description | The data source login accounts that were used to authenticate against the data source |
| Field type | dimension |
| Data type | [string.text.json](/apidocs/field-data-types#text) |
| \| system_metadata.data_source_login_owners \| \| --- \| \| \\| Field label \\| Data source login owners \\| \\| --- \\| --- \\| \\| Description \\| The Supermetrics users that created the data source login connections \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.json](/apidocs/field-data-types#text) \\| \| \| Field label \| Data source login owners \| \| Description \| The Supermetrics users that created the data source login connections \| \| Field type \| dimension \| \| Data type \| [string.text.json](/apidocs/field-data-types#text) \| |
| system_metadata.data_source_login_owners |
| \| Field label \| Data source login owners \| \| --- \| --- \| \| Description \| The Supermetrics users that created the data source login connections \| \| Field type \| dimension \| \| Data type \| [string.text.json](/apidocs/field-data-types#text) \| |
| Field label | Data source login owners |
| Description | The Supermetrics users that created the data source login connections |
| Field type | dimension |
| Data type | [string.text.json](/apidocs/field-data-types#text) |

### DEMOGRAPHIC BREAKDOWN

| \| country \| \| --- \| \| \\| Field label \\| Country \\| \\| --- \\| --- \\| \\| Description \\| Country where the ad was delivered \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Country \| \| Description \| Country where the ad was delivered \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| |
| --- |
| country |
| \| Field label \| Country \| \| --- \| --- \| \| Description \| Country where the ad was delivered \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| |
| Field label | Country |
| Description | Country where the ad was delivered |
| Field type | dimension |
| Data type | [string.text.value](/apidocs/field-data-types#text) |
| \| age_range \| \| --- \| \| \\| Field label \\| Age range \\| \\| --- \\| --- \\| \\| Description \\| Age range of the audience (e.g. 25-34) \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Age range \| \| Description \| Age range of the audience (e.g. 25-34) \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| |
| age_range |
| \| Field label \| Age range \| \| --- \| --- \| \| Description \| Age range of the audience (e.g. 25-34) \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| |
| Field label | Age range |
| Description | Age range of the audience (e.g. 25-34) |
| Field type | dimension |
| Data type | [string.text.value](/apidocs/field-data-types#text) |
| \| male_reach \| \| --- \| \| \\| Field label \\| Male reach \\| \\| --- \\| --- \\| \\| Description \\| Number of male accounts reached in this age range and country \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Male reach \| \| Description \| Number of male accounts reached in this age range and country \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| |
| male_reach |
| \| Field label \| Male reach \| \| --- \| --- \| \| Description \| Number of male accounts reached in this age range and country \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| |
| Field label | Male reach |
| Description | Number of male accounts reached in this age range and country |
| Field type | metric |
| Data type | [int.number.value](/apidocs/field-data-types#number) |
| \| female_reach \| \| --- \| \| \\| Field label \\| Female reach \\| \\| --- \\| --- \\| \\| Description \\| Number of female accounts reached in this age range and country \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Female reach \| \| Description \| Number of female accounts reached in this age range and country \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| |
| female_reach |
| \| Field label \| Female reach \| \| --- \| --- \| \| Description \| Number of female accounts reached in this age range and country \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| |
| Field label | Female reach |
| Description | Number of female accounts reached in this age range and country |
| Field type | metric |
| Data type | [int.number.value](/apidocs/field-data-types#number) |
| \| unknown_reach \| \| --- \| \| \\| Field label \\| Unknown reach \\| \\| --- \\| --- \\| \\| Description \\| Number of accounts with unknown gender reached in this age range and country \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Unknown reach \| \| Description \| Number of accounts with unknown gender reached in this age range and country \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| |
| unknown_reach |
| \| Field label \| Unknown reach \| \| --- \| --- \| \| Description \| Number of accounts with unknown gender reached in this age range and country \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| |
| Field label | Unknown reach |
| Description | Number of accounts with unknown gender reached in this age range and country |
| Field type | metric |
| Data type | [int.number.value](/apidocs/field-data-types#number) |

### POLITICAL

| \| bylines \| \| --- \| \| \\| Field label \\| Bylines \\| \\| --- \\| --- \\| \\| Description \\| Entity that funded the ad. Available for political/issue ads \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Bylines \| \| Description \| Entity that funded the ad. Available for political/issue ads \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| |
| --- |
| bylines |
| \| Field label \| Bylines \| \| --- \| --- \| \| Description \| Entity that funded the ad. Available for political/issue ads \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| |
| Field label | Bylines |
| Description | Entity that funded the ad. Available for political/issue ads |
| Field type | dimension |
| Data type | [string.text.value](/apidocs/field-data-types#text) |
| \| currency \| \| --- \| \| \\| Field label \\| Currency \\| \\| --- \\| --- \\| \\| Description \\| Currency used for ad spend. Available for political/issue ads \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Currency \| \| Description \| Currency used for ad spend. Available for political/issue ads \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| |
| currency |
| \| Field label \| Currency \| \| --- \| --- \| \| Description \| Currency used for ad spend. Available for political/issue ads \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| |
| Field label | Currency |
| Description | Currency used for ad spend. Available for political/issue ads |
| Field type | dimension |
| Data type | [string.text.value](/apidocs/field-data-types#text) |
| \| spend_lower_bound \| \| --- \| \| \\| Field label \\| Spend lower bound \\| \\| --- \\| --- \\| \\| Description \\| Lower bound of ad spend range. Available for political/issue ads \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Spend lower bound \| \| Description \| Lower bound of ad spend range. Available for political/issue ads \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| |
| spend_lower_bound |
| \| Field label \| Spend lower bound \| \| --- \| --- \| \| Description \| Lower bound of ad spend range. Available for political/issue ads \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| |
| Field label | Spend lower bound |
| Description | Lower bound of ad spend range. Available for political/issue ads |
| Field type | metric |
| Data type | [int.number.value](/apidocs/field-data-types#number) |
| \| spend_upper_bound \| \| --- \| \| \\| Field label \\| Spend upper bound \\| \\| --- \\| --- \\| \\| Description \\| Upper bound of ad spend range. Available for political/issue ads \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Spend upper bound \| \| Description \| Upper bound of ad spend range. Available for political/issue ads \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| |
| spend_upper_bound |
| \| Field label \| Spend upper bound \| \| --- \| --- \| \| Description \| Upper bound of ad spend range. Available for political/issue ads \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| |
| Field label | Spend upper bound |
| Description | Upper bound of ad spend range. Available for political/issue ads |
| Field type | metric |
| Data type | [int.number.value](/apidocs/field-data-types#number) |
| \| impressions_lower_bound \| \| --- \| \| \\| Field label \\| Impressions lower bound \\| \\| --- \\| --- \\| \\| Description \\| Lower bound of impressions range. Available for political/issue ads \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Impressions lower bound \| \| Description \| Lower bound of impressions range. Available for political/issue ads \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| |
| impressions_lower_bound |
| \| Field label \| Impressions lower bound \| \| --- \| --- \| \| Description \| Lower bound of impressions range. Available for political/issue ads \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| |
| Field label | Impressions lower bound |
| Description | Lower bound of impressions range. Available for political/issue ads |
| Field type | metric |
| Data type | [int.number.value](/apidocs/field-data-types#number) |
| \| impressions_upper_bound \| \| --- \| \| \\| Field label \\| Impressions upper bound \\| \\| --- \\| --- \\| \\| Description \\| Upper bound of impressions range. Available for political/issue ads \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Impressions upper bound \| \| Description \| Upper bound of impressions range. Available for political/issue ads \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| |
| impressions_upper_bound |
| \| Field label \| Impressions upper bound \| \| --- \| --- \| \| Description \| Upper bound of impressions range. Available for political/issue ads \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| |
| Field label | Impressions upper bound |
| Description | Upper bound of impressions range. Available for political/issue ads |
| Field type | metric |
| Data type | [int.number.value](/apidocs/field-data-types#number) |
| \| estimated_audience_size_lower_bound \| \| --- \| \| \\| Field label \\| Estimated audience size lower bound \\| \\| --- \\| --- \\| \\| Description \\| Lower bound of estimated audience size. Available for political/issue ads \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Estimated audience size lower bound \| \| Description \| Lower bound of estimated audience size. Available for political/issue ads \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| |
| estimated_audience_size_lower_bound |
| \| Field label \| Estimated audience size lower bound \| \| --- \| --- \| \| Description \| Lower bound of estimated audience size. Available for political/issue ads \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| |
| Field label | Estimated audience size lower bound |
| Description | Lower bound of estimated audience size. Available for political/issue ads |
| Field type | metric |
| Data type | [int.number.value](/apidocs/field-data-types#number) |
| \| estimated_audience_size_upper_bound \| \| --- \| \| \\| Field label \\| Estimated audience size upper bound \\| \\| --- \\| --- \\| \\| Description \\| Upper bound of estimated audience size. Available for political/issue ads \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Estimated audience size upper bound \| \| Description \| Upper bound of estimated audience size. Available for political/issue ads \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| |
| estimated_audience_size_upper_bound |
| \| Field label \| Estimated audience size upper bound \| \| --- \| --- \| \| Description \| Upper bound of estimated audience size. Available for political/issue ads \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| |
| Field label | Estimated audience size upper bound |
| Description | Upper bound of estimated audience size. Available for political/issue ads |
| Field type | metric |
| Data type | [int.number.value](/apidocs/field-data-types#number) |

### QUERY

| \| system_metadata.query_date_range_start \| \| --- \| \| \\| Field label \\| Start date \\| \\| --- \\| --- \\| \\| Description \\| The start date of the requested query \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.time.date](/apidocs/field-data-types#time) \\| \| \| Field label \| Start date \| \| Description \| The start date of the requested query \| \| Field type \| dimension \| \| Data type \| [string.time.date](/apidocs/field-data-types#time) \| |
| --- |
| system_metadata.query_date_range_start |
| \| Field label \| Start date \| \| --- \| --- \| \| Description \| The start date of the requested query \| \| Field type \| dimension \| \| Data type \| [string.time.date](/apidocs/field-data-types#time) \| |
| Field label | Start date |
| Description | The start date of the requested query |
| Field type | dimension |
| Data type | [string.time.date](/apidocs/field-data-types#time) |
| \| system_metadata.query_date_range_end \| \| --- \| \| \\| Field label \\| End date \\| \\| --- \\| --- \\| \\| Description \\| The end date of the requested query \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.time.date](/apidocs/field-data-types#time) \\| \| \| Field label \| End date \| \| Description \| The end date of the requested query \| \| Field type \| dimension \| \| Data type \| [string.time.date](/apidocs/field-data-types#time) \| |
| system_metadata.query_date_range_end |
| \| Field label \| End date \| \| --- \| --- \| \| Description \| The end date of the requested query \| \| Field type \| dimension \| \| Data type \| [string.time.date](/apidocs/field-data-types#time) \| |
| Field label | End date |
| Description | The end date of the requested query |
| Field type | dimension |
| Data type | [string.time.date](/apidocs/field-data-types#time) |
| \| system_metadata.query_timezone \| \| --- \| \| \\| Field label \\| Timezone \\| \\| --- \\| --- \\| \\| Description \\| The timezone that is supplied to the query \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.time.timezone](/apidocs/field-data-types#time) \\| \| \| Field label \| Timezone \| \| Description \| The timezone that is supplied to the query \| \| Field type \| dimension \| \| Data type \| [string.time.timezone](/apidocs/field-data-types#time) \| |
| system_metadata.query_timezone |
| \| Field label \| Timezone \| \| --- \| --- \| \| Description \| The timezone that is supplied to the query \| \| Field type \| dimension \| \| Data type \| [string.time.timezone](/apidocs/field-data-types#time) \| |
| Field label | Timezone |
| Description | The timezone that is supplied to the query |
| Field type | dimension |
| Data type | [string.time.timezone](/apidocs/field-data-types#time) |
| \| system_metadata.query_filters \| \| --- \| \| \\| Field label \\| Filters \\| \\| --- \\| --- \\| \\| Description \\| All filters used in the query \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.json](/apidocs/field-data-types#text) \\| \| \| Field label \| Filters \| \| Description \| All filters used in the query \| \| Field type \| dimension \| \| Data type \| [string.text.json](/apidocs/field-data-types#text) \| |
| system_metadata.query_filters |
| \| Field label \| Filters \| \| --- \| --- \| \| Description \| All filters used in the query \| \| Field type \| dimension \| \| Data type \| [string.text.json](/apidocs/field-data-types#text) \| |
| Field label | Filters |
| Description | All filters used in the query |
| Field type | dimension |
| Data type | [string.text.json](/apidocs/field-data-types#text) |
| \| system_metadata.query_date_start \| \| --- \| \| \\| Field label \\| Start \\| \\| --- \\| --- \\| \\| Description \\| When the query was started \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.time.datetime](/apidocs/field-data-types#time) \\| \| \| Field label \| Start \| \| Description \| When the query was started \| \| Field type \| dimension \| \| Data type \| [string.time.datetime](/apidocs/field-data-types#time) \| |
| system_metadata.query_date_start |
| \| Field label \| Start \| \| --- \| --- \| \| Description \| When the query was started \| \| Field type \| dimension \| \| Data type \| [string.time.datetime](/apidocs/field-data-types#time) \| |
| Field label | Start |
| Description | When the query was started |
| Field type | dimension |
| Data type | [string.time.datetime](/apidocs/field-data-types#time) |
| \| system_metadata.query_date_end \| \| --- \| \| \\| Field label \\| End \\| \\| --- \\| --- \\| \\| Description \\| When the query completed \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.time.datetime](/apidocs/field-data-types#time) \\| \| \| Field label \| End \| \| Description \| When the query completed \| \| Field type \| dimension \| \| Data type \| [string.time.datetime](/apidocs/field-data-types#time) \| |
| system_metadata.query_date_end |
| \| Field label \| End \| \| --- \| --- \| \| Description \| When the query completed \| \| Field type \| dimension \| \| Data type \| [string.time.datetime](/apidocs/field-data-types#time) \| |
| Field label | End |
| Description | When the query completed |
| Field type | dimension |
| Data type | [string.time.datetime](/apidocs/field-data-types#time) |
| \| system_metadata.query_duration \| \| --- \| \| \\| Field label \\| Duration \\| \\| --- \\| --- \\| \\| Description \\| The duration in seconds of the query \\| \\| Field type \\| dimension \\| \\| Data type \\| [int.duration.seconds](/apidocs/field-data-types#duration) \\| \| \| Field label \| Duration \| \| Description \| The duration in seconds of the query \| \| Field type \| dimension \| \| Data type \| [int.duration.seconds](/apidocs/field-data-types#duration) \| |
| system_metadata.query_duration |
| \| Field label \| Duration \| \| --- \| --- \| \| Description \| The duration in seconds of the query \| \| Field type \| dimension \| \| Data type \| [int.duration.seconds](/apidocs/field-data-types#duration) \| |
| Field label | Duration |
| Description | The duration in seconds of the query |
| Field type | dimension |
| Data type | [int.duration.seconds](/apidocs/field-data-types#duration) |
| \| system_metadata.query_accounts \| \| --- \| \| \\| Field label \\| Accounts \\| \\| --- \\| --- \\| \\| Description \\| A list of accounts of which the data was pulled from \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.json](/apidocs/field-data-types#text) \\| \| \| Field label \| Accounts \| \| Description \| A list of accounts of which the data was pulled from \| \| Field type \| dimension \| \| Data type \| [string.text.json](/apidocs/field-data-types#text) \| |
| system_metadata.query_accounts |
| \| Field label \| Accounts \| \| --- \| --- \| \| Description \| A list of accounts of which the data was pulled from \| \| Field type \| dimension \| \| Data type \| [string.text.json](/apidocs/field-data-types#text) \| |
| Field label | Accounts |
| Description | A list of accounts of which the data was pulled from |
| Field type | dimension |
| Data type | [string.text.json](/apidocs/field-data-types#text) |
| \| system_metadata.query_excluded_accounts \| \| --- \| \| \\| Field label \\| Excluded invalid accounts \\| \\| --- \\| --- \\| \\| Description \\| A list of unavailable accounts excluded from the query due to the "Exclude invalid accounts" setting \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.json](/apidocs/field-data-types#text) \\| \| \| Field label \| Excluded invalid accounts \| \| Description \| A list of unavailable accounts excluded from the query due to the "Exclude invalid accounts" setting \| \| Field type \| dimension \| \| Data type \| [string.text.json](/apidocs/field-data-types#text) \| |
| system_metadata.query_excluded_accounts |
| \| Field label \| Excluded invalid accounts \| \| --- \| --- \| \| Description \| A list of unavailable accounts excluded from the query due to the "Exclude invalid accounts" setting \| \| Field type \| dimension \| \| Data type \| [string.text.json](/apidocs/field-data-types#text) \| |
| Field label | Excluded invalid accounts |
| Description | A list of unavailable accounts excluded from the query due to the "Exclude invalid accounts" setting |
| Field type | dimension |
| Data type | [string.text.json](/apidocs/field-data-types#text) |

### REACH

| \| eu_total_reach \| \| --- \| \| \\| Field label \\| EU total reach \\| \\| --- \\| --- \\| \\| Description \\| Total reach across EU locations. Available for EU-delivered ads \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| EU total reach \| \| Description \| Total reach across EU locations. Available for EU-delivered ads \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| |
| --- |
| eu_total_reach |
| \| Field label \| EU total reach \| \| --- \| --- \| \| Description \| Total reach across EU locations. Available for EU-delivered ads \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| |
| Field label | EU total reach |
| Description | Total reach across EU locations. Available for EU-delivered ads |
| Field type | metric |
| Data type | [int.number.value](/apidocs/field-data-types#number) |
| \| br_total_reach \| \| --- \| \| \\| Field label \\| BR total reach \\| \\| --- \\| --- \\| \\| Description \\| Total reach in Brazil. Available for Brazilian political ads \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| BR total reach \| \| Description \| Total reach in Brazil. Available for Brazilian political ads \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| |
| br_total_reach |
| \| Field label \| BR total reach \| \| --- \| --- \| \| Description \| Total reach in Brazil. Available for Brazilian political ads \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| |
| Field label | BR total reach |
| Description | Total reach in Brazil. Available for Brazilian political ads |
| Field type | metric |
| Data type | [int.number.value](/apidocs/field-data-types#number) |

### TARGETING

| \| target_ages \| \| --- \| \| \\| Field label \\| Target ages \\| \\| --- \\| --- \\| \\| Description \\| Age range targeted by the ad (e.g. 18-65). Available for UK/EU ads \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Target ages \| \| Description \| Age range targeted by the ad (e.g. 18-65). Available for UK/EU ads \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| |
| --- |
| target_ages |
| \| Field label \| Target ages \| \| --- \| --- \| \| Description \| Age range targeted by the ad (e.g. 18-65). Available for UK/EU ads \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| |
| Field label | Target ages |
| Description | Age range targeted by the ad (e.g. 18-65). Available for UK/EU ads |
| Field type | dimension |
| Data type | [string.text.value](/apidocs/field-data-types#text) |
| \| target_gender \| \| --- \| \| \\| Field label \\| Target gender \\| \\| --- \\| --- \\| \\| Description \\| Gender targeted by the ad (Women, Men, or All). Available for UK/EU ads \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Target gender \| \| Description \| Gender targeted by the ad (Women, Men, or All). Available for UK/EU ads \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| |
| target_gender |
| \| Field label \| Target gender \| \| --- \| --- \| \| Description \| Gender targeted by the ad (Women, Men, or All). Available for UK/EU ads \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| |
| Field label | Target gender |
| Description | Gender targeted by the ad (Women, Men, or All). Available for UK/EU ads |
| Field type | dimension |
| Data type | [string.text.value](/apidocs/field-data-types#text) |
| \| target_locations \| \| --- \| \| \\| Field label \\| Target locations \\| \\| --- \\| --- \\| \\| Description \\| Countries targeted by the ad. Available for UK/EU ads \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Target locations \| \| Description \| Countries targeted by the ad. Available for UK/EU ads \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| |
| target_locations |
| \| Field label \| Target locations \| \| --- \| --- \| \| Description \| Countries targeted by the ad. Available for UK/EU ads \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| |
| Field label | Target locations |
| Description | Countries targeted by the ad. Available for UK/EU ads |
| Field type | dimension |
| Data type | [string.text.value](/apidocs/field-data-types#text) |
| \| payer \| \| --- \| \| \\| Field label \\| Payer \\| \\| --- \\| --- \\| \\| Description \\| Entity that paid for the ad. Available for EU ads \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Payer \| \| Description \| Entity that paid for the ad. Available for EU ads \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| |
| payer |
| \| Field label \| Payer \| \| --- \| --- \| \| Description \| Entity that paid for the ad. Available for EU ads \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| |
| Field label | Payer |
| Description | Entity that paid for the ad. Available for EU ads |
| Field type | dimension |
| Data type | [string.text.value](/apidocs/field-data-types#text) |
| \| beneficiary \| \| --- \| \| \\| Field label \\| Beneficiary \\| \\| --- \\| --- \\| \\| Description \\| Entity that benefits from the ad. Available for EU ads \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Beneficiary \| \| Description \| Entity that benefits from the ad. Available for EU ads \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| |
| beneficiary |
| \| Field label \| Beneficiary \| \| --- \| --- \| \| Description \| Entity that benefits from the ad. Available for EU ads \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| |
| Field label | Beneficiary |
| Description | Entity that benefits from the ad. Available for EU ads |
| Field type | dimension |
| Data type | [string.text.value](/apidocs/field-data-types#text) |

### TIME

| \| today \| \| --- \| \| \\| Field label \\| Today \\| \\| --- \\| --- \\| \\| Description \\| Today's date, e.g. 2017-01-31 \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.time.date](/apidocs/field-data-types#time) \\| \\| Destinations \\| API, Data warehouse \\| \| \| Field label \| Today \| \| Description \| Today's date, e.g. 2017-01-31 \| \| Field type \| dimension \| \| Data type \| [string.time.date](/apidocs/field-data-types#time) \| \| Destinations \| API, Data warehouse \| |
| --- |
| today |
| \| Field label \| Today \| \| --- \| --- \| \| Description \| Today's date, e.g. 2017-01-31 \| \| Field type \| dimension \| \| Data type \| [string.time.date](/apidocs/field-data-types#time) \| \| Destinations \| API, Data warehouse \| |
| Field label | Today |
| Description | Today's date, e.g. 2017-01-31 |
| Field type | dimension |
| Data type | [string.time.date](/apidocs/field-data-types#time) |
| Destinations | API, Data warehouse |