Product
Jentic OSThe workplace. An in-house AI platform for every employeeJentic OneSafe access. Agents reach your systems without holding keysJentic AIRThe foundation. Gets your existing platforms ready for AI
Pricing
Developers

GET STARTED

API DirectoryBrowse 10,000+ APIs Ready For AI Agent IntegrationDocumentationGuides and API reference

TOOLS

API ScoringCheck your AI Readiness using our scorecardArazzo UIVisualize Arazzo Workflows As Interactive DocumentationArazzo EditorBuild And Edit Multi-Step API Workflows Visually

COMMUNITY

GitHubOpen source projects and examplesOpen StandardsBuilt on open specs. Never locked in.
Resources
Company
About UsOur mission and teamCareersJoin our teamContactGet in touch
Try it now
Jentic OSJentic OneJentic AIR
Pricing
API DirectoryDocumentationAPI ScoringArazzo UIArazzo EditorGitHubOpen Standards
Resources
About UsCareersContact
Try it now
JenticJentic
Products
  • Jentic OS
  • Jentic One
  • Jentic AIR
For Developers
  • API Directory
  • Documentation
  • GitHub
Company
  • About Jentic
  • Careers
  • Contact Us
  • Trust Centre
ISO/IEC 27001:2022 certification badge issued by Prescient SecurityISO/IEC 27001:2022 certification badge issued by Prescient Security

Information Security Management System

Certified to ISO/IEC 27001:2022 by Prescient Security

Terms & Conditions•Privacy Policy•
© 2026 Jentic Technology Ltd. All rights reserved.
2 Grattan Court East, Dublin, D02 VX86, Ireland
Switch to light modeSwitch to dark mode

Install Jentic One Beta

Connect the TikTok Marketing API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the TikTok Marketing API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

1

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fbusiness-api.tiktok.com%2Ftiktok-marketing" | sh
2

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fbusiness-api.tiktok.com%2Ftiktok-marketing" | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with TikTok Marketing API.

Create, list, and update TikTok ad campaigns and update their status

Manage ad groups and ads, including bulk status updates

Run Smart+ campaigns and ad groups via the /smart_plus paths

Manage audiences, pixels, and catalogs for ad targeting and product feeds

Pull reporting data and apply automated rules across the ad account

GET STARTED

Start building with TikTok Marketing API

Explore with Jentic One
View OpenAPI Document

Manage creatives, including comments and blocked words

Operate Business Center entities for multi-account advertisers

Use Cases

Patterns agents use TikTok Marketing API for, with concrete tasks.

★ Programmatic TikTok ad campaign management

Create campaigns, ad groups, and ads, then update their status as performance changes. The campaign, adgroup, and ad endpoints each expose create, list, update, and status-update operations, suitable for performance teams that orchestrate dozens or hundreds of ad units across multiple advertisers.

POST /campaign/create/ for the new objective, POST /adgroup/create/ under it, POST /ad/create/ for each creative, then POST /ad/status/update/ to enable them.

Smart+ automated campaigns

Run TikTok Smart+ campaigns where the platform optimizes targeting and creative selection. The /smart_plus/campaign and /smart_plus/adgroup endpoints mirror the standard create-list-update-status pattern but route to TikTok's automated optimization stack, suitable for teams that want simpler campaign management with platform-driven optimization.

POST /smart_plus/campaign/create/ with budget and objective, POST /smart_plus/adgroup/create/ under it, then activate with POST /smart_plus/campaign/status/update/.

Reporting and pixel-driven attribution

Pull spend, reach, and conversion data via the Reporting endpoints, and feed in offline conversions through the offline-events endpoints to attribute back to TikTok ads. Pair with pixel and audience endpoints to close the loop on retargeting and lookalike-style audiences.

Pull a campaign-level report from the Reporting endpoints for the last 7 days, then post matching offline events through the offline-events endpoint to attribute store visits.

AI agent ad operations via Jentic

An AI agent can manage day-to-day TikTok ad operations - pausing underperforming ad groups, building lookalike audiences, and adjusting Smart+ campaigns - without ever holding the raw Access-Token. Jentic securely stores the access token and refresh material and issues scoped, short-lived credentials per operation.

Search Jentic for 'pause a TikTok ad group', load the /adgroup/status/update/ schema, and execute the pause for the chosen ad group ID after the user confirms.

Key Endpoints

155 endpoints — the tiktok marketing api is tiktok's advertising and business center api for managing the full tiktok ads stack: ad accounts, campaigns, ad groups, ads, smart+ campaigns, creatives, audiences, pixels, catalogs, automated rules, comments, and reporting.

METHOD

PATH

DESCRIPTION

POST

/oauth2/access_token/

Exchange OAuth code for an access token

POST

/campaign/create/

Create a campaign

GET

/campaign/get/

List campaigns

POST

/adgroup/create/

Create an ad group

POST

/adgroup/status/update/

Update ad group status

POST

/ad/create/

Create an ad

POST

/smart_plus/campaign/create/

Create a Smart+ campaign

POST

/ad/status/update/

Update ad status

POST

/oauth2/access_token/

Exchange OAuth code for an access token

POST

/campaign/create/

Create a campaign

GET

/campaign/get/

List campaigns

POST

/adgroup/create/

Create an ad group

POST

/adgroup/status/update/

Update ad group status

POST

/ad/create/

Create an ad

POST

/smart_plus/campaign/create/

Create a Smart+ campaign

POST

/ad/status/update/

Update ad status

Why Jentic?

What agents get from Jentic-routed access to this vendor.

Setup

Wiring the TikTok Marketing API by hand means running the OAuth exchange at /oauth2/access_token/, scoping calls to an authorized advertiser via /oauth2/advertiser/get/, sending the Access-Token header on every request, and handling per-advertiser 429 throttling yourself. Through Jentic you install once, import the TikTok Marketing API from the API Directory, store the access token once, and your agent calls it.

Permission scoping

TikTok carries the advertiser and entity ids in the request body rather than the URL path, so you limit the agent to the operations it needs, such as GET /campaign/get/ to list campaigns or POST /adgroup/status/update/ to pause one. Write and status operations like POST /campaign/create/ or /ad/status/update/ stay out of reach unless you add them.

Credential isolation

Your TikTok Access-Token and OAuth refresh material are stored once, encrypted, by your own Jentic One instance and injected at execution time. They never enter the agent's prompt, logs, or context.

Intent-based discovery

Agents search Jentic by intent such as 'create a TikTok campaign' or 'pause a TikTok ad group', and Jentic returns the matching operation like POST /campaign/create/ or /adgroup/status/update/ with its input schema, so the agent calls the right endpoint without reading the TikTok developer portal.

Related APIs

Alternatives and complements available in the Jentic catalogue.

Alternative

Facebook Graph API

→

Meta's ad and content API spans Facebook and Instagram, with a different objective taxonomy than TikTok.

Pick Meta's Graph API when running cross-Meta campaigns; pick TikTok Marketing API specifically for TikTok ad operations.

Alternative

Snapchat Marketing API

→

Snapchat's advertising API for vertical-video campaigns on Snap.

Pick Snapchat for ads on Snap; both target similar advertiser personas to TikTok.

Complementary

Pinterest API

→

Pinterest exposes ads and content endpoints for parallel social distribution.

Use alongside TikTok when running campaigns across multiple visual-discovery platforms.

FAQs

Specific to using TikTok Marketing API through Jentic.

What authentication does the TikTok Marketing API use?

Requests carry an Access-Token header obtained via the TikTok OAuth flow at /oauth2/access_token/. List authorized advertisers with /oauth2/advertiser/get/. Through Jentic, the access token and refresh material are encrypted in the vault and a scoped, short-lived token is issued per operation.

Can I create and manage TikTok ad campaigns through this API?

Yes - POST /campaign/create/ to create a campaign, GET /campaign/get/ to list, POST /campaign/update/ to edit, and POST /campaign/status/update/ to enable, pause, or delete. Ad groups and ads expose the same create-list-update-status pattern.

What is Smart+ and how do I run it via the API?

Smart+ is TikTok's automated campaign optimization stack. Use /smart_plus/campaign/create/ and /smart_plus/adgroup/create/ to set up Smart+ entities; status and update operations mirror the standard ad surface.

How do I pull spend or performance data from a TikTok ad account?

Use the Reporting endpoints, which return aggregated metrics by campaign, ad group, or ad over a date range. Pair with the pixel and offline-events endpoints to attribute conversions to specific ads.

What are the rate limits for the TikTok Marketing API?

The OpenAPI spec does not declare explicit limits. TikTok publishes per-app and per-advertiser quotas in their developer documentation - implement 429 retry-with-backoff and stagger reporting pulls to avoid spikes.

How do I create a TikTok campaign through Jentic?

Run `pip install jentic` and search for 'create a TikTok campaign'. Jentic returns the /campaign/create/ operation, you load its schema, and execute with the campaign payload - credentials stay in your Jentic One instance.

Can I limit what my agent is allowed to do with the TikTok Marketing API?

Yes. Because you run Jentic One yourself, you decide which TikTok Marketing operations the agent can call, so you can grant read-only access like GET /campaign/get/ to list campaigns while withholding everything else. Write and status operations such as POST /campaign/create/ and POST /adgroup/status/update/ stay out of reach unless you explicitly add them. Since TikTok carries the advertiser and entity ids in the request body rather than the URL, your own rules govern both which endpoints the agent uses and the credentials it is given at execution time.

APIs / Marketing / TikTok Marketing API
TikTok Marketing API logo

Business Api Tiktok TikTok Marketing API

54
AI ReadinessFoundational (C)54/100
See full scorecard
Official vendor OpenAPI document · agent-readyMarketingAdvertisingapiKey155 EndpointsREST

For Agents

Create and manage TikTok ad campaigns, ad groups, ads, audiences, and creatives, run Smart+ campaigns, and pull reporting data on behalf of an authorized advertiser.

Use for: I need to create a TikTok ad campaign, Pause an ad group whose performance has dropped, List all my TikTok ads with their current status, Pull last week's spend report for an ad account

Not supported: Does not handle organic TikTok content posting, creator-economy payouts, or non-ad analytics - use for TikTok ad operations and Business Center management only.

The TikTok Marketing API is TikTok's advertising and Business Center API for managing the full TikTok Ads stack: ad accounts, campaigns, ad groups, ads, Smart+ campaigns, creatives, audiences, pixels, catalogs, automated rules, comments, and reporting. It also exposes Business Center, app, and offline events endpoints for advertisers running cross-account or attribution workflows. Authentication uses an Access-Token header issued through the TikTok OAuth flow against /oauth2/access_token/.

Jentic One on GithubView OpenAPI Document

Jentic AI Readiness Score

This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use.

T

TikTok Marketing API

- Foundational (C)
54/100
43
Foundational Compliance
63
Developer Experience & Jentic Compatibility
46
AI-Readiness & Agent Experience
65
Agent Usability
50
Security
100
AI Discoverability
Powered by JenticScoring Framework 1.0.0 | Scoring Engine 0.4.0
Show dimension breakdown
43

Foundational Compliance

Base layer of spec validity and structural soundness.

Grade: D-Signals: 4
61%

Lint Results

Aggregated quality score from linter diagnostics, weighted by severity.

100%

Resolution Completeness

Percentage of `$ref` references that resolve successfully.

0%

Specification Validity

Checks whether the API description parses successfully and conforms to its declared specification (e.g., OpenAPI).

10%

Structural Integrity

Structural correctness score based on schema issues using logarithmic dampening.

63

Developer Experience & Jentic Compatibility

Clarity, completeness, and ingestion readiness for developers and tooling.

Grade: B-Signals: 4
0%

Example Density

How richly the API is illustrated with examples.

100%

Example Validity

Percentage of examples that conform to their schemas.

50%

Response Coverage

Percentage of operations with complete response definitions (success, client error, server error).

100%

Tooling Readiness

Health of API ingestion, bundling, and resolution within Jentic pipelines.

46

AI-Readiness & Agent Experience

Semantic breadth, depth, and agent comprehension for AI systems.

Grade: DSignals: 4
32%

Description Coverage

Coverage of descriptions across API elements.

0%

Error Standardization

Coverage of RFC 9457 Problem Details for error responses.

100%

OperationId Quality

Coverage, uniqueness, and casing consistency of operationIds for AI inference.

50%

Summary Coverage

Coverage of summaries across operations/tags/info.

65

Agent Usability

Functional utility, complexity comfort, and AI orchestration readiness.

Grade: BSignals: 1
65%

Complexity Comfort

Agent comfort level based on API operational and structural complexity.

50

Security

Trust, risk posture, and security compliance.

Grade: C-Signals: 1
50%

Authentication Strength

Average quality of security schemes based on authentication method strength (weakest link for OAuth2).

100

AI Discoverability

Findability, semantic richness, and reasoning readiness.

Grade: A+Signals: 1
100%

Descriptive Richness

Clarity and depth of descriptions across API elements.

View full reportHow the score is calculatedMore about the dimensions

Score it yourself

Every API in the directory is allowlisted, so you can re-score it with no key required.

Score your own APIScoring CLI agent skill
npx @jentic/api-scorecard-cli score <openapi-url>