Skip to main content
Google AdsVersion: v3

Get audiences

GET/ad-publishing/google/audiences

Retrieve Google Ads combined audiences for a location. Without limit the response is a plain array. When limit is provided (max 100, default 100) the response is a paginated { audiences, paging } envelope; pass pageToken (from paging.next) to fetch the next batch.

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your access token.

Scope:adPublishing.readonly
Auth methods:OAuthPrivate Integration
Token type:Sub-Account Token

Request​

Headers

Versionstringrequired

API Version

Available optionsv3
Example:v3

Query Parameters

locationIdstringrequired

Location identifier

Example:loc_abc123
limitstring

Page size for a paginated fetch (max 100, defaults to 100). When set, the response is a { audiences, paging } envelope instead of a plain array.

Example:100
pageTokenstring

Opaque cursor for the next batch, taken from the previous response paging.next

Example:100

Response

application/json

A plain array of audiences (default), or a { audiences, paging } envelope when limit is provided

oneOf
  • Array items
    • resourceNamestringrequired

    Google Ads resource name

    Example:customers/6776452901/audiences/330214962
    idstringrequired

    Audience id

    Example:330214962
    statusstringrequired

    Audience status

    Example:ENABLED
    namestringrequired

    Audience name

    Example:Returning customers
    scopestringrequired

    Scope the audience is defined at

    Example:CUSTOMER
    dimensionsobjectrequired

    Inclusion targeting

    exclusionDimensionobjectrequired

    Exclusion targeting