Spiral gives your agent every tool with one account. Browse the tools →

Codex · Social Media

How to Use TikTok creator videos in Codex

Fetch a TikTok creator's posts with captions, publication times, and engagement counts. Use it to discover posts and compare their performance across a creator's feed.

Prompts to try with TikTok creator videos in Codex

Copy an example into Codex, or ask in your own words.

Use TikTok creator videos for @duolingo and add a report to this project showing returned captions, publication times, views, and likes.

TikTok creator videosCodex
Try asking
  • Use TikTok creator videos for @nasa and write a CSV of the retrieved posts with their captions, views, comments, and shares.

  • Use TikTok creator videos for @netflix and add a caption keyword filter to the project's content report.

  • Use TikTok creator videos for @nba and build a chart of posting intervals from returned publication times.

  • Use TikTok creator videos for @redbull and add a table ranking retrieved posts by shares per view, excluding posts with zero views.

How to set up TikTok creator videos in Codex

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

Use Spiral's MCP server

  1. Add the hosted server
    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.

    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.

    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 videos

    One request; the result comes back by polling or a webhook.

    curl https://api.spiral.ai/v1/runs \
      -H "Authorization: Bearer $SPIRAL_API_KEY" \
      -H "Content-Type: application/json" \
      -H "Idempotency-Key: $(uuidgen)" \
      -d '{
        "provider": "scrapecreators",
        "model": "scrapecreators/tiktok-profile-videos",
        "input": {
          "handle": "stoolpresidente"
        }
      }'

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

TikTok creator videos providers and prices

Spiral runs TikTok creator videos through ScrapeCreators. Open a card for today's price, with every fee included.

ScrapeCreatorsSocial Media
TikTok · Profile Videos
scrapecreators/tiktok-profile-videos

Settings you can ask for

Ask Codex for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Trimon or off

Set to true for a trimmed down version of the response

Sort bylatest or popular

What to sort by

Include pinnedon or off

Whether to include pinned posts. Defaults to true. Set to false to exclude posts marked as pinned, including with trim=true. Keep this value unchanged while paginating. Filtering can produce shorter or empty pages; follow has_more and max_cursor. Successful pages still cost 1 credit, including empty results.

Every API field of TikTok · Profile Videos is on its tool page: open its card above.

What can you do with TikTok creator videos in Codex?

Build a TikTok content report in your project from returned captions, publication times, and engagement counts. Compare brand posts while making feed coverage limits visible in the report.

Compare brand post performance

Compare views, likes, comments, and shares across retrieved posts from competing brands to identify which posts deserve closer review.

Prepare a creator partnership brief

Review a public creator's post captions and performance before proposing a campaign. Ground the brief in specific returned posts.

Review campaign captions

Find campaign names and product mentions in a brand's returned captions, then compare engagement across matching posts.

Measure publishing cadence

Use returned publication times to calculate posting intervals and summarize activity within the retrieved sample.

Build an editorial research brief

Group a publisher's retrieved captions by topic and compare post performance to guide the next round of editorial research.

Track brand content performance over time

Compare repeated feed snapshots to measure changes in engagement for posts returned in both. Keep feed omissions separate from deletion claims.

Audit hashtag use

Extract hashtags from a brand's returned captions and compare engagement across posts using different tags.

Questions about TikTok creator videos in Codex

Can Codex use TikTok creator videos?

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

How much does TikTok creator videos cost in Codex?

Up to $0.0013 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 a ScrapeCreators account to use TikTok creator videos in Codex?

No. Spiral runs TikTok creator videos on its own ScrapeCreators account. You sign in to Spiral once and never paste a key.

How long does it take to set up TikTok creator videos in Codex?

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

Does Codex wait while TikTok creator videos runs?

TikTok creator videos runs in the background. Codex starts the run, checks on it and gives you the json when it's ready.

Which performance numbers can I compare?

Returned posts include counts for views, likes, comments, shares, and saves. These support comparisons between posts in the retrieved feed.

How fresh is the TikTok data?

ScrapeCreators describes the feed as real-time and says it fetches the latest available information when requested. It is an unofficial TikTok source.

Will pagination find every post?

No. The provider has verified feed omissions even after pagination finishes, and changing the feed country does not guarantee complete coverage. A missing post does not prove deletion.

Does an empty page mean there are no more posts?

Excluding pinned posts can leave a page empty while more results remain. Continue when the response indicates more pages are available.

Are captions the words spoken in the video?

Captions here are post descriptions, not speech transcripts. Original caption line breaks are preserved when TikTok supplies structured description data.

Get started

Start using TikTok creator videos in Codex

One Spiral account for every tool your agent needs. No subscription; you pay per run.

Paste this into Codex:

Set up Codex

set up https://spiral.ai/SKILL.md
Are you an AI agent? See setup options