How to Use TikTok video details in Gemini CLI
Returns metadata and engagement data for a specific TikTok video. Use it to examine one campaign post or creative example in detail.
Prompts to try with TikTok video details in Gemini CLI
Copy an example into Gemini CLI, or ask in your own words.
Use TikTok video details for https://www.tiktok.com/@zachking/video/6768504823336815877 and map the returned metadata and engagement metrics into our internal video review component.
Use TikTok video details to look this up and give me the result as a table. Save the result in ./assets.
Pull the latest numbers from TikTok video details and tell me what changed since last week.
Check TikTok video details and summarize what you find in three bullet points.
Pull the newest data from TikTok video details and give me the result as a table.
How to set up TikTok video details in Gemini CLI
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the server
Or add it to ~/.gemini/settings.json yourself:
gemini mcp add --scope user --transport http spiral https://api.spiral.ai/mcp
- Sign in
Start gemini and run:
/mcp auth spiral
- Check it
In Gemini CLI, run /mcp. From your shell:
gemini mcp list
Use the Spiral skill
- Send Gemini CLI 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 details
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": "alexandria", "model": "influencers-club/tiktok/video-details", "input": { "url": "<url>", "content_type": "<content_type>" } }'
Then paste one of the prompts above: Gemini CLI finds TikTok video details on Spiral, shows the price and runs it.
TikTok video details providers and prices
Spiral runs TikTok video details through Alexandria. Open a card for today's price, with every fee included.
What can you do with TikTok video details in Gemini CLI?
Build internal TikTok research tables for creator selection and content reviews. Map returned profile information, connected accounts, or post metrics into the project's reports so the partnership team can compare candidates.
Build a campaign shortlist
Find creators for a campaign brief, check their profile information, and review recent posts and selected videos before recommending candidates internally.
Research creative examples
Find creators in a relevant category, review recent captions and engagement, and examine individual videos for an internal content brief.
Review public brand activity
Compare public brand profiles, their connected accounts, recent posting activity, and individual video metrics to prepare an internal competitor report.
Prepare a sponsorship renewal review
Refresh a creator's profile and connected account information, review recent posts, and compare selected campaign videos before an internal renewal discussion.
Produce a weekly content report
Collect recent posts from public brand or creator accounts and revisit selected video metrics to show which content gained engagement between checks.
More on TikTok video details and Gemini CLI
Overview
TikTok video details in other agents
Questions about TikTok video details in Gemini CLI
Can Gemini CLI use TikTok video details?
Yes. Add Spiral to Gemini CLI as an MCP server, and Gemini CLI can find and run TikTok video details like any built-in tool.
How much does TikTok video details cost in Gemini CLI?
Up to $0.034918 per run. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Gemini CLI plan is separate.
Do I need an Alexandria account to use TikTok video details in Gemini CLI?
No. Spiral runs TikTok video details on its own Alexandria account. You sign in to Spiral once and never paste a key.
How long does it take to set up TikTok video details in Gemini CLI?
About two minutes: add the server, then sign in, then check it.
Does Gemini CLI wait while TikTok video details runs?
TikTok video details runs in the background. Gemini CLI starts the run, checks on it and gives you the json when it's ready.
Where does Influencers.club get its creator data?
Influencers.club collects public web information, including public pages and search engine results, and obtains publicly available data from partners. It says it does not collect information behind login or password walls.
How fresh is the TikTok data?
Influencers.club says enrichment and post endpoints refresh responses on each call. Creator search uses indexes that update on a rolling basis.
Does Influencers.club guarantee complete TikTok coverage?
No. Its terms do not guarantee completeness, accuracy, or continued availability of any particular data point, field, or category, including when public source information changes or disappears.
Can I redistribute the returned creator data?
The standard terms license creator data for internal business use. Reselling or redistributing it, including passing API results to your own customers, requires a separate written agreement.
Can a public creator disappear from the database?
Yes. Influencers.club processes creator removal requests within at most 30 days and removes profiles from customer-facing systems within 30 days of detecting that the source account was deleted.
Start using TikTok video details in Gemini CLI
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Gemini CLI:
set up https://spiral.ai/SKILL.md


