# 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

{% hint style="success" %}
Start with the **Campaign** entity to get a high-level view of spend and performance before drilling into ad groups or promoted tweets.
{% endhint %}

## How to connect

{% stepper %}
{% step %}
**Create a new data flow** in Coupler.io and select **X (Twitter) Ads** as your source.
{% endstep %}

{% step %}
**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.
{% endstep %}

{% step %}
**Select your ad account.** Choose one or more ad accounts you want to pull data from.
{% endstep %}

{% step %}
**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.
{% endstep %}

{% step %}
**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.
{% endstep %}
{% endstepper %}

## 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                                 |