v2

latestOpenAPI 3.1.02026-08-075421692.0 MB

Ad Accounts

List ad accounts

Returns the platform ad accounts available for the given social account (e.g. Meta ad accounts, TikTok advertiser IDs, Google Ads customer IDs).

For TikTok agencies: enumerates every advertiser under every Business Center the token can read (paginated server-side), then chunks the lookup against TikTok's /advertiser/info/ endpoint (which has a per-call cap of ≤100 IDs). Solo advertisers without a BC fall back to the OAuth-time advertiser_ids list. Cached for 1h on the SocialAccount; lazy-refreshed on first call after expiry.

For Google Ads: responds 429 when Google's API quota is temporarily exhausted (instead of an empty list). Retry after a delay.

get/v1/ads/accounts

Query parameters

accountIdstring required

Social account ID

adAccountIdstring

Filter response to a single platform ad account ID (e.g. act_123 for Meta, advertiser_id for TikTok). Returns at most one item.

limitinteger

Clamp the returned accounts[] length. Useful for typeahead pickers on agency tokens with hundreds of advertisers.

Response

Ad accounts