E-commerce sourcing API

Product rows from 1688, AliExpress and Etsy: prices, minimum orders, sales counts and supplier details.

Three marketplaces, one set of columns. 1688 prices are in Chinese yuan.

Sample rows from the E-commerce sourcing family
platform	title	price or priceMin	currency
AliExpress	Wireless LED Night Lights Motion Sensor Lights Closet Kitchen	0.33	USD
Etsy	Leather Envelope Wallet for Women, Personalized Mini Card Wallet, Full Grain Crazy Horse	64	USD
1688	数据线保护套硅胶防折断充电线保护套咬线器防断裂神器	priceMin2.5	CNY

3 scrapers in E-commerce sourcing

One price per 1,000 rows each. Pick one to see its sample, input and fields.

Scrapers in this family and their prices
Scraper	Price per 1,000	One row is	Start fee per run
1688 Products	$1.50	a product	$0.001
AliExpress Search	$1.25	a product	$0.001
Etsy Products	$3.50	a listing	$0.002

Shared fields

11 fields with the same names on all three sites. Site-specific fields, such as price tiers on 1688, come on top.

The product 7 fields

The product
Field	Type	What it holds
platform	string	Always '1688'.
url	string	Product page link on detail.1688.com.
title	string	Product title as the seller wrote it, usually Chinese; contact data removed.
isAd	boolean	True when the row is a paid placement in the search results.
currency	string	Currency of all prices, always CNY (Chinese yuan).
rating		Details only: buyer review score, goodRatePct and reviewCount.
scrapedAt		ISO time the row was collected.

Error rows, free 3 fields

Error rows, free
Field	Type	What it holds
input		Coverage and error rows: the keyword or offer the row is about.
code		Error rows: invalid_input, not_found, no_match, blocked or unavailable.
message		Error rows: what went wrong, in plain words.

Call any of them the same way

Only the scraper name and its input change between scrapers in E-commerce sourcing. The API opens at launch.

Terminal

curl -X POST https://scrapers-api.arcadiumdata.io/v1/scrapers/1688-products/runs \
  -H "Authorization: Bearer $ARCADIUM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input": {
      "keywords": [
        "保温杯"
      ],
      "maxItemsPerKeyword": 50,
      "sort": "relevance"
    }
  }'

Questions people ask before they top up

Which currency are prices in?

The currency the site shows, named in the currency field of each row. 1688 prices are in Chinese yuan. We do not convert them.

Do these scrapers return supplier details?

1688 rows include the supplier's company name, years on the platform and service scores. No scraper returns a person's name or contact details.

What am I charged for when a run fails or finds nothing?

Nothing. You pay for rows we deliver, at the price on the scraper's page, plus a small start fee on runs that deliver rows. A run that returns rows costs at least $0.005. Failed runs, empty runs and duplicate rows cost $0.