Spiral gives your agent every tool with one account. Browse the tools →

Muse Code · E-commerce

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.

Prompts to try with TikTok Shop store products in Muse Code

Copy an example into Muse Code, or ask in your own words.

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.

TikTok Shop store productsMuse Code
Try asking
  • 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
    curl -fsSL https://dev.meta.ai/install.sh | bash
  2. Ask Muse to add the server

    Start muse and ask:

    Add the Spiral MCP server at https://api.spiral.ai/mcp
  3. Sign in

    In your terminal, run:

    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.

    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.

    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.

TikTok Shop store products providers and prices

Spiral runs TikTok Shop store products through ScrapeCreators. Open a card for today's price, with every fee included.

ScrapeCreatorsE-commerce
TikTok Shop · Shop Products
scrapecreators/tiktok-shop-products

Settings you can ask for

Ask Muse Code for any of these in your prompt.

SettingAllowed valuesDefaultDescription
RegionUS, GB, DE, FR, IT, ID, MY, MX and 8 more

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 bytop or new_releases

Sort products by best-selling items (top) or newest products (new_releases). Defaults to top.

Every API field of TikTok Shop · Shop Products is on its tool page: open its card above.

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.

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.

Get started

Start using TikTok Shop store products in Muse Code

One Spiral account for every tool your agent needs. No subscription; you pay per run.

Paste this into Muse Code:

Set up Muse Code

set up https://spiral.ai/SKILL.md
Are you an AI agent? See setup options