{
  "openapi": "3.0.1",
  "info": {
    "title": "Made-in-China Scraper - Products, Suppliers, Prices & Reviews",
    "description": "Scrape Made-in-China.com products and suppliers by keyword, category or link: price tiers, MOQ, specs, HS code, samples, audited and Diamond badges, supplier profiles (employees, year, markets, payment terms, contact person) and reviews. Monitor mode. $0.76 per 1,000 products.",
    "version": "0.1",
    "x-build-id": "RIwA9sddR6nBfxCk5"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/topapi~made-in-china-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-topapi-made-in-china-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/topapi~made-in-china-scraper/runs": {
      "post": {
        "operationId": "runs-sync-topapi-made-in-china-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/topapi~made-in-china-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-topapi-made-in-china-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",
        "properties": {
          "mode": {
            "title": "What keywords return",
            "enum": [
              "products",
              "suppliers"
            ],
            "type": "string",
            "description": "products: one row per product with its supplier. suppliers: one row per company (supplier search). Links route themselves: product, product list, search and category links give products; supplier showroom, supplier search and manufacturer directory links give suppliers.",
            "default": "products"
          },
          "searchKeywords": {
            "title": "Search keywords",
            "type": "array",
            "description": "Keywords searched the way Made-in-China.com's own search box searches them, e.g. led light, cnc machine, solar panel. Each keyword runs separately.",
            "items": {
              "type": "string"
            }
          },
          "startUrls": {
            "title": "Made-in-China.com links",
            "type": "array",
            "description": "Any Made-in-China.com link: product pages (m.made-in-china.com/product/..., <supplier>.en.made-in-china.com/product/...), supplier showrooms (<supplier>.en.made-in-china.com or m.made-in-china.com/company-<supplier>/), supplier product lists, product and supplier searches, hot-products pages, categories (catlist / Catalog links), manufacturer directories (/manufacturers/<keyword>.html) and supplier review pages.",
            "items": {
              "type": "string"
            }
          },
          "maxResults": {
            "title": "Max results per keyword or link",
            "minimum": 0,
            "maximum": 30000,
            "type": "integer",
            "description": "Rows per keyword and per list link (after the filters). Product searches go up to 30,000 rows (834 pages of 36), supplier searches up to 2,000 (100 pages of 20). 0 = everything the list shows.",
            "default": 100
          },
          "maxItems": {
            "title": "Max rows in total",
            "minimum": 0,
            "type": "integer",
            "description": "Stops the whole run after this many product and supplier rows (reviews included). 0 = no total cap."
          },
          "maxPages": {
            "title": "Max list pages per keyword or link",
            "minimum": 0,
            "maximum": 834,
            "type": "integer",
            "description": "Optional page cap per keyword or link (36 products or 20 suppliers a page). 0 = no page cap."
          },
          "includeProductDetails": {
            "title": "Include product details",
            "type": "boolean",
            "description": "Open each product page: every quantity price tier, all specifications, model number, HS code, trademark, origin, production capacity, packaging size and weight, sample price, highlights, description, images and video, category path, FAQ, plus the supplier's address, payment terms, Incoterms, lead time, nearest port, main markets, export year, audit agency and report number. Charged as the product-details add-on per product row that carries them.",
            "default": false
          },
          "includeSupplierProfile": {
            "title": "Include the supplier profile",
            "type": "boolean",
            "description": "Supplier rows: read the company profile and contact page (year established, employees, plant area, registered capital, main markets, payment terms, lead time, R&D and QA staff, customization options, verified fields, overview, contact person with title and department, postal code, website and virtual tour). Included in the supplier price. On product rows (with details on) it adds a supplierProfile object, read once per supplier.",
            "default": true
          },
          "includeReviews": {
            "title": "Include supplier reviews",
            "type": "boolean",
            "description": "Adds buyer reviews of each supplier as separate review rows (rating, sub-ratings, text, date, buyer name as masked by the site, buyer country, verified purchase, the product reviewed). Read once per supplier. Charged per review row.",
            "default": false
          },
          "maxReviewsPerSupplier": {
            "title": "Max reviews per supplier",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "Reviews per supplier when reviews are on, newest first.",
            "default": 20
          },
          "includeSupplierProducts": {
            "title": "Supplier links: also list their products",
            "type": "boolean",
            "description": "For supplier showroom links, also deliver the supplier's product list (product rows) after the supplier row.",
            "default": false
          },
          "businessType": {
            "title": "Business type",
            "type": "array",
            "description": "Keep suppliers of these types. One type goes into Made-in-China.com's own search; several are matched on each row.",
            "items": {
              "type": "string",
              "enum": [
                "manufacturer",
                "trading",
                "group",
                "other"
              ],
              "enumTitles": [
                "Manufacturer / factory",
                "Trading company",
                "Group corporation",
                "Other"
              ]
            }
          },
          "province": {
            "title": "Supplier province",
            "type": "array",
            "description": "Keep suppliers in these Chinese provinces or cities, e.g. Guangdong, Zhejiang, Jiangsu. One province goes into Made-in-China.com's own search; several are matched on each row.",
            "items": {
              "type": "string"
            }
          },
          "membership": {
            "title": "Membership",
            "enum": [
              "any",
              "diamond",
              "gold"
            ],
            "type": "string",
            "description": "Only Diamond or Gold members (supplier searches apply it in Made-in-China.com's own query).",
            "default": "any"
          },
          "auditedOnly": {
            "title": "Audited suppliers only",
            "type": "boolean",
            "description": "Only suppliers with the Audited Supplier badge (audited by a third-party agency such as SGS, BV or TUV).",
            "default": false
          },
          "samplesOnly": {
            "title": "Samples available only",
            "type": "boolean",
            "description": "Products only: only products that can be bought as a sample (applied in Made-in-China.com's own search).",
            "default": false
          },
          "securedTradingOnly": {
            "title": "Secured Trading only",
            "type": "boolean",
            "description": "Products only: only products covered by Made-in-China.com's Secured Trading Service.",
            "default": false
          },
          "leadingFactoryOnly": {
            "title": "Leading factories only",
            "type": "boolean",
            "description": "Only suppliers Made-in-China.com marks as a leading factory.",
            "default": false
          },
          "excludeSponsored": {
            "title": "Skip sponsored rows",
            "type": "boolean",
            "description": "Leave out rows Made-in-China.com shows as paid placements (isSponsored).",
            "default": false
          },
          "categoryCode": {
            "title": "Category code",
            "type": "string",
            "description": "Optional 10-digit Made-in-China.com category code (the number at the end of a catlist or Catalog link, e.g. 3024130000 for LED Work Light). With keywords it narrows the search; alone it lists the category."
          },
          "minPrice": {
            "title": "Minimum price (USD)",
            "minimum": 0,
            "type": "number",
            "description": "Products only: keep products whose highest listed price is at least this."
          },
          "maxPrice": {
            "title": "Maximum price (USD)",
            "minimum": 0,
            "type": "number",
            "description": "Products only: keep products whose lowest listed price is at most this."
          },
          "maxMoq": {
            "title": "Maximum MOQ",
            "minimum": 0,
            "type": "integer",
            "description": "Products only: keep products whose minimum order quantity is at most this."
          },
          "rdCapabilities": {
            "title": "R&D capability",
            "type": "array",
            "description": "Keep suppliers that list one of these R&D capabilities.",
            "items": {
              "type": "string",
              "enum": [
                "oem",
                "odm",
                "own_brand",
                "other"
              ],
              "enumTitles": [
                "OEM",
                "ODM",
                "Own brand",
                "Other"
              ]
            }
          },
          "minLeadScore": {
            "title": "Minimum lead score",
            "minimum": 0,
            "maximum": 100,
            "type": "integer",
            "description": "Keep rows whose leadScore (0-100, explained in the README) is at least this."
          },
          "minYearsOnPlatform": {
            "title": "Minimum years on Made-in-China.com",
            "minimum": 0,
            "type": "integer",
            "description": "Products only: keep products whose supplier has been a member at least this many years."
          },
          "titleMustContain": {
            "title": "Title must contain",
            "type": "array",
            "description": "Products only: keep products whose title contains every one of these words.",
            "items": {
              "type": "string"
            }
          },
          "titleMustNotContain": {
            "title": "Title must not contain",
            "type": "array",
            "description": "Products only: leave out products whose title contains any of these words.",
            "items": {
              "type": "string"
            }
          },
          "onePerSupplier": {
            "title": "One product per supplier",
            "type": "boolean",
            "description": "Products only: deliver only the first product of each supplier.",
            "default": false
          },
          "monitorMode": {
            "title": "Monitor mode (only new and changed rows)",
            "type": "boolean",
            "description": "Deliver only products, suppliers and reviews not delivered by an earlier monitor run with the same inputs and monitor key, plus products whose listed price range changed (changeType changed, previousPrice). A row that lacked details or the profile is delivered once more when they are asked for. Rows already delivered are not charged.",
            "default": false
          },
          "monitorKey": {
            "title": "Monitor key",
            "type": "string",
            "description": "Name of the monitor memory. Use a different key per saved task.",
            "default": "mic"
          },
          "resetMonitor": {
            "title": "Reset the monitor memory",
            "type": "boolean",
            "description": "Forget what earlier monitor runs delivered (this run delivers everything again).",
            "default": false
          },
          "maxConcurrency": {
            "title": "Max concurrency",
            "minimum": 1,
            "maximum": 16,
            "type": "integer",
            "description": "Pages read at the same time.",
            "default": 8
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "Optional. By default the actor reads Made-in-China.com directly and steps up to Apify datacenter, then residential proxy only when a page is refused.",
            "default": {
              "useApifyProxy": false
            }
          }
        }
      },
      "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}