Ads transparency

In 2023, X relaunched Ads Transparency for the Digital Services Act (DSA). For ads served in the EU, this Ad Repository will include the following: Advertiser, Funding Entity, the Advertiser’s Main Targeting Parameters for the advertisement, Impression, and Reach of Ad to provide transparency around advertisements on the platform.

X is also providing an archived version of Ads Transparency Center (ATC) data from all Political ads that ran between May 24, 2018 and November 22, 2019 and Issue ads that ran between August 08, 2018 and November 22, 2019.

Political advertising

You can download an archive of political ads that ran from May 24, 2018 to November 22, 2019.

Download .TXT

Issue advertising (US only)

You can download an archive of issue ads that ran from August 08, 2018 to November 22, 2019. 

Download .TXT

Finally, If you’re interested in learning more about any and all ads being served to you, you can download this information by clicking on Your Account in the Settings & Privacy tab.

Steps for API Access to X Ads Repository:

  1. Create X developer account at the X Developer portal
  2. Once you have account, create a app and get a bearer token
  3. Then you will be able to make a curl request like which will provide you a exportId:
      curl 'https://api.twitter.com/graphql/e9OJa7fJKHtHftkNzcRkzw/CreateExportReportMutation' \
  -H 'authorization: Bearer myToken' \
  -H 'content-type: application/json' \
  --data-raw '{"variables":{"user":"$userIdOfHandle","geoLocation":"$GeoCode","deliveryRange":{"start_date":"YYYY-MM-DD","end_date":"YYYY-MM-DD"}}}' \
  --compressed
    

4. To look up the status of your request you can make a request like:

      curl 'https://api.twitter.com/graphql/0RTLTx4DunPS6rVj-1cLCg/GetExportReportStatusQuery?variables=%7B%22exportId%22%3A%myExportId%22%7D' \
  -H 'authorization: Bearer myToken' \
  --compressed
    

Ready to get started?