How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Need help?

Contact us
TikTok Marketing API

TikTok Marketing API

RESTful Marketing API for managing TikTok ad accounts, campaigns, ad groups, ads, Upgraded Smart+ and GMV Max campaigns, creatives, files, catalogs, audiences, Business Centers, conversions, pixels and reporting. Authorization is three-legged advertiser consent; the resulting long-lived token is sent in the Access-Token request header. 202 operations across 19 tags are published as machine-readable OpenAPI by TikTok itself.

Documentation Provider Profile APIs.io OpenAPI GitHub

TikTok Marketing API is published by TikTok Marketing API on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Advertising, Marketing, Campaign Management, Audience Management, and Reporting. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, and authentication docs.

This API exposes 202 operations across 202 paths, organized into 20 resource areas. It is described by OpenAPI 3.0.1, at version v1.3.

Requests are made against 2 base URLs: https://business-api.tiktok.com/open_api/v1.3, https://sandbox-ads.tiktok.com/open_api/v1.3.

202 operations 202 paths 0 schemas 100 GET102 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.1
API Version
v1.3
Base URL
https://business-api.tiktok.com/open_api
Authentication
API Key
Contact
TikTok API for Business support
Terms of Service
View terms
Resource Areas
20

Authentication & Security 1

TikTok Marketing API declares 1 security scheme for authenticating requests. An API key is passed in the header as Access-Token (AccessToken). By default, every request must be authenticated.

  • AccessToken — Long-term access token issued by POST /oauth2/accesstoken/ after advertiser authorization. See https://business-api.tiktok.com/portal/docs?id=1738373164380162

Paths & Operations 202

Across 202 paths, the API surfaces 202 operations — 100 GET, 102 POST. They span 20 resource areas, including Ads Management, Account Management, APP Management, Audience, BC, Operations, Comments, Campaign Creation, and 12 more. Each is listed below with its method, path, parameters, and response codes.

Ads Management 1
GET
/adgroup/quota/
Get the dynamic quota [Adgroup Quota](https://ads.tiktok.com/marketingapi/docs?id=1768463039162369)
Adgroup Quota 2 params → 200
Account Management 8
GET
/advertiser/info/
Get ad account details. [Advertiser Info](https://business-api.tiktok.com/portal/docs?id=1739593083610113)
Advertiser Info 3 params → 200
POST
/advertiser/update/
Update an ad account. [Advertiser Update](https://business-api.tiktok.com/portal/docs?id=1739939050770434)
Advertiser Update 1 param body → 200
GET
/pangle_audience_package/get/
Get the Pangle audience packages. [Pangle Audience Package Get](https://business-api.tiktok.com/portal/docs?id=1740040177229826)
Pangle_audience_package Get 2 params → 200
GET
/pangle_block_list/get/
Get the Pangle block list. [Pangle Block List Get](https://business-api.tiktok.com/portal/docs?id=1740039957181441)
Pangle_block_list Get 2 params → 200
POST
/pangle_block_list/update/
Update the Pangle block list. [Pangle Block List Update](https://business-api.tiktok.com/portal/docs?id=1740040139110466)
Pangle_block_list Update 1 param body → 200
GET
/term/check/
Check the status of Terms. [Term Check](https://business-api.tiktok.com/portal/docs?id=1737192304571394)
Term Check 3 params → 200
POST
/term/confirm/
Sign Terms. [Term Confirm](https://business-api.tiktok.com/portal/docs?id=1737192284435457)
Term Confirm 1 param body → 200
GET
/term/get/
Get Terms. [Term Get](https://business-api.tiktok.com/portal/docs?id=1737191909315585)
Term Get 4 params → 200
APP Management 6
POST
/app/create/
Create an app. [APP Create](https://business-api.tiktok.com/portal/docs?id=1740859280958466)
App Create 1 param body → 200
GET
/app/info/
Get info of an app. [APP Info](https://business-api.tiktok.com/portal/docs?id=1740859272887297)
App Info 3 params → 200
GET
/app/list/
Get the app list. [APP List](https://business-api.tiktok.com/portal/docs?id=1740859313270786)
App List 3 params → 200
GET
/app/optimization_event/
Get App Conversion Events. [App Optimization Event](https://business-api.tiktok.com/portal/docs?id=1740859338750977)
App Optimization_event 10 params → 200
GET
/app/optimization_event/retargeting/
Get App Retargeting Events. [App Optimization Event Retargeting](https://business-api.tiktok.com/portal/docs?id=1740859371033601)
App Optimization_event Retargeting 3 params → 200
POST
/app/update/
Update an app. [APP Update](https://business-api.tiktok.com/portal/docs?id=1740859300069378)
App Update 1 param body → 200
Audience 18
GET
/audience/insight/overlap/
Get details of audience overlap. [Audience Insight Overlap](https://business-api.tiktok.com/portal/docs?id=1797023590780930)
Audience Insight Overlap 4 params → 200
POST
/dmp/custom_audience/apply/
Apply a shared custom audience [Dmp Customaudience Apply](https://ads.tiktok.com/marketingapi/docs?id=1740245827044354)
Dmp Custom_audience Apply 1 param body → 200
GET
/dmp/custom_audience/apply/log/
Get the latest application log of custom audiences [Dmp Customaudience Apply Log](https://ads.tiktok.com/marketingapi/docs?id=1758615737388033)
Dmp Custom_audience Apply Log 6 params → 200
POST
/dmp/custom_audience/create/
Create an audience by file [Dmp Customaudience Create](https://ads.tiktok.com/marketingapi/docs?id=1739940570793985)
Dmp Custom_audience Create 1 param body → 200
POST
/dmp/custom_audience/delete/
Delete audiences [Dmp Customaudience Delete](https://business-api.tiktok.com/portal/docs?id=1739940539757569)
Dmp Custom_audience Delete 1 param body → 200
POST
/dmp/custom_audience/file/upload/
Upload a data file [Dmp Customaudience File Upload](https://business-api.tiktok.com/portal/docs?id=1739940567842818)
Dmp Custom_audience File Upload 1 param body → 200
GET
/dmp/custom_audience/get/
Obtain the details of specified audiences [Dmp Customaudience Get](https://business-api.tiktok.com/portal/docs?id=1739940507792385)
Dmp Custom_audience Get 4 params → 200
GET
/dmp/custom_audience/list/
Get all audiences [Dmp Customaudience List](https://business-api.tiktok.com/portal/docs?id=1739940506015746)
Dmp Custom_audience List 5 params → 200
POST
/dmp/custom_audience/lookalike/create/
Create a lookalike audience [Dmp Customaudience Lookalike Create](https://business-api.tiktok.com/portal/docs?id=1739940511844353)
Dmp Custom_audience Lookalike Create 1 param body → 200
POST
/dmp/custom_audience/lookalike/update/
Manually refresh a Lookalike Audience [Dmp Customaudience Lookalike Update](https://ads.tiktok.com/marketingapi/docs?id=1758616888158209)
Dmp Custom_audience Lookalike Update 1 param body → 200
POST
/dmp/custom_audience/rule/create/
Create an audience by rules [Dmp Customaudience Rule Create](https://business-api.tiktok.com/portal/docs?id=1739940509849601)
Dmp Custom_audience Rule Create 1 param body → 200
POST
/dmp/custom_audience/share/
Share custom audiences with other advertisers [Dmp Customaudience Share](https://business-api.tiktok.com/portal/docs?id=1740245803888706)
Dmp Custom_audience Share 1 param body → 200
POST
/dmp/custom_audience/share/cancel/
Stop sharing custom audiences with other advertisers [Dmp Customaudience Share Cancel](https://business-api.tiktok.com/portal/docs?id=1740245829978113)
Dmp Custom_audience Share Cancel 1 param body → 200
GET
/dmp/custom_audience/share/log/
Get the sharing log of a custom audience [Dmp Customaudience Share Log](https://ads.tiktok.com/marketingapi/docs?id=1740245827044354)
Dmp Custom_audience Share Log 3 params → 200
POST
/dmp/custom_audience/update/
Update the details of an audience [Dmp Customaudience Update](https://business-api.tiktok.com/portal/docs?id=1739940572667906)
Dmp Custom_audience Update 1 param body → 200
POST
/dmp/saved_audience/create/
Create a Saved Audience [Dmp Savedaudience Create](https://business-api.tiktok.com/portal/docs?id=1780154541898754)
Dmp Saved_audience Create 1 param body → 200
POST
/dmp/saved_audience/delete/
Delete Saved Audiences [Dmp Savedaudience Delete](https://business-api.tiktok.com/portal/docs?id=1780154666312706)
Dmp Saved_audience Delete 1 param body → 200
GET
/dmp/saved_audience/list/
Get the details of Saved Audiences [Dmp Savedaudience List](https://business-api.tiktok.com/portal/docs?id=1780154619404290)
Dmp Saved_audience List 5 params → 200
BC 33
GET
/bc/account/transaction/get/
Get the transaction records of a BC or ad accounts. [BC Account Transaction Get](https://business-api.tiktok.com/portal/docs?id=1792849810925569)
Bc Account Transaction Get 7 params → 200
POST
/bc/asset/admin/delete/
Delete assets. [BC Asset Admin Delete](https://business-api.tiktok.com/portal/docs?id=1739657251102722)
Bc Asset Admin Delete 1 param body → 200
GET
/bc/asset/admin/get/
Get assets of a Business Center as admins. [BC Asset Admin Get](https://business-api.tiktok.com/portal/docs?id=1739433007779841)
Bc Asset Admin Get 7 params → 200
POST
/bc/asset/assign/
Assign assets to a user. [BC Asset Assign](https://business-api.tiktok.com/portal/docs?id=1739438211077121)
Bc Asset Assign 1 param body → 200
GET
/bc/asset/get/
Get assets of a Business Center. [BC Asset Get](https://business-api.tiktok.com/portal/docs?id=1739432717798401)
Bc Asset Get 7 params → 200
GET
/bc/asset/member/get/
Get members by an asset. [BC Asset Member Get](https://business-api.tiktok.com/portal/docs?id=1739659558931458)
Bc Asset Member Get 7 params → 200
GET
/bc/asset/partner/get/
Get partners by assets. [BC Asset Partner Get](https://business-api.tiktok.com/portal/docs?id=1739663268166722)
Bc Asset Partner Get 7 params → 200
POST
/bc/asset/unassign/
Revoke the access to an asset from a user. [BC Asset Unassign](https://business-api.tiktok.com/portal/docs?id=1739448126749698)
Bc Asset Unassign 1 param body → 200
POST
/bc/asset_group/create/
Create an Asset Group in your Business Center. [BC Asset Group Create](https://business-api.tiktok.com/portal/docs?id=1749001658583105)
Bc Asset_group Create 1 param body → 200
POST
/bc/asset_group/delete/
Remove members' access to an Asset Group. [BC Asset Group Delete](https://business-api.tiktok.com/portal/docs?id=1749001673406466)
Bc Asset_group Delete 1 param body → 200
GET
/bc/asset_group/get/
Get the assets or members of an Asset Group in a Business Center. [BC Asset Group Get](https://business-api.tiktok.com/portal/docs?id=1749001669670913)
Bc Asset_group Get 7 params → 200
GET
/bc/asset_group/list/
Get all Asset Groups in your Business Center. [BC Asset Group List](https://business-api.tiktok.com/portal/docs?id=1749001665910786)
Bc Asset_group List 5 params → 200
POST
/bc/asset_group/update/
Update assets, members or the name of an Asset Group. [BC Asset Group Update](https://business-api.tiktok.com/portal/docs?id=1749001662156801)
Bc Asset_group Update 1 param body → 200
GET
/bc/balance/get/
Get the balance of a Business Center. [BC Balance Get](https://business-api.tiktok.com/portal/docs?id=1739939128198145)
Bc Balance Get 3 params → 200
POST
/bc/billing_group/create/
Create a billing group in a Business Center. [BC Billing Group Create](https://business-api.tiktok.com/portal/docs?id=1738947780033537)
Bc Billing_group Create 1 param body → 200
GET
/bc/billing_group/get/
Get all billing groups in a Business Center. [BC Billing Group Get](https://business-api.tiktok.com/portal/docs?id=1738944324279297)
Bc Billing_group Get 5 params → 200
POST
/bc/billing_group/update/
Update settings of a billing group. [BC Billing Group Update](https://business-api.tiktok.com/portal/docs?id=1738947843447809)
Bc Billing_group Update 1 param body → 200
GET
/bc/get/
Get Business Centers that you have access to. [BC Get](https://business-api.tiktok.com/portal/docs?id=1737115687501826)
Bc Get 6 params → 200
GET
/bc/invoice/unpaid/get/
Finance Managers and Finance Analysts of a Business Center account can use this endpoint to get total unpaid amount of their Business Center accounts. [BC Invoice Unpaid Get](https://business-api.tik…
Bc Invoice Unpaid Get 3 params → 200
POST
/bc/member/delete/
Delete member. [BC Member Delete](https://business-api.tiktok.com/portal/docs?id=1739939482851329)
Bc Member Delete 1 param body → 200
GET
/bc/member/get/
Get BC members. [BC Member Get](https://business-api.tiktok.com/portal/docs?id=1739939404802049)
Bc Member Get 6 params → 200
POST
/bc/member/invite/
Invite members to BC. [BC Member Invite](https://business-api.tiktok.com/portal/docs?id=1739939455765505)
Bc Member Invite 1 param body → 200
POST
/bc/member/update/
Update member information. [BC Member Update](https://business-api.tiktok.com/portal/docs?id=1739696704424961)
Bc Member Update 1 param body → 200
POST
/bc/partner/add/
Add partner to Business Center. [BC Partner Add](https://business-api.tiktok.com/portal/docs?id=1739662756510721)
Bc Partner Add 1 param body → 200
POST
/bc/partner/asset/delete/
Cancel asset sharing. [BC Partner Asset Delete](https://business-api.tiktok.com/portal/docs?id=1739662800930817)
Bc Partner Asset Delete 1 param body → 200
GET
/bc/partner/asset/get/
Get partner assets. [BC Partner Asset Get](https://business-api.tiktok.com/portal/docs?id=1739662828320769)
Bc Partner Asset Get 8 params → 200
POST
/bc/partner/delete/
Delete partner. [BC Partner Delete](https://business-api.tiktok.com/portal/docs?id=1739662779301890)
Bc Partner Delete 1 param body → 200
GET
/bc/partner/get/
Get partners. [BC Partner Get](https://business-api.tiktok.com/portal/docs?id=1739662727395330)
Bc Partner Get 5 params → 200
GET
/bc/pixel/link/get/
Use this endpoint to get a list of ad accounts that have been linked to the request pixel. [BC Pixel Link Get](https://business-api.tiktok.com/portal/docs?id=1753994966965249)
Bc Pixel Link Get 5 params → 200
POST
/bc/pixel/link/update/
Use this endpoint to link and unlink pixel to advertiser accounts. [BC Pixel Link Update](https://business-api.tiktok.com/portal/docs?id=1753994950327297)
Bc Pixel Link Update 1 param body → 200
POST
/bc/pixel/transfer/
Transfer Pixel from Advertiser to BC. [BC Pixel Transfer](https://business-api.tiktok.com/portal/docs?id=1753994928261122)
Bc Pixel Transfer 1 param body → 200
GET
/bc/transaction/get/
Get translaction records of a Business Center. [BC Transaction Get](https://business-api.tiktok.com/portal/docs?id=1739939140408322)
Bc Transaction Get 7 params → 200
POST
/bc/transfer/
Process payments (recharge money to or deduct money from an ad account in a Business Center. [BC Transfer](https://business-api.tiktok.com/portal/docs?id=1739939095321601)
Bc Transfer 1 param body → 200
Operations 3
POST
/bc/create/
Bc Create 1 param body → 200
POST
/bc/image/upload/
Bc Image Upload 1 param body → 200
POST
/bc/member/assign/
Bc Member Assign 1 param body → 200
Comments 14
GET
/blockedword/check/
Check if a list of words is blocked. [Blockedword Check](https://business-api.tiktok.com/portal/docs?id=1739029247961089)
Blockedword Check 3 params → 200
POST
/blockedword/create/
Add words to the block list. [Blockedword Create](https://business-api.tiktok.com/portal/docs?id=1739029218470913)
Blockedword Create 1 param body → 200
POST
/blockedword/delete/
Delete one or more blocked words. [Blockedword Delete](https://business-api.tiktok.com/portal/docs?id=1739029277346817)
Blockedword Delete 1 param body → 200
GET
/blockedword/list/
Get the list of blocked words for an ad account. [Blockedword List](https://business-api.tiktok.com/portal/docs?id=1739029260837889)
Blockedword List 3 params → 200
GET
/blockedword/task/check/
Check the status of the export task. [Blockedword Task Check](https://business-api.tiktok.com/portal/docs?id=1739029311687681)
Blockedword Task Check 3 params → 200
POST
/blockedword/task/create/
Create a task to export blocked words. [Blockedword Task Create](https://business-api.tiktok.com/portal/docs?id=1739029296119809)
Blockedword Task Create 1 param body → 200
POST
/blockedword/update/
Replace a blocked word with another word. [Blockedword Task Update](https://business-api.tiktok.com/portal/docs?id=1739029234526209)
Blockedword Update 1 param body → 200
POST
/comment/delete/
Delete comments. [Comment Delete](https://business-api.tiktok.com/portal/docs?id=1738957772267522)
Comment Delete 1 param body → 200
GET
/comment/list/
Get comments for your ads. [Comment List](https://business-api.tiktok.com/portal/docs?id=1738086301876225)
Comment List 12 params → 200
POST
/comment/post/
Reply to comments. [Comment Post](https://business-api.tiktok.com/portal/docs?id=1738957702411265)
Comment Post 1 param body → 200
GET
/comment/reference/
Get related comments. [Comment Reference](https://business-api.tiktok.com/portal/docs?id=1738086824859650)
Comment Reference 8 params → 200
POST
/comment/status/update/
Use this endpoint to change the status of a list of comments from public to hidden, or vice versa. [Comment Status Update](https://business-api.tiktok.com/portal/docs?id=1738086844585985)
Comment Status Update 1 param body → 200
GET
/comment/task/check/
Get comment export status. [Comment Task Check](https://business-api.tiktok.com/portal/docs?id=1738088242659330)
Comment Task Check 4 params → 200
POST
/comment/task/create/
Create comment export task. [Comment Task Create](https://business-api.tiktok.com/portal/docs?id=1738088144215041)
Comment Task Create 1 param body → 200
Campaign Creation 15
POST
/campaign/gmv_max/create/
Create GMV Max campaign [Smart Plus GMV Max Campaign Create](https://business-api.tiktok.com/portal/docs?id=1822000988713089)
Campaign Gmv_max Create 1 param body → 200
GET
/campaign/gmv_max/info/
Get GMV Max campaign info [Smart Plus GMV Max Campaign Info](https://business-api.tiktok.com/portal/docs?id=1822000968821762)
Campaign Gmv_max Info 3 params → 200
POST
/campaign/gmv_max/session/create/
Create GMV Max session [Smart Plus GMV Max Session Create](https://business-api.tiktok.com/portal/docs?id=1835246967275522)
Campaign Gmv_max Session Create 1 param body → 200
POST
/campaign/gmv_max/session/delete/
Delete GMV Max session [Smart Plus GMV Max Session Delete](https://business-api.tiktok.com/portal/docs?id=1835246983475217)
Campaign Gmv_max Session Delete 1 param body → 200
GET
/campaign/gmv_max/session/get/
Get GMV Max session info [Smart Plus GMV Max Session Get](https://business-api.tiktok.com/portal/docs?id=1835247031331842)
Campaign Gmv_max Session Get 3 params → 200
GET
/campaign/gmv_max/session/list/
Get GMV Max session list [Smart Plus GMV Max Session List](https://business-api.tiktok.com/portal/docs?id=1835246996436162)
Campaign Gmv_max Session List 3 params → 200
POST
/campaign/gmv_max/session/update/
Update GMV Max session [Smart Plus GMV Max Session Update](https://business-api.tiktok.com/portal/docs?id=1835247009119233)
Campaign Gmv_max Session Update 1 param body → 200
POST
/campaign/gmv_max/update/
Update GMV Max campaign [Smart Plus GMV Max Campaign Update](https://business-api.tiktok.com/portal/docs?id=1822001009002497)
Campaign Gmv_max Update 1 param body → 200
GET
/gmv_max/bid/recommend/
Get GMV Max bid recommendation [Smart Plus GMV Max Bid Recommend](https://business-api.tiktok.com/portal/docs?id=1822001024720897)
Gmv_max Bid Recommend 7 params → 200
GET
/gmv_max/custom_anchor_video_list/get/
Get GMV Max custom anchor video list [Smart Plus GMV Max Custom Anchor Video List Get](https://business-api.tiktok.com/portal/docs?id=1830215925061633)
Gmv_max Custom_anchor_video_list Get 4 params → 200
GET
/gmv_max/occupied_custom_shop_ads/list/
Get GMV Max occupied custom shop ads [Smart Plus GMV Max Occupied Custom Shop Ads List](https://business-api.tiktok.com/portal/docs?id=1822001136924674)
Gmv_max Occupied_custom_shop_ads List 5 params → 200
POST
/smart_plus/campaign/create/
Create a new campaign [Smart Plus Campaign Create]
Smart_plus Campaign Create 1 param body → 200
GET
/smart_plus/campaign/get/
Retrieve campaign details [Smart Plus Campaign Get]
Smart_plus Campaign Get 6 params → 200
POST
/smart_plus/campaign/status/update/
Update campaign status [Smart Plus Campaign Status Update]
Smart_plus Campaign Status Update 1 param body → 200
POST
/smart_plus/campaign/update/
Update an existing campaign [Smart Plus Campaign Update]
Smart_plus Campaign Update 1 param body → 200
Catalog 26
GET
/catalog/available_country/get/
Get the countries and regions that ads for a catalog can be delivered to. [Catalog Available Country Get](https://business-api.tiktok.com/portal/docs?id=1740491257516034)
Catalog Available_country Get 2 params → 200
POST
/catalog/capitalize/
Migrate catalogs under your ad account to your Business Center. [Catalog Capitalize](https://business-api.tiktok.com/portal/docs?id=1740490222539778)
Catalog Capitalize 1 param body → 200
POST
/catalog/create/
Create a catalog by specifying information such as name, targeted locations, and currency. [Catalog Create](https://business-api.tiktok.com/portal/docs?id=1740306481704961)
Catalog Create 1 param body → 200
POST
/catalog/delete/
Delete a catalog. [Catalog Delete](https://business-api.tiktok.com/portal/docs?id=1740310064588801)
Catalog Delete 1 param body → 200
POST
/catalog/eventsource/bind/
Bind app or website event sources to a catalog in a Business Center. [Catalog Eventsource Bind](https://business-api.tiktok.com/portal/docs?id=1740492491200513)
Catalog Eventsource Bind 1 param body → 200
POST
/catalog/eventsource/unbind/
Unbind event sources from a catalog. [Catalog Eventsource Unbind](https://business-api.tiktok.com/portal/docs?id=1740492512449538)
Catalog Eventsource Unbind 1 param body → 200
GET
/catalog/eventsource_bind/get/
Get event source binding information. [Catalog Eventsource Bind Get](https://business-api.tiktok.com/portal/docs?id=1740492531343362)
Catalog Eventsource_bind Get 3 params → 200
POST
/catalog/feed/create/
Create a feed. [Catalog Feed Create](https://business-api.tiktok.com/portal/docs?id=1740665161957377)
Catalog Feed Create 1 param body → 200
POST
/catalog/feed/delete/
Delete a feed. [Catalog Feed Delete](https://business-api.tiktok.com/portal/docs?id=1740665210863617)
Catalog Feed Delete 1 param body → 200
GET
/catalog/feed/get/
Get all feeds or a particular feed. [Catalog Feed Get](https://business-api.tiktok.com/portal/docs?id=1740665183073281)
Catalog Feed Get 4 params → 200
GET
/catalog/feed/log/
Get the last 10 operations of a feed. [Catalog Feed Log](https://business-api.tiktok.com/portal/docs?id=1740665225631810)
Catalog Feed Log 5 params → 200
POST
/catalog/feed/update/
Update a feed. [Catalog Feed Update](https://business-api.tiktok.com/portal/docs?id=1740665197662210)
Catalog Feed Update 1 param body → 200
GET
/catalog/get/
Get all catalogs or a particular catalog. [Catalog Get](https://business-api.tiktok.com/portal/docs?id=1740315452868610)
Catalog Get 5 params → 200
GET
/catalog/lexicon/get/
Get the lexicon for your catalog for use in ad texts. [Catalog Lexicon Get](https://business-api.tiktok.com/portal/docs?id=1740488375815169)
Catalog Lexicon Get 3 params → 200
GET
/catalog/location_currency/get/
Get supported locations and corresponding currencies for Catalog API. [Catalog Location Currency Get](https://business-api.tiktok.com/portal/docs?id=1740491571747841)
Catalog Location_currency Get 1 param → 200
GET
/catalog/overview/
Get the number of products in different audit statuses in a catalog. [Catalog Overview](https://business-api.tiktok.com/portal/docs?id=1740492470201345)
Catalog Overview 3 params → 200
POST
/catalog/product/delete/
Delete products in bulk. [Catalog Product Delete](https://business-api.tiktok.com/portal/docs?id=1740562489236481)
Catalog Product Delete 1 param body → 200
POST
/catalog/product/file/
Upload products via file URL. [Catalog Product File](https://business-api.tiktok.com/portal/docs?id=1740496787164161)
Catalog Product File 1 param body → 200
GET
/catalog/product/log/
Use this endpoint to find out if a product was uploaded or deleted successfully, and what to do if it failed. [Catalog Product Get](https://business-api.tiktok.com/portal/docs?id=1740570027173889)
Catalog Product Log 7 params → 200
POST
/catalog/set/delete/
Delete product sets. [Catalog Set Delete](https://business-api.tiktok.com/portal/docs?id=1740573143966722)
Catalog Set Delete 1 param body → 200
GET
/catalog/set/get/
Get product sets. [Catalog Set Get](https://business-api.tiktok.com/portal/docs?id=1740570556295169)
Catalog Set Get 5 params → 200
POST
/catalog/set/update/
Use this endpoint to update the filter conditions or name of a product set. [Catalog Set Get](https://business-api.tiktok.com/portal/docs?id=1740572974725122)
Catalog Set Update 1 param body → 200
POST
/catalog/update/
Use this endpoint to update the name of a catalog. The catalog must be under a Business Center. [Catalog Update](https://business-api.tiktok.com/portal/docs?id=1740306544966657)
Catalog Update 1 param body → 200
POST
/catalog/video/delete/
Delete uploaded catalog videos. [Catalog Video Delete](https://business-api.tiktok.com/portal/docs?id=1803655103069185)
Catalog Video Delete 1 param body → 200
POST
/catalog/video/file/
Catalog Video File 1 param body → 200
GET
/catalog/video/get/
Catalog Video Get 6 params → 200
catalog 1
GET
/catalog/set/product/get/
Get products in a product set. [Catalog Set Product Get](https://business-api.tiktok.com/portal/docs?id=1740571478441986)
Catalog Set Product Get 6 params → 200
Creative Management 15
POST
/creative/asset/delete/
Delete creative assets. [Asset Delete](https://business-api.tiktok.com/portal/docs?id=1797202997456897)
Creative Asset Delete 1 param body → 200
POST
/creative/asset/share/
SShare creative assets with other advertiser accounts. [Asset Share](https://business-api.tiktok.com/portal/docs?id=1773192725768193)
Creative Asset Share 1 param body → 200
POST
/creative/image/edit/
Edit an image according to the size you want as well as apply creative trimmings. [Image Edit](https://business-api.tiktok.com/portal/docs?id=1739067107903489)
Creative Image Edit 1 param body → 200
POST
/creative/portfolio/create/
Create a portfolio. [Creative Portfolie Create](https://business-api.tiktok.com/portal/docs?id=1739091950439426)
Creative Portfolio Create 1 param body → 200
GET
/creative/portfolio/get/
Get a portfolio by ID. [Portfolio Get](https://business-api.tiktok.com/portal/docs?id=1739092113671170)
Creative Portfolio Get 3 params → 200
GET
/creative/portfolio/list/
Get portfolios within an ad account. [Portfolio List](https://business-api.tiktok.com/portal/docs?id=1766324010279938)
Creative Portfolio List 5 params → 200
POST
/creative/shareable_link/create/
Creative Shareable_link Create 1 param body → 200
POST
/creative/smart_text/generate/
Use smart text. [Smart Text Generate](https://business-api.tiktok.com/portal/docs?id=1739084248002626)
Creative Smart_text Generate 1 param body → 200
GET
/discovery/detail/
Get details of a popular hashtag. [Discovery Detail](https://business-api.tiktok.com/portal/docs?id=1825119047070721)
Discovery Detail 6 params → 200
GET
/discovery/trending_list/
Get popular hashtags. [Trending List](https://business-api.tiktok.com/portal/docs?id=1825119032526849)
Discovery Trending_list 6 params → 200
POST
/playable/delete/
Delete a playable ad. [Playable Delete](https://business-api.tiktok.com/portal/docs?id=1737733368940546)
Playable Delete 1 param body → 200
GET
/playable/get/
Use this endpoint to get a list of playables. [Playable Get](https://business-api.tiktok.com/portal/docs?id=1737732758495234)
Playable Get 9 params → 200
POST
/playable/save/
Use this endpoint to save a playable. [Playable Save](https://business-api.tiktok.com/portal/docs?id=1737732203851777)
Playable Save 1 param body → 200
POST
/playable/upload/
You can use this endpoint to upload Playable Ad contents. [Playable Upload](https://business-api.tiktok.com/portal/docs?id=1737730926765057)
Playable Upload 1 param body → 200
GET
/playable/validate/
Check the status of the playable. [Playable Validate](https://business-api.tiktok.com/portal/docs?id=1737732054892545)
Playable Validate 3 params → 200
Store 4
POST
/gmv_max/exclusive_authorization/create/
Create GMV Max exclusive authorization [Smart Plus GMV Max Exclusive Authorization Create](https://business-api.tiktok.com/portal/docs?id=1822001200356354)
Gmv_max Exclusive_authorization Create 1 param body → 200
GET
/gmv_max/exclusive_authorization/get/
Get GMV Max exclusive authorization [Smart Plus GMV Max Exclusive Authorization Get](https://business-api.tiktok.com/portal/docs?id=1822001184635905)
Gmv_max Exclusive_authorization Get 4 params → 200
GET
/gmv_max/store/list/
Get GMV Max store list [Smart Plus GMV Max Store List](https://business-api.tiktok.com/portal/docs?id=1822001044479041)
Gmv_max Store List 2 params → 200
GET
/gmv_max/store/shop_ad_usage_check/
Check GMV Max shop ad usage [Smart Plus GMV Max Shop Ad Usage Check](https://business-api.tiktok.com/portal/docs?id=1822001084174338)
Gmv_max Store Shop_ad_usage_check 3 params → 200
Identity 1
GET
/gmv_max/identity/get/
Get GMV Max identity info [Smart Plus GMV Max Identity Get](https://business-api.tiktok.com/portal/docs?id=1822001101474882)
Gmv_max Identity Get 4 params → 200
Reporting 7
GET
/gmv_max/report/get/
Get GMV Max report [Smart Plus GMV Max Report Get](https://business-api.tiktok.com/portal/docs?id=1824721673497601)
Gmv_max Report Get 14 params → 200
GET
/report/integrated/get/
Run a synchronous report. [Report Integrated Get](https://business-api.tiktok.com/portal/docs?id=1740302848100353)
Report Integrated Get 20 params → 200
POST
/report/task/cancel/
Cancel an asynchronous report task. [Report Task Cancel](https://business-api.tiktok.com/portal/docs?id=1803615367145537)
Report Task Cancel 1 param body → 200
GET
/report/task/check/
Get the status of an async report task. [Report Task Check](https://business-api.tiktok.com/portal/docs?id=1740302781443073)
Report Task Check 3 params → 200
POST
/report/task/create/
Report Task Create 1 param body → 200
GET
/smart_plus/material_report/breakdown/
Get breakdown of material reports [Smart Plus Material Report Breakdown]
Smart_plus Material_report Breakdown 11 params → 200
GET
/smart_plus/material_report/overview/
Get overview of material reports [Smart Plus Material Report Overview]
Smart_plus Material_report Overview 12 params → 200
Video 1
GET
/gmv_max/video/get/
Get GMV Max video info [Smart Plus GMV Max Video Get](https://business-api.tiktok.com/portal/docs?id=1822001168512129)
Gmv_max Video Get 13 params → 200
Measurement 11
POST
/offline/create/
Create a new Offline Event set. [Offline Create](https://business-api.tiktok.com/portal/docs?id=1758427576470529)
Offline Create 1 param body → 200
POST
/offline/delete/
Delete an Offline Event set. [Offline Delete](https://business-api.tiktok.com/portal/docs?id=1765596790860802)
Offline Delete 1 param body → 200
GET
/offline/get/
Get Offline Event sets. [Offline Get](https://business-api.tiktok.com/portal/docs?id=1765596808589313)
Offline Get 4 params → 200
POST
/offline/update/
Update an Offline Event set. [Offline Update](https://business-api.tiktok.com/portal/docs?id=1765596741157889)
Offline Update 1 param body → 200
POST
/pixel/create/
Create a Pixel. [Pixel Create](https://business-api.tiktok.com/portal/docs?id=1740858779758593)
Pixel Create 1 param body → 200
POST
/pixel/event/create/
Choose either an industry or custom template to define your events. [Pixel Event Create](https://business-api.tiktok.com/portal/docs?id=1740858807646209)
Pixel Event Create 1 param body → 200
POST
/pixel/event/delete/
Delete Pixel events. [Pixel Event Delete](https://business-api.tiktok.com/portal/docs?id=1740858862104578)
Pixel Event Delete 1 param body → 200
GET
/pixel/event/stats/
View statistics of an event data over a period of time. [Pixel Event Stats](https://business-api.tiktok.com/portal/docs?id=1740858904557570)
Pixel Event Stats 4 params → 200
POST
/pixel/event/update/
Update the name of a Pixel event and the conversion value. [Pixel Event Update](https://business-api.tiktok.com/portal/docs?id=1740858823774210)
Pixel Event Update 1 param body → 200
GET
/pixel/list/
Obtain a list of Pixel information. [Pixel List](https://business-api.tiktok.com/portal/docs?id=1740858697598978)
Pixel List 9 params → 200
POST
/pixel/update/
Update a Pixel. [Pixel Update](https://business-api.tiktok.com/portal/docs?id=1740858799524865)
Pixel Update 1 param body → 200
Automated_Rules 7
POST
/optimizer/rule/batch_bind/
Bind objects to rules. [Optimizer Rule Batch Bind](https://business-api.tiktok.com/portal/docs?id=1738769164954626)
Optimizer Rule Batch_bind 1 param body → 200
POST
/optimizer/rule/create/
Create an automated rule. [Optimizer Rule Create](https://business-api.tiktok.com/portal/docs?id=1738767670852610)
Optimizer Rule Create 1 param body → 200
GET
/optimizer/rule/get/
Get rules by rule IDs. [Optimizer Rule Get](https://business-api.tiktok.com/portal/docs?id=1738768750822466)
Optimizer Rule Get 3 params → 200
GET
/optimizer/rule/list/
Get rules based on the values of certain filters. [Optimizer Rule List](https://business-api.tiktok.com/portal/docs?id=1738768861976578)
Optimizer Rule List 6 params → 200
GET
/optimizer/rule/result/get/
Get result details. [Optimizer Rule Result Get](https://business-api.tiktok.com/portal/docs?id=1738769098314754)
Optimizer Rule Result Get 4 params → 200
GET
/optimizer/rule/result/list/
Get rule results. [Optimizer Rule Result List](https://business-api.tiktok.com/portal/docs?id=1738769076676609)
Optimizer Rule Result List 6 params → 200
POST
/optimizer/rule/update/
Update an automated rule. [Optimizer Rule Update](https://business-api.tiktok.com/portal/docs?id=1738769123170306)
Optimizer Rule Update 1 param body → 200
Tool 19
GET
/search/region/
Get available locations by advertiser ID [Search Region](https://ads.tiktok.com/marketingapi/docs?id=1773644763581441)
Search Region 3 params → 200
GET
/tool/action_category/
Get action categories. [Tool Action Category](https://business-api.tiktok.com/portal/docs?id=1737166752522241)
Tool Action_category 4 params → 200
POST
/tool/bid/recommend/
Get a suggested bid [Tool Bid Recommend](https://ads.tiktok.com/marketingapi/docs?id=1737107845597186)
Tool Bid Recommend 1 param body → 200
GET
/tool/brand_safety/partner/authorize/status/
Get the authorization status of a Brand Safety partner [Tool Brandsafety Partner Authorize Status](https://ads.tiktok.com/marketingapi/docs?id=1738456743621634)
Tool Brand_safety Partner Authorize Status 3 params → 200
GET
/tool/carrier/
Get carriers. [Tool Carrier](https://business-api.tiktok.com/portal/docs?id=1737168013095938)
Tool Carrier 2 params → 200
GET
/tool/contextual_tag/get/
Get available contextual tags [Tool Contextualtag Get](https://ads.tiktok.com/marketingapi/docs?id=1747747118654465)
Tool Contextual_tag Get 6 params → 200
GET
/tool/contextual_tag/info/
Get details of contextual tags [Tool Contextualtag Info](https://ads.tiktok.com/marketingapi/docs?id=1747747180830722)
Tool Contextual_tag Info 3 params → 200
GET
/tool/hashtag/get/
Get targeting hashtags by ID [Tool Hashtag Get](https://ads.tiktok.com/marketingapi/docs?id=1736280889167874)
Tool Hashtag Get 3 params → 200
GET
/tool/hashtag/recommend/
Search for targeting hashtags [Tool Hashtag Recommend](https://ads.tiktok.com/marketingapi/docs?id=1736271339521025)
Tool Hashtag Recommend 4 params → 200
GET
/tool/interest_keyword/get/
Get additional interest categories by ID [Tool Interestkeyword Get](https://ads.tiktok.com/marketingapi/docs?id=1763590894544897)
Tool Interest_keyword Get 4 params → 200
GET
/tool/open_url/
Get a TikTok in-app link [Tool Openurl](https://ads.tiktok.com/marketingapi/docs?id=1738457335681026)
Tool Open_url 4 params → 200
GET
/tool/os_version/
Get OS versions [Tool Osversion](https://ads.tiktok.com/marketingapi/docs?id=1738308662898689)
Tool Os_version 3 params → 200
GET
/tool/phone_region_code/
Get region calling codes and region codes for phone numbers [Tool Phoneregioncode](https://ads.tiktok.com/marketingapi/docs?id=1774488637039618)
Tool Phone_region_code 2 params → 200
POST
/tool/targeting/info/
Obtain details about location targeting tags by ID [Tool Targeting Info](https://ads.tiktok.com/marketingapi/docs?id=1761237001980929)
Tool Targeting Info 1 param body → 200
GET
/tool/targeting/list/
Get internet service providers [Tool Targeting List](https://ads.tiktok.com/marketingapi/docs?id=1762962378261506)
Tool Targeting List 4 params → 200
POST
/tool/targeting/search/
Search for location targeting tags [Tool Targeting Search](https://ads.tiktok.com/marketingapi/docs?id=1761236883355649)
Tool Targeting Search 1 param body → 200
GET
/tool/timezone/
Get time zones [Tool Timezone](https://ads.tiktok.com/marketingapi/docs?id=1738455961470977)
Tool Timezone 2 params → 200
GET
/tool/url_validate/
Get the verification results of a URL [Tool Urlvalidate](https://ads.tiktok.com/marketingapi/docs?id=1774487686007810)
Tool Url_validate 3 params → 200
GET
/tool/vbo_status/
Check Value-Based Optimization eligibility [Tool Vbostatus](https://ads.tiktok.com/marketingapi/docs?id=1770016073586753)
Tool Vbo_status 18 params → 200
Ad 8
POST
/smart_plus/ad/appeal/
Submit ad appeal [Smart Plus Ad Appeal]
Smart_plus Ad Appeal 1 param body → 200
POST
/smart_plus/ad/create/
Create a new ad [Smart Plus Ad Create]
Smart_plus Ad Create 1 param body → 200
GET
/smart_plus/ad/get/
Retrieve ad details [Smart Plus Ad Get]
Smart_plus Ad Get 6 params → 200
POST
/smart_plus/ad/material_status/update/
Update ad material status [Smart Plus Ad Material Status Update]
Smart_plus Ad Material_status Update 1 param body → 200
GET
/smart_plus/ad/review_info/
Get ad review info [Smart Plus Ad Review Info]
Smart_plus Ad Review_info 6 params → 200
POST
/smart_plus/ad/status/update/
Update ad status [Smart Plus Ad Status Update]
Smart_plus Ad Status Update 1 param body → 200
POST
/smart_plus/ad/update/
Update an ad [Smart Plus Ad Update]
Smart_plus Ad Update 1 param body → 200
GET
/smart_plus/material/review_info/
Get material review info [Smart Plus Material Review Info]
Smart_plus Material Review_info 6 params → 200
Adgroup 4
POST
/smart_plus/adgroup/create/
Create a new ad group [Smart Plus AdGroup Create]
Smart_plus Adgroup Create 1 param body → 200
GET
/smart_plus/adgroup/get/
Retrieve ad group details [Smart Plus AdGroup Get]
Smart_plus Adgroup Get 6 params → 200
POST
/smart_plus/adgroup/status/update/
Update ad group status [Smart Plus AdGroup Status Update]
Smart_plus Adgroup Status Update 1 param body → 200
POST
/smart_plus/adgroup/update/
Update an ad group [Smart Plus AdGroup Update]
Smart_plus Adgroup Update 1 param body → 200

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

tiktok-ads-marketing-api-openapi.yml Raw ↑
#Advertising#Marketing#Campaign Management#Audience Management#Reporting#Conversions API
← Back to T APIs
API Details
ID
tiktok-ads:marketing-api
Base URL
https://business-api.tiktok.com/open_api
Docs
https://business-api.tiktok.com/portal/docs
Provider
TikTok Marketing API
APIs.io →  GitHub →
Explore more
All APIs Providers APIs.io Network
Work with this as data

Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.

Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.

MCP tools for apis
4 tools reach this content
  • search_api_evangelistSearch every content type across the network at once.
  • find_relatedThe shared-tag relevance graph — what else covers this.
  • get_tagEverything one tag labels, across all content types.
  • guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
All tools & prompts
Call it yourself
curl for this page
Search the network for this 
curl "https://api.apievangelist.com/v1/search?q=marketing-api&limit=10"
Everything under a tag 
curl "https://api.apievangelist.com/v1/tags/marketing-api"

Discovery needs no key. Full bodies and the synthesis endpoints are Pro.

Get an API key

Free tier, no email required. Sign in with whichever identity you already have.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have. Your account

Where this information came from

This is an independent, third-party profile of TikTok Marketing API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.