{
  "openapi": "3.0.1",
  "info": {
    "title": "Alibaba Scraper: Prices, MOQ, Verified Suppliers",
    "description": "Scrape Alibaba.com product offers by keyword: price range and quantity price tiers, minimum order, units sold, ratings, certifications, and the supplier's name, country, years, verified badge and response rate. Filter by price, MOQ, supplier country, Verified Supplier and Trade Assurance.",
    "version": "0.1",
    "x-build-id": "GKmgcpGgyoAxR1q2c"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/v0iddo~alibaba-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-v0iddo-alibaba-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/v0iddo~alibaba-scraper/runs": {
      "post": {
        "operationId": "runs-sync-v0iddo-alibaba-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/v0iddo~alibaba-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-v0iddo-alibaba-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": {
          "searchTerms": {
            "title": "Keywords",
            "type": "array",
            "description": "Products as a buyer would type them, one per line, for example led strip lights.",
            "items": {
              "type": "string"
            }
          },
          "searchUrls": {
            "title": "Alibaba keyword page URLs",
            "type": "array",
            "description": "Optional alibaba.com keyword pages (https://www.alibaba.com/wholesale/....html) or the link of a search on alibaba.com: its words are searched as a Search Term.",
            "items": {
              "type": "string"
            }
          },
          "maxPages": {
            "title": "Pages per keyword",
            "minimum": 1,
            "maximum": 100,
            "type": "integer",
            "description": "How many result pages (about 47 offers each) to read per keyword. With filters, only the matching offers of these pages are returned.",
            "default": 2
          },
          "minPrice": {
            "title": "Price from (USD)",
            "minimum": 0,
            "type": "number",
            "description": "Keep offers whose price range reaches this price or more. Empty: no limit."
          },
          "maxPrice": {
            "title": "Price to (USD)",
            "minimum": 0,
            "type": "number",
            "description": "Keep offers with a price at or under this one (their lowest tier). Empty: no limit."
          },
          "maxMOQ": {
            "title": "Largest minimum order",
            "minimum": 1,
            "type": "integer",
            "description": "Keep offers whose minimum order is this many units or fewer. Empty: no limit."
          },
          "supplierCountries": {
            "title": "Supplier countries",
            "type": "array",
            "description": "Keep suppliers from these countries: names or codes, for example China, Vietnam, IN, Hong Kong.",
            "items": {
              "type": "string"
            }
          },
          "verifiedSupplier": {
            "title": "Verified suppliers only",
            "type": "boolean",
            "description": "Keep offers of suppliers with Alibaba's verified badge.",
            "default": false
          },
          "tradeAssurance": {
            "title": "Trade Assurance only",
            "type": "boolean",
            "description": "Keep offers of suppliers that take Trade Assurance orders.",
            "default": false
          },
          "minSupplierRating": {
            "title": "Supplier rating",
            "enum": [
              "any",
              "4",
              "4.5",
              "4.8"
            ],
            "type": "string",
            "description": "Keep suppliers rated at least this (out of 5).",
            "default": "any"
          },
          "minSold": {
            "title": "Units sold at least",
            "minimum": 1,
            "type": "integer",
            "description": "Keep offers that show at least this many units sold. Empty: no limit."
          },
          "certifications": {
            "title": "Product certifications",
            "type": "array",
            "description": "Keep offers with any of these certifications, for example CE, RoHS, FCC.",
            "items": {
              "type": "string"
            }
          },
          "maxItems": {
            "title": "Maximum results",
            "minimum": 1,
            "maximum": 1000000,
            "type": "integer",
            "description": "The run stops after this many result rows. It also caps what one run can cost.",
            "default": 200
          },
          "onlyNew": {
            "title": "Only new results",
            "type": "boolean",
            "description": "Skip rows that an earlier run with the same input already returned, so a scheduled run gives each new row once. Skipped rows are not charged. The keys of returned rows are kept in a key-value store in your Apify account. A run stops after 200 seen rows in a row.",
            "default": false
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "Leave as is: the run starts on the cheapest network the site accepts and switches to Apify Proxy automatically when the site blocks it. Pick proxy groups here only to force one specific network."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}