- Source
- Marketing Analytics
- Alpha
Move Apple Ads data anywhere it matters.
Move Apple Ads data into your warehouse, lake or AI app.
Source
Apple Ads

Snowflake
BigQuery
Postgres
Databricks
Claude
- Destinations
- 50+
- Standard support
- 1.1.24
Overview
What is the Airbyte Apple Ads connector?
The Airbyte Apple Ads connector extracts data from Apple Ads and loads it into 50+ destinations such as Snowflake, BigQuery, Databricks or Postgres, with full refresh and incremental sync. It publishes tables and events you can select per connection.
- 01
Sync to your warehouse
Land Apple Ads data 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 Apple Ads once and Airbyte keeps every scheduled sync running on it.
- 04
Cloud or self-hosted
Run the Apple Ads connector on Cloud, OSS, Hybrid.
Setup
Live in five steps
Sign in to Apple Ads as an account administrator, select the account from the Users menu, and go to Account Settings → User Management.
Click Invite Users. In User Access and Role, select an API role, such as API Account Manager or API Account Read Only, and send the invite. The invited user activates the account from the invitation email.
As the API user, generate a private key and extract its public key: bash openssl ecparam -genkey -name prime256v1 -noout -out private-key.pem openssl ec -in private-key.pem -pubout -out public-key.pem
In Apple Ads, go to Account Settings → API, paste the contents of public-key.pem into Public Key, and click Save. Apple then shows your clientId, teamId, and keyId.
Create the client secret: a JWT signed with private-key.pem using the ES256 algorithm, with these values: - Header: alg is ES256 and kid is your keyId. - Payload: sub is your clientId, iss is your teamId, aud is https://appleid.apple.com, iat is the current UNIX timestamp, and exp is a UNIX timestamp less than 180 days after iat. The encoded JWT is the value for Client Secret in Airbyte. Keep the private key secure; you need it every time you create a new client secret.
Configuration fields
| Field | Type | Description |
|---|---|---|
| client_id* | string | The client ID of your Apple Ads API user. Apple shows it in Account Settings > API after you upload the user's public key. See Implementing OAuth for the Apple Ads API. |
| client_secret* | string | A client secret JWT that you sign with the API user's private key (ES256). Apple accepts a client secret for at most 180 days, so generate a new one and update this field before it expires. See Implementing OAuth for the Apple Ads API. |
| org_id* | integer | The identifier of the organization that owns the campaign. Your Org Id is the same as your account in the Apple Search Ads UI. |
| start_date* | string | Start getting data from that date. Apple serves daily reports for the last 90 days only, so report streams need a Start Date within that window. |
| backoff_factor | integer | Multiplier for the delay between retries of temporary Apple Ads API errors on the report streams. Valid values are integers between 1 and 20. |
| end_date | string | Data is retrieved until that date (included) |
| lookback_window | integer | Apple Search Ads uses a 30-day attribution window. However, you may consider smaller values in order to shorten sync durations, at the cost of missing late data attributions. |
| num_workers | integer | The number of concurrent workers for syncing data. Increase this value to speed up syncs for accounts with many campaigns and ad groups, at the cost of higher API usage. Valid values are 1 to 20. |
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
Airbyte control plane
FAQ
Apple Ads connector questions
What data can I sync from Apple Ads with Airbyte?
The Apple Ads connector syncs the tables and events published in Airbyte docs.
Does the Apple Ads connector support incremental sync?
Yes. The Apple Ads connector supports incremental sync on selected streams, and full refresh on every stream.
Where can I run the Apple Ads connector?
Run the Apple 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 Apple Ads in minutes.
Free 14-day trial. No credit card needed.