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

# How to Use TikTok video details in Perplexity

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 Perplexity

- Use TikTok video details for https://www.tiktok.com/@zachking/video/6768504823336815877 and summarize the returned metadata and engagement counts in a small table.
- Use TikTok video details to look this up and give me the result as a table.
- 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 Perplexity

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

### Use the Perplexity connector

1. **Add a remote connector**: In Perplexity, open Plugins in the sidebar (or Customize › Connectors if you don't see Plugins yet). Choose Add custom › Add MCP connector, then Remote. Name it Spiral and paste this MCP server URL:

```text
https://api.spiral.ai/mcp
```

2. **Sign in to Spiral and approve**: Select the Spiral card on the Plugins page to start sign-in. Spiral opens: sign in, pick the organization and click Authorize. No API key.

### Use the Spiral skill

1. **Send Perplexity 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: Perplexity finds TikTok video details on Spiral, shows the price and runs it.

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

## 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 Perplexity?

Prepare an internal TikTok partnership brief from public creator and content data. Summarize the returned account information or engagement metrics into a comparison the team can use when choosing creators and creative examples.

### 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 Perplexity guides](https://spiral.ai/integrations/perplexity)

## 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)
- [Cursor](https://spiral.ai/integrations/cursor/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)
- [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 Perplexity guides

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

## Questions about TikTok video details in Perplexity

**Can Perplexity use TikTok video details?**

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

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

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

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

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

About two minutes: add a remote connector, then sign in to Spiral and approve.

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

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

