{ "openapi": "3.0.1", "info": { "title": "1688 Image Search", "description": "Search 1688.com by photo: paste product image links from Amazon, AliExpress, Shopify or any site and get the matching 1688 wholesale offers with price in CNY and USD, units sold, repeat buyers and the supplier. Up to 600 matches a photo, no login, pay per photo.", "version": "0.1", "x-build-id": "rNg3l16sV8ap3BSWx" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/maksim_lazouski~1688-image-search/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-maksim_lazouski-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/maksim_lazouski~1688-image-search/runs": { "post": { "operationId": "runs-sync-maksim_lazouski-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/maksim_lazouski~1688-image-search/run-sync": { "post": { "operationId": "run-sync-maksim_lazouski-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", "required": [ "images" ], "properties": { "images": { "title": "Photo links", "type": "array", "description": "Links of product photos, one per line: a picture from Amazon, AliExpress, Shopify, 1688 or any other site, or a data:image link. JPEG, PNG, WebP and GIF are taken. Each photo is searched on 1688 on its own.", "items": { "type": "string" } }, "maxPagesPerImage": { "title": "Pages of matches per photo", "minimum": 1, "maximum": 10, "type": "integer", "description": "1688 shows the offers that look like a photo 60 to a page, best matches first. 1 gives the first 60; each page more gives 60 more, up to 10 pages (600). An offer 1688 shows twice for one photo is returned once.", "default": 1 }, "scrapeDetails": { "title": "Open every match", "type": "boolean", "description": "Off: one row per match (title, price, sales, supplier, link). On: the actor opens the offer page of every match and returns the full offer row instead: price by quantity, every variant with stock, the supplier card, ratings and dropshipping terms.", "default": false }, "includeExtras": { "title": "Supplier card, ratings, dropshipping terms and description", "type": "boolean", "description": "With \"Open every match\": adds to every offer the blocks its page loads beside the main data. Turn off to get only what the offer page itself carries.", "default": true }, "translateTitles": { "title": "English titles (add-on)", "type": "boolean", "description": "Adds title_en to every row: an English machine translation of the Chinese title. Charged as one more event per row that gets an English title; rows without one are not charged for it.", "default": false }, "maxItems": { "title": "Stop after this many rows", "minimum": 1, "type": "integer", "description": "The run stops once it has stored this many rows. Leave empty for no limit." }, "maxConcurrency": { "title": "Photos read side by side", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many photos (and, with \"Open every match\", offers) are read at the same time, each from its own address. More is faster; the default suits most jobs.", "default": 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 } } } } } } } } } }