[Integrations](https://spiral.ai/integrations) › [Muse Code](https://spiral.ai/integrations/muse-code) › [TikTok Shop store products](https://spiral.ai/integrations/muse-code/tiktok-shop-store-products)

# How to Use TikTok Shop store products in Muse Code

Fetch a TikTok Shop store's product titles, images, links, listing prices, ratings, review counts, and sold counts. Use it to review one seller's catalog or compare repeated snapshots for assortment changes.

|  |  |
| --- | --- |
| Model | TikTok Shop store products |
| Available through | ScrapeCreators |
| Category | E-commerce |
| 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 Shop store products in Muse Code

- Use TikTok Shop store products for https://www.tiktok.com/shop/store/goli-nutrition/7495794203056835079 in the US and create a CSV of product IDs, titles, links, ratings, review counts, and sold counts in this project.
- Use TikTok Shop store products to fetch Goli Nutrition's US catalog and populate this project's product table with real titles, images, and product links.
- Use TikTok Shop store products for Goli Nutrition's US store and compare the retrieved product IDs and titles with the catalog snapshot in this repository.
- Use TikTok Shop store products for Goli Nutrition's US store and generate a report ranking retrieved listings by sold count, with rating and review count columns.
- Use TikTok Shop store products for Goli Nutrition's US store and add a catalog summary to this project's report, grouping listings by product type inferred from their titles.

## How to set up TikTok Shop store products 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 Shop store products**: 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-shop-products",
    "input": {
      "url": "https://www.tiktok.com/shop/store/goli-nutrition/7495794203056835079"
    }
  }'
```

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

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

## TikTok Shop store products tools and prices

- [TikTok Shop · Shop Products](https://spiral.ai/tools/scrapecreators/scrapecreators/tiktok-shop-products) (ScrapeCreators): Up to $0.0013 per run.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| cursor |  | — | Cursor parameter from the previous response to retrieve the next page of products. Omit for the first page. |
| region | US, GB, DE, FR, IT, ID, MY, MX, PH, SG, ES, TH, VN, BR, JP, IE | — | Region to get shop products from. Defaults to US if not provided. Non-US regions are not reliable right now and may return `not_found` or limited catalog data even when the shop appears in search. Sorry for the inconvenience. |
| sort_by | top, new_releases | — | Sort products by best-selling items (`top`) or newest products (`new_releases`). Defaults to `top`. |

## What can you do with TikTok Shop store products in Muse Code?

Build a catalog comparison report that identifies changed TikTok Shop listings by product ID. A coding agent can connect retrieved titles, images, ratings, and counts to the project's reporting components.

### Catalog change reports

Compare successive store catalog snapshots by product ID to flag newly observed listings and changed titles.

### Competitor assortment reviews

Organize a public seller's product titles into categories and identify which categories dominate its retrieved assortment.

### Product research shortlists

Rank a store's retrieved products by reported sold count, then show ratings and review counts beside each candidate.

### Merchandising audits

Review listing titles and images for inconsistent naming or presentation across a brand's TikTok Shop catalog.

### Review growth monitoring

Compare product review counts across scheduled snapshots and surface listings with the largest observed increases.

### Campaign product briefs

Prepare a product reference sheet with listing titles, images, links, ratings, and reported sales for a public brand's campaign planning.

## Overview

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

## TikTok Shop store products in other agents

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

## More Muse Code guides

- [TikTok Shop seller products](https://spiral.ai/integrations/muse-code/tiktok-shop-seller-products)
- [TikTok creator showcase products](https://spiral.ai/integrations/muse-code/tiktok-creator-showcase-products)
- [TikTok Shop products by category](https://spiral.ai/integrations/muse-code/tiktok-shop-products-by-category)
- [Trader Joe's product details](https://spiral.ai/integrations/muse-code/trader-joe-s-product-details)
- [TikTok Shop product search](https://spiral.ai/integrations/muse-code/tiktok-shop-product-search)
- [Trader Joe's product search](https://spiral.ai/integrations/muse-code/trader-joe-s-product-search)

## Questions about TikTok Shop store products in Muse Code

**Can Muse Code use TikTok Shop store products?**

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

**How much does TikTok Shop store products 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 Shop store products in Muse Code?**

No. Spiral runs TikTok Shop store products 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 Shop store products 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 Shop store products runs?**

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

**What product information does TikTok Shop expose through this endpoint?**

The documented response includes titles, images, product links, listing price information, ratings, review counts, and sold counts. These are store catalog records.

**Does one response contain the whole store catalog?**

Catalog retrieval uses cursor pagination. Follow the continuation returned by each response before treating the results as the retrieved catalog.

**How reliable is coverage outside the US?**

ScrapeCreators warns that non-US catalogs are unreliable. A store may return not_found or only part of its catalog even when TikTok Shop search shows the store.

**How fresh are the product records?**

ScrapeCreators describes Shop Products data as real-time. Its general freshness policy says cache misses fetch live source data, while cached responses may also be returned.

**Is this public storefront data?**

ScrapeCreators says its live retrieval collects publicly available source data. For TikTok Shop, the documented output consists of store product listings and their displayed commerce metrics.

