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

opencode · E-commerce

How to Use TikTok Shop Shop Search in opencode

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 opencode

Copy an example into opencode, 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.

TikTok Shop Shop Searchopencode
Try asking
  • 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 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.

    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.

    opencode mcp auth spiral
  3. Check it

    Spiral shows as connected.

    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.

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

ScrapeCreatorsE-commerce
TikTok Shop · Shop Search
scrapecreators/tiktok-shop-search

Settings you can ask for

Ask opencode for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Pagea number

Page number to retrieve

RegionUS, 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 opencode?

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.

Questions about TikTok Shop Shop Search in opencode

Can opencode use TikTok Shop Shop Search?

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

How much does TikTok Shop Shop Search cost in opencode?

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

Do I need a ScrapeCreators account to use TikTok Shop Shop Search in opencode?

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

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

Does opencode wait while TikTok Shop Shop Search runs?

TikTok Shop Shop Search runs in the background. opencode 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.

Get started

Start using TikTok Shop Shop Search in opencode

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

Paste this into opencode:

Set up opencode

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