[Integrations](https://spiral.ai/integrations) › [Factory Droid](https://spiral.ai/integrations/factory-droid) › [TikTok Live Info](https://spiral.ai/integrations/factory-droid/tiktok-live-info)

# How to Use TikTok Live Info in Factory Droid

Returns a TikTok LIVE room's title, status, likes, viewer count, cover image, and owner details. Use it to summarize a known broadcast or compare room snapshots during a public brand livestream.

|  |  |
| --- | --- |
| Model | TikTok Live Info |
| 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 Live Info in Factory Droid

- Use TikTok LIVE room details for @duolingo's current broadcast, if available, and add its title and counts to this project's dashboard.
- Use TikTok LIVE room details for @nike's current broadcast, if available, and save the returned room snapshot as JSON in this project.
- Use TikTok LIVE room details for @ryanair's current broadcast, if available, and render its cover image and title in the existing broadcast component.
- Use TikTok LIVE room details for @nasa's current broadcast, if available, and add the returned owner identity to this project's event view.
- Use TikTok LIVE room details for @duolingo's current broadcast, if available, and compare its counts with this project's last saved snapshot of that room.

## How to set up TikTok Live Info in Factory Droid

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

### Use Spiral's MCP server

1. **Add the server**: Droid saves it to your user config, `~/.factory/mcp.json`, so it works in every project.

```bash
droid mcp add spiral https://api.spiral.ai/mcp --type http
```

2. **Sign in**: Start `droid`, type `/mcp`, select spiral and authenticate it. Sign in to Spiral in the browser and click Authorize. No API key.

3. **Check it**: Spiral shows as connected. needs authentication means the sign-in did not finish: run `/mcp` again.

```bash
droid mcp list
```

### Use the Spiral skill

1. **Send Factory Droid 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 Live Info**: 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-live",
    "input": {
      "room_id": "7523685855395842871",
      "user_id": "6742945285876515845"
    }
  }'
```

Then paste one of the prompts above: Factory Droid finds TikTok Live Info on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/factory-droid

## TikTok Live Info tools and prices

- [TikTok · Live Info](https://spiral.ai/tools/scrapecreators/scrapecreators/tiktok-live) (ScrapeCreators): Up to $0.0013 per run.

## What can you do with TikTok Live Info in Factory Droid?

Build a broadcast panel showing a public brand's room title, owner, status, and reported counts. Add saved snapshots to compare observations during a campaign.

### Broadcast briefing

Summarize a public brand broadcast with its room title, owner, status, and reported counts.

### Campaign observation log

Save room snapshots during a sponsored livestream for a report on the observations collected.

### Audience threshold alerts

Flag a public business broadcast when its reported viewer count crosses a threshold you choose.

### Broadcast title review

Compare a brand's returned room title with the wording approved for its campaign.

### Concurrent broadcast comparison

Compare reported likes and viewers across selected public brand rooms observed during the same period.

### Broadcast identity check

Match the returned owner identity to the public brand account expected in a campaign brief.

## Overview

- [ScrapeCreators](https://spiral.ai/providers/scrapecreators)
- [All Factory Droid guides](https://spiral.ai/integrations/factory-droid)

## TikTok Live Info in other agents

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

## More Factory Droid guides

- [TikTok LIVE search](https://spiral.ai/integrations/factory-droid/tiktok-live-search)
- [TikTok Profile](https://spiral.ai/integrations/factory-droid/tiktok-profile)
- [TikTok LIVE room status in bulk](https://spiral.ai/integrations/factory-droid/tiktok-live-room-status-in-bulk)
- [TikTok Search Suggestions ScrapeCreators](https://spiral.ai/integrations/factory-droid/tiktok-search-suggestions-scrapecreators)
- [TikTok LIVE room status](https://spiral.ai/integrations/factory-droid/tiktok-live-room-status)
- [TikTok Search Users](https://spiral.ai/integrations/factory-droid/tiktok-search-users)

## Questions about TikTok Live Info in Factory Droid

**Can Factory Droid use TikTok Live Info?**

Yes. Add Spiral to Factory Droid as an MCP server, and Factory Droid can find and run TikTok Live Info like any built-in tool.

**How much does TikTok Live Info cost in Factory Droid?**

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

**Do I need a ScrapeCreators account to use TikTok Live Info in Factory Droid?**

No. Spiral runs TikTok Live Info 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 Live Info in Factory Droid?**

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

**Does Factory Droid wait while TikTok Live Info runs?**

TikTok Live Info runs in the background. Factory Droid starts the run, checks on it and gives you the json when it's ready.

**What information does a TikTok LIVE room lookup return?**

The documented response describes one room: its title, status, like count, viewer count, cover URL, and owner ID, username, and display name.

**How fresh are the room details?**

ScrapeCreators says it fetches the latest available LIVE room information when you request it. That describes a lookup at request time, rather than a promised refresh interval.

**Does this include private livestream information?**

The endpoint uses TikTok's public live-room source. TikTok can refuse room access with HTTP 403, so the lookup does not promise access to every broadcast.

**Can I reuse TikTok LIVE data commercially?**

ScrapeCreators permits commercial use and redistribution of its output, but requires users to comply with third-party terms. TikTok's US terms separately prohibit automated extraction without written approval.

