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

# How to Use TikTok video metrics in Cursor

Returns a TikTok video's views, likes, comments, favorites, and performance overview, with documented 14-day trend fields. Use it to measure post performance and compare engagement across selected videos.

|  |  |
| --- | --- |
| Model | TikTok video metrics |
| 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 video metrics in Cursor

- Use TikTok video metrics for video 7502551047378832671 and add a table of views, likes, comments, and favorites to this project.
- Use TikTok video metrics for video 7502551047378832671 and add a chart for any returned daily trends, using the response's dates as labels.
- Use TikTok video metrics to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from TikTok video metrics and tell me what changed since last week.
- Check TikTok video metrics and summarize what you find in three bullet points.

## How to set up TikTok video metrics 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 video metrics**: 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-analytics-fetch-video-metrics",
    "input": {
      "item_id": "7502551047378832671"
    }
  }'
```

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

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

## TikTok video metrics tools and prices

- [TikTok Analytics · Get video metrics](https://spiral.ai/tools/tikhub/tikhub/tiktok-analytics-fetch-video-metrics) (TikHub): $0.0013 per request.

## What can you do with TikTok video metrics in Cursor?

Build a TikTok reporting view that turns comment themes, creator milestones, or post engagement into evidence an editor can review. A coding agent can add tables and comparisons to your project using the returned data.

### Prepare a creator partnership brief

Combine dated account milestones and follower totals with selected video results and audience comment themes to prepare questions for a public creator partnership.

### Write a campaign review

Report engagement on selected campaign videos, summarize the feedback in matching comments, and add account totals and milestones as context.

### Compare public brand accounts

Compare a chosen set of brands using account totals, dated milestones, selected post metrics, and comment themes. Keep the comparison tied to the accounts and videos reviewed.

### Plan the next content brief

Use audience questions from comments and engagement on selected posts to propose follow-up videos. Include account milestones when choosing whether a retrospective or celebration fits the brief.

### Build a weekly brand report

Compare retrieved account totals, video engagement, and comment themes with earlier saved results to show what changed for a public business account.

### Create a public creator case study

Build a dated account timeline, describe engagement on selected example videos, and summarize the audience feedback returned for those posts.

## Overview

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

## TikTok video metrics in other agents

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

## More Cursor guides

- [TikTok video metadata](https://spiral.ai/integrations/cursor/tiktok-video-metadata)
- [TikTok video search](https://spiral.ai/integrations/cursor/tiktok-video-search)
- [TikTok video download and details](https://spiral.ai/integrations/cursor/tiktok-video-download-and-details)
- [TikTok video share link](https://spiral.ai/integrations/cursor/tiktok-video-share-link)
- [TikTok video details with region from a share link](https://spiral.ai/integrations/cursor/tiktok-video-details-with-region-from-a-share-link)
- [TikTok video transcript](https://spiral.ai/integrations/cursor/tiktok-video-transcript)

## Questions about TikTok video metrics in Cursor

**Can Cursor use TikTok video metrics?**

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

**How much does TikTok video metrics 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 video metrics in Cursor?**

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

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

**Does Cursor wait while TikTok video metrics runs?**

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

**Can this retrieve private TikTok content?**

TikHub says it excludes private, restricted, and password-protected content. Its stated coverage boundary is publicly accessible source data.

**Do repeated requests return the same saved data?**

TikHub says endpoint requests retrieve fresh data, including when the request is repeated. That is its stated retrieval behavior, rather than a documented TikTok update interval.

**Are TikTok results guaranteed to be complete and current?**

No. TikHub's terms explicitly decline guarantees of accuracy, completeness, and currency, which qualifies the FAQ's fresh-data description.

**Does reopening a cached response refresh its contents?**

The cache preserves the exact response for 24 hours. Reopening it provides that saved result rather than an updated TikTok snapshot.

**Does public TikTok data come with unrestricted reuse rights?**

TikHub places downstream compliance on the customer, including TikTok's terms and applicable privacy and intellectual property laws. Public availability alone does not establish unrestricted reuse rights.

