TikTok Marketing API Tool API
The Tool API from TikTok Marketing API — 19 operation(s) for tool.
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-tool-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 Tool 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: Tool
paths:
/search/region/:
get:
operationId: Search Region
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-field-id: 1
- description: 'The language you want the returned region name to be translated into. Default value: en Currently, we only support zh, fr, es, ko, vi, en, hi, it, tr, ru, ja, id, de, ms, ar, and th Note: If you do not pass in one of the supported values above, it will return as the default en.'
in: query
name: language
required: false
schema:
default: en
type: string
x-open-allow-strlist: false
x-open-allow-strnum: 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 available locations by advertiser ID [Search Region](https://ads.tiktok.com/marketing_api/docs?id=1773644763581441)
tags:
- Tool
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: language
required: false
source: $.http.query.language
type: string
plugins:
after_response: []
before_request: []
request_query_rule: null
request_rule:
advertiser_id: $.http.query.advertiser_id
language: $.http.query.language
response_cookie: []
response_header: []
response_rule:
region_list[][]:
- area_type: $.rpc.output.region_list[].area_type
country_code: $.rpc.output.region_list[].country_code
parent_id: $.rpc.output.region_list[].parent_id
region_id: $.rpc.output.region_list[].region_id
region_level: $.rpc.output.region_list[].region_level
region_name: $.rpc.output.region_list[].region_name
support_below_18: $.rpc.output.region_list[].support_below_18
x-open-scene-labels: []
x-open-settings:
pop_resp_nullvalue: true
/tool/action_category/:
get:
operationId: Tool Action_category
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
x-open-enum:
enum_package_expired: false
enum_package_id: 1800966552221698
enum_package_name: IndustryType
enums:
- description: ''
is_valid: true
key: CREDIT
value: '3'
- description: ''
is_valid: true
key: EMPLOYMENT
value: '2'
- description: ''
is_valid: true
key: HOUSING
value: '1'
key_format: string
strict: true
use_part: false
validate_only: false
value_format: int32
type: array
x-open-allow-strlist: false
x-open-allow-strnum: false
x-open-source: $.http.query.special_industries
description: 'Special ad categories. Enum values: HOUSING: Ads for real estate listings, homeowners insurance, mortgage loans or other related opportunities. EMPLOYMENT: Ads for job offers, internship, professional certification programs or other related opportunities. CREDIT: Ads for credit card offers, auto loans, long-term financing or other related opportunities. Note: This field is generally available to advertisers registered in America or Canada. Advertisers who are not registered in America or Canada but want to target these countries with special ad categories need to apply for an additional allowlist.'
in: query
name: special_industries
required: false
x-open-field-id: 2
- description: 'Category name language in repsonse. Default value: en. Supported languages: en, zh, ja, de, es, fr, id, it, ko, ru, th, tr, vi, ar, pt, ms. For details, see Enumeration - Language Code.'
in: query
name: language
required: false
schema:
default: en
type: string
x-open-allow-strlist: false
x-open-allow-strnum: false
x-open-source: $.http.query.language
x-open-field-id: 3
- 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 action categories. [Tool Action Category](https://business-api.tiktok.com/portal/docs?id=1737166752522241)
tags:
- Tool
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: number
name: special_industries
required: false
source: $.http.query.special_industries
sub_type: number
type: array
- name: language
required: false
source: $.http.query.language
type: string
plugins:
after_response: []
before_request: []
request_query_rule: null
request_rule:
advertiser_id: $.http.query.advertiser_id
language: $.http.query.language
special_industries: $.http.query.special_industries
response_cookie: []
response_header: []
response_rule:
action_categories[][]:
- action_category_id: $.rpc.output.action_categories[].action_category_id
action_scene: $.rpc.output.action_categories[].scene
description: $.rpc.output.action_categories[].description
level: $.rpc.output.action_categories[].level
name: $.rpc.output.action_categories[].action_category_name
special_industries: $.rpc.output.action_categories[].special_industries
sub_category_ids: $.rpc.output.action_categories[].sub_category_ids
x-open-scene-labels: []
x-open-settings:
pop_resp_nullvalue: false
/tool/bid/recommend/:
post:
operationId: Tool Bid Recommend
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: Advertiser ID.
type: string
x-open-allow-strlist: false
x-open-allow-strnum: false
x-open-convert:
- int64(%s)
x-open-field-id: 1
campaign_id:
default: '"0"'
description: Campaign ID.
type: string
x-open-allow-strlist: false
x-open-allow-strnum: false
x-open-convert:
- int64(%s)
x-open-field-id: 2
external_action:
description: Conversion event for the ad group.
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_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: ''
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: ''
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_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: ''
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
value: '168'
- description: ''
is_valid: true
key: LIVE_ROOM_ACTION
value: '254'
- description: ''
is_valid: true
key: LIVE_SLIDECART_CLICK_ACTION
value: '166'
- description: ''
is_valid: true
key: LIVE_STAY_TIME
value: '186'
- description: ''
is_valid: true
key: LIVE_SUCCESSORDER_ACTION
value: '172'
- description: ''
is_valid: true
key: LIVE_SUCESSORDER_PAY
value: '169'
- description: ''
is_valid: true
key: LOAN
value: '119'
- description: ''
is_valid: true
key: LOAN_APPLY
value: '118'
- description: ''
is_valid: true
key: LOAN_COMPLETION
value: '103'
- description: ''
is_valid: true
key: LOAN_CREDIT
value: '105'
- description: ''
is_valid: true
key: LOCATION_ACTION
value: '48'
- description: ''
is_valid: true
key: LOGIN
value: '114'
- description: ''
is_valid: true
key: LOGIN_ACTION
value: '136'
- description: ''
is_valid: true
key: LONGTERM_CUSTOMER
value: '130'
- description: ''
is_valid: true
key: LOTTERY
value: '11'
- description: ''
is_valid: true
key: LT_ROI
value: '110'
- description: ''
is_valid: true
key: MAP_SEARCH
value: '3'
- description: ''
is_valid: true
key: MESSAGE
value: '94'
- description: ''
is_valid: true
key: MESSAGE_ACTION
value: '63'
- description: ''
is_valid: true
key: MESSAGE_CLICK
value: '177'
- description: ''
is_valid: true
key: MESSAGE_JOIN_GROUP
value: '247'
- description: ''
is_valid: true
key: MESSAGE_SELF_SERVICE
value: '188'
- description: ''
is_valid: true
key: MESSA
# --- truncated at 32 KB (216 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/tiktok-ads/refs/heads/main/openapi/tiktok-ads-tool-api-openapi.yml