{
  "openapi": "3.0.1",
  "info": {
    "title": "Alibaba Product Scraper",
    "description": "Input keywords, country filters, price, MOQ and max items to scrape unlimited Alibaba product listings. Outputs comprehensive bulk product data(100+ fields): titles, prices, specs, images, supplier details, customization options, payment methods & delivery rates.",
    "version": "0.0",
    "x-build-id": "5I02ibYLhkYWssC5A"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/codenest~alibaba-product-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-codenest-alibaba-product-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/codenest~alibaba-product-scraper/runs": {
      "post": {
        "operationId": "runs-sync-codenest-alibaba-product-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/codenest~alibaba-product-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-codenest-alibaba-product-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": {
          "keywords": {
            "title": "🔑 Keywords (e.g. laptop, solar panel, battery)",
            "type": "array",
            "description": "Enter one or more search keywords (each line is one independent product search).\n\nThe scraper automatically constructs the exact Alibaba Countrysearch URL with your chosen filters:\n  'laptop' + 'India' + filters ➡️ 'https://www.alibaba.com/countrysearch/IN/laptop.html?readyToShip=y&assessmentCompany=ASS&moqf=MOQF&moqt=MOQT50&ta=y&pricef=500&pricet=700'\n\nAnd crawls the listings to scrape complete product details, tiered wholesale prices, MOQ, specifications, images, and supplier information.",
            "items": {
              "type": "string"
            },
            "default": [
              "laptop"
            ]
          },
          "country": {
            "title": "🌍 Country / Region (Name or 2-letter Code)",
            "type": "string",
            "description": "Enter the supplier country name or 2-letter ISO country code for countrysearch URL generation:\n• India or IN\n• China or CN (Default)\n• Vietnam or VN\n• Pakistan or PK\n• Turkey or TR\n• Bangladesh or BD\n• United States or US\n• Germany or DE, Italy or IT, Japan or JP, etc.",
            "default": "IN"
          },
          "readyToShip": {
            "title": "⚡ Ready to Ship Only (readyToShip=y)",
            "type": "boolean",
            "description": "Filter in-stock products with dispatch within 15 days (ideal for e-commerce sellers & dropshippers). When enabled, appends 'readyToShip=y' to the URL.",
            "default": false
          },
          "verifiedSupplier": {
            "title": "🛡️ Verified Suppliers Only (assessmentCompany=ASS)",
            "type": "boolean",
            "description": "Filter products from verified manufacturers & factories inspected by third-party certifiers (TÜV, SGS, etc.). When enabled, appends 'assessmentCompany=ASS' to the URL.",
            "default": false
          },
          "tradeAssurance": {
            "title": "🔒 Trade Assurance Only (ta=y)",
            "type": "boolean",
            "description": "Filter products protected by Alibaba Trade Assurance payment and order protection. When enabled, appends 'ta=y' to the URL.",
            "default": false
          },
          "paidSample": {
            "title": "🧪 Paid / Available Samples (sample=y)",
            "type": "boolean",
            "description": "Filter products offering sample orders before placing large wholesale bulk orders. When enabled, appends 'sample=y' to the URL.",
            "default": false
          },
          "minMoq": {
            "title": "📦 Minimum Order Quantity Floor (moqf)",
            "minimum": 1,
            "type": "integer",
            "description": "Minimum MOQ floor. When set (e.g. 10), appends 'moqf=MOQF10' to the search URL. Leave blank if not filtering by minimum MOQ."
          },
          "maxMoq": {
            "title": "📦 Maximum Order Quantity Ceiling (moqt)",
            "minimum": 1,
            "type": "integer",
            "description": "Maximum MOQ ceiling. When set (e.g. 50), appends 'moqf=MOQF&moqt=MOQT50' to the search URL to filter out high-MOQ manufacturers. Leave blank to disable."
          },
          "minPrice": {
            "title": "💵 Minimum Price (USD - pricef)",
            "minimum": 0,
            "type": "number",
            "description": "Minimum unit price in USD. When set (e.g. 500), appends 'pricef=500' to the search URL. Leave blank to disable."
          },
          "maxPrice": {
            "title": "💵 Maximum Price (USD - pricet)",
            "minimum": 0,
            "type": "number",
            "description": "Maximum unit price in USD. When set (e.g. 700), appends 'pricet=700' to the search URL. Leave blank to disable."
          },
          "urls": {
            "title": "🔗 Direct Alibaba URLs (Optional)",
            "type": "array",
            "description": "Optionally enter direct Alibaba.com URLs to scrape (each line is one URL).\n\nSupported URL types:\n• Countrysearch listing pages (e.g. 'https://www.alibaba.com/countrysearch/CN/eve-lifepo4-100ah.html')\n• Filtered Countrysearch pages (e.g. 'https://www.alibaba.com/countrysearch/IN/laptop.html?readyToShip=y&ta=y')\n• Trade search listing pages (e.g. 'https://www.alibaba.com/trade/search?SearchText=...')\n• Direct product detail pages (e.g. 'https://www.alibaba.com/product-detail/...html')",
            "items": {
              "type": "string"
            },
            "default": []
          },
          "maxItems": {
            "title": "Maximum Products Limit (Per Keyword/URL)",
            "minimum": 1,
            "type": "integer",
            "description": "Maximum number of products to scrape per keyword search or listing URL. Default is 20.",
            "default": 20
          },
          "maxConcurrency": {
            "title": "Max Concurrency",
            "minimum": 1,
            "maximum": 10,
            "type": "integer",
            "description": "Maximum number of product pages to scrape in parallel. Lower values are safer against rate-limiting. Default is 3.",
            "default": 3
          },
          "minDelayMs": {
            "title": "Minimum Delay (ms)",
            "minimum": 200,
            "type": "integer",
            "description": "Minimum random delay in milliseconds between requests. Default is 1000ms.",
            "default": 1000
          },
          "maxDelayMs": {
            "title": "Maximum Delay (ms)",
            "minimum": 500,
            "type": "integer",
            "description": "Maximum random delay in milliseconds between requests. Default is 3000ms.",
            "default": 3000
          },
          "proxyConfiguration": {
            "title": "Proxy Configuration",
            "type": "object",
            "description": "Select Apify Proxy (Residential recommended) or provide custom proxy URLs for reliable scraping.",
            "default": {
              "useApifyProxy": true,
              "apifyProxyGroups": [
                "RESIDENTIAL"
              ]
            }
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}