Ad Accounts

List ad labels

Changed on

Lists the labels used to organise campaigns and ads in an ad account.

  • Meta: pass adAccountId=act_<n>. Rows are Meta's /act_X/adlabels returned verbatim (id, name, created/updated time), paginated with limit / after.
  • Google Ads: pass the numeric customer id as adAccountId (optional when the connection has a single customer). Returns every non-removed label as a GoogleAdLabel in one page (paging.after is always null). Reads are cached for 10 minutes; when the shared Google quota is exhausted the last successful result is served with stale: true.
get/v1/ads/labels

Request

  • Base URL: https://zernio.com/api
  • URL: https://zernio.com/api/v1/ads/labels
  • Auth: HTTP bearer

Query parameters

accountIdstring required

Zernio SocialAccount id. For Meta, the posting or ads variant used to resolve the token.

adAccountIdstring

Meta ad account id (act_<n>), or the Google Ads customer id (digits only).

customerIdstring

Google only. Alias of adAccountId, kept for existing callers.

limitinteger

Meta only. Rows per page.

afterstring

Meta only. Cursor from paging.after of the previous page.

Response

Ad labels

adAccountIdstring

Meta act_<n>, or the resolved Google customer id

cachedAtstring date-time nullable

Google only. When the served list was fetched from Google.

staleboolean

Google only. True when Google quota was exhausted and the last cached list was served.

Changes

  • 450ec6ec5b0eRevision changes
    • info

      added the non-success response with the status

  • f8c8f34fb41aRevision changes
    • warning

      added the new account enum value to the / response property for the response status

    • warning

      added the new account enum value to the / response property for the response status

    • warning

      added the new account enum value to the / response property for the response status

    • warning

      added the new account enum value to the / response property for the response status