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

# How to Use TikTok video details in Cursor

Returns metadata and engagement data for a specific TikTok video. Use it to examine one campaign post or creative example in detail.

|  |  |
| --- | --- |
| Model | TikTok video details |
| Available through | Alexandria |
| Category | Social Media |
| Price | Up to $0.034918 per run. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with TikTok video details in Cursor

- 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 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 details**: 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": "alexandria",
    "model": "influencers-club/tiktok/video-details",
    "input": {
      "url": "<url>",
      "content_type": "<content_type>"
    }
  }'
```

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

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

## TikTok video details tools and prices

- [Influencers.club · TikTok video details](https://spiral.ai/tools/alexandria/influencers-club/tiktok/video-details) (Alexandria): Up to $0.034918 per run.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| pagination_token |  | — | pagination token |

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

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.

## Overview

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

## TikTok video details in other agents

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

## More Cursor guides

- [TikTok video data by ID](https://spiral.ai/integrations/cursor/tiktok-video-data-by-id)
- [TikTok video details and media links](https://spiral.ai/integrations/cursor/tiktok-video-details-and-media-links)
- [TikTok video comments](https://spiral.ai/integrations/cursor/tiktok-video-comments)
- [TikTok video details by ID](https://spiral.ai/integrations/cursor/tiktok-video-details-by-id)
- [TikTok video ID from link](https://spiral.ai/integrations/cursor/tiktok-video-id-from-link)
- [TikTok video details by country](https://spiral.ai/integrations/cursor/tiktok-video-details-by-country)

## Questions about TikTok video details in Cursor

**Can Cursor use TikTok video details?**

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

**How much does TikTok video details cost in Cursor?**

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 Cursor plan is separate.

**Do I need an Alexandria account to use TikTok video details in Cursor?**

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 Cursor?**

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

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

TikTok video details runs in the background. Cursor 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.

