TikTok Marketing API APP Management API
The APP Management API from TikTok Marketing API — 6 operation(s) for app management.
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-app-management-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: TikTok API for Business — Marketing APP Management 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: APP Management
paths:
/app/create/:
post:
operationId: App 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:
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.AdvertiserId
download_url:
description: ''
format: url
type: string
x-open-allow-strlist: false
x-open-allow-strnum: false
x-open-field-id: 2
x-open-source: $.http.body.DownloadUrl
enable_retargeting:
default: NON_RETARGETING
description: ''
type: string
x-open-allow-strlist: false
x-open-allow-strnum: false
x-open-enum:
enum_package_expired: false
enum_package_id: null
enum_package_name: null
enums:
- description: ''
is_valid: true
key: RETARGETING
value: '1'
- description: ''
is_valid: true
key: NON_RETARGETING
value: '0'
key_format: string
strict: true
use_part: false
validate_only: false
value_format: int32
x-open-field-id: 5
x-open-source: $.http.body.RetargetingState
partner:
description: ''
type: string
x-open-allow-strlist: false
x-open-allow-strnum: false
x-open-enum:
enum_package_expired: false
enum_package_id: 1816188710840322
enum_package_name: partnerForAppCreate
enums:
- description: ''
is_valid: true
key: AdBrix
value: '14'
- description: ''
is_valid: true
key: Adform
value: '23'
- description: ''
is_valid: true
key: Adjust
value: '2'
- description: ''
is_valid: true
key: Adzcore
value: '7'
- description: ''
is_valid: true
key: AppAdforce
value: '5'
- description: ''
is_valid: true
key: AppLink
value: '13'
- description: ''
is_valid: true
key: AppMetrica
value: '20'
- description: ''
is_valid: true
key: AppsFlyer
value: '1'
- description: ''
is_valid: true
key: BASE
value: '48'
- description: ''
is_valid: true
key: BigCommerce
value: '36'
- description: ''
is_valid: true
key: Cafe24
value: '47'
- description: ''
is_valid: true
key: Cinarra
value: '31'
- description: ''
is_valid: true
key: Dentsu
value: '21'
- description: ''
is_valid: true
key: DoubleClick
value: '10'
- description: ''
is_valid: true
key: ECWID
value: '37'
- description: ''
is_valid: true
key: FlashTalking
value: '12'
- description: ''
is_valid: true
key: Huangbaoche
value: '15'
- description: ''
is_valid: true
key: Kantar
value: '30'
- description: ''
is_valid: true
key: Kochava
value: '4'
- description: ''
is_valid: true
key: Lazada
value: '16'
- description: ''
is_valid: true
key: LeadBolt
value: '17'
- description: ''
is_valid: true
key: Macromil
value: '27'
- description: ''
is_valid: true
key: Magento
value: '40'
- description: ''
is_valid: true
key: Metaps
value: '18'
- description: ''
is_valid: true
key: Nielsen
value: '25'
- description: ''
is_valid: true
key: OpenCart
value: '45'
- description: ''
is_valid: true
key: Other
value: '9'
- description: ''
is_valid: true
key: Placed_powered_by_Foursquare
value: '26'
- description: ''
is_valid: true
key: PrestaShop
value: '38'
- description: ''
is_valid: true
key: SHOPLINE
value: '46'
- description: ''
is_valid: true
key: Salesforce
value: '44'
- description: ''
is_valid: true
key: ServingsSys
value: '11'
- description: ''
is_valid: true
key: Shopify
value: '34'
- description: ''
is_valid: true
key: Singular
value: '6'
- description: ''
is_valid: true
key: Square
value: '35'
- description: ''
is_valid: true
key: Tenjin
value: '8'
- description: ''
is_valid: true
key: Testee
value: '28'
- description: ''
is_valid: true
key: TikTokCustomInstantPage
value: '41'
- description: ''
is_valid: true
key: TikTokEC1PSeller
value: '42'
- description: ''
is_valid: true
key: TikTokEC3PStore
value: '43'
- description: ''
is_valid: true
key: TikTokLeadAd
value: '33'
- description: ''
is_valid: true
key: TlnkIo
value: '3'
- description: ''
is_valid: true
key: Vidoadsplus
value: '19'
- description: ''
is_valid: true
key: Weborama
value: '29'
- description: ''
is_valid: true
key: WooCommerce
value: '39'
- description: ''
is_valid: true
key: doubleverify
value: '24'
- description: ''
is_valid: true
key: myTracker
value: '22'
key_format: string
strict: true
use_part: false
validate_only: false
value_format: int32
x-open-field-id: 4
x-open-source: $.http.body.PartnerId
tracking_url:
description: ''
properties:
click_url:
description: ''
type: string
x-open-allow-strlist: false
x-open-allow-strnum: false
x-open-field-id: 1
x-open-source: $.http.body.Tracking.ClickUrl
impression_url:
description: ''
type: string
x-open-allow-strlist: false
x-open-allow-strnum: false
x-open-field-id: 2
x-open-source: $.http.body.Tracking.ImpressionUrl
retargeting_click_url:
description: ''
type: string
x-open-allow-strlist: false
x-open-allow-strnum: false
x-open-field-id: 3
x-open-source: $.http.body.Tracking.RetargetingClickUrl
retargeting_impression_url:
description: ''
type: string
x-open-allow-strlist: false
x-open-allow-strnum: false
x-open-field-id: 4
x-open-source: $.http.body.Tracking.RetargetingImpressionUrl
type: object
x-open-allow-strlist: false
x-open-allow-strnum: false
x-open-field-id: 3
x-open-source: $.http.body.Tracking
required:
- advertiser_id
- download_url
type: object
x-open-allow-strlist: false
x-open-allow-strnum: false
responses:
'200':
content:
application/json:
schema:
properties:
code:
description: Response code. For the complete list of response codes and descriptions, see [Appendix - Return Codes](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097). Will be shown only if it is an error request.
format: int64
type:
- integer
- 'null'
x-open-allow-strlist: false
x-open-field-id: 4
data:
description: Returned data. The response for the SDK can be checked in the document for the API given in the description.
properties: {}
type:
- object
- 'null'
x-open-allow-strlist: false
x-open-field-id: 1
x-open-source: $.rpc.output.data
message:
description: Response message. For details, see [Appendix - Return Codes](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097).
type:
- string
- 'null'
x-open-allow-strlist: false
x-open-field-id: 3
request_id:
description: The log ID of a request, which uniquely identifies the request.
type:
- string
- 'null'
x-open-allow-strlist: false
x-open-field-id: 2
type: object
x-open-allow-strlist: false
description: OK
summary: Create an app. [APP Create](https://business-api.tiktok.com/portal/docs?id=1740859280958466)
tags:
- APP Management
x-open-allowlist: {}
x-open-denylist: {}
x-open-rules:
base_rule: null
extra_rule:
base_source: []
http_query_source: []
http_source:
- name: AdvertiserId
required: true
source: $.http.body.advertiser_id
type: number
- name: DownloadUrl
required: true
source: $.http.body.download_url
type: string
- children:
- name: ClickUrl
required: false
source: $.http.body.tracking_url.click_url
type: string
- name: ImpressionUrl
required: false
source: $.http.body.tracking_url.impression_url
type: string
- name: RetargetingClickUrl
required: false
source: $.http.body.tracking_url.retargeting_click_url
type: string
- name: RetargetingImpressionUrl
required: false
source: $.http.body.tracking_url.retargeting_impression_url
type: string
is_expand: true
name: Tracking
required: false
type: object
- name: PartnerId
required: false
source: $.http.body.partner
type: number
- name: RetargetingState
required: false
source: $.http.body.enable_retargeting
type: number
- name: CoreUserId
required: false
source: $.context.core_user_id
type: number
plugins:
after_response: []
before_request: []
request_query_rule: null
request_rule:
AdvertiserId: $.http.body.advertiser_id
CoreUserId: $.context.core_user_id
DownloadUrl: $.http.body.download_url
PartnerId: $.http.body.partner
RetargetingState: $.http.body.enable_retargeting
Tracking:
ClickUrl: $.http.body.tracking_url.click_url
ImpressionUrl: $.http.body.tracking_url.impression_url
RetargetingClickUrl: $.http.body.tracking_url.retargeting_click_url
RetargetingImpressionUrl: $.http.body.tracking_url.retargeting_impression_url
response_cookie: []
response_header: []
response_rule:
app_id: $.rpc.output.id
x-open-scene-labels: []
x-open-settings:
pop_resp_nullvalue: false
/app/info/:
get:
operationId: App Info
parameters:
- description: ''
in: query
name: advertiser_id
required: true
schema:
type: string
x-open-allow-strlist: false
x-open-allow-strnum: false
x-open-convert:
- int64(%s)
x-open-source: $.http.query.advertiser_id
x-open-field-id: 1
- description: ''
in: query
name: app_id
required: true
schema:
type: string
x-open-allow-strlist: false
x-open-allow-strnum: false
x-open-convert:
- int64(%s)
x-open-source: $.http.query.app_id
x-open-field-id: 2
- 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
responses:
'200':
content:
application/json:
schema:
properties:
code:
description: Response code. For the complete list of response codes and descriptions, see [Appendix - Return Codes](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097). Will be shown only if it is an error request.
format: int64
type:
- integer
- 'null'
x-open-allow-strlist: false
x-open-field-id: 4
data:
description: Returned data. The response for the SDK can be checked in the document for the API given in the description.
properties: {}
type:
- object
- 'null'
x-open-allow-strlist: false
x-open-field-id: 1
x-open-source: $.rpc.output.data
message:
description: Response message. For details, see [Appendix - Return Codes](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097).
type:
- string
- 'null'
x-open-allow-strlist: false
x-open-field-id: 3
request_id:
description: The log ID of a request, which uniquely identifies the request.
type:
- string
- 'null'
x-open-allow-strlist: false
x-open-field-id: 2
type: object
x-open-allow-strlist: false
description: OK
summary: Get info of an app. [APP Info](https://business-api.tiktok.com/portal/docs?id=1740859272887297)
tags:
- APP Management
x-open-allowlist: {}
x-open-denylist: {}
x-open-rules:
base_rule: null
extra_rule:
base_source: []
http_query_source: []
http_source:
- name: advertiser_id
required: true
source: $.http.query.advertiser_id
type: number
- name: app_id
required: true
source: $.http.query.app_id
type: number
plugins:
after_response: []
before_request: []
request_query_rule: null
request_rule:
advertiser_id: $.http.query.advertiser_id
app_id: $.http.query.app_id
response_cookie: []
response_header: []
response_rule:
app: $.rpc.output.app
x-open-scene-labels: []
x-open-settings:
pop_resp_nullvalue: false
/app/list/:
get:
operationId: App List
parameters:
- description: Advertiser ID.
in: query
name: advertiser_id
required: true
schema:
type: string
x-open-allow-strlist: false
x-open-allow-strnum: false
x-open-convert:
- int64(%s)
x-open-source: $.http.query.advertiser_id
x-open-field-id: 1
- content:
application/json:
schema:
items:
type: string
x-open-allow-strlist: false
x-open-allow-strnum: false
type: array
x-open-allow-strlist: false
x-open-allow-strnum: false
x-open-source: $.http.query.app_platform_ids
description: List of app platform ID for filter purpose.
in: query
name: app_platform_ids
required: false
x-open-field-id: 2
- 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
responses:
'200':
content:
application/json:
schema:
properties:
code:
description: Response code. For the complete list of response codes and descriptions, see [Appendix - Return Codes](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097). Will be shown only if it is an error request.
format: int64
type:
- integer
- 'null'
x-open-allow-strlist: false
x-open-field-id: 4
data:
description: Returned data. The response for the SDK can be checked in the document for the API given in the description.
properties: {}
type:
- object
- 'null'
x-open-allow-strlist: false
x-open-field-id: 1
x-open-source: $.rpc.output.data
message:
description: Response message. For details, see [Appendix - Return Codes](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097).
type:
- string
- 'null'
x-open-allow-strlist: false
x-open-field-id: 3
request_id:
description: The log ID of a request, which uniquely identifies the request.
type:
- string
- 'null'
x-open-allow-strlist: false
x-open-field-id: 2
type: object
x-open-allow-strlist: false
description: OK
summary: Get the app list. [APP List](https://business-api.tiktok.com/portal/docs?id=1740859313270786)
tags:
- APP Management
x-open-allowlist: {}
x-open-denylist: {}
x-open-rules:
base_rule: null
extra_rule:
base_source: []
http_query_source: []
http_source:
- name: advertiser_id
required: true
source: $.http.query.advertiser_id
type: number
- children:
- type: string
is_expand: true
name: app_platform_ids
required: true
source: $.http.query.app_platform_ids[]
sub_type: string
type: array
plugins:
after_response: []
before_request: []
request_query_rule: null
request_rule:
advertiser_id: $.http.query.advertiser_id
app_platform_ids: $.http.query.app_platform_ids[]
response_cookie: []
response_header: []
response_rule:
apps: $.rpc.output.apps
x-open-scene-labels: []
x-open-settings:
pop_resp_nullvalue: false
/app/optimization_event/:
get:
operationId: App Optimization_event
parameters:
- description: Your App ID, obtained after successfully creating your app.
in: query
name: app_id
required: true
schema:
type: string
x-open-allow-strlist: false
x-open-allow-strnum: false
x-open-convert:
- int64(%s)
x-open-source: $.http.query.app_id
x-open-field-id: 1
- description: Advertiser ID
in: query
name: advertiser_id
required: true
schema:
type: string
x-open-allow-strlist: false
x-open-allow-strnum: false
x-open-convert:
- int64(%s)
x-open-source: $.http.query.advertiser_id
x-open-field-id: 2
- content:
application/json:
schema:
items:
type: string
x-open-allow-strlist: false
x-open-allow-strnum: false
x-open-enum:
enum_package_expired: false
enum_package_id: null
enum_package_name: InventoryFlow
enums:
- description: ''
is_valid: true
key: PLACEMENT_TOPBUZZ
value: '1000'
- description: ''
is_valid: true
key: PLACEMENT_VIGO
value: '2000'
- description: ''
is_valid: true
key: PLACEMENT_TIKTOK
value: '3000'
- description: ''
is_valid: true
key: PLACEMENT_HELO
value: '4000'
- description: ''
is_valid: true
key: PLACEMENT_PANGLE
value: '9000'
- description: ''
is_valid: true
key: PLACEMENT_GLOBAL_APP_BUNDLE
value: '1000'
key_format: string
strict: true
use_part: false
validate_only: false
value_format: int32
minItems: 1
type: array
x-open-allow-strlist: false
x-open-allow-strnum: false
x-open-source: $.http.query.placement
description: 'The apps where you want to deliver your ads. Required when placement_type is PLACEMENT_TYPE_NORMAL, and ignored when placement_type is PLACEMENT_TYPE_AUTOMATIC. Note: Currently, we support PLACEMENT_TIKTOK, PLACEMENT_PANGLE and PLACEMENT_GLOBAL_APP_BUNDLE. Please don''t select PLACEMENT_TOPBUZZ or PLACEMENT_HELO as your placements since they''ve been deprecated. For a full list of enum values, see Enumeration - Placement. For Product Sales campaigns (objective_type = PRODUCT_SALES), only TikTok placement (PLACEMENT_TIKTOK) is supported.'
in: query
name: placement
required: false
x-open-field-id: 3
- description: '版位类型。 枚举值：PLACEMENT_TYPE_AUTOMATIC（自动版位）,PLACEMENT_TYPE_NORMAL （编辑版位）。 默认值: PLACEMENT_TYPE_NORMAL。'
in: query
name: placement_type
required: false
schema:
type: string
x-open-allow-strlist: false
x-open-allow-strnum: false
x-open-enum:
enum_package_expired: false
enum_package_id: null
enum_package_name: null
enums:
- description: ''
is_valid: true
key: PLACEMENT_TYPE_NORMAL
value: '1'
- description: ''
is_valid: true
key: PLACEMENT_TYPE_AUTOMATIC
value: '0'
key_format: string
strict: true
use_part: false
validate_only: false
value_format: int32
x-open-source: $.http.query.placement_type
x-open-field-id: 4
- description: Optimization goal. For enum values, see Enumeration-Optimization Goal for more
in: query
name: optimization_goal
required: true
schema:
type: string
x-open-allow-strlist: false
x-open-allow-strnum: false
x-open-convert:
- int32(%s)
x-open-enum:
enum_package_expired: false
enum_package_id: 1804193306612737
enum_package_name: OptimizeGoal
enums:
- description: ''
is_valid: true
key: ANCHOR_CLICK
value: '112'
- description: ''
is_valid: true
key: ANCHOR_CLICK_PURCHASE
value: '117'
- description: ''
is_valid: true
key: AUTOMATED_VALUE
value: '125'
- description: ''
is_valid: true
key: CLICK
value: '101'
- description: ''
is_valid: true
key: CONVERSATION
value: '124'
- description: ''
is_valid: true
key: CONVERSION_LEADS
value: '121'
- description: ''
is_valid: true
key: CONVERT
value: '100'
- description: ''
is_valid: true
key: DESTINATION_VISIT
value: '123'
- description: ''
is_valid: true
key: ENGAGED_VIEW
value: '118'
- description: ''
is_valid: true
key: ENGAGED_VIEW_FIFTEEM
value: '120'
- description: ''
is_valid: true
key: FOLLOWERS
value: '108'
- description: ''
is_valid: true
key: INSTALL
value: '105'
- description: ''
is_valid: true
key: IN_APP_EVENT
value: '106'
- description: ''
is_valid: true
key: LEAD_GENERATION
value: '107'
- description: ''
is_valid: true
key: MESSAGE
value: '119'
- description: ''
is_valid: true
key: MT_LIVE_FOLLOW
value: '126'
- description: ''
is_valid: true
key: MT_LIVE_ROOM
value: '113'
- description: ''
is_valid: true
key: MT_LIVE_SHOPPING
value: '116'
- description: ''
is_valid: true
key: PAGE_VISIT
value: '122'
- description: ''
is_valid: true
key: POST_ENGAGEMNT
value: '110'
- description: ''
is_valid: true
key: PREFERRED_LEAD
value: '127'
- description: ''
is_valid: true
key: PRODUCT_CLICK_IN_LIVE
value: '114'
- description: ''
is_valid: true
key: PROFILE_VIEWS
value: '109'
- description: ''
is_valid: true
key: REACH
value: '103'
- description: ''
# --- truncated at 32 KB (75 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/tiktok-ads/refs/heads/main/openapi/tiktok-ads-app-management-api-openapi.yml