[Integrations](https://spiral.ai/integrations) › [Muse Code](https://spiral.ai/integrations/muse-code) › [TikTok Ad Library Ad Library Ad](https://spiral.ai/integrations/muse-code/tiktok-ad-library-ad-library-ad)

# How to Use TikTok Ad Library Ad Library Ad in Muse Code

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.

|  |  |
| --- | --- |
| Model | TikTok Ad Library Ad Library Ad |
| Available through | ScrapeCreators |
| Category | Social Media |
| Price | Up to $0.0013 per run. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with TikTok Ad Library Ad Library Ad in Muse Code

- Use TikTok ad details for ad 7646829987799334920 and add its available summary to our project's creative review page.
- 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 Muse Code

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

### Use Spiral's MCP server

1. **Install Muse Code**

```bash
curl -fsSL https://dev.meta.ai/install.sh | bash
```

2. **Ask Muse to add the server**: Start `muse` and ask:

```text
Add the Spiral MCP server at https://api.spiral.ai/mcp
```

3. **Sign in**: In your terminal, run:

```bash
muse mcp login spiral
```

### Use the Spiral skill

1. **Send Muse Code 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 Ad Library Ad Library Ad**: 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": "scrapecreators",
    "model": "scrapecreators/tiktok-ad-library-ad",
    "input": {
      "ad_id": "1869335220395266"
    }
  }'
```

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

Setup guide in the docs: https://spiral.ai/docs/quickstarts/muse-code

## TikTok Ad Library Ad Library Ad tools and prices

- [TikTok Ad Library · Ad Library Ad](https://spiral.ai/tools/scrapecreators/scrapecreators/tiktok-ad-library-ad) (ScrapeCreators): Up to $0.0013 per run.

## What can you do with TikTok Ad Library Ad Library Ad in Muse Code?

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.

## Overview

- [ScrapeCreators](https://spiral.ai/providers/scrapecreators)
- [All Muse Code guides](https://spiral.ai/integrations/muse-code)

## TikTok Ad Library Ad Library Ad in other agents

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

## More Muse Code guides

- [Threads user posts](https://spiral.ai/integrations/muse-code/threads-user-posts)
- [TikTok Ad Library search](https://spiral.ai/integrations/muse-code/tiktok-ad-library-search)
- [Threads top post search](https://spiral.ai/integrations/muse-code/threads-top-post-search)
- [TikTok App Check if live room is online](https://spiral.ai/integrations/muse-code/tiktok-app-check-if-live-room-is-online)
- [Threads recent post search](https://spiral.ai/integrations/muse-code/threads-recent-post-search)
- [TikTok App Get comment replies data of specified video](https://spiral.ai/integrations/muse-code/tiktok-app-get-comment-replies-data-of-specified-video)

## Questions about TikTok Ad Library Ad Library Ad in Muse Code

**Can Muse Code use TikTok Ad Library Ad Library Ad?**

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

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

**Do I need a ScrapeCreators account to use TikTok Ad Library Ad Library Ad in Muse Code?**

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 Muse Code?**

About two minutes: install Muse Code, then ask Muse to add the server, then sign in.

**Does Muse Code wait while TikTok Ad Library Ad Library Ad runs?**

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

