How to Use TikTok video share link in Codex
Generates a share link that opens a specified video's detail page in TikTok. Use it to put the original post within reach during campaign reviews or editorial checks; the documented output is a link, not video statistics.
Prompts to try with TikTok video share link in Codex
Copy an example into Codex, or ask in your own words.
Use TikTok video share link for @duolingo video 7514320905909194030 and save the returned link in our campaign review fixture.
Use TikTok video share link for @duolingo video 7514320905909194030, then add an Open in TikTok action to our existing video review component.
Use TikTok video share link for @duolingo video 7514320905909194030 and add the returned link to the creative references page in this project.
Use TikTok video share link for @duolingo video 7514320905909194030 and update our review reminder template to include the returned link.
Use TikTok video share link for @duolingo video 7514320905909194030 and store the actual response as a development fixture for our link display.
How to set up TikTok video share link in Codex
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the hosted server
codex mcp add spiral --url https://api.spiral.ai/mcp
- Sign in
Codex opens the browser: sign in to Spiral and click Authorize. No API key. codex mcp list then shows Spiral.
codex mcp login spiral
Use the Spiral skill
- Send Codex this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use the Spiral CLI
- Install and sign in
Installs the Spiral CLI, signs you in and adds its skill to your coding agents.
npx -y spiral-cli@latest init
Call the Spiral API
- Create an API key
In the console, under API keys.
- Run TikTok video share link
One request; the result comes back by polling or a webhook.
curl https://api.spiral.ai/v1/runs \ -H "Authorization: Bearer $SPIRAL_API_KEY" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: $(uuidgen)" \ -d '{ "provider": "tikhub", "model": "tikhub/tiktok-app-v3-open-tiktok-app-to-video-detail", "input": { "aweme_id": "7440436579409153311" } }'
Then paste one of the prompts above: Codex finds TikTok video share link on Spiral, shows the price and runs it.
TikTok video share link providers and prices
Spiral runs TikTok video share link through TikHub. Open a card for today's price, with every fee included.
$0.0013 per request.
What can you do with TikTok video share link in Codex?
Add an Open in TikTok action beside a known brand video in your review app. A coding agent can retrieve the share link and connect it to the project's existing review interface.
Campaign review references
Add links for known brand posts to a campaign review so reviewers can open each original video in TikTok.
Editorial source checks
Attach a link to the original public TikTok post beside a draft's reference to it, giving an editor a direct place to check the source.
Creative reference lists
Turn an existing selection of public business and creator videos into links for a creative review session.
Published-post handoffs
Include a link to a known published brand video in the handoff from the publishing team to the people reviewing it.
Mobile review buttons
Use the returned link for an Open in TikTok button beside a known video in an internal content review app.
Scheduled review reminders
Include the original post's link in recurring reminders to review a selected public campaign video.
More on TikTok video share link and Codex
Overview
TikTok video share link in other agents
Questions about TikTok video share link in Codex
Can Codex use TikTok video share link?
Yes. Add Spiral to Codex as an MCP server, and Codex can find and run TikTok video share link like any built-in tool.
How much does TikTok video share link cost in Codex?
$0.0013 per request. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Codex plan is separate.
Do I need a TikHub account to use TikTok video share link in Codex?
No. Spiral runs TikTok video share link on its own TikHub account. You sign in to Spiral once and never paste a key.
How long does it take to set up TikTok video share link in Codex?
About two minutes: add the hosted server, then sign in.
Does Codex wait while TikTok video share link runs?
TikTok video share link runs in the background. Codex starts the run, checks on it and gives you the json when it's ready.
Does this return the video's details or just a link?
TikHub documents the return as a share link pointing to a specified video's detail page in the TikTok app. It does not document video statistics or comments as this endpoint's output.
Can a share link make a private TikTok video public?
TikTok says videos set to private are visible only to their owner. A generated share link should not be treated as permission to view restricted content.
Will a public video stay available through its link?
TikTok allows an uploaded video to be made private later. The link therefore is not a guarantee that everyone can continue viewing the post.
Does a share link preserve a deleted TikTok post?
The documented output is a link, not an archived copy. TikTok says deleted posts remain in its system for up to 30 days before permanent deletion; that internal retention does not establish public access.
Does getting a link give me permission to reuse the video?
A share link is not a reuse license. TikTok's policy says using another person's copyrighted content requires proper authorization or a legally valid reason.
Start using TikTok video share link in Codex
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Codex:
set up https://spiral.ai/SKILL.md


