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

Devin · Social Media

How to Use TikTok Ad Library search in Devin

Search TikTok’s public Ad Library for advertiser names, ad links, available media, first and last shown dates, and estimated audience ranges. Use it to find campaign examples or compare a brand’s advertising activity over time.

Prompts to try with TikTok Ad Library search in Devin

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

Use TikTok Ad Library search to find Gymshark ads last shown in the UK during October 2026, then create a CSV in this project with ad IDs, advertiser names, dates, audience ranges, and public links.

TikTok Ad Library searchDevin
Try asking
  • Use TikTok Ad Library search to find IKEA ads delivered in Germany during October 2026 and build a campaign timeline in this project from the returned first and last shown dates.

  • Use TikTok Ad Library search for Nike ads delivered in France during October 2026 and add a review page to this project showing the returned ad links and available covers.

  • Use TikTok Ad Library search to find Adidas ads delivered in Germany during September and October 2026, then compare unique returned ad IDs by month in a project report.

  • Use TikTok Ad Library search to find Duolingo ads delivered in the UK during October 2026 and create a deduplicated JSON dataset in this project with delivery dates and audience ranges.

How to set up TikTok Ad Library search in Devin

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

Use Spiral's MCP server

  1. Add a custom MCP

    Open Customize › MCPs. Click + and choose New MCP. Fill in:

  2. Sign in to Spiral and approve

    In Customize › MCPs, open Spiral and choose Connect. Spiral opens: sign in, pick the organization and click Authorize. No API key.

  3. Check it

    On Spiral's configuration page, click Test tools. Devin lists Spiral's tools.

Use the Spiral skill

  1. Send Devin 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 search

    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-search",
        "input": {
          "query": "The Creator Loop"
        }
      }'

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

TikTok Ad Library search providers and prices

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

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

Settings you can ask for

Ask Devin for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Regionall, AT, BE, BG, BR, CH, CY, CZ and 27 moreall

Filter by the ad's targeting/delivery country, not the advertiser's registration country. Omitted region defaults to all supported countries, not every country worldwide. Values are case-insensitive; choose all or one of the listed country codes. US is not supported. Empty values, unsupported countries and multiple countries return 400 bad_request.

End timea whole number

Inclusive upper bound for the ad's last shown date; start_time is the inclusive lower bound. Supply start_time and end_time together as positive base-10 safe integers, no greater than 9007199254740991, in Unix seconds (preferred) or milliseconds. Values greater than 9999999999 are interpreted as milliseconds, divided by 1000 and rounded down to seconds. start_time must be less than or equal to end_time after normalization; equal bounds are accepted. If both are omitted, the last-shown date window defaults to the rolling 30 days ending at the time of each request. A missing companion, empty value, sign, fraction, scientific notation, whitespace, date string, unsafe integer or reversed interval returns 400 bad_request.

Start timea whole number

Inclusive lower bound for the ad's last shown date; end_time is the inclusive upper bound. Supply start_time and end_time together as positive base-10 safe integers, no greater than 9007199254740991, in Unix seconds (preferred) or milliseconds. Values greater than 9999999999 are interpreted as milliseconds, divided by 1000 and rounded down to seconds. start_time must be less than or equal to end_time after normalization; equal bounds are accepted. If both are omitted, the last-shown date window defaults to the rolling 30 days ending at the time of each request. A missing companion, empty value, sign, fraction, scientific notation, whitespace, date string, unsafe integer or reversed interval returns 400 bad_request.

Every API field of TikTok Ad Library · Ad Library Search is on its tool page: open its card above.

What can you do with TikTok Ad Library search in Devin?

Build a competitor ad timeline from TikTok ad IDs, delivery dates, and public links. A coding agent can turn the returned records into a deduplicated table or campaign review page in your project.

Competitor campaign timelines

Arrange a public brand’s returned ads by first and last shown dates to build a campaign timeline with links to the original records.

Creative review shortlists

Collect ad detail links and available video previews for a creative team’s review before planning a new campaign.

Weekly brand advertising reports

Compare successive searches for a brand and report newly observed ad IDs with their first shown dates.

Seasonal campaign research

Find a retailer’s ads around Black Friday or a summer promotion and compare the returned delivery dates.

Audience range comparisons

Compare the estimated audience bands attached to returned ads and prepare a review list without converting bands into exact counts.

Country-specific campaign reviews

Run separate searches for a brand’s ads delivered in Germany and France, then compare the returned ad IDs and dates.

Agency research handoffs

Prepare a deduplicated table of advertiser names, ad IDs, dates, audience ranges, and public links for an account team.

Questions about TikTok Ad Library search in Devin

Can Devin use TikTok Ad Library search?

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

How much does TikTok Ad Library search cost in Devin?

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

Do I need a ScrapeCreators account to use TikTok Ad Library search in Devin?

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

About two minutes: add a custom MCP, then sign in to Spiral and approve, then check it.

Does Devin wait while TikTok Ad Library search runs?

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

Does TikTok’s Ad Library cover advertising worldwide?

TikTok’s published coverage includes ads targeted to the EEA, Switzerland, and the UK. These results should not be treated as a worldwide inventory.

How quickly do new ads appear?

TikTok says ads generally enter the library within 24 hours of campaign initiation.

How far back does the advertising history go?

TikTok retains advertisement data while an ad runs and until one year after it was last shown.

Are the audience figures exact?

TikTok reports unique users seen as estimated ranges. Keep those ranges intact when comparing ads.

Will a search return every matching ad?

ScrapeCreators explicitly warns that results may be incomplete or duplicated. It recommends narrower date windows to reduce pagination.

Get started

Start using TikTok Ad Library search in Devin

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

Paste this into Devin:

Set up Devin

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