{
  "openapi": "3.0.1",
  "info": {
    "title": "Alibaba Products Scraper: Price Tiers & Suppliers",
    "description": "Alibaba.com products by keyword or link, with price tiers in US dollars on every row. $1.50 per 1,000 products. MOQ, ratings, Verified and Trade Assurance badges, supplier; product pages optional.",
    "version": "0.1",
    "x-build-id": "LSkgzf30nlMCCtexb"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/luzivanlt~alibaba-products-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-luzivanlt-alibaba-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/luzivanlt~alibaba-products-scraper/runs": {
      "post": {
        "operationId": "runs-sync-luzivanlt-alibaba-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/luzivanlt~alibaba-products-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-luzivanlt-alibaba-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",
        "properties": {
          "searchTerms": {
            "title": "Search terms",
            "type": "array",
            "description": "Words to search Alibaba.com for, one search per line, as you would type them in Alibaba's search box, up to 200 characters each. The filters and sort below apply to them. A link here is refused: paste it under Links. A product found by two searches is saved and charged once. Example: bluetooth speaker",
            "items": {
              "type": "string"
            }
          },
          "startUrls": {
            "title": "Links",
            "type": "array",
            "description": "Alibaba.com search results links (https://www.alibaba.com/trade/search?SearchText=…), showroom links (https://www.alibaba.com/showroom/….html) or product links (https://www.alibaba.com/product-detail/…_<id>.html). A search link keeps the filters and sort you picked on Alibaba and is read from its first page; the filters below do not change it. A product link always comes with its product page's details. Searches are read on www.alibaba.com in English; a search on a language site (spanish.alibaba.com) is refused. Example: https://www.alibaba.com/trade/search?SearchText=yoga+mat&ta=y",
            "items": {
              "type": "string"
            }
          },
          "maxProductsPerSearch": {
            "title": "Max products per search",
            "minimum": 1,
            "maximum": 4800,
            "type": "integer",
            "description": "Stop each search after this many products, in Alibaba's order, from 1 to 4,800 (100 by default). A search ends on its own when Alibaba lists nothing new, or at its 100th page (48 products a page). You pay per product saved ($1.50 per 1,000), so this also caps what each search costs. Example: 500",
            "default": 100
          },
          "includeDetails": {
            "title": "Include product page details",
            "type": "boolean",
            "description": "Also read each product's own page: each option's (SKU) price in US dollars where the product is priced by option, the full attributes table, the option lists, lead times, package size and weight, certificates, videos, the store rating, and the supplier's profile (business type, staff, on-time delivery, response time, six-month revenue and orders, capabilities, contact name and title). One more page per product, so a run takes longer; the price per product stays the same. Off by default.",
            "default": false
          },
          "sortBy": {
            "title": "Sort by",
            "enum": [
              "relevance",
              "sales_volume"
            ],
            "type": "string",
            "description": "The order Alibaba lists the products in, for the search terms above: Relevance (Alibaba's own order, the default) or Sales volume (the products sold most in the last 180 days first). A pasted search link keeps its own order. Example: sales_volume",
            "default": "relevance"
          },
          "tradeAssurance": {
            "title": "Trade Assurance only",
            "type": "boolean",
            "description": "Only products from suppliers that offer Alibaba's Trade Assurance (payment protection for orders paid on Alibaba), for the search terms above. A pasted search link keeps its own filters.",
            "default": false
          },
          "verifiedSupplier": {
            "title": "Verified suppliers only",
            "type": "boolean",
            "description": "Only products from Verified suppliers, whose business was inspected by a third-party company, for the search terms above. A pasted search link keeps its own filters. Off by default.",
            "default": false
          },
          "verifiedProSupplier": {
            "title": "Verified Pro suppliers only",
            "type": "boolean",
            "description": "Only products from Verified Pro suppliers, Alibaba's highest level of supplier checks, for the search terms above. A pasted search link keeps its own filters. Off by default.",
            "default": false
          },
          "guaranteed": {
            "title": "Alibaba Guaranteed only",
            "type": "boolean",
            "description": "Only Alibaba Guaranteed products: a fixed price with shipping included, delivery by a set date and money back if it is late, for the search terms above. A pasted search link keeps its own filters.",
            "default": false
          },
          "minReviewScore": {
            "title": "Minimum supplier rating",
            "enum": [
              "4",
              "4.5",
              "5"
            ],
            "type": "string",
            "description": "Only products from suppliers whose store rating is this high or higher: 4.0 & up, 4.5 & up, or 5.0, for the search terms above. Empty = any rating; a pasted link keeps its own. Example: 4.5"
          },
          "supplierCountry": {
            "title": "Supplier country",
            "type": "string",
            "description": "Only products from suppliers in this country or region, as a two-letter code, for the search terms above. Empty = anywhere. A pasted search link keeps its own filters. Example: VN"
          },
          "minPrice": {
            "title": "Minimum price",
            "minimum": 0,
            "type": "number",
            "description": "Only products priced at or above this, in US dollars, for the search terms above. Leave empty for no lower limit. A pasted search link keeps its own filters. Example: 5"
          },
          "maxPrice": {
            "title": "Maximum price",
            "minimum": 0,
            "type": "number",
            "description": "Only products priced at or below this, in US dollars, for the search terms above. Leave empty for no upper limit. A pasted search link keeps its own filters. Example: 20"
          },
          "maxMoq": {
            "title": "Maximum minimum order",
            "minimum": 1,
            "type": "integer",
            "description": "Only products you can order this many of or fewer (a minimum order quantity of at most this), for the search terms above. Empty = any; a pasted search link keeps its own filters. Example: 10"
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}