{
  "openapi": "3.0.1",
  "info": {
    "title": "1688 Product Details Scraper — SKUs, Stock, Supplier · $4/1k",
    "description": "Get 1688 product details by link, offer ID, search URL or keyword: price tiers in CNY and USD, MOQ, stock, units sold, every SKU with stock and image, specs, reviews, shipping and the supplier profile, with English copies. Schedule a named monitor for new listings only. $4 per 1,000 products.",
    "version": "0.0",
    "x-build-id": "23Rjl3G7i34qCJxc2"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/memo23~1688-product-details-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-memo23-1688-product-details-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/memo23~1688-product-details-scraper/runs": {
      "post": {
        "operationId": "runs-sync-memo23-1688-product-details-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/memo23~1688-product-details-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-memo23-1688-product-details-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": {
          "productUrls": {
            "title": "Product URLs, search links or offer IDs",
            "type": "array",
            "description": "1688 product pages, one per line: https://detail.1688.com/offer/926325393607.html, the mobile m.1688.com/offer/... link, or just the offer ID. A 1688 search results link works too: its top products are looked up, up to \"Products per search\". Duplicates are removed before anything is looked up.",
            "items": {
              "type": "string"
            }
          },
          "startUrls": {
            "title": "Start URLs (same as product URLs)",
            "type": "array",
            "description": "Optional. Same as Product URLs above: 1688 product pages, search-results links or offer IDs. The Console, integrations and MCP clients send this field. Paste here or there; both are read and duplicates are dropped.",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "maxItems": {
            "title": "Max products",
            "minimum": 1,
            "type": "integer",
            "description": "Stop after this many products. Each product is one charged row; products that cannot be read are never charged.",
            "default": 1000
          },
          "searchQueries": {
            "title": "Search keywords",
            "type": "array",
            "description": "Optional. Keywords to search on 1688, e.g. 蓝牙耳机 or yoga mat. Each keyword returns its best-matching products with full details, up to \"Products per search\". English keywords are translated to Chinese first, since 1688 matches Chinese far better.",
            "items": {
              "type": "string"
            }
          },
          "maxProductsPerSearch": {
            "title": "Products per search",
            "minimum": 1,
            "maximum": 100,
            "type": "integer",
            "description": "How many products each keyword or pasted search link adds (best matches first, up to 100).",
            "default": 20
          },
          "monitoringStoreName": {
            "title": "Only new products (monitor name)",
            "type": "string",
            "description": "Optional. Give the monitor a name (e.g. yoga-mats) and every later run with the same name skips products it already delivered, so they are neither returned nor charged again. Schedule it with a keyword to get only newly listed products. Leave empty for a normal run."
          },
          "translateKeywords": {
            "title": "Translate keywords to Chinese",
            "type": "boolean",
            "description": "Translate English keywords to Chinese before searching. Model numbers (e.g. ESP32-C3) are kept as typed.",
            "default": true
          },
          "translateToEnglish": {
            "title": "Add English copies",
            "type": "boolean",
            "description": "Adds English next to the Chinese original for the title, category, specs, SKU options, review tags, services and supplier name. The Chinese text is always kept.",
            "default": true
          },
          "includeSupplierProfile": {
            "title": "Supplier factory profile",
            "type": "boolean",
            "description": "Adds supplierProfile to each row: year founded, factory area, staff, production lines, equipment, patents, certificates, the company that audited the factory, OEM minimum order, export markets, response and on-time-delivery rates, rating and followers. One extra read per supplier, shared across that supplier's products, at no extra charge. Suppliers with no public profile, or whose shop link does not name them, get an empty profile.",
            "default": true
          },
          "maxConcurrency": {
            "title": "Products at a time",
            "minimum": 1,
            "maximum": 50,
            "type": "integer",
            "description": "How many products are looked up in parallel. Each takes about a minute and a half, so 20 at a time handles roughly 800 products an hour.",
            "default": 20
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}