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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.coupler.io/sources/category/ppc/twitter-ads.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.