{
  "openapi": "3.0.1",
  "info": {
    "title": "1688 Image Search — Find Suppliers by Photo · $0.35/1k",
    "description": "Search 1688.com by photo: paste an Amazon, AliExpress or Shopify product picture and get the factories and wholesalers selling it, with price, units sold, supplier, location, factory badges and English titles, plus tier pricing and MOQ on request. $0.35 per 1,000 matches. No login.",
    "version": "1.0",
    "x-build-id": "yfjUTnyWfoSOCYIVV"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/memo23~1688-image-search-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-memo23-1688-image-search-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-image-search-scraper/runs": {
      "post": {
        "operationId": "runs-sync-memo23-1688-image-search-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-image-search-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-memo23-1688-image-search-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": [
          "imageUrls"
        ],
        "properties": {
          "imageUrls": {
            "title": "Photo links",
            "type": "array",
            "description": "Links to product photos (.jpg, .png, .webp, up to 5 MB). Each photo returns the 1688 offers that look like it: usually the same product from several factories and wholesalers first, then close variants. Every row carries its photo in sourceImageUrl.",
            "items": {
              "type": "string"
            }
          },
          "maxResultsPerImage": {
            "title": "Max offers per photo",
            "minimum": 1,
            "maximum": 2000,
            "type": "integer",
            "description": "How many matching offers to return for each photo, best match first. The closest matches come first, so 20 to 50 is usually enough to find the factory.",
            "default": 50
          },
          "scrapeDetails": {
            "title": "Offer page details (tier pricing, MOQ, attributes, gallery, stock)",
            "type": "boolean",
            "description": "Open each matching offer's page to add the quantity-break tier pricing, the MOQ and unit, the full product attribute map, the complete image gallery, delivery terms, the category id, units in stock, exact units sold, the mixed-batch rule (混批), one-piece dropshipping (一件代发), the product video and the buyer-protection services. Billed as one Product details event per delivered offer that carries them.",
            "default": false
          },
          "includeSkuDetails": {
            "title": "Include SKU variants",
            "type": "boolean",
            "description": "Add every offer's variant matrix: variantAxes (颜色, 尺码, 型号 and so on, with option images) and variants, one entry per SKU with skuId, its own price or promotional price where it has one, and stock. If the variants cannot be read, the row is still delivered without them.",
            "default": false
          },
          "includeDescription": {
            "title": "Include the long description",
            "type": "boolean",
            "description": "Add the seller's long description (详情) as plain text (descriptionText) and the images inside it (descriptionImages). It lives on the offer page, so this turns on offer page details.",
            "default": false
          },
          "translateToEnglish": {
            "title": "English translation",
            "type": "boolean",
            "description": "Add titleEn and supplierNameEn, machine-translated from the Chinese. The Chinese originals stay in title and supplierName. On by default; turn it off if you only want Chinese.",
            "default": true
          },
          "priceMin": {
            "title": "Min unit price (CNY)",
            "minimum": 0,
            "type": "integer",
            "description": "Keep only offers priced at or above this, in yuan. Offers that show no price are kept."
          },
          "priceMax": {
            "title": "Max unit price (CNY)",
            "minimum": 0,
            "type": "integer",
            "description": "Keep only offers priced at or below this, in yuan."
          },
          "maxMoq": {
            "title": "Max MOQ",
            "minimum": 1,
            "type": "integer",
            "description": "Keep only offers whose minimum order quantity is at or below this. Photo matches carry their MOQ on the offer page only, so this filter works with Offer page details on; without them every offer is kept."
          },
          "locations": {
            "title": "Supplier locations",
            "type": "array",
            "description": "Keep only suppliers whose location contains one of these. A province matches every city in it, e.g. 广东 matches 广东深圳市 and 广东佛山市. Leave empty to keep every supplier.",
            "items": {
              "type": "string"
            }
          },
          "manufacturersOnly": {
            "title": "Manufacturers only",
            "type": "boolean",
            "description": "Keep only offers from manufacturers: suppliers listed as 生产加工 (production), super factories (超级工厂) and on-site inspected factories. Traders and wholesalers are dropped before billing.",
            "default": false
          },
          "excludeAds": {
            "title": "Skip sponsored offers",
            "type": "boolean",
            "description": "Drop sponsored placements. Those rows never reach the dataset and are not billed.",
            "default": false
          },
          "excludeKeywords": {
            "title": "Exclude words in title",
            "type": "array",
            "description": "Drop offers whose title contains any of these words, Chinese or English, case-insensitive. Dropped offers are not billed.",
            "items": {
              "type": "string"
            }
          },
          "includeSupplierList": {
            "title": "Supplier list",
            "type": "boolean",
            "description": "After the offers, return one row per supplier behind them (type: supplier): name, location, manufacturer or trader, factory badges, years on 1688, repurchase rate, service scores, how many of the run's offers it has, its lowest price and up to 5 sample offers. Billed per row like an offer.",
            "default": false
          },
          "maxItems": {
            "title": "Max offers in total",
            "minimum": 1,
            "type": "integer",
            "description": "Cap on the offers returned across all photos together. Each photo still stops at Max offers per photo.",
            "default": 500
          },
          "proxy": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "Optional. Runs on paid Apify plans use the actor's own connection and ignore this setting. On the free plan you can set your own residential proxy here."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}