
TikTok Shop Scraper
scrape.ly/store/shelfbright/tiktok-shop-scraperE-commerceSocial media
1 monthly user

Scrape alibaba.com product search results, category and product pages: price tiers, MOQ, supplier name, country, years, verified and Trade Assurance badges, ratings, sold counts, images, specifications and certificates. No login needed.
Scrape alibaba.com product search results, category pages and product pages into clean rows: price tiers, minimum order quantity (MOQ), supplier name, country, years on Alibaba, Verified and Trade Assurance badges, ratings, sold counts, images, specifications and certificates. No login, no cookies: a run of 60 products finishes in about 10 seconds.
wireless earbuds), or paste alibaba.com search, category or product URLs.| Field | What it does |
|---|---|
queries | Search keywords, one per line. |
startUrls | alibaba.com search URLs (filters in the URL are kept), category URLs, product URLs or bare product IDs. |
maxItems | Products to save per query or URL (0 = no limit). |
startPage | Search page to start from. |
fullDetails | Also open each product page for gallery, video, specs, variants, certificates and supplier metrics. |
priceMin / priceMax | Price range in USD. |
moqMin / moqMax | Minimum order quantity range. |
tradeAssurance, verifiedSupplier, verifiedPro, alibabaGuaranteed, readyToShip | Badge filters. |
supplierCountry | Two-letter country code such as CN, US, VN, IN. |
{
"queries": ["wireless earbuds", "yoga mat"],
"startUrls": ["https://www.alibaba.com/trade/search?SearchText=led+strip&ta=y"],
"maxItems": 20,
"moqMax": 10,
"tradeAssurance": true,
"fullDetails": false
}
| Field | Description |
|---|---|
product_id, name, product_url | Product identity and link. |
price_min, price_max, currency | Price range. |
price_tiers | Quantity ladder: min/max quantity and price per tier. |
moq, moq_unit, price_at_moq | Minimum order quantity and its price. |
main_image, images, has_video, video_url | Media. |
company_name, company_id, supplier_url, supplier_country | Supplier. |
years_as_gold_supplier, is_gold_supplier, is_verified_supplier, is_verified_pro | Supplier badges. |
is_trade_assurance, is_alibaba_guaranteed, is_ready_to_ship | Order badges. |
review_score, review_count, orders_count, reply_rate | Ratings and sales (when shown). |
specifications, variants, certificates, lead_time_tiers, supplier_metrics | Filled with Full product details. |
search_query, page, position, is_ad | Where the product was found. |
Example (sample data, trimmed):
{
"search_query": "stainless steel water bottle",
"product_id": "1600000000001",
"name": "20oz Sport Water Bottle with Straw Double Wall Stainless Steel",
"price_min": 2.56,
"price_max": 2.87,
"currency": "USD",
"moq": 25,
"moq_unit": "pieces",
"price_at_moq": 2.87,
"price_tiers": [
{"min_quantity": 25, "max_quantity": 1249, "price": 2.87, "currency": "USD", "formatted_ladder": "25-1249 pieces", "formatted_price": "$2.87"},
{"min_quantity": 1250, "max_quantity": null, "price": 2.66, "currency": "USD", "formatted_ladder": ">=1250 pieces", "formatted_price": "$2.66"}
],
"product_url": "https://www.alibaba.com/product-detail/20oz-Sport-Water-Bottle_1600000000001.html",
"main_image": "https://sc04.alicdn.com/kf/example.jpg",
"company_name": "Example Drinkware Co., Ltd.",
"supplier_country": "CN",
"years_as_gold_supplier": 14,
"is_verified_supplier": true,
"is_trade_assurance": true,
"is_ready_to_ship": true,
"review_score": 4.6,
"review_count": 382,
"orders_count": 752,
"reply_rate": "92.8%",
"specifications": [{"name": "capacity", "value": "20OZ"}],
"lead_time_tiers": [{"quantity": "25-25 pieces", "lead_time": "15 days"}],
"supplier_metrics": {"on_time_shipment": "97.0%", "response_time": "≤5h", "business_type": "Manufacturer"},
"page": 1,
"position": 1,
"details_fetched": true
}
You pay $0.70 per 1,000 products saved ($0.0007 per product), plus the small platform usage of the run (compute and proxy traffic). Example: 1,000 products from search ≈ $0.70 in result fees plus about one cent of usage. Full product details load one extra page per product, so they add proxy traffic: roughly 0.09 GB per 1,000 products, about 9 cents at the datacenter proxy rate. Product URLs that cannot be read are listed in the run status and the OUTPUT record and are not saved or charged.
Is it legal to scrape Alibaba? The actor reads only public product and supplier information that anyone can see without logging in. Check the site's terms and your local laws for your use case, especially for personal data.
Do I need a login or my own proxy? No. The built-in datacenter proxy works; the run moves to residential by itself if datacenter addresses keep getting challenged.
How many results can I get? Alibaba shows up to 60 products per page and a few thousand per search. Use several keywords or filters to go wider. The run says in its status when a search had fewer products than you asked for.
Why is a field empty? Not every listing shows every field (for example ratings or sold counts). Specifications, variants, certificates and supplier metrics need Full product details.
Can I schedule it or use the API? Yes. Schedule runs for price monitoring, call it over the API, or connect it to webhooks and integrations.
Every field below can be set in the run form, passed through the API, or saved as a task. Unset fields fall back to the defaults shown.
queriesarrayOptionalSearch queries
Keywords to search on alibaba.com, one per line. Each query is searched separately and all products land in one dataset.
startUrlsarrayOptionalAlibaba URLs
Optional alibaba.com search URLs (filters in the URL are kept), category URLs, or product page URLs. Bare numeric product IDs work too.
maxItemsintegerOptionaldefault 20Max products per query or URL
How many products to save for each search query or search URL. Search pages hold 60 products. 0 means no limit. Alibaba pages one search only about 100 pages deep, so very broad keywords stop there; add filters or more keywords for more.
startPageintegerOptionaldefault 1Start page
Search results page to start from (1 = first page).
fullDetailsbooleanOptionaldefault falseFull product details
Also open every product page for the full image gallery, video, specifications, variants, certificates with validity, lead times, supplier contact and supplier metrics. Slower: one extra page per product.
priceMinnumberOptionalMin price (USD)
Only products priced at least this much.
priceMaxnumberOptionalMax price (USD)
Only products priced at most this much.
moqMinintegerOptionalMin order quantity from
Only products whose minimum order quantity is at least this.
moqMaxintegerOptionalMin order quantity up to
Only products whose minimum order quantity is at most this (for example 10 for low-MOQ sourcing).
tradeAssurancebooleanOptionaldefault falseTrade Assurance only
Only suppliers that offer Trade Assurance order protection.
verifiedSupplierbooleanOptionaldefault falseVerified suppliers only
Only suppliers verified by an independent inspection company.
verifiedProbooleanOptionaldefault falseVerified Pro suppliers only
Only Verified Pro suppliers (a much smaller set).
alibabaGuaranteedbooleanOptionaldefault falseGuaranteed products only
Only products with guaranteed delivery dates, shipping-included prices and money-back protection.
readyToShipbooleanOptionaldefault falseReady to ship only
Only products in stock and ready to ship.
supplierCountrystringOptionalSupplier country
Two-letter country code of the supplier, for example CN, US, VN, IN or TR. Leave empty for all countries.
proxyConfigurationobjectOptionaldefault {"useScrapelyProxy":true,"scrapelyProxyGroups":["DATACENTER…Proxy configuration
Proxy used to open alibaba.com. Datacenter works well; the run moves to residential by itself if datacenter addresses keep getting challenged.
Every run writes its results to a dataset. Preview it in the dashboard, then export it or read it through the API.
| Field | Type | Description |
|---|---|---|
| search_query | string | null | Query, search URL or category the product came from. |
| product_id | string | null | Alibaba numeric product ID. |
| name | string | null | Product title. |
| price_min | number | null | Lowest tier price. |
| price_max | number | null | Highest tier price. |
| currency | string | null | ISO currency code. |
| moq | integer | null | Smallest quantity the supplier accepts. |
| moq_unit | string | null | Unit of the MOQ, e.g. piece or set. |
| price_at_moq | number | null | Unit price at the minimum order quantity. |
| price_at_moq_formatted | string | null | Formatted price range. |
| promotion_price_min | number | null | Discounted price while a promotion runs. |
| promotion_price_max | number | null | Discounted top price while a promotion runs. |
| price_tiers | array | null | Quantity price ladder. |
| product_url | string | null | Product page on alibaba.com. |
| main_image | string | null | Main product image. |
| images | array | null | Product images (full gallery with Full product details). |
| has_video | boolean | null | The listing has a product video. |
| video_url | string | null | Product video (Full product details). |
| video_duration_sec | integer | null | Video length (Full product details). |
| category_id | string | null | Leaf category ID. |
| category_name | string | null | Leaf category name. |
| category_path | array | null | Breadcrumb (Full product details). |
| company_name | string | null | Supplier company name. |
| company_id | string | null | Supplier company ID. |
| supplier_url | string | null | Supplier storefront. |
| supplier_country | string | null | Two-letter supplier country code. |
| years_as_gold_supplier | integer | null | Years the supplier has been on alibaba.com. |
| is_gold_supplier | boolean | null | Paid Gold Supplier membership. |
| is_verified_supplier | boolean | null | Verified by an independent inspection company. |
| is_verified_pro | boolean | null | Verified Pro supplier. |
| is_trade_assurance | boolean | null | Trade Assurance order protection. |
| is_alibaba_guaranteed | boolean | null | Guaranteed delivery and shipping-included price. |
| is_ready_to_ship | boolean | null | In stock, ready to ship. |
| supplier_service_score | number | null | Supplier service rating (1-5). |
| review_score | number | null | Review rating (1-5). |
| review_count | integer | null | Number of reviews. |
| orders_count | integer | null | Units or orders sold as shown on the listing. |
| reply_rate | string | null | Supplier response rate. |
| delivery_estimate | string | null | Estimated delivery date as shown. |
| dispatch_time | string | null | Dispatch lead time for the first quantity tier (Full product details). |
| lead_time_days | integer | null | Shortest processing time in days. |
| free_shipping | boolean | null | Free shipping offered. |
| easy_return | boolean | null | Easy return offered. |
| specifications | array | null | Product attributes (Full product details). |
| certificates | array | null | Certificates with validity (Full product details). |
| lead_time_tiers | array | null | Lead time per quantity (Full product details). |
| supplier_contact | object | null | Sales contact shown on the page (Full product details). |
| supplier_metrics | object | null | On-time rate, response time, staff and more (Full product details). |
| details_fetched | boolean | null | The product page was opened. |
You pay for the events the actor reports, such as each result or page it produces. Platform usage is included in the event prices.
| Event | Charged when | Price |
|---|---|---|
| Result | One saved Alibaba product. | $0.0007 |
Run this actor from your own code. Swap in your API token and the examples work as-is.
import { ScrapelyClient } from 'scrapely-client'
const client = new ScrapelyClient({ token: process.env.SCRAPELY_TOKEN })
// Start the actor and wait for the run to finish.
const run = await client.actor('shelfbright/alibaba-scraper').call({
"queries": [
"wireless earbuds"
],
"startUrls": [],
"maxItems": 20,
"proxyConfiguration": {
"useScrapelyProxy": true,
"scrapelyProxyGroups": [
"DATACENTER"
]
}
})
// Read the dataset the run produced.
const { items } = await client.dataset(run.defaultDatasetId).listItems()
console.log(items)Tokens live in your account settings. Keep them server-side: a token carries the full permissions of your account.
Connect the Scrape.ly MCP server once and your agent can run this actor as a tool. Pick your tool:
Fetch scrape.ly/agents.md and run shelfbright/alibaba-scraperPaste into Claude Code, Codex, Cursor or any AI agent. It signs you in once in the browser.
{
"mcpServers": {
"scrapely": {
"url": "https://api.scrape.ly/mcp?tools=actors,runs,storage,docs&actors=shelfbright/alibaba-scraper"
}
}
}No key in the file: your client opens the browser to sign you in the first time it connects.
Inputs the developer prepared for common jobs. Open one to see its input, then copy it to your account to run it as-is or adjust it.
Product offers with prices and supplier info.
Offers priced 2 to 10 USD with trade assurance.
Full product pages from a pasted Alibaba search.
Scrape.ly gives you the infrastructure, the tooling, and the team to extract, process, and operationalize web data at any scale. Setup takes minutes. The advantage lasts forever.