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

Gemini CLI · Social Media

How to Use TikTok Ad Library Ad Library Ad in Gemini CLI

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 Gemini CLI

Copy an example into Gemini CLI, 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 AdGemini CLI
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 Gemini CLI

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

Use Spiral's MCP server

  1. Add the server

    Or add it to ~/.gemini/settings.json yourself:

    gemini mcp add --scope user --transport http spiral https://api.spiral.ai/mcp
  2. Sign in

    Start gemini and run:

    /mcp auth spiral
  3. Check it

    In Gemini CLI, run /mcp. From your shell:

    gemini mcp list

Use the Spiral skill

  1. Send Gemini CLI 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: Gemini CLI 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 Gemini CLI?

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 Gemini CLI

Can Gemini CLI use TikTok Ad Library Ad Library Ad?

Yes. Add Spiral to Gemini CLI as an MCP server, and Gemini CLI 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 Gemini CLI?

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

Do I need a ScrapeCreators account to use TikTok Ad Library Ad Library Ad in Gemini CLI?

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 Gemini CLI?

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

Does Gemini CLI wait while TikTok Ad Library Ad Library Ad runs?

TikTok Ad Library Ad Library Ad runs in the background. Gemini CLI 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 Gemini CLI

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

Paste this into Gemini CLI:

Set up Gemini CLI

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