config.yaml

# This access_token is a User access token w/ permission to access API
access_token: <FILL IN>

page_total: 100   # Should be a maximum of 1,000
search_total: 100   # You can query a maximum of 5,000 ads

ad_active_status: ACTIVE   # ACTIVE, INACTIVE, or ALL

# You can provide search terms and/or page IDs.
search_terms: aoc
# search_page_ids:   # Max 10 pages
#   - !!str 153080620724   # page_ids should be str, not int
#   - !!str 416707608450706

# Fields for querying all possible metadata from the API
query_fields:
  - ad_creation_time
  - ad_creative_body
  - ad_creative_link_caption
  - ad_creative_link_description
  - ad_creative_link_title
  - ad_delivery_start_time
  - ad_delivery_stop_time
  - ad_snapshot_url
  - demographic_distribution
  - funding_entity
  - impressions
  - page_id
  - page_name
  - region_distribution
  - spend

# Fields which are included in the main CSV, including derived fields
output_fields:
  - ad_id
  - page_id
  - page_name
  - ad_creative_body
  - ad_creative_link_caption
  - ad_creative_link_description
  - ad_creative_link_title
  - ad_delivery_start_time
  - ad_delivery_stop_time
  - funding_entity
  - impressions_min
  - impressions_max
  - spend_min
  - spend_max
  - ad_url

# Fields for the unnested CSVs
demo_fields:
  - ad_id
  - age
  - gender
  - percentage

region_fields:
  - ad_id
  - region
  - percentage

demo_ages:
  - 18-24
  - 25-34
  - 35-44
  - 45-54
  - 55-64
  - 65+

demo_genders:
  - male
  - female
  - unknown

regions:
  - Alabama
  - Arkansas
  - California
  - Connecticut
  - Florida
  - Georgia
  - Idaho
  - Illinois
  - Indiana
  - Kansas
  - Kentucky
  - Maryland
  - Massachusetts
  - Minnesota
  - Mississippi
  - Nebraska
  - New Jersey
  - New Mexico
  - New York
  - North Carolina
  - Ohio
  - Oregon
  - South Carolina
  - South Dakota
  - Tennessee
  - Virginia
  - Washington
  - West Virginia
  - Montana
  - Pennsylvania
  - Wisconsin
  - Alaska
  - Arizona
  - Colorado
  - Delaware
  - Washington, District of Columbia
  - Hawaii
  - Iowa
  - Louisiana
  - Maine
  - Michigan
  - Missouri
  - North Dakota
  - Oklahoma
  - Rhode Island
  - Nevada
  - New Hampshire
  - Texas
  - Utah
  - Vermont
  - Wyoming