Skip to content
Truto

Unified API

Unified Ads Management API

One standardized interface to read and write advertising management data across every provider. 7 unified resources, 3 supported integrations, zero provider-specific code.

https://api.truto.one/unified/ads
Start integrating API docs
7

Unified resources

3

Supported integrations

Pass‑through

Real-time, no data storage

Data Model

Ads resources

Every resource is normalized across providers. Use the same schema whether your customer is on Google Ads or LinkedIn.

Accounts

Accounts are the top level resource in the Ads API. Each account has a unique ID and contains a set of campaigns.

10 fields Docs →
Accounts fields
id string
name string
currency_code string
status string
timezone object
type array
spend object
disable_reason string
created_at string
updated_at string

Ad Groups

Ad Groups are the third level resource in the Ads API. Each ad_group has a unique ID and contains a set of ads.

23 fields Docs →
Ad Groups fields
id string
name string
status string
account_id string
campaign_id string
labels array
attribution_spec string
bid object
billing_event string
budget object
spend object
impressions object
destination object
start_time string
stop_time string
issues array
optimization_goal string
promoted_object object
targeting object
targeting_optimization_types array
schedule object
created_at string
updated_at string

Ads

Ads are the fourth level resource in the Ads API. Each ad has a unique ID and contains a set of creatives.

18 fields Docs →
Ads fields
id string
name string
type string
status string
account_id string
ad_group_id string
campaign_id string
labels array
schedule object
bid object
conversion_domain string
creative object
creative_id array
issues array
preview_url array
tracking_specs array
created_at string
updated_at string

Assets

The assets like images, videos, etc. which can be used in the ads and creatives.

14 fields Docs →
Assets fields
id string
type string
account_id string
creative_id array
hash string
height integer
width integer
name string
original_height integer
original_width integer
status string
urls array
created_at string
updated_at string

Campaigns

Campaigns are the second level resource in the Ads API. Each campaign has a unique ID and contains a set of ad_groups.

18 fields Docs →
Campaigns fields
id string
name string
status string
type string
account_id string
labels array
objective string
bid_strategy object
buying_type string
budget object
spend object
primary_attribution string
special_ad_categories array
special_ad_category string
start_time string
stop_time string
created_at string
updated_at string

Creatives

Creatives provide the layout and content for an ad.

18 fields Docs →
Creatives fields
id string
name string
status string
account_id string
labels array
applink_treatment string
authorization_category string
body string
call_to_action_type string
image_crops object
image_hash string
image_url string
properties array
spec object
interactive_components object
urls array
created_at string
updated_at string

Custom Audiences

10 fields Docs →
Custom Audiences fields
id string
name string
description string
type string
source string
status string
account_id string
members array
created_at string
updated_at string

Integrations

3 integrations, one API

Connect to any of these providers through the Unified Ads Management API. Same resources, same schema, same code.

Google Ads LinkedIn Meta Marketing API

How It Works

From zero to integrated

Go live with the Unified Ads Management API in under an hour. No boilerplate, no maintenance burden.

01

Connect your customer’s account

Use Truto’s pre-built auth flows to connect any advertising management provider. OAuth, API keys, and custom auth — all handled.

02

Query the unified API

Read and write data through a single, normalized REST API. Same endpoints, same schema, regardless of the underlying provider.

03

Customize with JSONata

Need a field the unified model doesn’t cover? Extend the schema with declarative JSONata mappings — no code deploys, no waiting on us.

Unified Ads Management API

Start building with the Unified Ads Management API

3 integrations. 7 unified resources. Zero provider-specific code. Ship advertising management integrations in hours, not months.

Talk to us