[Integrations](https://spiral.ai/integrations) › [Cursor](https://spiral.ai/integrations/cursor) › [TikTok keyword search](https://spiral.ai/integrations/cursor/tiktok-keyword-search)

# How to Use TikTok keyword search in Cursor

Returns comprehensive TikTok search results for a keyword. Use it to investigate a brand, product, or subject before narrowing the research to hashtags or search insights.

|  |  |
| --- | --- |
| Model | TikTok keyword search |
| Available through | TikHub |
| Category | Social Media |
| Price | $0.0013 per request. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with TikTok keyword search in Cursor

- Use TikTok keyword search for 'LEGO flowers' and add a table of the returned results to this project's research report.
- Use TikTok keyword search to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from TikTok keyword search and tell me what changed since last week.
- Check TikTok keyword search and summarize what you find in three bullet points.
- Pull the newest data from TikTok keyword search and give me the result as a table.

## How to set up TikTok keyword search in Cursor

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

### Use Spiral's MCP server

1. **Add the hosted server**: Use Add to Cursor on the console's Agents & MCP page, or add this to `.cursor/mcp.json` (one project) or `~/.cursor/mcp.json` (every project):

```json
{
  "mcpServers": {
    "spiral": { "url": "https://api.spiral.ai/mcp" }
  }
}
```

2. **Sign in**: Open Cursor Settings › MCP, click Connect next to spiral, sign in to Spiral and click Authorize. No API key. Spiral then shows as connected, with its tools listed.

### Use the Spiral skill

1. **Send Cursor 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.

```bash
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**: One request; the result comes back by polling or a webhook.

```bash
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-fetch-general-search-result",
    "input": {
      "keyword": "中华娘"
    }
  }'
```

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

Setup guide in the docs: https://spiral.ai/docs/quickstarts/cursor

## TikTok keyword search tools and prices

- [TikTok App · Get comprehensive search results of specified keywords](https://spiral.ai/tools/tikhub/tikhub/tiktok-app-v3-fetch-general-search-result) (TikHub): $0.0013 per request.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| count |  | 20 | Number |
| offset |  | 0 | Offset |
| sort_type |  | 0 | Sort type |
| publish_time |  | 0 | Publish time |

## What can you do with TikTok keyword search in Cursor?

Build a TikTok research report in your project from retrieved search results, topic insights, or hashtag data. Your coding agent can turn the returned records into tables and translate supplied text for an editorial review.

### Prepare a multilingual product launch brief

Research a product category through keyword results, matching hashtags, hashtag details, and hashtag videos. Add search topics, their statistics, regional trends, and related videos; review public shopping creator information and translate selected text for the launch team.

### Build an editorial calendar for a retail category

Use search insights, topic statistics, and regional trends to propose subjects. Ground each proposal in keyword results, hashtag research, and related video examples; add potential shopping collaborators and translations of relevant text.

### Plan a seasonal retail campaign

Compare seasonal search topics using their statistics, geographic interest, and related videos. Combine keyword and hashtag research with public shopping creator information, then translate selected phrases for a campaign planning brief.

### Write a creator partnership brief

Combine a public shopping creator's storefront and audience counts with category keyword results and hashtag details and videos. Use search insights, topic statistics, regional trends, and related videos to suggest subjects, translating selected text for collaborators.

### Research a branded hashtag

Search for a campaign phrase, inspect the matching hashtag's details, and collect associated videos for a campaign review.

### Prepare a bilingual research digest

Collect keyword and hashtag video results for a category, then translate selected supplied text into the editorial team's working language.

## Overview

- [TikHub](https://spiral.ai/providers/tikhub)
- [All Cursor guides](https://spiral.ai/integrations/cursor)

## TikTok keyword search in other agents

- [Amp](https://spiral.ai/integrations/amp/tiktok-keyword-search)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/tiktok-keyword-search)
- [Claude](https://spiral.ai/integrations/claude-desktop/tiktok-keyword-search)
- [Claude Code](https://spiral.ai/integrations/claude-code/tiktok-keyword-search)
- [Cline](https://spiral.ai/integrations/cline/tiktok-keyword-search)
- [Codex](https://spiral.ai/integrations/codex/tiktok-keyword-search)
- [Devin](https://spiral.ai/integrations/devin/tiktok-keyword-search)
- [dots](https://spiral.ai/integrations/dots/tiktok-keyword-search)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/tiktok-keyword-search)
- [Gemini](https://spiral.ai/integrations/gemini/tiktok-keyword-search)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/tiktok-keyword-search)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/tiktok-keyword-search)
- [goose](https://spiral.ai/integrations/goose/tiktok-keyword-search)
- [Grok](https://spiral.ai/integrations/grok/tiktok-keyword-search)
- [Grok Build](https://spiral.ai/integrations/grok-build/tiktok-keyword-search)
- [Hermes](https://spiral.ai/integrations/hermes/tiktok-keyword-search)
- [Instinct](https://spiral.ai/integrations/instinct/tiktok-keyword-search)
- [Manus](https://spiral.ai/integrations/manus/tiktok-keyword-search)
- [Muse](https://spiral.ai/integrations/muse/tiktok-keyword-search)
- [Muse Code](https://spiral.ai/integrations/muse-code/tiktok-keyword-search)
- [n8n](https://spiral.ai/integrations/n8n/tiktok-keyword-search)
- [Notion](https://spiral.ai/integrations/notion/tiktok-keyword-search)
- [OpenClaw](https://spiral.ai/integrations/openclaw/tiktok-keyword-search)
- [opencode](https://spiral.ai/integrations/opencode/tiktok-keyword-search)
- [Perplexity](https://spiral.ai/integrations/perplexity/tiktok-keyword-search)
- [Raycast](https://spiral.ai/integrations/raycast/tiktok-keyword-search)
- [VS Code](https://spiral.ai/integrations/vscode/tiktok-keyword-search)
- [Windsurf](https://spiral.ai/integrations/windsurf/tiktok-keyword-search)
- [Zapier](https://spiral.ai/integrations/zapier/tiktok-keyword-search)

## More Cursor guides

- [TikTok home feed videos](https://spiral.ai/integrations/cursor/tiktok-home-feed-videos)
- [TikTok keyword search link](https://spiral.ai/integrations/cursor/tiktok-keyword-search-link)
- [TikTok hashtag videos](https://spiral.ai/integrations/cursor/tiktok-hashtag-videos)
- [TikTok keyword videos](https://spiral.ai/integrations/cursor/tiktok-keyword-videos)
- [TikTok hashtag search](https://spiral.ai/integrations/cursor/tiktok-hashtag-search)
- [TikTok liked videos](https://spiral.ai/integrations/cursor/tiktok-liked-videos)

## Questions about TikTok keyword search in Cursor

**Can Cursor use TikTok keyword search?**

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

**How much does TikTok keyword search cost in Cursor?**

$0.0013 per request. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Cursor plan is separate.

**Do I need a TikHub account to use TikTok keyword search in Cursor?**

No. Spiral runs TikTok keyword search 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 in Cursor?**

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

**Does Cursor wait while TikTok keyword search runs?**

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

**Does TikHub return private TikTok content?**

TikHub's privacy policy says it does not access or store private, restricted, or password-protected platform content. Public availability is the access boundary.

**How fresh is TikHub's data?**

TikHub describes repeat requests as fresh, real-time retrievals. Its terms still disclaim guarantees that the returned data is current.

**Does TikHub guarantee complete or accurate results?**

No. TikHub's terms explicitly disclaim guarantees that retrieved data is accurate, complete, or current.

**Can retrieved TikTok content be reused freely?**

TikHub's terms say retrieved content may carry third-party intellectual property rights. Retrieval does not establish permission to republish a creator's work.

**Does TikHub document every returned data field?**

No. TikHub says its responses vary by platform and its documentation describes endpoints and parameters rather than every payload key.

