List all groups

GET/ads/{connection_id}/group

Parameters

limitnumber default=100
offsetnumber default=0
updated_gtedate
Return only results whose updated date is equal or greater to this value (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
sort enum
order enum
querystring
Query string to search. eg. email address or name
org_idstring
The org ID to filter by (reference to AdsOrganization)
campaign_idstring
The campaign ID to filter by
parent_idstring
The parent ID to filter by
io_idstring
The IO ID to filter by
start_gtestring
The start date to filter by (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
end_ltstring
The end date to filter by (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
statusstring
The status to filter by
fieldsstring array
Fields to return
rawstring
Raw parameters to include in the 3rd-party request. Encoded as a URL component. eg. raw parameters: foo=bar&zoo=bar -> raw=foo%3Dbar%26zoo%3Dbar
connection_idstring required
ID of the connection

Returns

idstring
created_atdate
(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
updated_atdate
(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
namestring
parent_idstring
campaign_idstring
organization_idstring
insertionorder_idstring
status enum
Valid values:
"UNSPECIFIED"
"ACTIVE"
"PAUSED"
"ARCHIVED"
"DRAFT"
targetingobject
bid_amountnumber
bid_strategyobject
YOUTUBE_AND_PARTNERS
budget_amountnumber
budget_period enum
Valid values:
"DAILY"
"MONTHLY"
"TOTAL"
"LIFETIME"
budget_allocation_type enum
Valid values:
"UNSPECIFIED"
"AUTOMATIC"
"FIXED"
"UNLIMITED"
start_atdate
(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
end_atdate
(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
budget_unit enum
Valid values:
"UNSPECIFIED"
"CURRENCY"
"IMPRESSIONS"
budget_max_amountnumber
type enum
Valid values:
"TEXT"
"IMAGE"
"VIDEO"
"RESPONSIVE"
"SHOPPING"
has_eu_political_adsboolean
pacingobject
frequency_capobject
creative_idsstring array
optimization_goal enum
Valid values:
"REACH"
"IMPRESSIONS"
"LINK_CLICKS"
"LANDING_PAGE_VIEWS"
"CONVERSIONS"
Optimization goals for ads_group (cross-platform; platform-specific values allowed as pass-through)
billing_event enum
Valid values:
"IMPRESSIONS"
"LINK_CLICKS"
"VIDEO_VIEWS"
"APP_INSTALLS"
"ENGAGEMENT"
Billing events for ads_group (what you pay for; cross-platform; platform-specific values allowed as pass-through)
currencystring
promoted array
const options = {
  method: 'GET',
  url: 'https://api.unified.to/ads/5de520f96e439b002043d8dc/group',
  headers: {
    authorization: 'bearer .....'
  },
  params: {
    limit: 50,
    offset: 0,
    updated_gte: '2026-06-30T19:51:01.337Z',
    sort: 'updated_at',
    order: 'asc',
    query: '',
    org_id: '',
    campaign_id: '',
    parent_id: '',
    io_id: '',
    start_gte: '',
    end_lt: '',
    status: '',
    fields: '',
    raw: '',
  }
};

const results = await axios.request(options);
Are we missing anything? Let us know
Was this page helpful?