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

Codex · Social Media

How to Use TikTok Ad Library Ad Library Ad in Codex

Fetch details for one ad from TikTok Creative Center Top Ads or the public Ads Library. Use it to inspect a known ad, with video files, performance graphs, summaries, and recommendations available for Top Ads.

Prompts to try with TikTok Ad Library Ad Library Ad in Codex

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

Use TikTok ad details for ad 7646829987799334920 and add its available summary to our project's creative review page.

TikTok Ad Library Ad Library AdCodex
Try asking
  • Use TikTok ad details for ad 7646829987799334920 and build a timeline from any returned performance graph data, labeling values as relative performance.

  • Use TikTok ad details for ad 7644102379697602567 and add any recommended ads to our project's review queue with their returned IDs.

  • Use TikTok ad details for ads 7646829987799334920 and 7644102379697602567, then add a side-by-side view of their available summaries and graph data.

  • Use TikTok ad details for ad 7637828811991810069 and create a report in our project showing which video files, summaries, graphs, and recommendations were returned.

How to set up TikTok Ad Library Ad Library Ad 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 Ad Library Ad Library Ad

    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-ad-library-ad",
        "input": {
          "ad_id": "1869335220395266"
        }
      }'

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

TikTok Ad Library Ad Library Ad providers and prices

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

ScrapeCreatorsSocial Media
TikTok Ad Library · Ad Library Ad
scrapecreators/tiktok-ad-library-ad

What can you do with TikTok Ad Library Ad Library Ad in Codex?

Build an ad review view that pairs a known TikTok ad with its available summary and performance graphs. A coding agent can turn returned Top Ads graph data into a timeline and add recommendations to a review queue.

Build a creative review brief

Turn a known Top Ad's available summary, video details, and performance graphs into a short brief for a creative review meeting.

Choose moments for an editor to review

Extract the seconds with the strongest relative performance from a Top Ad's available graph data. Give the editor a focused list of moments to inspect.

Compare selected competitor ads

Retrieve details for a shortlist of public business ads and compare their available summaries and performance graphs. Keep conclusions limited to the ads reviewed.

Expand a creative research shortlist

Use recommended ads returned with a Top Ad to identify additional examples worth reviewing. Retrieve their details before adding them to a creative brief.

Refresh an ad review queue

Revisit saved public ad IDs on a schedule and flag changes in available details, summaries, or graph data for the marketing team.

Prepare original creative test ideas

Use a Top Ad's available summary and engagement peaks to propose questions for an original creative test. Tie each proposal to the returned evidence.

Questions about TikTok Ad Library Ad Library Ad in Codex

Can Codex use TikTok Ad Library Ad Library Ad?

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

How much does TikTok Ad Library Ad Library Ad 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 Ad Library Ad Library Ad in Codex?

No. Spiral runs TikTok Ad Library Ad Library Ad 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 Ad Library Ad Library Ad in Codex?

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

Does Codex wait while TikTok Ad Library Ad Library Ad runs?

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

Does Top Ads include every TikTok advertisement?

No. Ads must meet performance thresholds and have advertiser authorization to appear in Top Ads. Use it for selected creative examples, not a count of everything a business is running.

Which regions does TikTok's transparency library cover?

The Commercial Content Library covers ads available to users in the European Economic Area, Switzerland, and the United Kingdom. That boundary applies to the transparency library, not to Creative Center Top Ads.

How quickly do transparency ads appear or change?

TikTok says an ad may take up to 24 hours to appear after its first view or after an ad or campaign change. This is the Commercial Content Library's timeline, not a refresh guarantee for Top Ads.

How far back does the transparency Ad Library go?

Qualifying ads remain in the library for one year after their last view. That retention period runs from the last view, rather than the campaign's launch date.

Are Top Ads graph values actual click or conversion totals?

TikTok's displayed performance graphs use a relative 0–100 index, with 100 marking the video's peak for the selected metric. An indexed value of 100 is not evidence of 100 clicks or conversions.

Get started

Start using TikTok Ad Library Ad Library Ad 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