Spiral gives your agent every tool with one account. Browse the tools →

Gemini CLI · Social Media

How to Use TikTok keyword search link in Gemini CLI

Returns a share link that opens TikTok's app at search results for a keyword. Use it to give a researcher a direct starting point for reviewing a brand, product, or topic in TikTok.

Prompts to try with TikTok keyword search link in Gemini CLI

Copy an example into Gemini CLI, or ask in your own words.

Use TikTok keyword search link for 'Duolingo' and add the returned link to the Duolingo entry in our internal brand research page.

TikTok keyword search linkGemini CLI
Try asking
  • Use TikTok keyword search link for 'Dyson Airwrap review' and add the returned link to our product comparison worksheet.

  • Use TikTok keyword search link for 'Seattle coffee shops' and add it to the Seattle research card in this project.

  • Use TikTok keyword search link for 'LEGO Botanicals' and place the returned link in our internal campaign brief.

  • Use TikTok keyword search link for 'Patagonia repair' and add the returned link to the sustainability research section in our app.

How to set up TikTok keyword search link in Gemini CLI

Pick the way that suits you. Each takes about two minutes.

Use Spiral's MCP server

  1. Add the server

    Or add it to ~/.gemini/settings.json yourself:

    gemini mcp add --scope user --transport http spiral https://api.spiral.ai/mcp
  2. Sign in

    Start gemini and run:

    /mcp auth spiral
  3. Check it

    In Gemini CLI, run /mcp. From your shell:

    gemini mcp list

Use the Spiral skill

  1. Send Gemini CLI this message

    Your agent reads Spiral's skill and sets itself up.

    set up https://spiral.ai/SKILL.md
  2. Sign in or paste a key

    Approve Spiral in the browser, or give the agent a key from the console.

Use the Spiral CLI

  1. 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

  1. Create an API key

    In the console, under API keys.

  2. Run TikTok keyword search 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-keyword-search",
        "input": {
          "keyword": "Evil0ctal"
        }
      }'

Then paste one of the prompts above: Gemini CLI finds TikTok keyword search link on Spiral, shows the price and runs it.

TikTok keyword search link providers and prices

Spiral runs TikTok keyword search link through TikHub. Open a card for today's price, with every fee included.

TikHubSocial Media

What can you do with TikTok keyword search link in Gemini CLI?

Add direct TikTok search links to an internal research dashboard or editorial queue. A coding agent can place the returned links beside the relevant brand, product, or topic in the project's interface.

Prepare a brand review

Generate a search link for 'Duolingo' and include it in an internal brief so a researcher can review the results in TikTok.

Organize product review research

Create separate search links for 'Dyson Airwrap review' and 'Shark FlexStyle review' for a researcher comparing product discussions.

Build an editorial research queue

Attach a 'sourdough starter' search link to an internal article brief so an editor can inspect TikTok examples before choosing an angle.

Prepare local business research

Generate a 'Seattle coffee shops' search link for a researcher preparing a local food or travel brief.

Support campaign planning

Add a 'LEGO Botanicals' search link to an internal campaign worksheet for manual review of relevant TikTok content.

Prepare recurring research handoffs

Include a 'Patagonia repair' search link in a weekly research checklist, giving the reviewer a direct route into TikTok search.

Questions about TikTok keyword search link in Gemini CLI

Can Gemini CLI use TikTok keyword search link?

Yes. Add Spiral to Gemini CLI as an MCP server, and Gemini CLI can find and run TikTok keyword search link like any built-in tool.

How much does TikTok keyword search link cost in Gemini CLI?

$0.0013 per request. 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 TikHub account to use TikTok keyword search link in Gemini CLI?

No. Spiral runs TikTok keyword search 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 keyword search link in Gemini CLI?

About two minutes: add the server, then sign in, then check it.

Does Gemini CLI wait while TikTok keyword search link runs?

TikTok keyword search link runs in the background. Gemini CLI starts the run, checks on it and gives you the json when it's ready.

Does this return TikTok videos or a search link?

TikHub documents a share link that opens the TikTok app at a keyword search. It does not document a returned list of videos, engagement counts, or paginated search records for this endpoint.

Will everyone opening the link see the same results?

Identical results are not assured: TikTok lists device settings, language preference, and location among the factors that can influence search results.

How does TikTok decide which content matches a search?

TikTok says search results can depend on how closely content matches the query, along with hashtags and the sound used. For a product review, a phrase such as 'Dyson Airwrap review' gives a more specific research target than 'Dyson'.

Does TikHub provide access to private TikTok content?

TikHub's terms explicitly exclude access to private, restricted, or password-protected content. A keyword search link provides a destination in TikTok, not permission to access restricted posts.

What business use does TikHub's license allow?

TikHub's service license specifies lawful internal business purposes. Keep that boundary in mind when planning internal brand research, editorial reviews, or product research.

Get started

Start using TikTok keyword search link 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 Gemini CLI

set up https://spiral.ai/SKILL.md
Are you an AI agent? See setup options