TikTok Ads
Grupos de anúncios
GET
Uma linha por grupo de anúncios: meta de otimização, evento de cobrança, lance, orçamento, posicionamentos e programação.
Este recurso não tem coluna de data: dateFrom e dateTo são recusados.
As linhas são ordenadas por adgroup_id, integration_id, inserted_at e paginadas com page/limit; meta.hasNextPage diz se existe outra página.
As respostas ficam em cache por 30 minutos.
ClientIdAuthClientSecretAuthheader
x-client-id<token>Client ID
header
x-client-secret<token>Client secret
organizationId*stringOrganização dona das contas conectadas.
Formato
uuidintegrationId?stringUma conta conectada desta integração (o integration_id das linhas). Omita para ler todas as contas da organização.
Tamanho
length <= 255page?integerNúmero da página, a partir de 1.
Intervalo
1 <= value <= 1000000Padrão
1limit?integerLinhas por página (máximo 5000).
Intervalo
1 <= value <= 5000Padrão
500Uma página de linhas
application/json- response
data*array<>meta*curl -X GET "https://example.com/v1/tiktok-ads/ad-groups?organizationId=3f2b8c1e-5d4a-4e6f-9a7b-1c2d3e4f5a6b"{ "data": [ { "organization_id": "3f2b8c1e-5d4a-4e6f-9a7b-1c2d3e4f5a6b", "integration_id": "9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d", "user_id": "123456", "document_id": "123456", "integration_name": "example", "advertiser_id": "123456", "campaign_id": "123456", "campaign_name": "example", "adgroup_id": "123456", "adgroup_name": "example", "operation_status": "example", "secondary_status": "example", "optimization_goal": "example", "optimization_event": "example", "billing_event": "example", "bid_type": "example", "budget": "125.50", "budget_mode": "example", "placement_type": "example", "placements": "example", "schedule_start_time": "example", "schedule_end_time": "example", "create_time": "example", "modify_time": "example", "inserted_at": "2026-10-01T12:00:00.000Z" } ], "meta": { "page": 1, "limit": 500, "hasNextPage": false, "hasPreviousPage": false }}