[Integrations](https://spiral.ai/integrations) › [opencode](https://spiral.ai/integrations/opencode) › [TikTok company ads](https://spiral.ai/integrations/opencode/tiktok-company-ads)

# How to Use TikTok company ads in opencode

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 opencode

- 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 opencode

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

### Use Spiral's MCP server

1. **Add the server**: Leave out `--global` to add Spiral to the current project only. No header and no client ID or secret: opencode registers itself with Spiral.

```bash
opencode mcp add spiral --global --url https://api.spiral.ai/mcp
```

2. **Sign in**: Your browser opens. Sign in to Spiral, pick the organization and click Authorize, then return to the terminal. No API key. Inside opencode, `/mcps` starts the same sign-in.

```bash
opencode mcp auth spiral
```

3. **Check it**: Spiral shows as connected.

```bash
opencode mcp list
```

### Use the Spiral skill

1. **Send opencode 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: opencode finds TikTok company ads on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/opencode

## 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 opencode?

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 opencode guides](https://spiral.ai/integrations/opencode)

## 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)
- [Muse Code](https://spiral.ai/integrations/muse-code/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)
- [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 opencode guides

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

## Questions about TikTok company ads in opencode

**Can opencode use TikTok company ads?**

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

**How much does TikTok company ads cost in opencode?**

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

**Do I need an Alexandria account to use TikTok company ads in opencode?**

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 opencode?**

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

**Does opencode wait while TikTok company ads runs?**

TikTok company ads runs in the background. opencode 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.

