Connector

Collect X Ads Data into Google BigQuery

Own your X Ads data in Google BigQuery with OWOX Data Marts. Collect analytics-ready advertising data directly into BigQuery, control schema and refresh logic, and reuse it across BI tools and AI Insights.

Get Started Free

Endpoints

X Ads Endpoints

Documentation

10 X Ads endpoints you can import. Each lands in its own table in your warehouse.

  • Accounts

    Advertising accounts — name, business, country, timezone, and approval status.

    12 fields
  • Ad Performance

    Daily ad performance by placement — impressions, clicks, spend, engagements, and social actions.

    20 fieldsTime series
  • Ad Performance by Country

    Daily ad performance broken down by country — impressions, clicks, spend, engagements, and social actions.

    21 fieldsTime series
  • All Cards

    All card types with full creative details — type, title, destination URL, call to action, and media.

    28 fields
  • Campaigns

    Your campaigns — status, budget optimization, daily and total budget, and currency.

    19 fields
  • Cards

    Website and app cards — type, URI, and components.

    8 fields
  • Line Items

    Line items within campaigns — bid strategy, goal, product type, budget, and schedule.

    33 fields
  • Promoted Tweets

    Tweets promoted as ads — status, approval, and links to their tweets and line items.

    8 fields
  • Targeting Locations

    Reference table of location IDs with names and country codes — join targeting_value with the country field in Ad Performance by Country.

    4 fields
  • Tweets

    Original tweets used as ad creatives — text, type, language, engagement counts, and card URI.

    34 fields

S01 · Step 1

Step 1: Create a Google BigQuery Data Storage

Start by connecting your own Google BigQuery project as a data storage.

  • Use your own BigQuery project and datasets
  • Keep full ownership of X Ads data
  • No third-party data warehouses

Connect BigQuery

Step 1: Create a Google BigQuery Data Storage

S02 · Step 2

Step 2: Create an X Ads Data Mart

Create a new Data Mart and choose Connector as the definition type.

  • Select X Ads as the data source
  • Connect your X Ads account
  • No API coding or engineering required

Create X Ads Data Mart

Step 2: Create an X Ads Data Mart

S03 · Step 3

Step 3: Select Fields & Configure Data Import

Choose exactly which X Ads data you want to store in BigQuery.

  • Select the appropriate X Ads API endpoint
  • Choose fields such as impressions, clicks, spend, engagements, and campaign attributes
  • Define the destination dataset and table name in BigQuery

Configure Data Import

Step 3: Select Fields & Configure Data Import

S04 · Step 4

Step 4: Run & Schedule X Ads Data Collection

Once published, control how and when X Ads data is imported.

  • Incremental load to import the current day’s data
  • Backfill (custom period) to load historical data
  • All runs are logged and visible in Run History

Run Data Mart

Step 4: Run & Schedule X Ads Data Collection

S05 · Step 5

Step 5: Use X Ads Data Across BI Tools & AI Insights

Your X Ads data is now available in Google BigQuery.

  • Analyze performance in Google Sheets or Looker Studio
  • Join X Ads data with GA4, CRM, or revenue datasets
  • Enable AI Insights for alerts, summaries, or performance questions

Activate Your Data

Step 5: Use X Ads Data Across BI Tools & AI Insights

What users are saying

Every claim has a receipt.

Real things real customers said — each quote pinned to a specific claim, straight from the quotes database.

A3re: trusting AI
Nodari RizunNodari RizunFounder & CEO, Pürblack®
“AI, by the nature of the models, will hallucinate. And because of that, you need something which will create guardrails to ensure that there are no hallucinations, that you can trust your data.”
C9re: one source of truth
Mark SimmonsMark SimmonsCMO, Pürblack®
“We had six or seven different channels and no single source of truth — it was almost impossible, a lot of guesswork.”
E7re: getting time back
Nodari RizunNodari RizunFounder & CEO, Pürblack®
“We regained time. And time is the one resource that never comes back.”

Turn X Ads Data into Business Decisions

Schedule a quick walkthrough to see how OWOX Data Marts helps you collect X Ads data in BigQuery, reduce reporting chaos, and scale analytics with confidence.

Get Started Free

Trust

Data Partner You Can Trust

users

175K

Executives and data analysts across 20+ industries

G2 rating

4.9★

“A trusted data analytics partner” — verified review

npm installs

156K

In Open Source We Trust

Customers