@@ -15,7 +15,7 @@ Use this repository to call the **[Alibaba Products Scraper](https://apify.com/D
 
 ## 🔥 What you get
 
-- **One row per unique product**: product ID, title, price or price range, minimum order quantity, supplier name, image URL and product URL.
+- **One row per unique product**, carrying the offer's title, its unit price or price band, the MOQ, the seller's company name, the main image and a link to the listing.
 - **Many keywords per run**: every search term is paginated on its own, up to the limit you set.
 - **No repeat rows**: sponsored offers that reappear on later result pages are removed across the whole run, so you are not billed twice for one product.
 - **One bad term never sinks the run**: a term that fails is skipped and logged while the other terms finish.
@@ -84,35 +84,35 @@ console.log(items);
 }
 ```
 
-| Field | Type | Required | Default | Description |
+| Field | Type | Required | Default | Allowed values |
 |---|---|---|---|---|
-| `searchTerms` | array | no | `["bluetooth speaker", "led strip light"]` | One or more free-text Alibaba search queries (e.g. bluetooth speaker, led strip light). Each term is fetched as its own paginated trade/search run. |
-| `maxResultsPerTerm` | integer | no | `100` | Cap on unique products collected per search term. Values above ~50 force multi-page pagination with run-wide duplicate removal. |
-| `proxyConfiguration` | object | no | `{"useApifyProxy": true}` | Apify Proxy spec — mandatory field. The Actor defaults to a RESIDENTIAL proxy pinned to the US when this is left at {"useApifyProxy": true} — the default (datacenter/auto) pool hit a served anti-bot challenge in cloud QA (2026-09-17). Override apifyProxyGroups/apifyProxyCountry here to change it. |
+| `searchTerms` | array | no | `["bluetooth speaker", "led strip light"]` | — |
+| `maxResultsPerTerm` | integer | no | `100` | — |
+| `proxyConfiguration` | object | no | `{"useApifyProxy": true}` | — |
 
 ## 📤 Output
 
 You get one object per product offer. Price strings are left as Alibaba displays them, including ranges and currency symbols, so your code decides how to parse and convert them.
 
-| Field | Type | Description |
+| Field | Type | Always present |
 |---|---|---|
-| `product_id` | string | Alibaba's internal product ID. |
-| `search_term` | string | The search query that produced this row. |
-| `title` | string | Product title as listed on the search results page. |
-| `price` | string or null | Raw price or price-range string as served (mixed currency formats preserved). |
-| `moq` | string or null | Minimum order quantity string, when present. |
-| `supplier_name` | string or null | Supplier / company name, when present. |
-| `image_url` | string or null | Primary listing image URL. |
-| `product_url` | string | Absolute alibaba.com product detail page URL. |
-| `page_number` | integer | 1-indexed search results page this row was found on. |
-| `scraped_at` | string | UTC ISO-8601 timestamp captured when the page was fetched. |
+| `product_id` | string | yes |
+| `search_term` | string | yes |
+| `title` | string | yes |
+| `price` | string or null | no |
+| `moq` | string or null | no |
+| `supplier_name` | string or null | no |
+| `image_url` | string or null | no |
+| `product_url` | string | yes |
+| `page_number` | integer | yes |
+| `scraped_at` | string | yes |
 
 ## 💰 Pricing
 
-| Event | Price (USD) | When it is charged |
-|---|---|---|
-| Actor start | $0.2 | Charged once when the Actor begins a run. |
-| Result item | $0.006 | Charged once per validated product row pushed to the dataset. |
+| Event | Price (USD) |
+|---|---|
+| Actor start | $0.2 |
+| Result item | $0.006 |
 
 Prices as configured on 2026-09-17. The [Actor page](https://apify.com/DevilScrapes/alibaba-products-scraper) always shows the current price. Runs are billed to the Apify account that owns the token. Use `--max-charge` to cap what a single run can cost.