TOOL API

adgroup_get

Gets detailed information for one or more ad groups from `/open_api/v1.3/adgroup/get/`. You can limit returned data with `fields` and filter results by campaign ID, objective, ad group ID, ad group name, creation time, billing event, status, and other supported filters. Deleted ad groups are excluded by default; to include them, set `filtering.primary_status` to `STATUS_DELETE` or use `ADGROUP_STATUS_DELETE` / `ADGROUP_STATUS_CAMPAIGN_DELETE` in `filtering.secondary_status`. If `fields` is omitted, all fields are returned. If `filtering` is omitted, all ad groups under the advertiser are returned.

ecommerceOAuth1 credits

Call information

Tool slug
tiktok-ads.adgroup_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

Field types to exclude from the response.

fields

List of ad group fields to return. If omitted, all available fields are returned by default.

filtering

Filter conditions for selecting ad groups. If omitted, all ad groups under the advertiser are returned. Example: `filtering={"campaign_automation_type":"UPGRADED_SMART_PLUS"}`.

page

Current page number. Default: `1`. Value must be greater than or equal to 1.

page_size

Page size. Default: `10`. Range: `1`-`1000`. If `filtering.buying_types` is `RESERVATION_TOP_VIEW`, the maximum allowed value is `100`.