Ads · Ad Accounts

List account snippets

Returns account snippets. Works with Google Ads.

GEThttps://api.pozy.ai/v1/ads/accounts/structured-snippets

Google WorkspacelistAccountStructuredSnippets

Request

Send your API key as Authorization: Bearer pz_live_.... Read-only keys can call it. Keys with the ads resource group disabled get 403 resource_group_disabled. Authentication

Query parameters

Name	Type	Notes
`accountId`required	string	Matches `^[a-fA-F0-9]{24}$`
`adAccountId`	string	Matches `^\d+$`
`customerId`	string	Matches `^\d+$`

Example

curl -X GET "https://api.pozy.ai/v1/ads/accounts/structured-snippets?accountId=696e0b682d0a31188e7a2ba9" \
  -H "Authorization: Bearer $POZY_API_KEY"

const res = await fetch("https://api.pozy.ai/v1/ads/accounts/structured-snippets?accountId=696e0b682d0a31188e7a2ba9", {
  headers: { Authorization: `Bearer ${process.env.POZY_API_KEY}` },
});
const data = await res.json();
if (!res.ok) throw new Error(data?.error ?? `Request failed with status ${res.status}`);
console.log(data);

import os
import requests

resp = requests.get(
    "https://api.pozy.ai/v1/ads/accounts/structured-snippets",
    headers={"Authorization": f"Bearer {os.environ['POZY_API_KEY']}"},
    params={
        "accountId": "696e0b682d0a31188e7a2ba9",
    },
    timeout=30,
)
resp.raise_for_status()
print(resp.json())

Response

200 on success

customerIdstring
structuredSnippetsarray of object
- assetIdstring
- statusstring
- assetResourceNamestring
- customerAssetResourceNamestring
- headerstring
- valuesarray of string
cachedAtstring (date-time)
Can be null.
staleboolean

200 response

{
  "customerId": "691909ff82eb5ed7c816716d",
  "structuredSnippets": [
    {
      "assetId": "649acf9abd13dbccc57b6012",
      "status": "active",
      "assetResourceName": "Acme",
      "customerAssetResourceName": "Acme",
      "header": "string",
      "values": [
        "string"
      ]
    }
  ],
  "cachedAt": "2026-10-02T09:00:00.000Z",
  "stale": true
}

Errors

Errors use one shape: { error, type, code, param?, details? }. The ones you are most likely to see here:

400	invalid_request_error	A parameter or body field is missing or invalid. `param` names it.
401	authentication_error	The API key is missing, revoked or expired.
403	permission_error	The key is scoped to other profiles or has this resource group disabled.
429	rate_limit_error	Too many requests this minute. Wait for `Retry-After` seconds.

Every code is listed in Errors.

More in Ad Accounts

GETList comments on an ad POSTReply to an ad comment POSTHide or unhide an ad comment DELDelete an ad comment GETList TikTok Business Centers GETAd account change / audit log GETA/B tests and lift studies GETList Instagram ad identities GETList Instagram posts to boost GETList advertisable apps GETGet iOS 14 campaign limits GETBusinesses list GETBusiness users GETPage users of a business POSTAssign a user to a Page DELRemove a user from a Page GETList ad labels POSTCreate a Google Ads label PATCHUpdate a Google Ads label DELRemove a Google Ads label POSTAttach a Google Ads label DELDetach a Google Ads label GETList high-demand periods POSTSchedule a budget increase GETList value rule sets POSTCreate a value rule set GETRead a value rule set PUTReplace a value rule set DELDelete a value rule set GETList negative keyword lists POSTCreate a negative keyword list GETGet a negative keyword list PUTRename a negative keyword list DELDelete a negative keyword list PUTReplace negative list keywords GETList account callouts POSTAdd account callouts PUTUpdate account callouts DELRemove account callout GETList account sitelinks POSTAdd account sitelinks PUTUpdate account sitelinks DELRemove account sitelink POSTAdd account snippets PUTUpdate account snippets DELRemove account snippet GETGet manager account hierarchy POSTInvite a client account to a manager PATCHAccept, decline, cancel or end a manager link GETGet ad account billing POSTSet up ad account billing (monthly invoicing)GETList user access invitations POSTInvite a user to an ad account by email DELRevoke a user access invitation GETList invitations awaiting multi-party approval DELWithdraw an invitation awaiting multi-party approval GETAd account users POSTAssign a user to an ad account DELRemove a user from an ad account GETAd account finances GETCheck an ad account before creating ads GETRead an ad account's campaigns and ad sets live GETList ad accounts POSTCreate ad account PATCHUpdate ad account settings GETGet ad account DSA defaults GETGet DSA recommendations GETList custom conversions POSTCreate custom conversion GETList TikTok ad pixels