How to Use TikTok Shop Shop Search in Muse Code
TikTok Shop product search returns matching listings with titles, product links, seller information, sold counts, ratings, and review counts. Use it to find products across shops and compare the returned listings for a category or brand.
Prompts to try with TikTok Shop Shop Search in Muse Code
Copy an example into Muse Code, or ask in your own words.
Use TikTok Shop product search for 'Crocs Classic Clogs' in the US and add a comparison table to this project with product titles, sellers, sold counts, ratings, review counts, and product links.
Use TikTok Shop product search for 'makeup brush' in the US and create a CSV in this repository containing the returned product IDs, titles, sellers, ratings, and review counts.
Use TikTok Shop product search for 'insulated tumbler' in the US and compare the returned product IDs and sold counts with our project's previous saved results.
Use TikTok Shop product search for 'running shoes' and 'walking shoes' in the US, then add a report to this project showing shared product IDs and titles unique to each search.
Use TikTok Shop product search for 'resistance bands' in the US and populate this project's seller comparison view with the returned titles, ratings, review counts, and product links.
How to set up TikTok Shop Shop Search in Muse Code
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Install Muse Code
curl -fsSL https://dev.meta.ai/install.sh | bash
- Ask Muse to add the server
Start muse and ask:
Add the Spiral MCP server at https://api.spiral.ai/mcp
- Sign in
In your terminal, run:
muse mcp login spiral
Use the Spiral skill
- Send Muse Code this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use the Spiral CLI
- 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
- Create an API key
In the console, under API keys.
- Run TikTok Shop Shop Search
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-search", "input": { "query": "shoes" } }'
Then paste one of the prompts above: Muse Code finds TikTok Shop Shop Search on Spiral, shows the price and runs it.
TikTok Shop Shop Search providers and prices
Spiral runs TikTok Shop Shop Search through ScrapeCreators. Open a card for today's price, with every fee included.
Settings you can ask for
Ask Muse Code for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Page | a number | Page number to retrieve | |
| Region | US, GB, DE, FR, IT, ID, MY, MX and 8 more | Region to search shop products in. Non-US TikTok Shop regions are not reliable right now and may return limited or inconsistent results. Sorry for the inconvenience. |
Every API field of TikTok Shop · Shop Search is on its tool page: open its card above.
What can you do with TikTok Shop Shop Search in Muse Code?
Build a category comparison table in your project from TikTok Shop product titles, sellers, ratings, and sold counts. Use product IDs to match listings across searches and link each row to its product page.
Compare products within a category
Search for makeup brushes and compare the returned listings by seller, sold count, rating, and review count. Include product links so a merchandiser can inspect the shortlist.
Review listings mentioning a brand
Search for Crocs Classic Clogs and group matching product titles by seller. Give a brand team a linked list of listings to review without assuming that a brand mention proves seller authorization.
Prepare an affiliate research shortlist
Find products matching a creator's public content niche, such as kitchen storage. Compare sold counts and review counts to select listings for further editorial review.
Monitor changes in returned listings
Repeat searches for insulated tumblers and compare matching product IDs across saved runs. Report newly observed listings and changes in reported sold counts or review counts.
Compare product wording
Search separately for running shoes, walking shoes, and gym shoes. Compare returned titles and overlapping product IDs to choose more precise terms for subsequent research.
Build a seller comparison brief
Search for resistance bands and group the returned products by seller. Summarize each seller's matching listings, ratings, review counts, and product links within the retrieved results.
More on TikTok Shop Shop Search and Muse Code
TikTok Shop Shop Search in other agents
Questions about TikTok Shop Shop Search in Muse Code
Can Muse Code use TikTok Shop Shop Search?
Yes. Add Spiral to Muse Code as an MCP server, and Muse Code can find and run TikTok Shop Shop Search like any built-in tool.
How much does TikTok Shop Shop Search 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 Shop Search in Muse Code?
No. Spiral runs TikTok Shop Shop Search 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 Shop Search 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 Shop Search runs?
TikTok Shop Shop Search runs in the background. Muse Code starts the run, checks on it and gives you the json when it's ready.
What information comes back for a TikTok Shop product?
Search results include product titles, IDs, links, sold counts, and seller information. The documented response also includes product rating scores and review counts.
How reliable is coverage outside the US?
ScrapeCreators explicitly warns that non-US TikTok Shop searches are unreliable and may return limited or inconsistent results. A sparse result set outside the US should not be presented as a complete category inventory.
How fresh is the data?
ScrapeCreators describes its extraction as real-time access to the latest public platform data. That describes retrieval freshness; it does not establish how frequently TikTok updates a product's sold count or rating.
Does this provide private TikTok Shop data?
ScrapeCreators describes its extraction as public data only. Use this search for public product listings and seller information.
Can I retrieve additional search results?
Yes. TikTok Shop search supports numbered result pages, so an agent can request subsequent pages for the same search.
Start using TikTok Shop Shop Search 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 https://spiral.ai/SKILL.md


