[Integrations](https://spiral.ai/integrations) › [Codex](https://spiral.ai/integrations/codex) › [TikTok creator search](https://spiral.ai/integrations/codex/tiktok-creator-search)

# How to Use TikTok creator search in Codex

Finds TikTok creators and returns profiles with follower counts, engagement rates, and analytics. Use it to build a candidate list from a campaign brief before researching individual creators.

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

## Prompts to try with TikTok creator search in Codex

- Use TikTok creator search to find US cooking creators with 100,000 to 1 million followers. Add the returned candidates and the search interpretation to our internal campaign report.
- Use TikTok creator search to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from TikTok creator search and tell me what changed since last week.
- Check TikTok creator search and summarize what you find in three bullet points.
- Pull the newest data from TikTok creator search and give me the result as a table.

## How to set up TikTok creator search in Codex

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

### Use Spiral's MCP server

1. **Add the hosted server**

```bash
codex mcp add spiral --url https://api.spiral.ai/mcp
```

2. **Sign in**: Codex opens the browser: sign in to Spiral and click Authorize. No API key. `codex mcp list` then shows Spiral.

```bash
codex mcp login spiral
```

### Use the Spiral skill

1. **Send Codex 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 creator 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": "alexandria",
    "model": "influencers-club/tiktok/creators-search",
    "input": {
      "paging": {},
      "filters": {}
    }
  }'
```

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

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

## TikTok creator search tools and prices

- [Influencers.club · Search TikTok creators](https://spiral.ai/tools/alexandria/influencers-club/tiktok/creators-search) (Alexandria): Up to $3.2595953 per run.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| sort |  | — | Platform-specific sort object from the upstream request contract. |
| nlp_search |  | — | nlp search |
| return_filter_values |  | — | return filter values |

## What can you do with TikTok creator search in Codex?

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.

### Plan a partnership across platforms

Find suitable TikTok creators, review their profiles, and compare the verified connected accounts returned for each candidate when deciding which platforms to include.

### Maintain an internal creator directory

Add candidates found through creator search, fill in their TikTok profile information, and attach verified connected account links for the partnership team's reference.

### Research creative examples

Find creators in a relevant category, review recent captions and engagement, and examine individual videos for an internal content brief.

### Check repeated candidates across lists

Compare creator search results with verified connected account matches to identify candidates who appear in several platform-specific partnership lists.

## Overview

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

## TikTok creator search in other agents

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

## More Codex guides

- [TikTok creator reposts](https://spiral.ai/integrations/codex/tiktok-creator-reposts)
- [TikTok creator search insights](https://spiral.ai/integrations/codex/tiktok-creator-search-insights)
- [TikTok creator profile](https://spiral.ai/integrations/codex/tiktok-creator-profile)
- [TikTok creator videos](https://spiral.ai/integrations/codex/tiktok-creator-videos)
- [TikTok creator posts](https://spiral.ai/integrations/codex/tiktok-creator-posts)
- [TikTok daily trending searches](https://spiral.ai/integrations/codex/tiktok-daily-trending-searches)

## Questions about TikTok creator search in Codex

**Can Codex use TikTok creator search?**

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

**How much does TikTok creator search cost in Codex?**

Up to $3.2595953 per run. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Codex plan is separate.

**Do I need an Alexandria account to use TikTok creator search in Codex?**

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

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

**Does Codex wait while TikTok creator search runs?**

TikTok creator search runs in the background. Codex 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.

