Skip to content

NEWUnify Agents (MCP): governed AI access to finance data. Early access.See Unify Agents

ADS API

Ad spend joined to revenue and SKUs.

Campaigns, ad groups, spend, clicks and conversions from Google, Meta, TikTok and Amazon Ads, joined to orders and products on the Unify Graph.

Sample data

GET /v1/ads/insights?level=campaign&date_from=2026-10-01

{
  "data": [
    {
      "campaign": {
        "id": "cmp_01JC4A9W2E",
        "name": "Racking - Shopping"
      },
      "platform": "google_ads",
      "date": "2026-10-01",
      "currency": "USD",
      "spend": "212.40",
      "impressions": 18440,
      "clicks": 391,
      "conversions": "14",
      "attributed_revenue": "2086.00"
    }
  ],
  "next_cursor": "c_eyJvZmZzZXQiOjF9"
}

OBJECTS

Supported objects.

Read and write status comes from coverage data for each platform on this API. Write shows only where write-back is confirmed.

  • Ad Accounts

    Read on roadmapNo write-back

    On 7 of 7 platforms.

  • Campaigns

    Read on roadmapWrite on roadmap

    On 7 of 7 platforms.

  • Conversions

    Read on roadmapNo write-back

    On 7 of 7 platforms.

  • Insights

    Read on roadmapNo write-back

    On 7 of 7 platforms.

  • Ads

    Read on roadmapNo write-back

    On 6 of 7 platforms.

  • Ad Groups

    Read on roadmapNo write-back

    On 5 of 7 platforms.

Also in the data model: Budget (R/W where allowed), Product Group.

See object-level coverage by platform

NO LOWEST COMMON DENOMINATOR

Same depth as a direct integration.

  • Custom fields.

    Map your customers' custom fields into the model, per connection, without code changes.

  • Raw records.

    Every object carries the platform's original record in raw, for the edge cases.

  • Passthrough.

    Call any native endpoint with Unify auth, rate limiting and logging.

  • Entities and currencies.

    Subsidiaries, locations and currencies are fields, not afterthoughts.

Spend you can tie to margin.

  • One metric set.

    Spend, impressions, clicks and conversions defined the same way everywhere.

  • Currency and timezone safe.

    Daily metrics in the account's timezone and currency, with normalized totals.

  • SKU-level joins.

    Shopping and product ads link to SKUs in the Catalog API.

Coverage, object by object.

Live, beta and roadmap status for every object below.

Coverage, object by object.: coverage by platform and capability
PlatformReadWriteWebhooksBank feedsCatalog/PIM
Amazon AdsOn the roadmapOn the roadmapNot supportedNot supportedNot supported
Google AdsOn the roadmapOn the roadmapNot supportedNot supportedNot supported
LinkedIn AdsOn the roadmapOn the roadmapNot supportedNot supportedNot supported
Meta AdsOn the roadmapOn the roadmapNot supportedNot supportedNot supported
Microsoft AdvertisingOn the roadmapOn the roadmapNot supportedNot supportedNot supported
Pinterest AdsOn the roadmapOn the roadmapNot supportedNot supportedNot supported
TikTok AdsOn the roadmapOn the roadmapNot supportedNot supportedNot supported
  • Live
  • Beta
  • On the roadmap
  • Via Technology Center
  • Not supported

Ads API questions.

Why would a finance or commerce product need ads data?

Lenders underwrite on spend efficiency, and commerce tools report margin after acquisition cost. Both need spend next to revenue.

Can we change budgets or pause campaigns?

Read is the default. Budget and status writes are available on selected platforms and listed per integration.

How far back can we pull metrics?

As far as each platform allows; limits are listed on each integration page.

Is there a sandbox?

Yes. Sandbox access is free for early-access teams and design partners: demo companies on QuickBooks Online, Xero and Shopify, and test credentials for other platforms where the vendor offers them. Request it on the Get started page.

Can I reach fields you don't model?

Yes: through raw, custom field mapping, or passthrough requests to native endpoints.

Get started

Connect once. Build everything else on top.

Request sandbox access, or book 30 minutes with an engineer to map your integrations.

Free sandbox access. No credit card. Reply within one business day.