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.
ad_creation_time Dimension
The timestamp indicating when the ad was created.
ad_creative_bodies Dimension
The main text content of the ad creative.
ad_creative_link_captions Dimension
The caption text displayed below the link in the ad creative.
ad_creative_link_descriptions Dimension
The description of the link associated with the ad creative. This text often appears below the title of the link in the ad, providing additional context or details about the destination.
ad_creative_link_titles Dimension
The headline or title of the link included in the ad creative.
ad_delivery_start_time Dimension
The date and time when the ad started being delivered.
ad_delivery_stop_time Dimension
The date and time when the ad stopped being delivered.
ad_snapshot_url Dimension
URL link that displays the archived ad, including uncompressed images and videos.
age_country_gender_reach_breakdown_json Dimension
Provides a detailed breakdown of the ad's estimated reach based on age, country, and gender demographics.
age_range Dimension
The age group targeted by the ad or within the demographic breakdown of its reach.
beneficiary Dimension
The entity or individual benefiting from the ad, often required for transparency in political or issue-based advertising.
bylines Dimension
The name of the person, company, or entity that funded the ad. This field is available only for political and issue-related ads, providing transparency about the ad's financial source.
country Dimension
The country or countries where the ad was delivered or targeted.
currency Dimension
The currency used for reporting the ad's spend.
delivery_by_region Dimension
Geographic regions where the ad was delivered, including breakdowns for specific countries or locations.
demographic_distribution Dimension
The distribution of the ad's audience across various demographic categories such as age and gender.
estimated_audience_size_lower_bound Dimension
The minimum estimated size of the audience reached by the ad.
estimated_audience_size_upper_bound Dimension
The maximum estimated size of the audience reached by the ad.
eu_total_reach Metric
The total estimated reach of the ad within the European Union.
gender_female Metric
The percentage or number of female users reached by the ad.
gender_male Metric
The percentage or number of male users reached by the ad.
gender_unknown Metric
The percentage or number of users with an unknown gender reached by the ad.
id Dimension
A unique identifier for the ad within the Facebook Ad Library.
impressions_lower_bound Dimension
The minimum estimated number of times the ad was viewed.
impressions_upper_bound Dimension
The maximum estimated number of times the ad was viewed.
page_id Dimension
The unique identifier of the Facebook Page that ran the ad.
page_name Dimension
The name of the Facebook Page that ran the ad.
payer Dimension
The entity or individual that paid for the ad, often required for transparency in political or issue-based advertising.
publisher_platforms Dimension
A list of platforms where the ad was published, such as Facebook, Instagram, Messenger, or Audience Network.
spend_lower_bound Dimension
The minimum estimated amount of money spent on the ad.
spend_upper_bound Dimension
The maximum estimated amount of money spent on the ad.
target_ages Dimension
The specific age ranges that the ad was configured to target.
target_gender Dimension
The specific genders that the ad was configured to target.
target_locations Dimension
The specific geographic locations or regions that the ad was configured to target.