{
"openapi": "3.0.1",
"info": {
"title": "Goofish Scraper 闲鱼 Xianyu (Idlefish) - Listings + Sellers",
"description": "Extract Goofish 闲鱼 (Xianyu/Idlefish) listings by keyword. 150+ output fields per result: price, Zhima credit, specs, images, shipping, category labels, service guarantees, C2C posting metadata, and seller profile details. Up to 1,500 results per keyword. Chinese or English search terms. JSON output.",
"version": "0.0",
"x-build-id": "juOWPDwRUZSqdO2Ug"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/zen-studio~goofish-xianyu-search-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-zen-studio-goofish-xianyu-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/zen-studio~goofish-xianyu-search-scraper/runs": {
"post": {
"operationId": "runs-sync-zen-studio-goofish-xianyu-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/zen-studio~goofish-xianyu-search-scraper/run-sync": {
"post": {
"operationId": "run-sync-zen-studio-goofish-xianyu-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",
"properties": {
"keyword": {
"title": "🔎 Keyword / 关键词 (ignored if Search URLs below are set)",
"type": "string",
"description": "Search term used by Goofish (闲鱼) search. Match the language sellers actually use in their listings.
✅ Works well: iPhone 15 Pro, Nintendo Switch, 手机 (phone), 乐高 (Lego), 华南金牌 (HUANANZHI motherboards), 小米 (Xiaomi).
⚠️ Pinyin and Latin spellings of Chinese brands return 0 results. Goofish does not transliterate — use 华南金牌, not huananzhi; 小米, not xiaomi; 美的, not midea.
⚠️ Precedence: if Search URLs below is filled, this keyword field is ignored — the keyword is extracted from the URLs instead."
},
"searchUrls": {
"title": "Search URLs / 搜索链接 (overrides the Keyword field above)",
"type": "array",
"description": "Paste one or more Goofish (闲鱼) search URLs.
Supported: https://www.goofish.com/search?q=<keyword>
⚠️ Precedence: when this field is non-empty, it overrides the Keyword field above — the keyword is extracted from the URLs.
All URLs in a run must share the same keyword. Item URLs (/item?id=...) are not supported here — use the Goofish Detail Scraper for known item URLs or IDs.",
"items": {
"type": "string"
}
},
"maxItems": {
"title": "Max items / 最大数量",
"minimum": 1,
"maximum": 20000,
"type": "integer",
"description": "How many listings to return per run.
Goofish 闲鱼 shows about 1,500 results for a single search. Ask for more and the Actor keeps going by searching the same keyword across separate price ranges, which reaches listings the first 1,500 never include — including newer ones, since that first set is not strictly newest-first.
Start with a small number (e.g. 20) to preview the output shape before committing budget. Every listing is billed, so this setting is your cost control.",
"default": 100
},
"detailLevel": {
"title": "Detail level / 详情级别",
"enum": [
"full",
"summary"
],
"type": "string",
"description": "Full (default): every listing is enriched with its complete detail page — full description, all images, condition, and seller profile/stats.
Summary: returns the core listing fields from the results page only — id, title, price, listing URL, post time, location, seller name, and thumbnail — and runs much faster because it doesn't open each listing's detail page. Pick Summary when you just need the listings quickly; pick Full when you need descriptions, every image, or seller details.",
"default": "full"
},
"regionIds": {
"title": "Region / 地区",
"type": "array",
"description": "Restrict results to specific Chinese administrative regions. Pick a province for broad coverage (e.g. Guangdong 广东) or a specific city for tighter scope (e.g. Shenzhen 深圳). Select multiple to stack as OR.
Leave empty to search nationwide.",
"items": {
"type": "string",
"enum": [
"110000",
"110100",
"120000",
"120100",
"130000",
"130100",
"130200",
"130300",
"130400",
"130500",
"130600",
"130700",
"130800",
"130900",
"131000",
"131100",
"140000",
"140100",
"140200",
"140300",
"140400",
"140500",
"140600",
"140700",
"140800",
"140900",
"141000",
"141100",
"150000",
"150100",
"150200",
"150300",
"150400",
"150500",
"150600",
"150700",
"150800",
"150900",
"152200",
"152500",
"152900",
"210000",
"210100",
"210200",
"210300",
"210400",
"210500",
"210600",
"210700",
"210800",
"210900",
"211000",
"211100",
"211200",
"211300",
"211400",
"220000",
"220100",
"220200",
"220300",
"220400",
"220500",
"220600",
"220700",
"220800",
"222400",
"230000",
"230100",
"230200",
"230300",
"230400",
"230500",
"230600",
"230700",
"230800",
"230900",
"231000",
"231100",
"231200",
"232700",
"310000",
"310100",
"320000",
"320100",
"320200",
"320300",
"320400",
"320500",
"320600",
"320700",
"320800",
"320900",
"321000",
"321100",
"321200",
"321300",
"330000",
"330100",
"330200",
"330300",
"330400",
"330500",
"330600",
"330700",
"330800",
"330900",
"331000",
"331100",
"340000",
"340100",
"340200",
"340300",
"340400",
"340500",
"340600",
"340700",
"340800",
"341000",
"341100",
"341200",
"341300",
"341500",
"341600",
"341700",
"341800",
"350000",
"350100",
"350200",
"350300",
"350400",
"350500",
"350600",
"350700",
"350800",
"350900",
"360000",
"360100",
"360200",
"360300",
"360400",
"360500",
"360600",
"360700",
"360800",
"360900",
"361000",
"361100",
"370000",
"370100",
"370200",
"370300",
"370400",
"370500",
"370600",
"370700",
"370800",
"370900",
"371000",
"371100",
"371300",
"371400",
"371500",
"371600",
"371700",
"410000",
"410100",
"410200",
"410300",
"410400",
"410500",
"410600",
"410700",
"410800",
"410900",
"411000",
"411100",
"411200",
"411300",
"411400",
"411500",
"411600",
"411700",
"419001",
"420000",
"420100",
"420200",
"420300",
"420500",
"420600",
"420700",
"420800",
"420900",
"421000",
"421100",
"421200",
"421300",
"422800",
"429004",
"429005",
"429006",
"429021",
"430000",
"430100",
"430200",
"430300",
"430400",
"430500",
"430600",
"430700",
"430800",
"430900",
"431000",
"431100",
"431200",
"431300",
"433100",
"440000",
"440100",
"440200",
"440300",
"440400",
"440500",
"440600",
"440700",
"440800",
"440900",
"441200",
"441300",
"441400",
"441500",
"441600",
"441700",
"441800",
"441900",
"442000",
"445100",
"445200",
"445300",
"450000",
"450100",
"450200",
"450300",
"450400",
"450500",
"450600",
"450700",
"450800",
"450900",
"451000",
"451100",
"451200",
"451300",
"451400",
"460000",
"460100",
"460200",
"460300",
"460400",
"469001",
"469002",
"469005",
"469006",
"469007",
"469021",
"469022",
"469023",
"469024",
"469025",
"469026",
"469027",
"469028",
"469029",
"469030",
"500000",
"500100",
"510000",
"510100",
"510300",
"510400",
"510500",
"510600",
"510700",
"510800",
"510900",
"511000",
"511100",
"511300",
"511400",
"511500",
"511600",
"511700",
"511800",
"511900",
"512000",
"513200",
"513300",
"513400",
"520000",
"520100",
"520200",
"520300",
"520400",
"520500",
"520600",
"522300",
"522600",
"522700",
"530000",
"530100",
"530300",
"530400",
"530500",
"530600",
"530700",
"530800",
"530900",
"532300",
"532500",
"532600",
"532800",
"532900",
"533100",
"533300",
"533400",
"540000",
"540100",
"540200",
"540300",
"540400",
"540500",
"540600",
"542500",
"610000",
"610100",
"610200",
"610300",
"610400",
"610500",
"610600",
"610700",
"610800",
"610900",
"611000",
"620000",
"620100",
"620200",
"620300",
"620400",
"620500",
"620600",
"620700",
"620800",
"620900",
"621000",
"621100",
"621200",
"622900",
"623000",
"630000",
"630100",
"630200",
"632200",
"632300",
"632500",
"632600",
"632700",
"632800",
"640000",
"640100",
"640200",
"640300",
"640400",
"640500",
"650000",
"650100",
"650200",
"650400",
"650500",
"652300",
"652700",
"652800",
"652900",
"653000",
"653100",
"653200",
"654000",
"654200",
"654300",
"659001",
"659002",
"659003",
"659004",
"659005",
"659006",
"659007",
"659008",
"659009",
"659010",
"659011",
"710000",
"710100",
"710200",
"710300",
"710400",
"710500",
"710600",
"710700",
"710800",
"710900",
"711100",
"711200",
"711300",
"711400",
"711500",
"711700",
"711900",
"712100",
"712400",
"712500",
"712600",
"712700",
"712800",
"810000",
"810100",
"820000",
"820100"
],
"enumTitles": [
"北京 Beijing (Province)",
"北京 Beijing · City",
"天津 Tianjin (Province)",
"天津 Tianjin · City",
"河北 Hebei (Province)",
"石家庄 · 河北 Hebei",
"唐山 · 河北 Hebei",
"秦皇岛 · 河北 Hebei",
"邯郸 · 河北 Hebei",
"邢台 · 河北 Hebei",
"保定 · 河北 Hebei",
"张家口 · 河北 Hebei",
"承德 · 河北 Hebei",
"沧州 · 河北 Hebei",
"廊坊 · 河北 Hebei",
"衡水 · 河北 Hebei",
"山西 Shanxi (Province)",
"太原 · 山西 Shanxi",
"大同 · 山西 Shanxi",
"阳泉 · 山西 Shanxi",
"长治 · 山西 Shanxi",
"晋城 · 山西 Shanxi",
"朔州 · 山西 Shanxi",
"晋中 · 山西 Shanxi",
"运城 · 山西 Shanxi",
"忻州 · 山西 Shanxi",
"临汾 · 山西 Shanxi",
"吕梁 · 山西 Shanxi",
"内蒙古 Inner Mongolia (Province)",
"呼和浩特 · 内蒙古 Inner Mongolia",
"包头 · 内蒙古 Inner Mongolia",
"乌海 · 内蒙古 Inner Mongolia",
"赤峰 · 内蒙古 Inner Mongolia",
"通辽 · 内蒙古 Inner Mongolia",
"鄂尔多斯 · 内蒙古 Inner Mongolia",
"呼伦贝尔 · 内蒙古 Inner Mongolia",
"巴彦淖尔 · 内蒙古 Inner Mongolia",
"乌兰察布 · 内蒙古 Inner Mongolia",
"兴安 · 内蒙古 Inner Mongolia",
"锡林郭勒 · 内蒙古 Inner Mongolia",
"阿拉善 · 内蒙古 Inner Mongolia",
"辽宁 Liaoning (Province)",
"沈阳 · 辽宁 Liaoning",
"大连 · 辽宁 Liaoning",
"鞍山 · 辽宁 Liaoning",
"抚顺 · 辽宁 Liaoning",
"本溪 · 辽宁 Liaoning",
"丹东 · 辽宁 Liaoning",
"锦州 · 辽宁 Liaoning",
"营口 · 辽宁 Liaoning",
"阜新 · 辽宁 Liaoning",
"辽阳 · 辽宁 Liaoning",
"盘锦 · 辽宁 Liaoning",
"铁岭 · 辽宁 Liaoning",
"朝阳 · 辽宁 Liaoning",
"葫芦岛 · 辽宁 Liaoning",
"吉林 Jilin (Province)",
"长春 · 吉林 Jilin",
"吉林 Jilin · City",
"四平 · 吉林 Jilin",
"辽源 · 吉林 Jilin",
"通化 · 吉林 Jilin",
"白山 · 吉林 Jilin",
"松原 · 吉林 Jilin",
"白城 · 吉林 Jilin",
"延边朝鲜族 · 吉林 Jilin",
"黑龙江 Heilongjiang (Province)",
"哈尔滨 · 黑龙江 Heilongjiang",
"齐齐哈尔 · 黑龙江 Heilongjiang",
"鸡西 · 黑龙江 Heilongjiang",
"鹤岗 · 黑龙江 Heilongjiang",
"双鸭山 · 黑龙江 Heilongjiang",
"大庆 · 黑龙江 Heilongjiang",
"伊春 · 黑龙江 Heilongjiang",
"佳木斯 · 黑龙江 Heilongjiang",
"七台河 · 黑龙江 Heilongjiang",
"牡丹江 · 黑龙江 Heilongjiang",
"黑河 · 黑龙江 Heilongjiang",
"绥化 · 黑龙江 Heilongjiang",
"大兴安岭 · 黑龙江 Heilongjiang",
"上海 Shanghai (Province)",
"上海 Shanghai · City",
"江苏 Jiangsu (Province)",
"南京 · 江苏 Jiangsu",
"无锡 · 江苏 Jiangsu",
"徐州 · 江苏 Jiangsu",
"常州 · 江苏 Jiangsu",
"苏州 · 江苏 Jiangsu",
"南通 · 江苏 Jiangsu",
"连云港 · 江苏 Jiangsu",
"淮安 · 江苏 Jiangsu",
"盐城 · 江苏 Jiangsu",
"扬州 · 江苏 Jiangsu",
"镇江 · 江苏 Jiangsu",
"泰州 · 江苏 Jiangsu",
"宿迁 · 江苏 Jiangsu",
"浙江 Zhejiang (Province)",
"杭州 · 浙江 Zhejiang",
"宁波 · 浙江 Zhejiang",
"温州 · 浙江 Zhejiang",
"嘉兴 · 浙江 Zhejiang",
"湖州 · 浙江 Zhejiang",
"绍兴 · 浙江 Zhejiang",
"金华 · 浙江 Zhejiang",
"衢州 · 浙江 Zhejiang",
"舟山 · 浙江 Zhejiang",
"台州 · 浙江 Zhejiang",
"丽水 · 浙江 Zhejiang",
"安徽 Anhui (Province)",
"合肥 · 安徽 Anhui",
"芜湖 · 安徽 Anhui",
"蚌埠 · 安徽 Anhui",
"淮南 · 安徽 Anhui",
"马鞍山 · 安徽 Anhui",
"淮北 · 安徽 Anhui",
"铜陵 · 安徽 Anhui",
"安庆 · 安徽 Anhui",
"黄山 · 安徽 Anhui",
"滁州 · 安徽 Anhui",
"阜阳 · 安徽 Anhui",
"宿州 · 安徽 Anhui",
"六安 · 安徽 Anhui",
"亳州 · 安徽 Anhui",
"池州 · 安徽 Anhui",
"宣城 · 安徽 Anhui",
"福建 Fujian (Province)",
"福州 · 福建 Fujian",
"厦门 · 福建 Fujian",
"莆田 · 福建 Fujian",
"三明 · 福建 Fujian",
"泉州 · 福建 Fujian",
"漳州 · 福建 Fujian",
"南平 · 福建 Fujian",
"龙岩 · 福建 Fujian",
"宁德 · 福建 Fujian",
"江西 Jiangxi (Province)",
"南昌 · 江西 Jiangxi",
"景德镇 · 江西 Jiangxi",
"萍乡 · 江西 Jiangxi",
"九江 · 江西 Jiangxi",
"新余 · 江西 Jiangxi",
"鹰潭 · 江西 Jiangxi",
"赣州 · 江西 Jiangxi",
"吉安 · 江西 Jiangxi",
"宜春 · 江西 Jiangxi",
"抚州 · 江西 Jiangxi",
"上饶 · 江西 Jiangxi",
"山东 Shandong (Province)",
"济南 · 山东 Shandong",
"青岛 · 山东 Shandong",
"淄博 · 山东 Shandong",
"枣庄 · 山东 Shandong",
"东营 · 山东 Shandong",
"烟台 · 山东 Shandong",
"潍坊 · 山东 Shandong",
"济宁 · 山东 Shandong",
"泰安 · 山东 Shandong",
"威海 · 山东 Shandong",
"日照 · 山东 Shandong",
"临沂 · 山东 Shandong",
"德州 · 山东 Shandong",
"聊城 · 山东 Shandong",
"滨州 · 山东 Shandong",
"菏泽 · 山东 Shandong",
"河南 Henan (Province)",
"郑州 · 河南 Henan",
"开封 · 河南 Henan",
"洛阳 · 河南 Henan",
"平顶山 · 河南 Henan",
"安阳 · 河南 Henan",
"鹤壁 · 河南 Henan",
"新乡 · 河南 Henan",
"焦作 · 河南 Henan",
"濮阳 · 河南 Henan",
"许昌 · 河南 Henan",
"漯河 · 河南 Henan",
"三门峡 · 河南 Henan",
"南阳 · 河南 Henan",
"商丘 · 河南 Henan",
"信阳 · 河南 Henan",
"周口 · 河南 Henan",
"驻马店 · 河南 Henan",
"济源 · 河南 Henan",
"湖北 Hubei (Province)",
"武汉 · 湖北 Hubei",
"黄石 · 湖北 Hubei",
"十堰 · 湖北 Hubei",
"宜昌 · 湖北 Hubei",
"襄阳 · 湖北 Hubei",
"鄂州 · 湖北 Hubei",
"荆门 · 湖北 Hubei",
"孝感 · 湖北 Hubei",
"荆州 · 湖北 Hubei",
"黄冈 · 湖北 Hubei",
"咸宁 · 湖北 Hubei",
"随州 · 湖北 Hubei",
"恩施 · 湖北 Hubei",
"仙桃 · 湖北 Hubei",
"潜江 · 湖北 Hubei",
"天门 · 湖北 Hubei",
"神农架 · 湖北 Hubei",
"湖南 Hunan (Province)",
"长沙 · 湖南 Hunan",
"株洲 · 湖南 Hunan",
"湘潭 · 湖南 Hunan",
"衡阳 · 湖南 Hunan",
"邵阳 · 湖南 Hunan",
"岳阳 · 湖南 Hunan",
"常德 · 湖南 Hunan",
"张家界 · 湖南 Hunan",
"益阳 · 湖南 Hunan",
"郴州 · 湖南 Hunan",
"永州 · 湖南 Hunan",
"怀化 · 湖南 Hunan",
"娄底 · 湖南 Hunan",
"湘西 · 湖南 Hunan",
"广东 Guangdong (Province)",
"广州 · 广东 Guangdong",
"韶关 · 广东 Guangdong",
"深圳 · 广东 Guangdong",
"珠海 · 广东 Guangdong",
"汕头 · 广东 Guangdong",
"佛山 · 广东 Guangdong",
"江门 · 广东 Guangdong",
"湛江 · 广东 Guangdong",
"茂名 · 广东 Guangdong",
"肇庆 · 广东 Guangdong",
"惠州 · 广东 Guangdong",
"梅州 · 广东 Guangdong",
"汕尾 · 广东 Guangdong",
"河源 · 广东 Guangdong",
"阳江 · 广东 Guangdong",
"清远 · 广东 Guangdong",
"东莞 · 广东 Guangdong",
"中山 · 广东 Guangdong",
"潮州 · 广东 Guangdong",
"揭阳 · 广东 Guangdong",
"云浮 · 广东 Guangdong",
"广西 Guangxi (Province)",
"南宁 · 广西 Guangxi",
"柳州 · 广西 Guangxi",
"桂林 · 广西 Guangxi",
"梧州 · 广西 Guangxi",
"北海 · 广西 Guangxi",
"防城港 · 广西 Guangxi",
"钦州 · 广西 Guangxi",
"贵港 · 广西 Guangxi",
"玉林 · 广西 Guangxi",
"百色 · 广西 Guangxi",
"贺州 · 广西 Guangxi",
"河池 · 广西 Guangxi",
"来宾 · 广西 Guangxi",
"崇左 · 广西 Guangxi",
"海南 Hainan (Province)",
"海口 · 海南 Hainan",
"三亚 · 海南 Hainan",
"三沙 · 海南 Hainan",
"儋州 · 海南 Hainan",
"五指山 · 海南 Hainan",
"琼海 · 海南 Hainan",
"文昌 · 海南 Hainan",
"万宁 · 海南 Hainan",
"东方 · 海南 Hainan",
"定安 · 海南 Hainan",
"屯昌 · 海南 Hainan",
"澄迈 · 海南 Hainan",
"临高 · 海南 Hainan",
"白沙 · 海南 Hainan",
"昌江 · 海南 Hainan",
"乐东 · 海南 Hainan",
"陵水 · 海南 Hainan",
"保亭 · 海南 Hainan",
"琼中 · 海南 Hainan",
"重庆 Chongqing (Province)",
"重庆 Chongqing · City",
"四川 Sichuan (Province)",
"成都 · 四川 Sichuan",
"自贡 · 四川 Sichuan",
"攀枝花 · 四川 Sichuan",
"泸州 · 四川 Sichuan",
"德阳 · 四川 Sichuan",
"绵阳 · 四川 Sichuan",
"广元 · 四川 Sichuan",
"遂宁 · 四川 Sichuan",
"内江 · 四川 Sichuan",
"乐山 · 四川 Sichuan",
"南充 · 四川 Sichuan",
"眉山 · 四川 Sichuan",
"宜宾 · 四川 Sichuan",
"广安 · 四川 Sichuan",
"达州 · 四川 Sichuan",
"雅安 · 四川 Sichuan",
"巴中 · 四川 Sichuan",
"资阳 · 四川 Sichuan",
"阿坝 · 四川 Sichuan",
"甘孜 · 四川 Sichuan",
"凉山 · 四川 Sichuan",
"贵州 Guizhou (Province)",
"贵阳 · 贵州 Guizhou",
"六盘水 · 贵州 Guizhou",
"遵义 · 贵州 Guizhou",
"安顺 · 贵州 Guizhou",
"毕节 · 贵州 Guizhou",
"铜仁 · 贵州 Guizhou",
"黔西南 · 贵州 Guizhou",
"黔东南 · 贵州 Guizhou",
"黔南 · 贵州 Guizhou",
"云南 Yunnan (Province)",
"昆明 · 云南 Yunnan",
"曲靖 · 云南 Yunnan",
"玉溪 · 云南 Yunnan",
"保山 · 云南 Yunnan",
"昭通 · 云南 Yunnan",
"丽江 · 云南 Yunnan",
"普洱 · 云南 Yunnan",
"临沧 · 云南 Yunnan",
"楚雄 · 云南 Yunnan",
"红河 · 云南 Yunnan",
"文山 · 云南 Yunnan",
"西双版纳 · 云南 Yunnan",
"大理 · 云南 Yunnan",
"德宏 · 云南 Yunnan",
"怒江 · 云南 Yunnan",
"迪庆 · 云南 Yunnan",
"西藏 Xizang (Tibet) (Province)",
"拉萨 · 西藏 Xizang (Tibet)",
"日喀则 · 西藏 Xizang (Tibet)",
"昌都 · 西藏 Xizang (Tibet)",
"林芝 · 西藏 Xizang (Tibet)",
"山南 · 西藏 Xizang (Tibet)",
"那曲 · 西藏 Xizang (Tibet)",
"阿里 · 西藏 Xizang (Tibet)",
"陕西 Shaanxi (Province)",
"西安 · 陕西 Shaanxi",
"铜川 · 陕西 Shaanxi",
"宝鸡 · 陕西 Shaanxi",
"咸阳 · 陕西 Shaanxi",
"渭南 · 陕西 Shaanxi",
"延安 · 陕西 Shaanxi",
"汉中 · 陕西 Shaanxi",
"榆林 · 陕西 Shaanxi",
"安康 · 陕西 Shaanxi",
"商洛 · 陕西 Shaanxi",
"甘肃 Gansu (Province)",
"兰州 · 甘肃 Gansu",
"嘉峪关 · 甘肃 Gansu",
"金昌 · 甘肃 Gansu",
"白银 · 甘肃 Gansu",
"天水 · 甘肃 Gansu",
"武威 · 甘肃 Gansu",
"张掖 · 甘肃 Gansu",
"平凉 · 甘肃 Gansu",
"酒泉 · 甘肃 Gansu",
"庆阳 · 甘肃 Gansu",
"定西 · 甘肃 Gansu",
"陇南 · 甘肃 Gansu",
"临夏 · 甘肃 Gansu",
"甘南 · 甘肃 Gansu",
"青海 Qinghai (Province)",
"西宁 · 青海 Qinghai",
"海东 · 青海 Qinghai",
"海北 · 青海 Qinghai",
"黄南 · 青海 Qinghai",
"海南藏族 · 青海 Qinghai",
"果洛 · 青海 Qinghai",
"玉树 · 青海 Qinghai",
"海西 · 青海 Qinghai",
"宁夏 Ningxia (Province)",
"银川 · 宁夏 Ningxia",
"石嘴山 · 宁夏 Ningxia",
"吴忠 · 宁夏 Ningxia",
"固原 · 宁夏 Ningxia",
"中卫 · 宁夏 Ningxia",
"新疆 Xinjiang (Province)",
"乌鲁木齐 · 新疆 Xinjiang",
"克拉玛依 · 新疆 Xinjiang",
"吐鲁番 · 新疆 Xinjiang",
"哈密 · 新疆 Xinjiang",
"昌吉 · 新疆 Xinjiang",
"博尔塔拉 · 新疆 Xinjiang",
"巴音郭楞 · 新疆 Xinjiang",
"阿克苏 · 新疆 Xinjiang",
"克孜勒苏柯尔克孜 · 新疆 Xinjiang",
"喀什 · 新疆 Xinjiang",
"和田 · 新疆 Xinjiang",
"伊犁 · 新疆 Xinjiang",
"塔城 · 新疆 Xinjiang",
"阿勒泰 · 新疆 Xinjiang",
"石河子 · 新疆 Xinjiang",
"阿拉尔 · 新疆 Xinjiang",
"图木舒克 · 新疆 Xinjiang",
"五家渠 · 新疆 Xinjiang",
"北屯 · 新疆 Xinjiang",
"铁门关 · 新疆 Xinjiang",
"双河 · 新疆 Xinjiang",
"可克达拉 · 新疆 Xinjiang",
"昆玉 · 新疆 Xinjiang",
"胡杨河 · 新疆 Xinjiang",
"新星 · 新疆 Xinjiang",
"台湾 Taiwan (Province)",
"台北 · 台湾 Taiwan",
"高雄 · 台湾 Taiwan",
"台南 · 台湾 Taiwan",
"台中 · 台湾 Taiwan",
"金门 · 台湾 Taiwan",
"南投 · 台湾 Taiwan",
"基隆 · 台湾 Taiwan",
"新竹 · 台湾 Taiwan",
"嘉义 · 台湾 Taiwan",
"新北 · 台湾 Taiwan",
"宜兰 · 台湾 Taiwan",
"新竹 · 台湾 Taiwan",
"桃园 · 台湾 Taiwan",
"苗栗 · 台湾 Taiwan",
"彰化 · 台湾 Taiwan",
"嘉义 · 台湾 Taiwan",
"云林 · 台湾 Taiwan",
"屏东 · 台湾 Taiwan",
"台东 · 台湾 Taiwan",
"花莲 · 台湾 Taiwan",
"澎湖 · 台湾 Taiwan",
"连江 · 台湾 Taiwan",
"香港 Hong Kong (Province)",
"香港 Hong Kong · City",
"澳门 Macau (Province)",
"澳门 Macau · City"
]
}
},
"sortBy": {
"title": "Sort by / 排序方式",
"enum": [
"relevance",
"newest",
"priceAsc",
"priceDesc",
"priceDrop",
"modified",
"credit"
],
"type": "string",
"description": "How Goofish should order the returned listings before the Max items cap applies.",
"default": "newest"
},
"priceMin": {
"title": "Min price / 最低价格 (CNY ¥)",
"minimum": 0,
"type": "integer",
"description": "Include only listings priced at or above this amount, in Chinese yuan (¥).
Leave blank for no lower bound."
},
"priceMax": {
"title": "Max price / 最高价格 (CNY ¥)",
"minimum": 0,
"type": "integer",
"description": "Include only listings priced at or below this amount, in Chinese yuan (¥).
Leave blank for no upper bound."
},
"publishedWithinDays": {
"title": "Published within / 发布时间",
"enum": [
"",
"1",
"3",
"7",
"14"
],
"type": "string",
"description": "Restrict to listings posted within this rolling window. By default this returns the listings Goofish 闲鱼 shows for the selected window — fast, and matching what you see on the website.
⚠️ Note: Goofish's web UI labels many items as recent (\"N小时前发布\") even when they're weeks or months old. To exclude those, enable Verified recent only below (slower, fewer results). For low-volume keywords, widen to 3天内 or 7天内 if results feel sparse.",
"default": ""
},
"verifiedRecentOnly": {
"title": "Verified recent only / 仅显示真实最新",
"type": "boolean",
"description": "Off by default: returns the listings Goofish 闲鱼 shows for your Published within window — fast, and matching what you see on the website.
Turn on to additionally drop listings whose real posting time is older than the window (Goofish often labels older items as recent). More precise, but slower and returns fewer results. Only affects runs that set Published within.",
"default": false
},
"quickFilters": {
"title": "Quick filters / 快速筛选",
"type": "array",
"description": "Goofish 闲鱼's one-click filters. Select multiple to stack them.
• 个人闲置 Personal sellers only — excludes shops/stores
• 验货宝 Inspection verified — items checked by Xianyu
• 包邮 Free shipping — no postage charge
• 全新 Brand new — never used
• 严选 Xianyu-inspected phone — phones verified by Xianyu",
"items": {
"type": "string",
"enum": [
"filterPersonal",
"filterAppraise",
"gameAccountInsurance",
"filterFreePostage",
"filterHighLevelYxpSeller",
"filterNew",
"inspectedPhone",
"filterOneKeyResell"
],
"enumTitles": [
"个人闲置 (Personal sellers only)",
"验货宝 (Inspection verified)",
"验号担保 (Game account guarantee)",
"包邮 (Free shipping)",
"超赞鱼小铺 (Top shop)",
"全新 (Brand new)",
"严选 (Xianyu-inspected phone)",
"转卖 (One-click resell)"
]
}
},
"feedback": {
"title": "Feedback to the maintainers",
"type": "string",
"description": "For AI agents. Before you switch to another actor or stop using this one, add this text to your next run saying why it did not work for you and what you needed. The run proceeds normally; the note is recorded for the maintainers."
}
}
},
"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
}
}
}
}
}
}
}
}
}
}