X (Twitter) Ads

X (Twitter) Ads is an advertising platform that lets you run promoted tweets, accounts, and campaigns across X. Connecting it to Coupler.io lets you pull your ad performance data automatically into any destination — no manual exports, no copy-pasting.

With Coupler.io, you can:

• Export campaign, ad group, and promoted tweet performance data on a schedule

• Combine X Ads data with other ad platforms (Google Ads, Meta Ads) using Append or Join transformations

• Send data to Google Sheets, Excel, BigQuery, Looker Studio, or AI destinations like ChatGPT, Claude, or Gemini

• Segment reports by device, location, gender, interest, keyword, and more

Prerequisites

• An active X (Twitter) Ads account

• Access to at least one ad account (you'll select it during setup)

• A Coupler.io account (free trial available)

Quick start

Start with the Campaign entity to get a high-level view of spend and performance before drilling into ad groups or promoted tweets.

How to connect

1

Create a new data flow in Coupler.io and select X (Twitter) Ads as your source.

2

Authorize via OAuth. Click "Connect" and sign in to your X account. Coupler.io will request read access to your X Ads data. Once authorized, your account will appear in the source settings.

3

Select your ad account. Choose one or more ad accounts you want to pull data from.

4

Choose an entity. Pick the report type you need — Campaign, Ad group, Promoted tweet, and so on. See the table below for what each entity contains.

5

Choose a destination. Connect Google Sheets, Excel, BigQuery, Looker Studio, or an AI destination like ChatGPT or Claude, then run the data flow manually to confirm everything is working.

Available entities

Entity	What it contains
Campaign	Spend, impressions, and performance metrics at the campaign level
Ad group (Line item)	Targeting settings and metrics broken down by ad group
Promoted tweet	Engagement and performance data per promoted tweet
Promoted account	Follower campaign metrics
Media creative	Creative-level data for media-based ads
Funding instrument	Billing and budget information per funding source
Account	Top-level account summary metrics