[Integrations](https://spiral.ai/integrations) › [Muse Code](https://spiral.ai/integrations/muse-code) › [TikTok company ads](https://spiral.ai/integrations/muse-code/tiktok-company-ads)

# How to Use TikTok company ads in Muse Code

Fetch a company's sponsored TikTok videos with captions, posting dates, video links, and engagement counts. Use it to compare brand messaging or review sponsored creator content with a sample ad per creator.

|  |  |
| --- | --- |
| Model | TikTok company ads |
| Available through | Alexandria |
| Category | SEO |
| Price | Up to $0.0977704 per run. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with TikTok company ads in Muse Code

- Use TikTok company ads for gymshark.com and add a report to this project showing the returned sponsored videos.
- Use TikTok company ads for nike.com and create a CSV export of the returned records in this project.
- Use TikTok company ads for duolingo.com, include sponsored creator samples, and build separate brand and creator sections.
- Use TikTok company ads for sephora.com and add a view that groups returned captions by product name.
- Use TikTok company ads for gymshark.com and compare the returned videos with our project's previous saved report.

## How to set up TikTok company ads 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 company ads**: 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": "alexandria",
    "model": "adyntel/tiktok-ads/company",
    "input": {
      "company_domain": "<company_domain>"
    }
  }'
```

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

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

## TikTok company ads tools and prices

- [Adyntel · TikTok ads for a company](https://spiral.ai/tools/alexandria/adyntel/tiktok-ads/company) (Alexandria): Up to $0.0977704 per run.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| influencer_ads |  | — | When true, also return influencers posting sponsored content, each with a sample ad. Costs one extra credit when any ads come back. |

## What can you do with TikTok company ads in Muse Code?

Build a competitor ad report in your project from TikTok sponsored videos and creator samples. Turn returned records into a sortable review table and compare observations across saved runs.

### Prepare a competitor messaging brief

Group returned sponsored captions by product, offer, and recurring phrase. Give the creative team links to the examples behind each observation.

### Build a sponsored video review queue

Sort returned videos by plays and shares to choose examples for manual creative review.

### Review public creator sponsorships

Collect the sample sponsored ad returned for each creator and compare its message with the brand's own ads.

### Follow product launch messaging

Find product names and launch dates in sponsored captions. Arrange matching videos by posting date to build a campaign brief.

### Measure changes in observed engagement

Compare counts for the same returned video across scheduled checks. Flag increases in plays, shares, or saves for review.

### Prepare an agency account review

Use a public business's returned sponsored videos and creator samples to prepare specific questions about its TikTok creative strategy.

## Overview

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

## TikTok company ads in other agents

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

## More Muse Code guides

- [Similarweb website traffic by country](https://spiral.ai/integrations/muse-code/similarweb-website-traffic-by-country)
- [Upspring Meta ad details](https://spiral.ai/integrations/muse-code/upspring-meta-ad-details)
- [Similarweb website traffic and engagement](https://spiral.ai/integrations/muse-code/similarweb-website-traffic-and-engagement)
- [Upspring Meta ad listings](https://spiral.ai/integrations/muse-code/upspring-meta-ad-listings)
- [Similarweb website channel visits](https://spiral.ai/integrations/muse-code/similarweb-website-channel-visits)
- [Upspring Meta ad search](https://spiral.ai/integrations/muse-code/upspring-meta-ad-search)

## Questions about TikTok company ads in Muse Code

**Can Muse Code use TikTok company ads?**

Yes. Add Spiral to Muse Code as an MCP server, and Muse Code can find and run TikTok company ads like any built-in tool.

**How much does TikTok company ads cost in Muse Code?**

Up to $0.0977704 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 an Alexandria account to use TikTok company ads in Muse Code?**

No. Spiral runs TikTok company ads on its own Alexandria account. You sign in to Spiral once and never paste a key.

**How long does it take to set up TikTok company ads 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 company ads runs?**

TikTok company ads runs in the background. Muse Code starts the run, checks on it and gives you the json when it's ready.

**What does the company lookup cover?**

It retrieves TikTok ads associated with a company. Sponsored creator results add one sample ad per creator, so those samples are not a complete creator posting history.

**Which engagement measurements come back?**

Adyntel lists six counts: plays, likes, comments, shares, saves, and downloads. Ad records also include a caption, posting date, region, and video link.

**Does one response contain the company's entire ad inventory?**

Adyntel paginates company ad results and uses continuation tokens for additional pages. A response with a continuation token should not be described as the full inventory.

**Does Adyntel guarantee complete coverage?**

No. Its terms explicitly disclaim guarantees of data accuracy, completeness, and reliability, so missing results cannot establish that a company has no TikTok advertising.

**What data do Adyntel's terms permit extracting?**

The acceptable-use clause limits extraction to publicly accessible advertising libraries, subject to Adyntel's terms. That permission does not establish access to private advertising records.

