{
  "openapi": "3.0.1",
  "info": {
    "title": "Alibaba Scraper: Suppliers, Products and MOQ | $1/1K",
    "description": "Alibaba.com suppliers by keyword with verification, years, reviews, on-time rate, revenue band, certifications, offers, prices and MOQ. No login. $1 per 1,000 results, platform usage included.",
    "version": "0.1",
    "x-build-id": "PHAreGaUUOQHoN0iH"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/one_dollar_store~alibaba-suppliers-products-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-one_dollar_store-alibaba-suppliers-products-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/one_dollar_store~alibaba-suppliers-products-scraper/runs": {
      "post": {
        "operationId": "runs-sync-one_dollar_store-alibaba-suppliers-products-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/one_dollar_store~alibaba-suppliers-products-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-one_dollar_store-alibaba-suppliers-products-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": [
          "keywords"
        ],
        "properties": {
          "keywords": {
            "title": "Keywords",
            "minItems": 1,
            "maxItems": 1000,
            "type": "array",
            "description": "What to look for, for example \"led strip lights wholesale price\" or \"yoga mat\". Each keyword opens the matching Alibaba supplier page (alibaba.com/supplier/<keyword>.html). You can also paste such a page address. Alibaba has no page for some keywords and shows others in a layout this actor does not read; those are skipped and listed in the run summary. Specific buying phrases work best.",
            "items": {
              "type": "string"
            }
          },
          "rowType": {
            "title": "One row per",
            "enum": [
              "suppliers",
              "products"
            ],
            "type": "string",
            "description": "Supplier: one row per supplier with its offers listed inside. Product: one row per offered product, with the supplier details beside it.",
            "default": "suppliers"
          },
          "followRelated": {
            "title": "Follow related pages",
            "type": "boolean",
            "description": "Also read the other supplier pages that Alibaba links from each page, to reach more suppliers than your keywords alone. Runs take longer and the extra suppliers can be about other products.",
            "default": false
          },
          "tryVariants": {
            "title": "Try keyword variants",
            "type": "boolean",
            "description": "When Alibaba has no readable supplier page for a keyword, also try it with manufacturer, supplier, wholesale price or factory added. Most plain two or three word keywords have no readable page, long buying phrases usually do.",
            "default": true
          },
          "maxPagesPerKeyword": {
            "title": "Pages per keyword",
            "minimum": 1,
            "maximum": 5,
            "type": "integer",
            "description": "How many pages of each keyword list to read. Alibaba lists about 24 suppliers a page and usually 30 to 70 in all.",
            "default": 3
          },
          "countries": {
            "title": "Supplier countries",
            "maxItems": 50,
            "type": "array",
            "description": "Keep suppliers in these countries. Two letter codes, for example CN, IN, VN, TR. Leave empty for all countries.",
            "items": {
              "type": "string"
            }
          },
          "verifiedOnly": {
            "title": "Verified suppliers only",
            "type": "boolean",
            "description": "Keep only suppliers that carry Alibaba's Verified mark.",
            "default": false
          },
          "manufacturersOnly": {
            "title": "Manufacturers only",
            "type": "boolean",
            "description": "Keep only suppliers that Alibaba labels as manufacturers.",
            "default": false
          },
          "minYears": {
            "title": "Years on Alibaba, at least",
            "minimum": 1,
            "maximum": 30,
            "type": "integer",
            "description": "Keep suppliers that have been on Alibaba for at least this many years."
          },
          "minReviewScore": {
            "title": "Review score, at least",
            "minimum": 1,
            "maximum": 5,
            "type": "number",
            "description": "Keep suppliers whose average store review score is at least this value (out of 5). Suppliers without reviews are left out when this is set."
          },
          "minOnTimeDeliveryRate": {
            "title": "On-time delivery rate, at least (percent)",
            "minimum": 1,
            "maximum": 100,
            "type": "integer",
            "description": "Keep suppliers whose on-time delivery rate is at least this many percent."
          },
          "certifications": {
            "title": "Certifications",
            "maxItems": 20,
            "type": "array",
            "description": "Keep suppliers that list any of these certifications. Part of the name is enough, for example \"CE\", \"ISO\" or \"Oeko-Tex\".",
            "items": {
              "type": "string"
            }
          },
          "maxMoq": {
            "title": "Minimum order, at most",
            "minimum": 1,
            "maximum": 10000000,
            "type": "integer",
            "description": "Keep offers whose minimum order quantity is at most this number. Suppliers with no matching offer are left out, and only the matching offers are returned."
          },
          "maxPriceUsd": {
            "title": "Unit price, at most (USD)",
            "minimum": 0.01,
            "maximum": 1000000,
            "type": "number",
            "description": "Keep offers whose lowest unit price is at most this many US dollars. Suppliers with no matching offer are left out, and only the matching offers are returned."
          },
          "maxItems": {
            "title": "Maximum results",
            "minimum": 10,
            "maximum": 100000,
            "type": "integer",
            "description": "Stop after this many rows. Minimum 10.",
            "default": 100
          },
          "proxyConfiguration": {
            "title": "Proxy",
            "type": "object",
            "description": "Leave the proxy off: the actor connects directly, which is what it was tested with and what is fastest. After two refused requests in a row it switches to the Apify datacenter proxy by itself. Alibaba shows a slider page to some connections; the actor does not try to solve it and stops after three refusals in a row.",
            "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}