{ "openapi": "3.0.1", "info": { "title": "Goofish Search Scraper — 闲鱼 Keyword Listings", "description": "Search Goofish (闲鱼/Xianyu) by keyword or search URL. Returns indexed public listings: title, price, item URL, snippet. Cookieless Google discovery, no login. MCP-ready.", "version": "0.1", "x-build-id": "BCMpl2JPpnkPEqmOE" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/khadinakbar~goofish-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-khadinakbar-goofish-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/khadinakbar~goofish-search-scraper/runs": { "post": { "operationId": "runs-sync-khadinakbar-goofish-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/khadinakbar~goofish-search-scraper/run-sync": { "post": { "operationId": "run-sync-khadinakbar-goofish-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": [ "keywords" ], "properties": { "keywords": { "title": "Search keywords", "minItems": 1, "maxItems": 10, "type": "array", "description": "Keywords to search on Goofish, such as iPhone 15 or 小米. Chinese terms usually match more listings than pinyin. Accepts one or more phrases, up to 10 unique values. This is not an item URL and not a seller profile.", "items": { "type": "string" } }, "searchUrls": { "title": "Goofish search URLs", "uniqueItems": true, "type": "array", "description": "Optional Goofish search pages whose q= keyword should be scraped, for example https://www.goofish.com/search?q=iPhone%2015. Keywords are extracted from those URLs and merged with the keywords field. Item or seller URLs are rejected; send those to Goofish Scraper instead.", "items": { "type": "string" } }, "maxResults": { "title": "Max listings", "minimum": 1, "maximum": 50, "type": "integer", "description": "Hard cap on unique Goofish item listings saved and billed this run. Default 20. Prefill is 5 so quality tests stay short. Google's public index is much smaller than live 闲鱼 search, so values above 50 are not useful.", "default": 20 }, "maxPagesPerKeyword": { "title": "Max Google pages per keyword", "minimum": 1, "maximum": 3, "type": "integer", "description": "How many Google result pages to request per keyword after the first page. Each page is about 10 organic results. Default 2. Raise only when a keyword still has unused index coverage under maxResults.", "default": 2 }, "priceMin": { "title": "Min price (CNY)", "minimum": 0, "type": "integer", "description": "Keep only listings whose parsed asking price is at least this amount in yuan. Listings with no visible price in the Google title or snippet are dropped when this filter is set. Leave empty for no lower bound." }, "priceMax": { "title": "Max price (CNY)", "minimum": 0, "type": "integer", "description": "Keep only listings whose parsed asking price is at most this amount in yuan. Listings with no visible price in the Google title or snippet are dropped when this filter is set. Leave empty for no upper bound." }, "condition": { "title": "Condition filter", "enum": [ "all", "used", "new" ], "type": "string", "description": "Optional condition filter applied after Google returns a listing. all keeps every indexed item. new keeps titles that mention 全新 or brand new. used keeps 99新, 闲置, and similar used cues. This is inferred from public text, not Goofish's native filter chips.", "default": "all" } } }, "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 } } }, "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 } } } } } } } } } }