TOOL API

ad_get

Gets regular ads and Smart Creative ads. To retrieve creative materials for Smart Creative ads, use `/ad/aco/get/`. Deleted ads are excluded by default; to include them, set `primary_status` to `STATUS_DELETE` or set `secondary_status` to `AD_STATUS_CAMPAIGN_DELETE`, `AD_STATUS_ADGROUP_DELETE`, or `AD_STATUS_DELETE`.

ecommerceOAuth1 credits

Call information

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

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

filtering

Filters for the query. Example: `filtering={"campaign_automation_type":"UPGRADED_SMART_PLUS"}`.

page

Current page number. Default: `1`. Value range: `>= 1`.

page_size

Page size. Default: `10`. Value range: `1-1000`.