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

Gemini CLI · E-commerce

How to Use TikTok Shop store products in Gemini CLI

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 Gemini CLI

Copy an example into Gemini CLI, 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 productsGemini CLI
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 Gemini CLI

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

Use Spiral's MCP server

  1. Add the server

    Or add it to ~/.gemini/settings.json yourself:

    gemini mcp add --scope user --transport http spiral https://api.spiral.ai/mcp
  2. Sign in

    Start gemini and run:

    /mcp auth spiral
  3. Check it

    In Gemini CLI, run /mcp. From your shell:

    gemini mcp list

Use the Spiral skill

  1. Send Gemini CLI 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: Gemini CLI 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 Gemini CLI 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 Gemini CLI?

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 Gemini CLI

Can Gemini CLI use TikTok Shop store products?

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

How much does TikTok Shop store products cost in Gemini CLI?

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

Do I need a ScrapeCreators account to use TikTok Shop store products in Gemini CLI?

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 Gemini CLI?

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

Does Gemini CLI wait while TikTok Shop store products runs?

TikTok Shop store products runs in the background. Gemini CLI 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 Gemini CLI

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

Paste this into Gemini CLI:

Set up Gemini CLI

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