{ "openapi": "3.0.1", "info": { "title": "Xianyu (Goofish) Item & Seller Scraper", "description": "Scrape Xianyu (Goofish, 闲鱼) items and seller shops without login, cookies or your own proxy. Get price, description, photos, attributes, views, wants and the seller's profile by item link, list up to 240 items of a seller's shop, or collect similar items. Pay per result.", "version": "0.1", "x-build-id": "zzSx2XnX3nqQUhRX9" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/maksim_lazouski~xianyu-goofish-item-seller-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-maksim_lazouski-xianyu-goofish-item-seller-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/maksim_lazouski~xianyu-goofish-item-seller-scraper/runs": { "post": { "operationId": "runs-sync-maksim_lazouski-xianyu-goofish-item-seller-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/maksim_lazouski~xianyu-goofish-item-seller-scraper/run-sync": { "post": { "operationId": "run-sync-maksim_lazouski-xianyu-goofish-item-seller-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": { "items": { "title": "Item links or ids", "type": "array", "description": "Xianyu items to read in full. Each line is a link such as https://www.goofish.com/item?id=777420130180 or just the number from it.", "items": { "type": "string" } }, "sellers": { "title": "Seller links or ids", "type": "array", "description": "Sellers whose profile and item list to read. Each line is a link to the seller's page such as https://www.goofish.com/personal?userId=2214156880408, or just the number from it, or a link to one of the seller's items (https://www.goofish.com/item?id=...): the actor then reads that item to find its seller.", "items": { "type": "string" } }, "maxItemsPerSeller": { "title": "Items per seller", "minimum": 0, "maximum": 240, "type": "integer", "description": "How many items of each seller's list to return, in the order the seller's page shows them. 240 is the most. 0 returns only the seller's profile.", "default": 60 }, "includeSimilar": { "title": "Similar items", "type": "boolean", "description": "For every item in \"Item links or ids\", also return the similar items Xianyu shows under it (up to 30 per item).", "default": false }, "scrapeDetails": { "title": "Open every listed item", "type": "boolean", "description": "Off: one short row per listed item (title, price, pictures, link). On: the actor opens every item of a seller's list and every similar item, and returns the full item row instead.", "default": false }, "maxItems": { "title": "Stop after this many results", "minimum": 1, "type": "integer", "description": "The run stops once it has stored this many rows. Leave empty for no limit." }, "maxConcurrency": { "title": "Read side by side", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many items and sellers are read at the same time, each from its own address. More is faster; the default suits most jobs.", "default": 10 }, "watchName": { "title": "Watch list name", "type": "string", "description": "For runs on a schedule. Give the same name every time: each run then stores only what is new or changed since the last run with that name, marked in the field change, and an item or listed item that is gone is stored once as removed, free. Rows that did not change are not stored and not charged. Similar items are not watched: they come every time. Leave empty to get every row." } } }, "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 } } } } } } } } } }