# Alibaba Scraper data API: fields, sample output and cost per 1,000 rows

Scrape Alibaba.com product offers by keyword: title, price range and quantity price tiers, minimum order, units sold, ratings, certifications, and the supplier's name, country, years, Gold and verified badges, Trade Assurance and response rate.

This is the reference for the Actor `v0iddo/alibaba-scraper`: what is in every output row, what the input takes, and what a run costs. Values below come from a real run of the Actor.

## At a glance

| | |
| --- | --- |
| Actor | `v0iddo/alibaba-scraper` |
| Store page | [Alibaba Scraper](https://apify.com/v0iddo/alibaba-scraper) |
| Output | one row per result, as JSON, CSV, Excel or HTML |
| Fields per row | 29 (12 text, 11 number, 3 true/false, 2 list, 1 URL) |
| Cap on results | `maxItems` in the input |
| Price | $0.75 per 1,000 results |

## Output fields

Each result is one row with these fields (fields that name people are left out):

| Field | Type | Meaning | Sample value |
| --- | --- | --- | --- |
| `productId` | text | Product ID | 1601209913000 |
| `title` | text | Title | Wholesale Custom Print logo Curve Arch Oval Shape Eco-friendly Yoga... |
| `priceMin` | number | Price from | 13.9 |
| `priceMax` | number | Price to | 13.9 |
| `minOrder` | number | Min order | 1 |
| `minOrderUnit` | text | Unit | piece |
| `sold` | number | Sold | 655 |
| `supplierName` | text | Supplier | Hunan Sanmo Sports Goods Co., Ltd. |
| `supplierCountry` | text | Country | China |
| `url` | URL | Product URL | https://www.alibaba.com/product-detail/wholesale-eco-friendly-custo... |
| `searchTerm` | text |  | yoga mat |
| `page` | number |  | 1 |
| `position` | number |  | 1 |
| `currency` | text |  | USD |
| `priceText` | text |  | US $13.90 |
| `minOrderText` | text |  | 1 piece |
| `quantityPrices` | list |  | [{"minQuantity": 1, "maxQuantity": null, "price": 13.9, "unit": "Pi... |
| `soldText` | text |  | 655 sold |
| `productRating` | number |  | 4.9 |
| `supplierRating` | number |  | 4.8 |
| `supplierReviews` | number |  | 122 |
| `certifications` | list |  | ["REACH"] |
| `supplierCountryCode` | text |  | CN |
| `supplierYears` | number |  | 3 |
| `goldSupplier` | true/false |  | true |
| `verifiedSupplier` | true/false |  | true |
| `tradeAssurance` | true/false |  | true |
| `responseRate` | number |  | 99.9 |
| `image` | text |  | https://s.alicdn.com/@sc04/kf/H5f8e09fbf6ac46dc8186def59e788754q.jpg |

## One record

```json
{
  "searchTerm": "yoga mat",
  "page": 1,
  "position": 1,
  "productId": "1601209913000",
  "title": "Wholesale Custom Print logo Curve Arch Oval Shape Eco-friendly Yoga Mats Pu Rubber Non-slip Pilates Mat Tapis Yoga Workout Mats",
  "priceMin": 13.9,
  "priceMax": 13.9,
  "currency": "USD",
  "priceText": "US $13.90",
  "minOrder": 1,
  "minOrderUnit": "piece",
  "minOrderText": "1 piece",
  "quantityPrices": [
    {
      "minQuantity": 1,
      "maxQuantity": null,
      "price": 13.9,
      "unit": "Piece"
    }
  ],
  "sold": 655,
  "soldText": "655 sold",
  "productRating": 4.9,
  "supplierRating": 4.8,
  "supplierReviews": 122,
  "certifications": [
    "REACH"
  ],
  "supplierName": "Hunan Sanmo Sports Goods Co., Ltd.",
  "supplierCountry": "China",
  "supplierCountryCode": "CN",
  "supplierYears": 3,
  "goldSupplier": true,
  "verifiedSupplier": true,
  "tradeAssurance": true,
  "responseRate": 99.9,
  "image": "https://s.alicdn.com/@sc04/kf/H5f8e09fbf6ac46dc8186def59e788754q.jpg",
  "url": "https://www.alibaba.com/product-detail/wholesale-eco-friendly-custom-print-logo_1601209913000.html"
}
```

## Input parameters

| Parameter | Type | Required | Default | What it does |
| --- | --- | --- | --- | --- |
| `searchTerms` | array | no | ["led strip lights"] | Products as a buyer would type them, one per line, for example led strip lights. |
| `searchUrls` | array | no |  | Optional alibaba.com keyword pages (https://www.alibaba.com/wholesale/....html). |
| `maxPages` | integer | no | 2 | How many result pages (about 47 offers each) to read per keyword. |
| `maxItems` | integer | no | 200 | The run stops after this many result rows. |
| `onlyNew` | boolean | no | false | Skip rows that an earlier run with the same input already returned, so a scheduled run gives each new row once. |

## Ready-made examples

Saved inputs on Apify: run one as it is, or copy it and change the values.

- [Alibaba yoga mat suppliers with prices and MOQ](https://apify.com/v0iddo/alibaba-scraper/examples/alibaba-yoga-mat-suppliers-prices)
- [Alibaba phone case manufacturers with MOQ and price tiers](https://apify.com/v0iddo/alibaba-scraper/examples/alibaba-phone-case-manufacturers-moq)
- [Alibaba LED strip lights wholesale prices and suppliers](https://apify.com/v0iddo/alibaba-scraper/examples/alibaba-led-strip-lights-wholesale)

## Cost per 1,000 rows

$0.75 per 1,000 results. You pay per result row. There is no separate charge per run. Higher Apify plans pay less per result, down to $0.53 per 1,000.

| Results | Cost at the listed price | Cost at the lowest plan price |
| --- | --- | --- |
| 100 | $0.07 | $0.05 |
| 1,000 | $0.75 | $0.53 |
| 10,000 | $7.50 | $5.25 |
| 100,000 | $75.00 | $52.50 |

The figures are the listed price times the number of results. The `maxItems` limit and the maximum cost setting in the run options both stop a run before it spends more than you planned.

## Get the rows as CSV over HTTP

One request starts a run, waits for it and returns the dataset. The `format` parameter picks the file type and `fields` picks the columns. Replace the token with the one from Apify Console, Settings, Integrations.

```bash
curl -X POST "https://api.apify.com/v2/acts/v0iddo~alibaba-scraper/run-sync-get-dataset-items?format=csv&fields=productId,title,priceMin" \
  -H "Authorization: Bearer YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"searchTerms": ["led strip lights"], "maxPages": 1, "maxItems": 20}'
```

## Good to know

- Reads Alibaba's public keyword pages (alibaba.com/wholesale/...). Its search box pages are closed to automated access in robots.txt, so filters such as price range or supplier type are not offered.
- Most product keywords have a page. When one has none, the run tries the plural once and logs the keyword if that has none either.
- Prices are as shown to a visitor of the English site, usually in US dollars; quantityPrices lists the price per quantity tier when the offer has tiers.
- Supplier contact details are not collected.

## Links

- Actor on the Apify Store: [Alibaba Scraper](https://apify.com/v0iddo/alibaba-scraper)
- Guide with the Python and JavaScript code: [https://voidd0.github.io/alibaba-scraper/](https://voidd0.github.io/alibaba-scraper/)
- Step by step: [https://voiddo.com/export/alibaba-scraper/](https://voiddo.com/export/alibaba-scraper/)