How to Use TikTok TikToks using Song in Gemini CLI
Returns TikTok videos using a specific sound, with captions, author details, media information, and engagement counts. Use it to compare posts attached to that sound and research caption themes or campaign participation.
Prompts to try with TikTok TikToks using Song in Gemini CLI
Copy an example into Gemini CLI, or ask in your own words.
Use TikTok videos using a sound for 7439295283975702544 and add a table to this project's dashboard with video links, captions, views, likes, comments, and shares.
Use TikTok videos using a sound for 7370375686554782506, fetch up to three pages, and export distinct video IDs, captions, posting times, and engagement counts to CSV.
Use TikTok videos using a sound for 7439295283975702544 and add a report that ranks returned posts by shares per 1,000 views, excluding records with zero views.
Use TikTok videos using a sound for 7370375686554782506 and compare the returned video IDs with this project's approved campaign list. Show matched posts and their engagement counts.
Use TikTok videos using a sound for 7439295283975702544 and build a caption-theme report in this repository, with supporting video links for each theme.
How to set up TikTok TikToks using Song 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 TikToks using Song
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": "scrapecreators", "model": "scrapecreators/tiktok-song-videos", "input": { "clipId": "7439295283975702544" } }'
Then paste one of the prompts above: Gemini CLI finds TikTok TikToks using Song on Spiral, shows the price and runs it.
TikTok TikToks using Song providers and prices
Spiral runs TikTok TikToks using Song through ScrapeCreators. Open a card for today's price, with every fee included.
Settings you can ask for
Ask Gemini CLI for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Cursor | a number | The cursor to get the next page of results. |
Every API field of TikTok · TikToks using Song is on its tool page: open its card above.
What can you do with TikTok TikToks using Song in Gemini CLI?
Build a sound report that lists TikTok posts alongside captions and engagement counts. A coding agent can add pagination, match video IDs across collections, and calculate comparisons in your project's reporting code.
Review campaign participation
Collect posts attached to a campaign sound and match their video IDs against an approved list of public brand and creator posts. Report matches within the collected results.
Compare engagement within a sound
Rank returned videos by views, likes, comments, or shares to choose examples for a music team's performance review.
Research caption themes
Group captions and hashtags from videos using a sound. Use the recurring themes to prepare a creative brief with links to supporting posts.
Find brand mentions in sound usage
Search returned captions for a brand or product name and review the matching posts with their engagement counts.
Measure changes in observed posts
Compare repeated collections by video ID to identify newly encountered posts and engagement changes on posts seen before.
Prepare a label's weekly sound report
Summarize the collected videos for a release's selected sound, including leading posts, caption themes, and the number of distinct videos reviewed.
More on TikTok TikToks using Song and Gemini CLI
TikTok TikToks using Song in other agents
Questions about TikTok TikToks using Song in Gemini CLI
Can Gemini CLI use TikTok TikToks using Song?
Yes. Add Spiral to Gemini CLI as an MCP server, and Gemini CLI can find and run TikTok TikToks using Song like any built-in tool.
How much does TikTok TikToks using Song cost in Gemini CLI?
Up to $0.0013 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 a ScrapeCreators account to use TikTok TikToks using Song in Gemini CLI?
No. Spiral runs TikTok TikToks using Song on its own ScrapeCreators account. You sign in to Spiral once and never paste a key.
How long does it take to set up TikTok TikToks using Song in Gemini CLI?
About two minutes: add the server, then sign in, then check it.
Does Gemini CLI wait while TikTok TikToks using Song runs?
TikTok TikToks using Song runs in the background. Gemini CLI starts the run, checks on it and gives you the json when it's ready.
Does this cover every upload of a song?
The lookup covers videos associated with one TikTok sound. Keep the report scoped to that sound rather than presenting it as every use of the song across TikTok.
How many videos does one request return?
ScrapeCreators observed 13 videos on one page and 12 on the next in its October 23, 2026 test. Both pages indicated more results, so those numbers are examples rather than a fixed page-size guarantee; additional results use cursor pagination.
Which engagement numbers are available?
The documented video records include views, likes, comments, and shares. These are video-level counts, which let you compare returned posts using the same sound.
How fresh is the data?
ScrapeCreators says live TikTok requests fetch the latest information available at request time. Its homepage also distinguishes live source retrieval on cache misses from cached responses.
Can it retrieve private TikTok content?
ScrapeCreators describes its source data as publicly available. Plan sound research around public posts rather than private account content.
Start using TikTok TikToks using Song 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


