Connectors

/

Sources

/

OpenAI Ads

  • Source
  • Marketing Analytics
  • Alpha

Move OpenAI Ads data anywhere it matters.

Sync OpenAI Ads ad account, campaigns and ad groups to any warehouse or AI app.

Source

OpenAI Ads

  • Snowflake
  • BigQuery
  • Postgres
  • Databricks
  • Claude
Streams
19
Destinations
50+
Standard support
0.1.9

Overview

What is the Airbyte OpenAI Ads connector?

The Airbyte OpenAI Ads connector extracts data from OpenAI Ads and loads it into 50+ destinations such as Snowflake, BigQuery, Databricks or Postgres, with full refresh and incremental sync. It publishes 19 streams you can select per connection.

  • 01

    Sync to your warehouse

    Land 19 OpenAI Ads tables in 50+ destinations on a schedule you control.

  • 02

    Incremental syncs

    Pull only the records that changed since the last run instead of reloading everything.

  • 03

    One authorization

    Authenticate OpenAI Ads once and Airbyte keeps every scheduled sync running on it.

  • 04

    Cloud or self-hosted

    Run the OpenAI Ads connector on Cloud, OSS, Hybrid.

19 streams

Every table you can sync from OpenAI Ads

  • ad_account
    Primary keyid
    Sync modesFullIncr.
  • campaigns
    Primary keyid
    Sync modesFullIncr.
  • ad_groups
    Primary keyid
    Sync modesFullIncr.
  • ads
    Primary keyid
    Sync modesFullIncr.
  • conversion_event_settings
    Primary keyid
    Sync modesFullIncr.
  • conversion_pixels
    Primary keyid
    Sync modesFullIncr.

Setup

Live in ten steps

  1. Log into your Airbyte Cloud account.

  2. In the left navigation bar, click Sources. In the top-right corner, click + New source.

  3. On the Set up the source page, select OpenAI Ads from the Source type dropdown.

Configuration fields

OpenAI Ads configuration fields
FieldTypeDescription
api_key*stringThe API key issued in the Settings page of OpenAI Ads Manager. Each key is scoped to one ad account. For more information, see OpenAI's documentation.
end_datestringDate in the ad account's time zone, in the format YYYY-MM-DD. Any data after this date will not be replicated. If empty or later than the current date in UTC-12 (the latest date that has started in every time zone), data is synced through that date.
lookback_windowintegerHow far into the past to look for records (in days) on every sync, so conversions attributed after the click are picked up. Use the click attribution window of the reports (30 days, the API default) plus 2 days, because OpenAI needs at least one day to process conversions. Used only for insights streams in incremental sync mode.
num_workersintegerThe number of worker threads to use for the sync. Increase this to speed up syncs for accounts with many campaigns. The default should work for most use cases.
start_datestringDate in the ad account's time zone, in the format YYYY-MM-DD. Any data before this date will not be replicated. Defaults to 2026-02-01, when ads in ChatGPT launched; there is no data before that. OpenAI keeps daily insights for the most recent 365 days and product insights for about 30 days, so older days are no longer available for those streams.

Hybrid deployment

Sovereign by architecture, not by policy.

The data plane runs in your environment. Records, credentials and keys stay with you; the control plane only receives configuration and job metadata.

  • Cloud
  • OSS
  • Hybrid

Your environment

DataConnectorsCredentialsKeys

↕ metadata only

Airbyte control plane

OrchestrationMonitoringUI

FAQ

OpenAI Ads connector questions

What data can I sync from OpenAI Ads with Airbyte?

19 streams, including ad account, campaigns, ad groups, ads, conversion event settings, conversion pixels, custom audiences, spend limit windows and more.

Does the OpenAI Ads connector support incremental sync?

Yes. The OpenAI Ads connector supports incremental sync on selected streams, and full refresh on every stream.

Where can I run the OpenAI Ads connector?

Run the OpenAI Ads connector on Cloud, OSS, Hybrid. Hybrid deployments keep the data plane in your environment while the control plane orchestrates syncs.

Didn't find your answer? Talk to sales

Start syncing OpenAI Ads in minutes.

Free 14-day trial. No credit card needed.