TikTok Ads
Campaigns
GET
One row per campaign: objective, budget, bidding and status settings.
This resource has no date column: dateFrom and dateTo are rejected.
Rows are sorted by campaign_id, integration_id, inserted_at and paginated with page/limit; meta.hasNextPage says whether another page exists.
Responses are cached for 30 minutes.
ClientIdAuthClientSecretAuthheader
x-client-id<token>Client ID
header
x-client-secret<token>Client secret
organizationId*stringOrganization that owns the connected accounts.
Format
uuidintegrationId?stringOne connected account of this integration (integration_id of the rows). Omit it to read every account of the organization.
Length
length <= 255page?integerPage number, starting at 1.
Range
1 <= value <= 1000000Default
1limit?integerRows per page (max 5000).
Range
1 <= value <= 5000Default
500One page of rows
application/json- response
data*array<>meta*curl -X GET "https://example.com/v1/tiktok-ads/campaigns?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", "campaign_system_origin": "example", "create_time": "example", "modify_time": "example", "objective_type": "example", "objective": "example", "app_promotion_type": "example", "is_search_campaign": true, "is_smart_performance_campaign": true, "campaign_type": "example", "app_id": "123456", "is_advanced_dedicated_campaign": true, "campaign_app_profile_page_state": "example", "rf_campaign_type": "example", "campaign_product_source": "example", "special_industries": "example", "budget_optimize_on": true, "bid_type": "example", "deep_bid_type": "example", "roas_bid": "125.50", "optimization_goal": "example", "budget_mode": "example", "budget": "125.50", "rta_id": "123456", "rta_product_selection_enabled": true, "operation_status": "example", "secondary_status": "example", "postback_window_mode": "example", "is_new_structure": true, "inserted_at": "2026-10-01T12:00:00.000Z" } ], "meta": { "page": 1, "limit": 500, "hasNextPage": false, "hasPreviousPage": false }}