Facebook Ad Library: Most-used fields

The table below gives information about most-used fields that you can import from Facebook Ad Library. Other fields might also be available in Adverity.

The fields that you can fetch in Adverity are updated regularly to reflect updates to data source APIs.

API name	Adverity UI name	Description	Use in Adverity
ad_creation_time	ad_creation_time	The timestamp indicating when the ad was created.	dimension
ad_creative_bodies	ad_creative_bodies	The main text content of the ad creative.	dimension
ad_creative_link_captions	ad_creative_link_captions	The caption text displayed below the link in the ad creative.	dimension
ad_creative_link_titles	ad_creative_link_titles	The headline or title of the link included in the ad creative.	dimension
ad_delivery_start_time	ad_delivery_start_time	The date and time when the ad started being delivered.	dimension
ad_delivery_stop_time	ad_delivery_stop_time	The date and time when the ad stopped being delivered.	dimension
ad_snapshot_url	ad_snapshot_url	A permalink to a snapshot of the ad as it appeared, including its creative content.	dimension
age_country_gender_reach_breakdown_json	age_country_gender_reach_breakdown_json	A detailed breakdown of the ad’s estimated reach by age, country, and gender.	dimension
age_range	age_range	The age group targeted by the ad or within the demographic breakdown of its reach.	dimension
beneficiary	beneficiary	The entity or individual benefiting from the ad, often required for transparency in political or issue-based advertising.	dimension
bylines	bylines	Information about the entity or individuals responsible for an ad, often related to disclosure requirements for transparency.	dimension
country	country	The country or countries where the ad was delivered or targeted.	dimension
currency	currency	The currency used for reporting the ad’s spend.	dimension
delivery_by_region	delivery_by_region	Geographic regions where the ad was delivered, including breakdowns for specific countries or locations.	dimension
demographic_distribution	demographic_distribution	The distribution of the ad’s audience across various demographic categories such as age and gender.	dimension
estimated_audience_size_lower_bound	estimated_audience_size_lower_bound	The minimum estimated size of the audience reached by the ad.	dimension
estimated_audience_size_upper_bound	estimated_audience_size_upper_bound	The maximum estimated size of the audience reached by the ad.	dimension
eu_total_reach	eu_total_reach	The total estimated reach of the ad within the European Union.	metric
gender_female	gender_female	The percentage or number of female users reached by the ad.	metric
gender_male	gender_male	The percentage or number of male users reached by the ad.	metric
gender_unknown	gender_unknown	The percentage or number of users with an unknown gender reached by the ad.	metric
id	id	A unique identifier for the ad within the Facebook Ad Library.	dimension
impressions_lower_bound	impressions_lower_bound	The minimum estimated number of times the ad was viewed.	dimension
impressions_upper_bound	impressions_upper_bound	The maximum estimated number of times the ad was viewed.	metric
page_id	page_id	The unique identifier of the Facebook Page that ran the ad.	dimension
page_name	page_name	The name of the Facebook Page that ran the ad.	dimension
payer	payer	The entity or individual that paid for the ad, often required for transparency in political or issue-based advertising.	dimension
publisher_platforms	publisher_platforms	A list of platforms where the ad was published, such as Facebook, Instagram, Messenger, or Audience Network.	dimension
spend_lower_bound	spend_lower_bound	The minimum estimated amount of money spent on the ad.	dimension
spend_upper_bound	spend_upper_bound	The maximum estimated amount of money spent on the ad.	metric
target_ages	target_ages	The specific age ranges that the ad was configured to target.	dimension
target_gender	target_gender	The specific genders that the ad was configured to target.	dimension
target_locations	target_locations	The specific geographic locations or regions that the ad was configured to target.	dimension