US products, prices & shopsCollect public US TikTok Shop listings and compare competitor prices and offers. Save each run with a date so you can follow product changes over time.
Try these examples for marketing, growth and competitor research.
For a consumer brand, check a set of competing shops daily. Compare current and original prices, badges and discounts. When an offer changes, review the listing before reacting.
Keep a dated price sheet that flags changes for each product.
Review a US category and its subcategories. Compare the product mix, sellers, ratings and cumulative sold counts to choose the niches that deserve a closer look.
Keep a category comparison with source products and a note on the sample coverage.
Review the TikTok video shown with a product alongside its description, price and variants. Use those examples to plan tests of a demonstration, bundle or product positioning.
Keep a product and creative brief with specific ideas to test.
FROM FIRST RUN TO REPEATABLE WORKFLOW
{
"searchQueries": ["phone case"],
"maxProducts": 20,
"scrapeProductDetails": false,
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": ["RESIDENTIAL"],
"apifyProxyCountry": "US"
}
}Paste this into the Actor’s JSON input editor. Replace the example targets with yours before running.
Check the current input form on ApifyThis scraper covers US TikTok Shop. Search phrases are useful for discovery; store, category and product URLs give you a more specific starting point. Listing-only runs are faster than collecting each product’s details.
| Search method | When to use it | What changes |
|---|---|---|
| Product searches | When to use itYou want to find relevant results before choosing specific targets. | What changesTikTok Shop product keywords, one per list item. Each search paginates until no more products are returned or a configured limit is reached. Queries are discovery searches, not exact product identifiers. |
| Store or product URLs | When to use itYou already configured the search on the source website. | What changesUS product, store, category or keyword-page URLs; supported share links and bare product IDs also work. A store collects its products, a product link collects one item, and non-US shop links are skipped. |
| Category coverage | When to use itYou want broader coverage and can allow a larger run. | What changesFor category URLs, follows their nested subcategories recursively. Turn off for a shallow category sample. It does not change keyword searches or turn a product URL into a catalog crawl. |
Adds descriptions, variants with price and stock, images, specifications, shipping, review samples and seller details with one extra request per product. Direct product links always receive details, even when false.
Compare the related scraperUse the exact field names below in JSON. In Apify’s form, enter list items separately, choose filters, and keep numbers and booleans in their proper types.
Default and prefill are different. A default applies when you omit a setting; a prefill is an example already entered in Apify’s form. Review prefilled targets and limits before every run. Some settings have no schema default. You still need to supply at least one supported target.
searchQueriesTikTok Shop product keywords, one per list item. Each search paginates until no more products are returned or a configured limit is reached. Queries are discovery searches, not exact product identifiers.
startUrlsUS product, store, category or keyword-page URLs; supported share links and bare product IDs also work. A store collects its products, a product link collects one item, and non-US shop links are skipped.
maxProductsGlobal cap on unique products across searches, stores and links. The same product found twice is written once. Empty removes the cap; start with 50 while checking the output.
maxProductsPerSearchCap each search, store or category separately. With three keywords and a cap of 20 each, up to 60 products can be found before global limits and deduplication.
scrapeProductDetailsAdds descriptions, variants with price and stock, images, specifications, shipping, review samples and seller details with one extra request per product. Direct product links always receive details, even when false.
includeSubcategoriesFor category URLs, follows their nested subcategories recursively. Turn off for a shallow category sample. It does not change keyword searches or turn a product URL into a catalog crawl.
maxConcurrency1-20 pages in parallel, each using its own proxy session. The default is 5. Raising it needs enough US residential exits and can increase traffic faster than coverage.
proxyConfigurationUS residential proxy is the working default. TikTok Shop’s US pages can show empty shells or security checks to other regions or datacenter exits. A non-US Apify proxy country is switched to US.
resumeSaves progress about every 30 seconds so an Apify restart or migration can continue the current run. Leave it on for normal use.
continueFromLastRunContinues unfinished work from the previous run with matching input. Earlier results remain in that run’s dataset. Keep false for a fresh collection or a recurring snapshot.
This reference follows the Actor’s published input fields. Check the live form before changing a production workflow. Check the current input form on Apify.
Each example is a separate run. Start small, inspect the results, then increase coverage. Update the targets, countries and dates to match your question.
Sample three related searches, with at most 20 products from each and 60 overall. Keep listing-only collection for a quick market map. Search overlap means the final unique count may be lower.
{
"searchQueries": ["phone case", "phone stand", "screen protector"],
"maxProducts": 60,
"maxProductsPerSearch": 20,
"scrapeProductDetails": false,
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": ["RESIDENTIAL"],
"apifyProxyCountry": "US"
}
}Enable product details for a 20-product sample. Compare variants and available price fields in Sheets, and retain the collection date. Listed prices, discounts and stock can change between runs.
{
"searchQueries": ["phone case"],
"maxProducts": 20,
"scrapeProductDetails": true,
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": ["RESIDENTIAL"],
"apifyProxyCountry": "US"
}
}Collect up to ten products from each of three skincare searches, with details and a lower concurrency of three. This keeps the initial review manageable before you commit to a larger catalog run.
{
"searchQueries": ["vitamin c serum", "retinol serum", "hyaluronic acid serum"],
"maxProducts": 30,
"maxProductsPerSearch": 10,
"scrapeProductDetails": true,
"maxConcurrency": 3,
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": ["RESIDENTIAL"],
"apifyProxyCountry": "US"
}
}Keep product IDs, seller names, source links and collection dates. Detail mode can add variants, descriptions, stock and review samples; it is not an unlimited review export. Sold counts and listed prices are marketplace signals, not a transaction ledger. Use repeated snapshots for price comparisons, retaining changes instead of overwriting them.
resume protects the current run if Apify restarts it. continueFromLastRun continues an earlier run with the same configuration; earlier records stay in the earlier dataset. Combine both datasets for the complete collection, and raise a previously reached result cap when continuing. Start fresh when you want to see what changed today.
Save one configuration above as input.json. Set APIFY_TOKEN to your Apify API token in your terminal, then send the file as the request body.
curl --fail-with-body --request POST \
--url "https://api.apify.com/v2/actors/jmlp~tiktok-shop-scraper/runs" \
--header "Authorization: Bearer $APIFY_TOKEN" \
--header "Content-Type: application/json" \
--data-binary @input.jsonThe response contains a run ID and defaultDatasetId, not finished results. Wait for the run to succeed, set DATASET_ID to that dataset ID, then fetch its items. For large datasets, use limit and offset to page through the export.
curl --fail-with-body \
--url "https://api.apify.com/v2/datasets/$DATASET_ID/items?format=json" \
--header "Authorization: Bearer $APIFY_TOKEN"Change one setting at a time, keep a small cap, and check the run summary before scaling up.
US residential proxy is the working default. TikTok Shop’s US pages can show empty shells or security checks to other regions or datacenter exits. A non-US Apify proxy country is switched to US.
Adds descriptions, variants with price and stock, images, specifications, shipping, review samples and seller details with one extra request per product. Direct product links always receive details, even when false.
Cap each search, store or category separately. With three keywords and a cap of 20 each, up to 60 products can be found before global limits and deduplication.
Success means the Actor finished handling the request, not that the source returned data. Check SUMMARY.inputProblem, SUMMARY.problem and the log for missing targets, unsupported filters or refused requests. Test one known target with fewer filters.
Check the global limit, per-search or per-page limits, platform coverage and deduplication. Several searches can find the same record. A source’s headline count can include records the public endpoint does not return. Review unfinished jobs before treating the dataset as complete.
Append product_id, shop_name, price, discount, sold_count and scraped_at. Compare with a reviewed baseline to flag price changes. Treat changes in the cumulative sold count separately from verified sales.
Read the setupAsk Claude to compare positioning, offers and review themes, citing product URLs. Keep featured reviews separate from any claim about the full review sample.
Read the setupShow price ranges and promotions with shop and category filters. Use repeated snapshots, label cumulative sold counts, and state what your sample covers.
Read the setupPartition product snapshots by collection date. Store variants and reviews separately. Match SKUs before calculating price changes, and label sold-count differences as observed net changes.
Read the setup
Check jmlp/tiktok-shop-scraper and collect at most 50 US phone case products with details. Compare price ranges, discounts, shop identities and featured review themes, cite product URLs, and flag variation by SKU. Do not treat cumulative sold_count as daily sales or revenue.Keep the collection time and original IDs with your records. You’ll need them to check where a result came from or compare it with a later run.
This scraper covers US TikTok Shop. Search and category results are limited samples of the market. sold_count is TikTok's cumulative figure, so changes can reflect returns or source updates and aren't daily revenue. The headline price is the cheapest variant; check matching variants before comparing prices.
No. This Actor currently targets the US TikTok Shop. Other-country shop links are outside its supported coverage.
It is a cumulative platform count. Repeated snapshots can show observed net changes, but returns, source adjustments and coverage mean you should not treat those differences as verified daily sales or revenue.
Source and current product details: JMLP’s TikTok Shop Actor on Apify.
Facebook & Instagram01See what your competitors are advertising.
Save competitor ads in one place. Compare their copy, offers and timing before planning your next campaign.
Search, YouTube & Display02See a brand's ads across Google.
Collect advertiser creatives from Search, YouTube and Display. Compare formats and markets to plan where your own campaign might fit.
Tell me what you need to collect or understand. I can help with a custom scraper, a pipeline or the analysis.
Start a project