1688 & Taobao Reverse Image Search | Find Products by Photo
Under maintenancePricing
from $3.25 / 1,000 successful photo searches
Search 1688 and Taobao by product photo. Compare prices, minimum orders, sellers and multi-photo matches; filter and export product listings.
You can access the 1688 & Taobao Reverse Image Search | Find Products by Photo programmatically from your own applications by using the Apify API. You can also choose the language preference from below. To use the Apify API, you’ll need an Apify account and your API token, found in API & Integrations in Apify Console.
{ "openapi": "3.0.1", "info": { "version": "0.3", "x-build-id": "Dote3aNct19Ptaz5y" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/apivault_labs~1688-image-search/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-apivault_labs-1688-image-search", "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/apivault_labs~1688-image-search/runs": { "post": { "operationId": "runs-sync-apivault_labs-1688-image-search", "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/apivault_labs~1688-image-search/run-sync": { "post": { "operationId": "run-sync-apivault_labs-1688-image-search", "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": { "marketplace": { "title": "Where to search", "enum": [ "1688", "taobao", "both" ], "type": "string", "description": "Choose 1688, Taobao, or both. Searching both uses more time and resources.", "default": "1688" }, "imageUrl": { "title": "Product photo link (easiest)", "type": "string", "description": "Paste a direct public HTTPS link to a JPG, PNG, WebP, or GIF image, not a product page. You can combine a link with uploads; all provided photos are searched. Add 1–3 photos total." }, "additionalImageUrls": { "title": "More photos of the same product", "maxItems": 3, "uniqueItems": true, "type": "array", "description": "Optional front, side, or detail views. Use no more than three photos total. A second view can help find recurring listings.", "items": { "type": "string" } }, "uploadedImages": { "title": "Upload product photos", "maxItems": 3, "type": "array", "description": "Add JPG, PNG, WebP, or GIF files, up to 5 MB each. If Apify asks where to save them, choose a storage in the upload dialog; no second selection is needed.", "items": { "type": "string" } }, "imageStoreId": { "title": "Previously selected photo storage", "type": "string", "description": "Kept for existing saved tasks; new uploads do not need this field." }, "imagesBase64": { "title": "Encoded photos (API users)", "maxItems": 3, "type": "array", "description": "Optional encoded JPG, PNG, WebP, or GIF images, up to 5 MB each after decoding. Avoid including private or sensitive photos in run input.", "items": { "type": "string" } }, "maxResults": { "title": "Results to request per photo and marketplace", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Request 1–5,000 candidates. The actual number of distinct listings can be lower, especially for deep searches. Larger searches take longer and use more resources.", "default": 10 }, "sortBy": { "title": "Sort products", "enum": [ "relevance", "price_asc", "price_desc" ], "type": "string", "description": "Keep photo-match relevance order, or sort by listed price. Listings without a price appear last.", "default": "relevance" }, "minMatchingPhotos": { "title": "Found in at least this many photos", "minimum": 1, "maximum": 3, "type": "integer", "description": "For multi-photo searches, keep only offers or visible cards found in at least this many of your photos. Must not exceed the number of photos provided.", "default": 1 }, "minPriceCny": { "title": "Minimum listed price (CNY)", "minimum": 0, "maximum": 1000000, "type": "number", "description": "Optional lower bound for the listed product price. Listings without a price are excluded when a price filter is set." }, "maxPriceCny": { "title": "Maximum listed price (CNY)", "minimum": 0, "maximum": 1000000, "type": "number", "description": "Optional upper bound for the listed product price. This is the listed price, not an all-in landed cost." }, "maxMinimumOrderQuantity": { "title": "Largest acceptable minimum order (1688)", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Optional: keep 1688 listings only when their reported minimum order is at or below this quantity. 1688 listings without a reported minimum order are excluded. Taobao listings remain available because this field is not provided for them." } } }, "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 } } } } } } } } }}OpenAPI is a standard for designing and describing RESTful APIs, allowing developers to define API structure, endpoints, and data formats in a machine-readable way. It simplifies API development, integration, and documentation.
OpenAPI is effective when used with AI agents and GPTs by standardizing how these systems interact with various APIs, for reliable integrations and efficient communication.
By defining machine-readable API specifications, OpenAPI allows AI models like GPTs to understand and use varied data sources, improving accuracy. This accelerates development, reduces errors, and provides context-aware responses, making OpenAPI a core component for AI applications.
You can download the OpenAPI definitions for 1688 & Taobao Reverse Image Search | Find Products by Photo from the options below:
If you’d like to learn more about how OpenAPI powers GPTs, read our blog post.
You can also check out our other API clients: