joshu

Search TikTok Shop products by keyword

From Apify, through Joshu Data Bodega.

Part of TikTok Shop search products.

Price
$0.0088 per call$8.80 per 1,000 calls

No calls measured in the last 30 days.

Prices include the router's 10% markup and are paid from the usage wallet. Checked on November 11, 2026.

Inputs

  • memoryinteger: 2048, optional

    MB of run memory. treg's key requires 2048, which fixes the actor-start charge; your own key may set any size

  • regionstring, optional

    storefront to scrape — one of US|GB|VN|TH|PH|MY|SG|JP|MX|ID; decides the catalogue, listing language and price currency. Default US. Coverage is strongest on US and SEA storefronts

  • timeoutinteger: 90, optional

    run timeout in seconds. treg's key requires 90 so the run and its rows arrive before any wait gives up; a larger pull should use your own key and the async web.scrape.job.* pair above

  • maxItemsinteger, optional

    optional row cap; pay-per-event actors that take the row count from their own input ignore it, so maxTotalChargeUsd is the spend limit

  • proxyUrlsstring, optional

    leave empty to use the residential proxy included in the run price; or pass your own gateway URLs (http://user:pass@host:port)

  • max_resultsinteger, optional

    max products per search term, 1-500; default 100. You pay per product returned, so cap it or set maxTotalChargeUsd

  • search_termsstring, required

    keywords to search, one per entry; each returns every matching product up to max_results

  • maxTotalChargeUsdnumber, optional

    the spend cap Apify enforces on every event this run bills, in dollars. treg's key requires it, above 0 and at most 1, and holds it for the call

  • scrape_product_detailsboolean: false, optional

    true opens each product's detail page for the full field set — billed at the higher product-detail price, not the search price (see cost note). Default false

Call it

Router call with a router API key
curl https://hello.joshu.me/api/router/call \
  -H "Authorization: Bearer $JOSHU_ROUTER_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "endpoint": "apify.tiktok-shop.search.products",
    "params": {
      "memory": 2048,
      "region": "US",
      "timeout": 90,
      "maxItems": 1,
      "max_results": 1,
      "search_terms": [
        "phone case"
      ],
      "maxTotalChargeUsd": 0.08,
      "scrape_product_details": false
    }
  }'