# TikTok Ads integration

> TikTok Business/Marketing API for managing ad campaigns, ad groups, ads, audiences, creatives, pixels, and reporting on TikTok Ads Manager.

- Authentication: oauth2

## Tools (234)

- **Add Blocked Words**: Add words to an advertiser's comment block list so matching comments are auto-hidden.
- **Add Business Center Partner**: Add another Business Center as a partner.
- **Apply Custom Audience to Ad Groups**: Include or exclude a custom audience across one or more ad groups.
- **Assign Business Center Asset**: Assign a BC asset (advertiser, pixel, catalog, identity) to a member, partner, or child BC.
- **Authorize TikTok Posts**: Redeem a creator's Spark Ads authorization code to authorize an organic TikTok post for use in ads.
- **Bind Event Source to Catalog**: Bind a pixel or app event source to a catalog for dynamic ads.
- **Cancel Custom Audience Share**: Revoke a previously shared custom audience from a recipient advertiser account.
- **Cancel Report Task**: Cancel a queued or in-progress asynchronous report task.
- **Check Blocked Words**: Check whether a list of words is already on the advertiser's comment block list.
- **Check Blocked Words Export Task**: Poll the status of a blocked-words export task and retrieve its download URL when ready.
- **Check Comment Export Task**: Poll the status of a comment export task and retrieve its download URL when ready.
- **Check GMV Max Shop Ad Usage**: Check whether a TikTok Shop store is eligible and available to run Product GMV Max campaigns.
- **Check Report Task Status**: Poll the status of an asynchronous report task and retrieve its download URL once complete.
- **Create ACO Ad**: Create an Automated Creative Optimization (ACO) ad from a pool of videos, images, texts, and CTAs that TikTok combines automatically.
- **Create Ad**: Create one or more ads (creatives) under an existing ad group.
- **Create Ad Account**: Create a new ad account (advertiser) under a Business Center, with advertiser, customer, contact, billing, and qualification info.
- **Create Ad Account under Business Center**: Create a new ad account (advertiser) under a Business Center with account, customer, and qualification info.
- **Create Ad Group**: Create an ad group under an existing campaign with targeting, budget, schedule, and bidding settings.
- **Create Ad Preview Link**: Generate shareable preview URLs (and QR codes) for existing ads so reviewers can see them in-app without spending.
- **Create App**: Register a mobile app for app-event measurement and app promotion campaigns.
- **Create Blocked Words Export Task**: Create an async task to export an advertiser's blocked words to a downloadable file.
- **Create Business Center Advertiser**: Create (register) a new ad account under a Business Center.
- **Create Business Center Asset Group**: Create an asset group bundling assets and members in a Business Center.
- **Create Business Center Billing Group**: Create a billing group bundling ad accounts for consolidated invoicing.
- **Create Campaign**: Create a new ad campaign under an advertiser.
- **Create Catalog**: Create a product catalog under a Business Center.
- **Create Comment Export Task**: Create an async task to export ad comments matching a time range and filters to a downloadable file.
- **Create Creative Portfolio**: Create a creative portfolio bundling advanced creative elements (stickers, badges, showcase products) for reuse in ads.
- **Create Creative Shareable Link**: Create a shareable link that lets external stakeholders view selected creative assets.
- **Create Custom Audience from File**: Create a custom audience from an uploaded file of hashed identifiers.
- **Create GMV Max Campaign**: Create a Product or Live GMV Max campaign for a TikTok Shop store with ROAS-based bidding.
- **Create GMV Max Exclusive Authorization**: Grant an advertiser exclusive authorization to run GMV Max campaigns for a TikTok Shop store.
- **Create GMV Max Live Session**: Add a scheduled live shopping session to a Live GMV Max campaign.
- **Create Identity**: Create a customized-user identity (custom display name and avatar) for use in ad creatives.
- **Create Lead Download Task**: Create an async task to generate a downloadable file of leads collected from an Instant Form.
- **Create Lookalike Audience**: Create a lookalike audience from a seed custom audience by expansion size and location.
- **Create Offline Event Set**: Create a new offline event set for measuring in-store and CRM conversions.
- **Create Pixel**: Create a new conversion pixel under an advertiser.
- **Create Pixel Event**: Configure a standard or custom web event on a TikTok Pixel.
- **Create Product Feed**: Create a scheduled product feed that fetches products from a hosted file.
- **Create Product Set**: Create a product set (group) within a catalog using filter conditions.
- **Create Rule-Based Audience**: Create an engagement or retargeting audience defined by inclusion/exclusion rules.
- **Create Saved Audience**: Create a reusable saved audience template from demographic, interest, and device targeting.
- **Create Smart+ Ad**: Create an ad under a Smart+ (automated) campaign with creatives, identity, ad text, CTA, and landing page.
- **Create Smart+ Campaign**: Create a Smart+ (automated) campaign under an advertiser with objective, budget, and automation settings.
- **Delete Blocked Words**: Remove words from an advertiser's comment block list.
- **Delete Business Center Admin Asset**: Remove (unlink) an asset that a Business Center administers.
- **Delete Business Center Asset Group**: Delete an asset group or remove members' access to it.
- **Delete Business Center Member**: Remove a member from a Business Center.
- **Delete Business Center Partner**: Remove a partner Business Center relationship.
- **Delete Business Center Partner Asset**: Stop sharing an asset with a partner Business Center.
- **Delete Catalog**: Delete a product catalog.
- **Delete Catalog Products**: Delete products from a catalog by SKU.
- **Delete Catalog Videos**: Delete catalog videos by id.
- **Delete Comment**: Delete a comment on an ad or authorized TikTok post.
- **Delete Creative Asset**: Delete images or videos from the ad account's Asset Library.
- **Delete Custom Audience**: Delete one or more custom audiences by ID.
- **Delete GMV Max Live Session**: Delete a scheduled live shopping session from a Live GMV Max campaign.
- **Delete Offline Event Set**: Delete an offline event set from an advertiser account.
- **Delete Pixel Event**: Delete one or more configured events from a TikTok Pixel.
- **Delete Playable**: Delete a playable ad from the ad account.
- **Delete Product Feed**: Delete a product feed from a catalog.
- **Delete Product Set**: Delete a product set from a catalog.
- **Delete Saved Audience**: Delete one or more saved audiences by ID.
- **Download Leads**: Download the generated leads file from an Instant Form lead download task.
- **Edit Creative Image**: Resize and crop an image in the Asset Library to a target dimension, producing a new image asset.
- **Estimate Ad Group Audience Size**: Estimate the reachable audience size (delivery estimate) for a proposed ad group targeting spec and placements.
- **Estimate Audience Size**: Estimate the reachable audience size for a given targeting spec and placements.
- **Generate Smart Text**: Generate AI-suggested ad text (smart creative copy) for a given industry and keywords.
- **Get ACO Ad Materials**: Retrieve the creative materials (videos, images, texts, CTAs, names) of ACO ads for given ad groups.
- **Get Action Categories**: List available action (behavior) categories for ad group targeting.
- **Get Ad Group Quota**: Get the remaining ad group creation quota for an advertiser account.
- **Get Ad Groups**: List ad groups for an advertiser, optionally filtered by campaign, status, or ad group IDs.
- **Get Ad Image Info**: Get metadata (dimensions, format, URL) for uploaded ad images by image ID.
- **Get Ad Review Info**: Get the audit/review status and rejection reasons for one or more ads.
- **Get Ads**: List ads for an advertiser, with optional filtering by campaign, ad group, status, or ad IDs.
- **Get Advertiser Balance**: Get the current account balance, available budget, and grant balance for an advertiser.
- **Get Advertiser Info**: Get detailed info (name, currency, timezone, status, balance, contact) for one or more advertiser accounts.
- **Get Advertiser Transactions**: List spend / top-up transactions for an advertiser ad account.
- **Get Ad Video Info**: Get metadata (dimensions, duration, format, thumbnail) for uploaded ad videos by video ID.
- **Get App Conversion Events**: List the app conversion (optimization) events available for an app.
- **Get App Info**: Retrieve details of a registered app by ID.
- **Get App List**: List the apps registered under an advertiser account.
- **Get App Retargeting Events**: List the app retargeting events available for an app.
- **Get Attribution Report**: Retrieve attributed conversion metrics (click-through, view-through, engaged view-through) via the integrated report endpoint with conversion metrics.
- **Get Audience Overlap Insight**: Compare how much a benchmark custom audience overlaps with other custom audiences.
- **Get Audience Report**: Retrieve an audience/demographic breakdown report (age, gender, geography, network, placement) via the integrated report endpoint with report_type=AUDIENCE.
- **Get Authorized TikTok Account Info**: Resolve a creator's account authorization code into their TikTok account info for Spark Ads.
- **Get Authorized TikTok Post Info**: Get details of specific authorized TikTok posts (Spark Ads) by their item IDs.
- **Get Authorized TikTok Posts**: List the organic TikTok posts an advertiser has been authorized to use for Spark Ads.
- **Get Blocked Words**: List the blocked words configured on an advertiser's comment block list.
- **Get Brand Safety Partner Authorization Status**: Check the authorization status of a third-party brand safety partner.
- **Get Business Center Accounts**: Get the ad accounts within a Business Center with their finance status.
- **Get Business Center Account Transactions**: Get transaction records of ad accounts within a Business Center.
- **Get Business Center Ad Account Balances**: Retrieve the fund balances of ad accounts held within a Business Center.
- **Get Business Center Admin Assets**: List assets a Business Center owns as admin, including those shared to child BCs.
- **Get Business Center Asset Group**: Get the assets or members of a specific asset group in a Business Center.
- **Get Business Center Asset Members**: List members who have access to a specific BC asset.
- **Get Business Center Asset Partners**: List partner BCs that have access to a specific BC asset.
- **Get Business Center Assets**: List assets (advertisers, pixels, catalogs, identities) in a Business Center.
- **Get Business Center Balance**: Get the account balance of a Business Center.
- **Get Business Center Billing Groups**: List billing groups in a Business Center.
- **Get Business Center Members**: List the members (users) of a Business Center with their roles.
- **Get Business Center Partner Assets**: List the assets shared with or by a partner Business Center.
- **Get Business Center Partners**: List the partner Business Centers of a Business Center.
- **Get Business Center Pixel Links**: List the ad accounts a pixel is linked to within a Business Center.
- **Get Business Center Transactions**: Get the transaction records (recharges, refunds, spend) of a Business Center.
- **Get Business Center Unpaid Invoices**: List the unpaid invoices of a Business Center.
- **Get Campaigns**: List campaigns for an advertiser, with optional filtering by status, objective, or campaign IDs.
- **Get Carriers**: List mobile carriers available for ad group carrier targeting.
- **Get Catalog Available Countries**: List countries where catalog ads can be delivered.
- **Get Catalog Event Source Bindings**: List event sources bound to a catalog.
- **Get Catalog Lexicon**: List product-attribute placeholders usable in dynamic ad text.
- **Get Catalog Overview**: Get product audit status counts for a catalog.
- **Get Catalog Product Log**: Get recent product upload and deletion operation logs.
- **Get Catalog Products**: List products stored in a catalog, optionally filtered by SKU or product group, with pagination.
- **Get Catalogs**: List product catalogs owned by a Business Center.
- **Get Catalog Supported Locations and Currencies**: List locations and currencies supported for catalogs.
- **Get Catalog Videos**: List catalog videos generated for a catalog.
- **Get Comment Replies**: Get the replies (referenced comments) under a specific comment on an ad or TikTok post.
- **Get Contextual Tag Info**: Resolve details for a set of contextual tag IDs.
- **Get Contextual Tags**: List contextual targeting tags available for the given objective and regions.
- **Get Creative Portfolio**: Get a single creative portfolio's configuration by ID.
- **Get Cross-Account Report**: Retrieve an aggregated multi-advertiser report across a Business Center via the integrated report endpoint with report_type=BC.
- **Get Currencies**: List currencies supported for the advertiser account.
- **Get Custom Audience Apply Log**: List the ad group apply history for one or more custom audiences.
- **Get Custom Audience Details**: Get detailed info for one or more specific custom audiences.
- **Get Custom Audience Share Log**: List the advertiser accounts a custom audience has been shared with.
- **Get Device Models**: List device models available for ad group device targeting.
- **Get GMV Max Bid Recommendation**: Get a recommended ROAS/bid for a GMV Max campaign on a TikTok Shop store.
- **Get GMV Max Campaign Info**: Retrieve settings, budget, and status for one or more GMV Max campaigns.
- **Get GMV Max Exclusive Authorization**: Get the exclusive-authorization status granting an advertiser rights to a TikTok Shop store for GMV Max.
- **Get GMV Max Live Session**: Get details for one or more GMV Max live sessions by session ID.
- **Get GMV Max Report**: Retrieve performance metrics for GMV Max (Product/Live) campaigns broken down by store, product, creative, or time.
- **Get GMV Max Store Identities**: List the TikTok identities (accounts) available to a TikTok Shop store for GMV Max campaigns.
- **Get GMV Max Store Videos**: List the shoppable videos available to a TikTok Shop store for use in GMV Max campaigns.
- **Get Hashtags**: Resolve hashtag details for a set of hashtag keyword IDs.
- **Get Identity Video Info**: Get details of a TikTok post owned by an identity, for use as a Spark Ad creative.
- **Get Industry List**: Retrieve the list of industry categories used for advertiser qualification and account setup.
- **Get Instant Pages**: List an advertiser's TikTok Instant Pages / Instant Forms for lead generation.
- **Get Interest Categories**: Look up available interest-category IDs for ad group targeting.
- **Get ISPs by Location**: List scene-specific targeting options (e.g. ISPs) for given location IDs.
- **Get Languages**: List languages available for ad group language targeting.
- **Get Music**: Get music tracks available in the ad account's Commercial Music Library for use in ad creatives.
- **Get Offline Event Sets**: List offline event sets for an advertiser, or fetch one by ID.
- **Get OS Versions**: List operating system versions for the given OS type for device targeting.
- **Get Phone Region Codes**: List phone region (dialing) codes supported for targeting and lead forms.
- **Get Pixel Event Statistics**: View statistics for a pixel's events over a time period.
- **Get Pixels**: List the conversion pixels owned by an advertiser.
- **Get Playables**: Get a list of playable ads in the ad account.
- **Get Product Feed Log**: Get the recent fetch/operation history of a product feed.
- **Get Product Feeds**: List product feeds in a catalog.
- **Get Product Set Products**: List the products that match a product set.
- **Get Product Sets**: List product sets in a catalog.
- **Get Recommended Targeting Categories**: Get recommended interest and action categories for an advertiser or promoted app.
- **Get Smart+ Ads**: List Smart+ ads for an advertiser, with optional filtering by campaign or Smart+ ad IDs.
- **Get Smart+ Campaigns**: List Smart+ campaigns for an advertiser, with optional filtering by IDs, objective, name, status, or creation time.
- **Get Smart+ Material Report Breakdown**: Retrieve dimension-level creative-material performance breakdowns for Smart+ (automated) campaigns.
- **Get Smart+ Material Report Overview**: Retrieve aggregated creative-material performance for Smart+ (automated) campaigns.
- **Get Targeting Info**: Resolve names and metadata for a set of targeting tag IDs.
- **Get Targeting Regions**: Look up available location targeting codes (countries, cities, postal codes) by advertiser.
- **Get Timezones**: List timezones supported for advertiser accounts and campaign scheduling.
- **Invite Business Center Member**: Invite a user by email to join a Business Center with a role.
- **List Authorized Advertisers**: Get the list of advertiser ad accounts the user has authorized this app to manage.
- **List Billing Group Advertisers**: List the ad accounts (advertisers) that belong to a specific billing group in a Business Center.
- **List Business Center Advertisers**: List advertiser ad accounts that belong to a Business Center.
- **List Business Center Asset Groups**: List all asset groups in a Business Center.
- **List Business Centers**: List Business Centers the user can access through this app.
- **List Comments**: Get comments on an advertiser's ads or authorized TikTok posts, filtered by time, type, and status.
- **List Creative Portfolios**: List the creative portfolios in an ad account with pagination and filtering.
- **List Custom Audiences**: List all custom audiences (DMP) for an advertiser.
- **List GMV Max Live Sessions**: List all live shopping sessions under a Live GMV Max campaign.
- **List GMV Max Stores**: List the TikTok Shop stores available to an advertiser for GMV Max shopping campaigns.
- **List Identities**: List TikTok identities (customized user names or authorized TikTok accounts) available for ad creatives.
- **List Saved Audiences**: List an advertiser's saved audiences with pagination.
- **Migrate Catalog to Business Center**: Migrate (capitalize) an ad-account catalog into a Business Center.
- **Recommend Hashtags**: Get recommended hashtags for the given seed keywords.
- **Recommend Interest Keywords**: Get recommended interest keywords for a seed keyword.
- **Refresh Lookalike Audience**: Manually refresh one or more lookalike audiences to recompute their members.
- **Replace Blocked Word**: Replace an existing blocked word on the comment block list with a new word.
- **Reply to Comment**: Post a reply to a comment on an ad or authorized TikTok post using a chosen identity.
- **Run Async Report Task**: Create an asynchronous report task and poll for results — required for large advertisers or long date ranges.
- **Run Synchronous Report**: Run a synchronous report for spend, impressions, clicks, conversions, and other metrics across campaigns, ad groups, or ads.
- **Save Playable**: Save (finalize) an uploaded playable ad with its display settings.
- **Search Ad Videos**: Search and paginate video creatives in an advertiser's Asset Library by filters like name, dimensions, and ratio.
- **Search Interest Keywords**: Search or look up interest keywords by query or filter.
- **Search Targeting**: Search targeting tags (locations, interests, etc.) by keyword within a scene.
- **Search Targeting Locations**: Search geographic targeting locations (cities, DMAs, zip codes) by keyword.
- **Share Creative Asset**: Share images or videos from the Asset Library with other advertiser accounts.
- **Share Custom Audience**: Share one or more custom audiences with other advertiser accounts in the same Business Center.
- **Track Pixel Event**: Send a single server-side web conversion event to a TikTok Pixel (Events API).
- **Track Pixel Events Batch**: Send a batch of server-side web conversion events to a TikTok Pixel (Events API).
- **Track Server Event (Events API 2.0)**: Send web, app, or offline conversion events to TikTok via the consolidated Events API 2.0 endpoint.
- **Transfer Business Center Balance**: Transfer balance between a Business Center and an ad account (recharge or refund).
- **Transfer Business Center Pixel**: Transfer ownership of a pixel to another ad account within a Business Center.
- **Transfer Funds**: Transfer funds (cash and/or grant) between a Business Center and one of its ad accounts — recharge or deduct.
- **Transfer Funds Between Business Center and Ad Account**: Recharge money to or deduct money from an ad account within a Business Center.
- **Unassign Business Center Asset**: Revoke a member, partner, or child BC's access to a BC asset.
- **Unbind Event Source from Catalog**: Detach a pixel, app, or offline event source from a catalog used for dynamic ads.
- **Update ACO Ad**: Add or replace creative materials (videos, images, texts, CTAs) on an existing ACO ad.
- **Update ACO Material Status**: Change the status of individual ACO creative materials (e.g. delete a video, image, text, or CTA from the pool).
- **Update Ad**: Update an existing ad's name, text, landing URL, or creative.
- **Update Ad Account**: Update an ad account's settings — name, company, contact details, license/qualification documents, and budget.
- **Update Ad Group**: Update an existing ad group's budget, schedule, targeting, optimization goal, or bid.
- **Update Ad Group Status**: Enable, pause, or delete one or more ad groups in bulk.
- **Update Ad Status**: Enable, pause, or delete one or more ads in bulk.
- **Update App**: Update the name, download URL, or tracking settings of a registered app.
- **Update Business Center Asset Group**: Update the name, members, or assets of an asset group.
- **Update Business Center Billing Group**: Update a billing group's name or ad account membership.
- **Update Business Center Member**: Update a Business Center member's role.
- **Update Business Center Pixel Links**: Link or unlink a pixel to ad accounts within a Business Center.
- **Update Campaign**: Update an existing campaign's name, budget, or special-industry flags.
- **Update Campaign Status**: Enable, pause, or delete one or more campaigns.
- **Update Catalog**: Rename or update a product catalog.
- **Update Comment Status**: Hide or unhide (show) one or more comments on ads.
- **Update Custom Audience**: Update a custom audience's name or append/remove/replace its member data from uploaded files.
- **Update GMV Max Campaign**: Update the budget, ROAS bid, schedule, or promoted products of a GMV Max campaign.
- **Update GMV Max Live Session**: Update the settings of a scheduled live shopping session in a Live GMV Max campaign.
- **Update Offline Event Set**: Update the name, description, or settings of an offline event set.
- **Update Pixel**: Update the name or settings of an existing TikTok Pixel.
- **Update Pixel Event**: Update the name or conversion value of a configured pixel event.
- **Update Product Feed**: Update a product feed's URL, schedule, or update mode.
- **Update Product Set**: Update a product set's name or filter conditions.
- **Update Smart+ Ad**: Update the creative fields (ad text, media, identity, CTA, landing page) of an existing Smart+ ad.
- **Update Smart+ Ad Status**: Enable, disable, or delete one or more Smart+ ads in bulk.
- **Update Smart+ Campaign**: Update the name or budget of an existing Smart+ campaign.
- **Update Smart+ Campaign Status**: Enable, disable, or delete one or more Smart+ campaigns in bulk.
- **Upload Ad Image**: Upload an image asset (by file, by URL, or by file_id) for use in ad creatives.
- **Upload Ad Video**: Upload a video asset for use in ad creatives, by file or URL.
- **Upload Business Center Image**: Upload an image asset to a Business Center (e.g. qualification documents).
- **Upload Catalog Products via File**: Bulk add or update catalog products from a data file.
- **Upload Custom Audience File**: Upload a hashed-identifier data file and get a file path to build or update a custom audience.
- **Upload Playable**: Upload a playable (interactive HTML5) ad package to the ad account.
- **Validate Playable**: Check the processing/validation status of an uploaded playable ad.

## Related prompts

- [Daily TikTok Ads performance digest in Slack](https://www.generalinput.com/prompts/daily-tiktok-ads-performance-digest-in-slack.md)
- [Weekly Shopify to TikTok audience refresh](https://www.generalinput.com/prompts/weekly-shopify-to-tiktok-audience-refresh.md)
- [Daily TikTok ad creative fatigue check](https://www.generalinput.com/prompts/daily-tiktok-ad-creative-fatigue-check.md)
- [Sync new TikTok lead form leads to HubSpot and Slack](https://www.generalinput.com/prompts/sync-new-tiktok-lead-form-leads-to-hubspot-and-slack.md)

Connect TikTok Ads in General Input: https://www.generalinput.com/apps/tiktok-ads