TOOL API

campaign_get

Gets campaigns for an ad account, with optional filters to return only matching campaigns. Deleted campaigns are excluded by default; to query them, set `primary_status` to `STATUS_DELETE` or `secondary_status` to `CAMPAIGN_STATUS_DELETE`. Promote campaigns have limited retrievable fields when filtered via `campaign_system_origins`. Deprecated GMV Max filters are documented, but to filter GMV Max campaigns you should use `/gmv_max/campaign/get/` instead.

ecommerceOAuth1 credits

Call information

Tool slug: tiktok-ads.campaign_get
Provider: TikTok for Business
Average response: 0 ms
Calls in 7 days: 0

Input parameters

advertiser_idrequired

Advertiser ID.

exclude_field_types_in_response

Types of fields to omit from the response.

fields

Fields to return. If omitted, all fields are returned by default. Allowed values are the field names under the response `list` object.

filtering

Filters applied to the campaign list. Example: `filtering={"campaign_automation_type":"UPGRADED_SMART_PLUS"}`.

page

Current page number. Default value: `1`. Must be greater than or equal to 1.

page_size

Page size. Default value: `10`. Valid range: 1 to 1,000.