# Made-in-China Search Scraper (`xtracto/made-in-china-search-scraper`) Actor

Search Made-in-China.com for any keyword and get B2B product cards with supplier, price, MOQ, and attributes.

- **URL**: https://apify.com/xtracto/made-in-china-search-scraper.md
- **Developed by:** [Farhan Febrian Nauval](https://apify.com/xtracto) (community)
- **Categories:** E-commerce
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.00 / 1,000 results

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

## Made-in-China Search Scraper

Search [Made-in-China.com](https://www.made-in-china.com/) for any keyword and get clean B2B product cards — product, supplier, FOB price, minimum order quantity, attributes, and supplier trust signals — as structured JSON.

### Why use this actor

- **Supplier sourcing at scale** — every result links the product to the exact supplier and their company page.
- **Real B2B pricing** — captures the FOB price (single value or range) and the minimum order quantity for each product.
- **Rich product detail** — pulls the product attributes table (material, function, Bluetooth version, usage, and more) for every card.
- **Supplier trust signals** — member level, review rating, location, audited status, and capability tags (OEM/ODM, Fast Delivery, R&D, …).
- **No account, no API key** — works straight from public search pages.
- **Stable JSON output** — the same field names every run, ready for spreadsheets, databases, or pipelines.

### How it works

1. You provide one or more search keywords.
2. The actor pulls the search results for each keyword across as many pages as you allow (about 30 products per page).
3. Each product is saved as a `PRODUCT` record with its supplier, price, minimum order, attributes, and trust signals.
4. If a keyword returns nothing, the actor still writes one diagnostic record so a query is never silently dropped.
5. Everything lands in your dataset, exportable as JSON, CSV, or Excel.

You don't need to manage any browsers or scrapers.

### Input

```json
{
    "queries": [
        "earbuds",
        "stainless steel water bottle"
    ],
    "maxPagesPerQuery": 2,
    "maxConcurrency": 4,
    "maxRequestRetries": 5,
    "proxyConfiguration": { "useApifyProxy": true }
}
````

Each keyword in `queries` is searched independently and produces its own set of `PRODUCT` records.

| Field | Type | Description |
| --- | --- | --- |
| `queries` | array | **Required.** Keywords to search (one per array entry). Each keyword yields its own product cards. |
| `maxPagesPerQuery` | integer | Pages of results per query, ~30 products/page (`1`–`20`). Stops early when a page returns no more products. Default `2`. |
| `maxConcurrency` | integer | Number of parallel requests across all keywords (`1`–`20`). Default `4`. |
| `maxRequestRetries` | integer | Retries per page before giving up (`1`–`15`). Default `5`. |
| `proxyConfiguration` | object | Apify Proxy or a custom proxy list. Datacenter proxies work fine for this source. |

### Output

Each product is one record (`recordType: "PRODUCT"`):

```json
{
    "recordType": "PRODUCT",
    "query": "earbuds",
    "page": 1,
    "title": "Cute Opera Face-Changing Tws in Ear Bluetooth Earphones True Wireless Earbuds",
    "productUrl": "https://romantech.en.made-in-china.com/product/MFifltwdEqTR/China-Cute-Opera-Face-Changing-Tws-in-Ear-Bluetooth-Earphones-True-Wireless-Earbuds.html",
    "productId": "MFifltwdEqTR",
    "companyName": "Roman Technology Co., Ltd",
    "companyUrl": "https://romantech.en.made-in-china.com",
    "priceText": "US$3.95-5.30",
    "priceMin": 3.95,
    "priceMax": 5.3,
    "currency": "USD",
    "minOrder": "50 Pieces",
    "image": "https://image.made-in-china.com/43f34j00csjWbVqBAkYQ/Cute-Opera-Face-Changing-Tws-in-Ear-Bluetooth-Earphones-True-Wireless-Earbuds.webp",
    "attributes": {
        "Style": "In-ear",
        "Usage": "Mobile Phone, MP3 & MP4, Computer",
        "Bluetooth Version": "Bluetooth 5.3",
        "Soundtrack": "Dual Track",
        "Function": "Bluetooth",
        "Characteristics": "Support Music"
    },
    "memberLevel": "Gold Member",
    "rating": "5.0/5",
    "location": "Guangdong, China",
    "auditedSupplier": true,
    "supplierTags": ["ODM Services", "OEM Services", "Years of Export Experience", "Exhibition Experience"],
    "scrapedAt": "2026-06-10T18:05:51Z"
}
```

If a keyword returns no products, the actor writes a single diagnostic record instead:

```json
{
    "recordType": "PRODUCT",
    "_input": "xyzzy no such product",
    "error": "NO_RESULTS",
    "scrapedAt": "2026-06-10T18:05:51Z"
}
```

| Field | Type | Description |
| --- | --- | --- |
| `recordType` | string | Always `"PRODUCT"`. |
| `query` | string | The keyword that produced this record. |
| `page` | integer | Result page the product was found on. |
| `title` | string | Product title. |
| `productUrl` | string | Full product detail URL. |
| `productId` | string | Product identifier parsed from the URL. |
| `companyName` | string | Supplier company name. |
| `companyUrl` | string | Supplier's company page (their own subdomain). |
| `priceText` | string | Price exactly as shown (FOB), e.g. `US$3.95-5.30`. |
| `priceMin` / `priceMax` | number | Low / high end of the price (`priceMax` is `null` for a single price). |
| `currency` | string | ISO currency of the price (e.g. `USD`). |
| `minOrder` | string | Minimum order quantity, e.g. `50 Pieces`. |
| `image` | string | Primary product image URL. |
| `attributes` | object | Product attribute table (label → value). |
| `memberLevel` | string | Supplier membership tier (e.g. `Gold Member`, `Diamond Member`). |
| `rating` | string | Supplier review rating when shown, e.g. `5.0/5`. |
| `location` | string | Supplier location, e.g. `Guangdong, China`. |
| `auditedSupplier` | boolean | Whether the supplier is shown as audited. |
| `supplierTags` | array | Capability/trust tags (e.g. `OEM Services`, `Fast Delivery`). |
| `scrapedAt` | string | ISO 8601 timestamp of collection. |
| `error` | string | Only on diagnostic records: `NO_RESULTS` or `BLOCKED_AFTER_RETRIES`. |

### Other Made-in-China / B2B Scrapers

| Actor | Description |
| --- | --- |
| [Made-in-China Search Scraper](https://apify.com/made-in-china-search-scraper) | Keyword search → product cards with supplier, price, MOQ, and attributes. |
| [Made-in-China Product Scraper](https://apify.com/made-in-china-product-scraper) | Full product detail: specifications, packaging, and supplier profile. |
| [Made-in-China Supplier Scraper](https://apify.com/made-in-china-supplier-scraper) | Company profile, certifications, and full product catalog per supplier. |

# Actor input Schema

## `queries` (type: `array`):

Keywords to search on Made-in-China.com (one per array entry). Each keyword is searched independently and yields its own product cards.

## `maxPagesPerQuery` (type: `integer`):

How many pages of search results to traverse per query (about 30 products per page). The actor stops early once a page returns no more products.

## `maxConcurrency` (type: `integer`):

Maximum number of parallel requests across all keywords.

## `maxRequestRetries` (type: `integer`):

How many times a page request will be retried before giving up on that page.

## `proxyConfiguration` (type: `object`):

Apify Proxy or your own proxy list. Datacenter proxies work fine for this source.

## Actor input object example

```json
{
  "queries": [
    "earbuds"
  ],
  "maxPagesPerQuery": 2,
  "maxConcurrency": 4,
  "maxRequestRetries": 5,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "queries": [
        "earbuds"
    ],
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("xtracto/made-in-china-search-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "queries": ["earbuds"],
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("xtracto/made-in-china-search-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "queries": [
    "earbuds"
  ],
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call xtracto/made-in-china-search-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=xtracto/made-in-china-search-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Made-in-China Search Scraper",
        "description": "Search Made-in-China.com for any keyword and get B2B product cards with supplier, price, MOQ, and attributes.",
        "version": "1.0",
        "x-build-id": "OvHSfjGm8ftteBLum"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/xtracto~made-in-china-search-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-xtracto-made-in-china-search-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/xtracto~made-in-china-search-scraper/runs": {
            "post": {
                "operationId": "runs-sync-xtracto-made-in-china-search-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/xtracto~made-in-china-search-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-xtracto-made-in-china-search-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "required": [
                    "queries"
                ],
                "properties": {
                    "queries": {
                        "title": "Search keywords",
                        "type": "array",
                        "description": "Keywords to search on Made-in-China.com (one per array entry). Each keyword is searched independently and yields its own product cards.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "maxPagesPerQuery": {
                        "title": "Max pages per query",
                        "minimum": 1,
                        "maximum": 20,
                        "type": "integer",
                        "description": "How many pages of search results to traverse per query (about 30 products per page). The actor stops early once a page returns no more products.",
                        "default": 2
                    },
                    "maxConcurrency": {
                        "title": "Max concurrency",
                        "minimum": 1,
                        "maximum": 20,
                        "type": "integer",
                        "description": "Maximum number of parallel requests across all keywords.",
                        "default": 4
                    },
                    "maxRequestRetries": {
                        "title": "Max retries",
                        "minimum": 1,
                        "maximum": 15,
                        "type": "integer",
                        "description": "How many times a page request will be retried before giving up on that page.",
                        "default": 5
                    },
                    "proxyConfiguration": {
                        "title": "Proxy configuration",
                        "type": "object",
                        "description": "Apify Proxy or your own proxy list. Datacenter proxies work fine for this source."
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```