TikTok Marketing API Adgroup API
The Adgroup API from TikTok Marketing API — 4 operation(s) for adgroup.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/tiktok-ads-adgroup-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
OpenAPI Specification
openapi: 3.2.0
info:
title: TikTok API for Business — Marketing Adgroup API
description: TikTok API for Business (Marketing API) v1.3. This document is a mechanical union of the 202 per-operation OpenAPI 3.0.1 documents TikTok publishes in yml_files/ of its own SDK repository (https://github.com/tiktok/tiktok-business-api-sdk), which are the swagger-codegen inputs for TikTok's first-party Java/Python/JavaScript SDKs. Operation content (paths, parameters, responses, tags and the x-open-* extensions) is preserved verbatim; only info, servers and components.securitySchemes were written by API Evangelist, because the per-operation fragments carry placeholder info blocks and no servers block. The servers values are the production and sandbox base URLs TikTok documents at https://business-api.tiktok.com/portal/docs?id=1738855331457026 .
version: v1.3
contact:
name: TikTok API for Business support
url: https://business-api.tiktok.com/portal/docs?id=1795190020378625
termsOfService: https://business-api.tiktok.com/portal/docs?id=1737191804348417
x-source: https://github.com/tiktok/tiktok-business-api-sdk/tree/main/yml_files
x-harvested-by: API Evangelist enrichment pipeline
x-harvested: '2026-08-13'
servers:
- url: https://business-api.tiktok.com/open_api/v1.3
description: Production
- url: https://sandbox-ads.tiktok.com/open_api/v1.3
description: Sandbox
security:
- AccessToken: []
tags:
- name: Adgroup
paths:
/smart_plus/adgroup/create/:
post:
operationId: Smart_plus Adgroup Create
parameters:
- description: Authorized access token. For details, see [Authentication](https://ads.tiktok.com/marketing_api/docs?id=1738373164380162).
in: query
name: Access-Token
required: true
schema:
type: string
requestBody:
content:
application/json:
schema:
properties:
adgroup_name:
description: ''
type: string
x-open-allow-strlist: false
x-open-allow-strnum: false
x-open-field-id: 2
x-open-source: $.http.body.name
advertiser_id:
description: ''
type: string
x-open-allow-strlist: false
x-open-allow-strnum: false
x-open-convert:
- int64(%s)
x-open-field-id: 1
x-open-source: $.http.body.advertiser_id
app_id:
description: ''
type: string
x-open-allow-strlist: false
x-open-allow-strnum: false
x-open-convert:
- int64(%s)
x-open-field-id: 6
x-open-source: $.http.body.ad_ref_app_id
attribution_event_count:
description: ''
type: string
x-open-allow-strlist: false
x-open-allow-strnum: false
x-open-enum:
enum_package_expired: false
enum_package_id: 1807532923759682
enum_package_name: AttributionStatisticType
enums:
- description: ''
is_valid: true
key: EVERY
value: '2'
- description: ''
is_valid: true
key: ONCE
value: '1'
- description: ''
is_valid: true
key: UNSET
value: '0'
key_format: string
strict: true
use_part: false
validate_only: false
value_format: int32
x-open-field-id: 41
x-open-source: $.http.body.attribution_statistic_type
bid_price:
description: ''
format: double
type: number
x-open-allow-strlist: false
x-open-allow-strnum: false
x-open-field-id: 31
x-open-source: $.http.body.bid
bid_type:
description: ''
type: string
x-open-allow-strlist: false
x-open-allow-strnum: false
x-open-enum:
enum_package_expired: false
enum_package_id: 1804193278233601
enum_package_name: SmartBidType
enums:
- description: 手动出价
is_valid: true
key: BID_TYPE_CUSTOM
value: '0'
- description: ''
is_valid: true
key: BID_TYPE_MAX_CONVERSION
value: '3'
- description: 国际化no-bid出价
is_valid: true
key: BID_TYPE_NO_BID
value: '7'
key_format: string
strict: true
use_part: false
validate_only: false
value_format: int32
x-open-field-id: 29
x-open-source: $.http.body.smart_bid_type
billing_event:
description: ''
type: string
x-open-allow-strlist: false
x-open-allow-strnum: false
x-open-enum:
enum_package_expired: false
enum_package_id: 1807532822255618
enum_package_name: PricingType
enums:
- description: ''
is_valid: true
key: CPA
value: '7'
- description: ''
is_valid: true
key: CPC
value: '2'
- description: ''
is_valid: true
key: CPM
value: '1'
- description: ''
is_valid: true
key: CPV
value: '10'
- description: ''
is_valid: true
key: GD
value: '6'
- description: ''
is_valid: true
key: OCPM
value: '9'
key_format: string
strict: true
use_part: false
validate_only: false
value_format: int32
x-open-field-id: 30
x-open-source: $.http.body.pricing
budget:
description: ''
format: double
type: number
x-open-allow-strlist: false
x-open-allow-strnum: false
x-open-field-id: 14
x-open-source: $.http.body.budget
budget_mode:
description: ''
type: string
x-open-allow-strlist: false
x-open-allow-strnum: false
x-open-enum:
enum_package_expired: false
enum_package_id: 1804191062647810
enum_package_name: BudgetMode
enums:
- description: ''
is_valid: true
key: BUDGET_MODE_DAY
value: '0'
- description: ''
is_valid: true
key: BUDGET_MODE_DYNAMIC_DAILY_BUDGET
value: '3'
- description: ''
is_valid: true
key: BUDGET_MODE_INFINITE
value: '-1'
- description: ''
is_valid: true
key: BUDGET_MODE_TOTAL
value: '1'
key_format: string
strict: true
use_part: false
validate_only: false
value_format: int32
x-open-field-id: 15
x-open-source: $.http.body.budget_mode
campaign_id:
description: ''
type: string
x-open-allow-strlist: false
x-open-allow-strnum: false
x-open-convert:
- int64(%s)
x-open-field-id: 3
x-open-source: $.http.body.campaign_id
catalog_authorized_bc_id:
description: ''
type: string
x-open-allow-strlist: false
x-open-allow-strnum: false
x-open-convert:
- int64(%s)
x-open-field-id: 34
x-open-source: $.http.body.catalog_authorized_bc
catalog_id:
description: ''
type: string
x-open-allow-strlist: false
x-open-allow-strnum: false
x-open-convert:
- int64(%s)
x-open-field-id: 33
x-open-source: $.http.body.product_platform_id
click_attribution_window:
description: ''
type: string
x-open-allow-strlist: false
x-open-allow-strnum: false
x-open-enum:
enum_package_expired: false
enum_package_id: 1807532889086018
enum_package_name: AttributionWindow
enums:
- description: ''
is_valid: true
key: FOURTEEN_DAYS
value: '14'
- description: ''
is_valid: true
key: 'OFF'
value: '-1'
- description: ''
is_valid: true
key: ONE_DAY
value: '1'
- description: ''
is_valid: true
key: SEVEN_DAYS
value: '7'
- description: ''
is_valid: true
key: TWENTY_EIGHT_DAYS
value: '28'
- description: ''
is_valid: true
key: UNSET
value: '0'
key_format: string
strict: true
use_part: false
validate_only: false
value_format: int32
x-open-field-id: 38
x-open-source: $.http.body.attribution_window_click
comment_disabled:
default: false
description: ''
type: boolean
x-open-allow-strlist: false
x-open-allow-strnum: false
x-open-convert:
- int32(%s)
x-open-field-id: 12
x-open-source: $.http.body.is_comment_disable
conversion_bid_price:
description: ''
format: double
type: number
x-open-allow-strlist: false
x-open-allow-strnum: false
x-open-field-id: 32
x-open-source: $.http.body.cpa_bid
custom_conversion_id:
description: ''
type: string
x-open-allow-strlist: false
x-open-allow-strnum: false
x-open-convert:
- int64(%s)
x-open-field-id: 49
dayparting:
description: ''
type: string
x-open-allow-strlist: false
x-open-allow-strnum: false
x-open-field-id: 19
x-open-source: $.http.body.dayparting
deep_bid_type:
description: ''
type: string
x-open-allow-strlist: false
x-open-allow-strnum: false
x-open-enum:
enum_package_expired: false
enum_package_id: 1804193389572097
enum_package_name: DeepBidType
enums:
- description: AEO直投出价
is_valid: true
key: AEO
value: '101'
- description: 标准出价
is_valid: true
key: DEFAULT
value: '0'
- description: 自定义出价
is_valid: true
key: MIN
value: '1'
- description: 动态出价
is_valid: true
key: PACING
value: '2'
- description: 非中VO highest value
is_valid: true
key: VO_HIGHEST_VALUE
value: '109'
- description: ROI自动出价，非中含义为VO target CPA
is_valid: true
key: VO_MIN
value: '7'
- description: 非中VO minRoas
is_valid: true
key: VO_MIN_ROAS
value: '108'
key_format: string
strict: true
use_part: false
validate_only: false
value_format: int32
x-open-field-id: 26
x-open-source: $.http.body.deep_bid_type
deep_cpabid:
description: ''
format: double
type: number
x-open-allow-strlist: false
x-open-allow-strnum: false
x-open-field-id: 27
x-open-source: $.http.body.deep_cpabid
deep_funnel_event_source:
description: ''
type: string
x-open-allow-strlist: false
x-open-allow-strnum: false
x-open-enum:
enum_package_expired: false
enum_package_id: 1829411592902721
enum_package_name: EventSourceIdType
enums:
- description: ''
is_valid: true
key: CRM
value: '5'
- description: ''
is_valid: true
key: OFFLINE
value: '4'
- description: ''
is_valid: true
key: PIXEL
value: '1'
key_format: string
strict: true
use_part: false
validate_only: false
value_format: int32
x-open-field-id: 45
x-open-source: $.http.body.deep_funnel_event_source
deep_funnel_event_source_id:
description: ''
type: string
x-open-allow-strlist: false
x-open-allow-strnum: false
x-open-field-id: 46
x-open-source: $.http.body.deep_funnel_event_source_id
deep_funnel_optimization_event:
description: ''
type: string
x-open-allow-strlist: false
x-open-allow-strnum: false
x-open-enum:
enum_package_expired: false
enum_package_id: 1799795326256129
enum_package_name: ExternalAction
enums:
- description: ''
is_valid: true
key: ACTIVE
value: '8'
- description: ''
is_valid: true
key: ACTIVE_PAY
value: '14'
- description: ''
is_valid: true
key: ACTIVE_REGISTER
value: '13'
- description: ''
is_valid: true
key: ADD_BILLING
value: '266'
- description: ''
is_valid: true
key: ADD_BOOKSHELF
value: '116'
- description: ''
is_valid: true
key: ADD_PAYMENT_INFO
value: '127'
- description: ''
is_valid: true
key: ADD_TO_WISHLIST
value: '128'
- description: ''
is_valid: true
key: ANCHOR_CLICK
value: '308'
- description: ''
is_valid: true
key: APPLET_DEAL
value: '126'
- description: application approval
is_valid: true
key: APPLICATION_APPROVAL
value: '321'
- description: ''
is_valid: true
key: APPOINTMENT_DOWNLOAD_BUTTON
value: '173'
- description: ''
is_valid: true
key: ASCRIPTION_PHONE
value: '161'
- description: ''
is_valid: true
key: AUTHORIZATION
value: '121'
- description: ''
is_valid: true
key: BANKCARD_INFORMATION
value: '107'
- description: ''
is_valid: true
key: BOOST
value: '124'
- description: ''
is_valid: true
key: BUTTON
value: '5'
- description: ''
is_valid: true
key: CERTIFICATION_INFORMATION
value: '109'
- description: ''
is_valid: true
key: CLICK_CALL_DY
value: '69'
- description: ''
is_valid: true
key: CLICK_DOWNLOAD
value: '68'
- description: ''
is_valid: true
key: CLICK_LANDING_PAGE
value: '66'
- description: ''
is_valid: true
key: CLICK_SHOPWINDow
value: '67'
- description: ''
is_valid: true
key: CLICK_WEBSITE
value: '70'
- description: ''
is_valid: true
key: CLUE_CONFIRM
value: '194'
- description: ''
is_valid: true
key: CLUE_HIGH_INTENTION
value: '196'
- description: ''
is_valid: true
key: CLUE_INTERFLOW
value: '195'
- description: ''
is_valid: true
key: CLUE_PAY_SUCCEED
value: '218'
- description: ''
is_valid: true
key: COMMENT_ACTION
value: '47'
- description: ''
is_valid: true
key: COMMODITY_CLICK
value: '122'
- description: ''
is_valid: true
key: COMPLETE_TUTORIAL
value: '131'
- description: ''
is_valid: true
key: CONSULT
value: '97'
- description: ''
is_valid: true
key: CONSULT_CLUE
value: '123'
- description: ''
is_valid: true
key: CONSULT_EFFECTIVE
value: '19'
- description: ''
is_valid: true
key: CONVERSION_LEADS
value: '313'
- description: ''
is_valid: true
key: COUPON
value: '28'
- description: ''
is_valid: true
key: CREATE_GAMEROLE
value: '38'
- description: ''
is_valid: true
key: CUSTOMER_EFFECTIVE
value: '26'
- description: customize product
is_valid: true
key: CUSTOMIZE_PRODUCT
value: '318'
- description: ''
is_valid: true
key: DEEP_PURCHASE
value: '52'
- description: ''
is_valid: true
key: DESTINATION_VISIT
value: '272'
- description: ''
is_valid: true
key: DIALBACK
value: '33'
- description: ''
is_valid: true
key: DIALBACK_CONFIRM
value: '34'
- description: ''
is_valid: true
key: DIALBACK_CONNECT
value: '35'
- description: ''
is_valid: true
key: DOWNLOAD_BUTTON
value: '155'
- description: ''
is_valid: true
key: DOWNLOAD_DETAIL
value: '154'
- description: ''
is_valid: true
key: DOWNLOAD_FINISH
value: '4'
- description: ''
is_valid: true
key: DOWNLOAD_START
value: '9'
- description: ''
is_valid: true
key: EC_CLICK_BUY
value: '175'
- description: ''
is_valid: true
key: EC_CLICK_PRODUCT
value: '179'
- description: ''
is_valid: true
key: EC_CONFRIM_DEAL
value: '214'
- description: ''
is_valid: true
key: EC_LIVE_CART
value: '210'
- description: ''
is_valid: true
key: EC_LIVE_CLICK_PRODUCT_ACTION
value: '208'
- description: ''
is_valid: true
key: EC_LIVE_COMMENT_ACTION
value: '205'
- description: ''
is_valid: true
key: EC_LIVE_ENTER_ACTION
value: '202'
- description: ''
is_valid: true
key: EC_LIVE_FOLLOW_ACTION
value: '204'
- description: ''
is_valid: true
key: EC_LIVE_GIFT_ACTION
value: '206'
- description: ''
is_valid: true
key: EC_LIVE_NATIVE_ACTION
value: '203'
- description: ''
is_valid: true
key: EC_LIVE_ORDER
value: '211'
- description: ''
is_valid: true
key: EC_LIVE_REDIRECT_TO_STORE_ACTION
value: '209'
- description: ''
is_valid: true
key: EC_LIVE_SLIDECART_CLICK_ACTION
value: '207'
- description: ''
is_valid: true
key: EC_SUBMIT_ORDER
value: '176'
- description: ''
is_valid: true
key: EFFECTIVE_COPY
value: '27'
- description: ''
is_valid: true
key: ENGAGED_SESSION
value: '319'
- description: ''
is_valid: true
key: ENGAGED_VIEW
value: '309'
- description: ''
is_valid: true
key: ENGAGED_VIEW_FIFTEEN
value: '311'
- description: ''
is_valid: true
key: ENTER_HOMEPAGE
value: '181'
- description: ''
is_valid: true
key: FEED_LIVE_HOMEPAGE
value: '120'
- description: find location
is_valid: true
key: FIND_LOCATION
value: '316'
- description: ''
is_valid: true
key: FOLLOW_ACTION
value: '46'
- description: ''
is_valid: true
key: FOLLOW_LIVE_ENTER
value: '250'
- description: ''
is_valid: true
key: FOLLOW_VIDEO_PLAY_FINISH
value: '252'
- description: ''
is_valid: true
key: FORM
value: '2'
- description: ''
is_valid: true
key: FORM_ANSWER
value: '32'
- description: ''
is_valid: true
key: FORM_BUTTON
value: '151'
- description: ''
is_valid: true
key: FORM_CONNECT
value: '31'
- description: ''
is_valid: true
key: FORM_DEEP
value: '36'
- description: ''
is_valid: true
key: FORM_DETAIL
value: '150'
- description: ''
is_valid: true
key: GAME_ADDICTION
value: '25'
- description: ''
is_valid: true
key: HIGHVALUE_CLUE
value: '42'
- description: ''
is_valid: true
key: IDCARD_INFORMATION
value: '106'
- description: ''
is_valid: true
key: IMPRESSION_LEVEL_AD_REVENUE
value: '312'
- description: ''
is_valid: true
key: INITIATE_ORDER
value: '267'
- description: ''
is_valid: true
key: INSTALL_FINISH
value: '15'
- description: ''
is_valid: true
key: INTENTION_CLUE
value: '41'
- description: ''
is_valid: true
key: INVALID_CLUE
value: '40'
- description: ''
is_valid: true
key: IN_APP_AD_CLICK
value: '132'
- description: ''
is_valid: true
key: IN_APP_AD_IMPR
value: '133'
- description: ''
is_valid: true
key: IN_APP_CART
value: '22'
- description: ''
is_valid: true
key: IN_APP_DETAIL_UV
value: '29'
- description: ''
is_valid: true
key: IN_APP_ORDER
value: '20'
- description: ''
is_valid: true
key: IN_APP_PAY
value: '23'
- description: ''
is_valid: true
key: IN_APP_UV
value: '21'
- description: ''
is_valid: true
key: LANDING_PAGE_VIEW
value: '271'
- description: ''
is_valid: true
key: LAUNCH_APP
value: '129'
- description: ''
is_valid: true
key: LIKE_ACTION
value: '45'
- description: ''
is_valid: true
key: LINK_ACTION
value: '51'
- description: ''
is_valid: true
key: LIVE_APPOINTMENT
value: '249'
- description: ''
is_valid: true
key: LIVE_CARD_CLICK
value: '215'
- description: ''
is_valid: true
key: LIVE_CLICK_PRODUCT_ACTION
value: '167'
- description: ''
is_valid: true
key: LIVE_COMMENT_ACTION
value: '164'
- description: ''
is_valid: true
key: LIVE_ENTER_ACTION
value: '171'
- description: ''
is_valid: true
key: LIVE_FOLLOW_ACTION
value: '163'
- description: ''
is_valid: true
key: LIVE_GIFT_ACTION
value: '165'
- description: ''
is_valid: true
key: LIVE_HOMEPAGE
value: '111'
- description: ''
is_valid: true
key: LIVE_JOIN_GROUP
value: '248'
- description: ''
is_valid: true
key: LIVE_NATIVE_ACTION
value: '162'
- description: ''
is_valid: true
key: LIVE_REDIRECT_TO_STORE_ACTION
# --- truncated at 32 KB (268 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/tiktok-ads/refs/heads/main/openapi/tiktok-ads-adgroup-api-openapi.yml