{
"openapi": "3.0.1",
"info": {
"title": "58.com / 58同城 二手房 Real Estate Scraper",
"description": "Extract 58.com / 58同城 二手房 prices, 房源 details, broker/经纪人, 小区, photos, VR, Q&A, and 房价 trends across 671 Chinese cities. Paste search/detail URLs or use city + filters; export JSON, CSV, Excel from Apify datasets.",
"version": "0.0",
"x-build-id": "e0eAVaOjgJTperoWu"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/zen-studio~58-real-estate-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-zen-studio-58-real-estate-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~58-real-estate-scraper/runs": {
"post": {
"operationId": "runs-sync-zen-studio-58-real-estate-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~58-real-estate-scraper/run-sync": {
"post": {
"operationId": "run-sync-zen-studio-58-real-estate-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": {
"maxItems": {
"title": "最大结果数 Max results",
"minimum": 1,
"maximum": 5000,
"type": "integer",
"description": "Maximum listings to save to the dataset. This is the main result limit.",
"default": 20
},
"city": {
"title": "城市 City",
"enum": [
"bj",
"sh",
"gz",
"sz",
"cd",
"hz",
"nj",
"tj",
"wh",
"cq",
"xa",
"suzhou",
"zz",
"cs",
"xm",
"fz",
"dg",
"fs",
"nb",
"qd",
"hf",
"wuhu",
"bengbu",
"fy",
"hn",
"anqing",
"la",
"huaibei",
"chuzhou",
"mas",
"tongling",
"xuancheng",
"bozhou",
"huangshan",
"chizhou",
"ch",
"hexian",
"hq",
"tongcheng",
"ningguo",
"tianchang",
"dongzhi",
"wuweixian",
"qz",
"pt",
"zhangzhou",
"nd",
"sm",
"np",
"ly",
"wuyishan",
"shishi",
"jinjiangshi",
"nananshi",
"longhai",
"shanghangxian",
"fuanshi",
"fudingshi",
"anxixian",
"yongchunxian",
"yongan",
"zhangpu",
"zs",
"zh",
"huizhou",
"jm",
"st",
"zhanjiang",
"zq",
"mm",
"jy",
"mz",
"qingyuan",
"yj",
"sg",
"heyuan",
"yf",
"sw",
"chaozhou",
"taishan",
"yangchun",
"sd",
"huidong",
"boluo",
"haifengxian",
"kaipingshi",
"lufengshi",
"nn",
"liuzhou",
"gl",
"yulin",
"wuzhou",
"bh",
"gg",
"qinzhou",
"baise",
"hc",
"lb",
"hezhou",
"fcg",
"chongzuo",
"guipingqu",
"beiliushi",
"bobaixian",
"cenxi",
"gy",
"zunyi",
"qdn",
"qn",
"lps",
"bijie",
"tr",
"anshun",
"qxn",
"renhuaishi",
"qingzhen",
"lz",
"tianshui",
"by",
"qingyang",
"pl",
"jq",
"zhangye",
"wuwei",
"dx",
"jinchang",
"ln",
"linxia",
"jyg",
"gn",
"dunhuang",
"haikou",
"sanya",
"wzs",
"sansha",
"qh",
"wenchang",
"wanning",
"tunchang",
"qiongzhong",
"lingshui",
"df",
"da",
"cm",
"baoting",
"baish",
"danzhou",
"luoyang",
"xx",
"ny",
"xc",
"pds",
"ay",
"jiaozuo",
"sq",
"kaifeng",
"puyang",
"zk",
"xy",
"zmd",
"luohe",
"smx",
"hb",
"jiyuan",
"mg",
"yanling",
"yuzhou",
"changge",
"lingbaoshi",
"qixianqu",
"ruzhou",
"xiangchengshi",
"yanshiqu",
"changyuan",
"huaxian",
"linzhou",
"qinyang",
"mengzhou",
"wenxian",
"weishixian",
"lankaoxian",
"tongxuxian",
"lyxinan",
"yichuan",
"mengjinqu",
"lyyiyang",
"wugang",
"yongcheng",
"suixian",
"luyi",
"yingchixian",
"shenqiu",
"taikang",
"shangshui",
"qixianq",
"junxian",
"fanxian",
"gushixian",
"huaibinxian",
"dengzhou",
"xinye",
"hrb",
"dq",
"qqhr",
"mdj",
"suihua",
"jms",
"jixi",
"sys",
"hegang",
"heihe",
"yich",
"qth",
"dxal",
"shanda",
"shzhaodong",
"zhaozhou",
"yc",
"xf",
"jingzhou",
"shiyan",
"hshi",
"xiaogan",
"hg",
"es",
"jingmen",
"xianning",
"ez",
"suizhou",
"qianjiang",
"tm",
"xiantao",
"snj",
"yidou",
"hanchuan",
"zaoyang",
"wuxueshi",
"zhongxiangshi",
"jingshanxian",
"shayangxian",
"songzi",
"guangshuishi",
"chibishi",
"laohekou",
"gucheng",
"yichengshi",
"nanzhang",
"yunmeng",
"anlu",
"dawu",
"xiaochang",
"dangyang",
"zhijiang",
"jiayuxian",
"suixia",
"zhuzhou",
"yiyang",
"changde",
"hy",
"xiangtan",
"yy",
"chenzhou",
"shaoyang",
"hh",
"yongzhou",
"ld",
"xiangxi",
"zjj",
"liling",
"lixian",
"czguiyang",
"zixing",
"yongxing",
"changningshi",
"qidongxian",
"hengdong",
"lengshuijiangshi",
"lianyuanshi",
"shuangfengxian",
"shaoyangxian",
"shaodongxian",
"yuanjiangs",
"nanxian",
"qiyang",
"xiangyin",
"huarong",
"cilixian",
"zzyouxian",
"sjz",
"bd",
"ts",
"lf",
"hd",
"qhd",
"cangzhou",
"xt",
"hs",
"zjk",
"chengde",
"dingzhou",
"gt",
"zhangbei",
"zx",
"zd",
"qianan",
"renqiu",
"sanhe",
"wuan",
"xionganxinqu",
"lfyanjiao",
"zhuozhou",
"hejian",
"huanghua",
"cangxian",
"cixian",
"shexian",
"bazhou",
"xianghe",
"lfguan",
"zunhua",
"qianxixian",
"yutianxian",
"luannanxian",
"shaheshi",
"su",
"wx",
"cz",
"xz",
"nt",
"yz",
"yancheng",
"ha",
"lyg",
"taizhou",
"suqian",
"zj",
"shuyang",
"dafeng",
"rugao",
"qidong",
"liyang",
"haimen",
"donghai",
"yangzhong",
"xinghuashi",
"xinyishi",
"taixing",
"rudong",
"pizhou",
"xzpeixian",
"jingjiang",
"jianhu",
"haian",
"dongtai",
"danyang",
"baoyingx",
"guannan",
"guanyun",
"jiangyan",
"jintan",
"szkunshan",
"sihong",
"siyang",
"jurong",
"sheyang",
"funingxian",
"xiangshui",
"xuyi",
"jinhu",
"jiangyins",
"nc",
"ganzhou",
"jj",
"yichun",
"ja",
"sr",
"px",
"fuzhou",
"jdz",
"xinyu",
"yingtan",
"yxx",
"lepingshi",
"jinxian",
"fenyi",
"fengchengshi",
"zhangshu",
"gaoan",
"yujiang",
"nanchengx",
"fuliangxian",
"cc",
"jl",
"sp",
"yanbian",
"songyuan",
"bc",
"th",
"baishan",
"liaoyuan",
"gongzhuling",
"meihekou",
"fuyuxian",
"changlingxian",
"huadian",
"panshi",
"lishu",
"sy",
"dl",
"as",
"jinzhou",
"fushun",
"yk",
"pj",
"cy",
"dandong",
"liaoyang",
"benxi",
"hld",
"tl",
"fx",
"pld",
"wfd",
"dengta",
"fengcheng",
"beipiao",
"kaiyuan",
"yinchuan",
"wuzhong",
"szs",
"zw",
"guyuan",
"hu",
"bt",
"chifeng",
"erds",
"tongliao",
"hlbe",
"bycem",
"wlcb",
"xl",
"xam",
"wuhai",
"alsm",
"hlr",
"xn",
"hx",
"haibei",
"guoluo",
"haidong",
"huangnan",
"ys",
"hainan",
"geermushi",
"jn",
"yt",
"wf",
"linyi",
"zb",
"jining",
"ta",
"lc",
"weihai",
"zaozhuang",
"dz",
"rizhao",
"dy",
"heze",
"bz",
"lw",
"zhangqiu",
"kl",
"zc",
"shouguang",
"longkou",
"caoxian",
"shanxian",
"feicheng",
"gaomi",
"guangrao",
"huantaixian",
"juxian",
"laizhou",
"penglai",
"qingzhou",
"rongcheng",
"rushan",
"tengzhou",
"xintai",
"zhaoyuan",
"zoucheng",
"zouping",
"linqing",
"chiping",
"hzyc",
"boxing",
"dongming",
"juye",
"wudi",
"qihe",
"weishan",
"yuchengshi",
"linyixianq",
"leling",
"laiyang",
"ningjin",
"gaotang",
"shenxian",
"yanggu",
"guanxian",
"pingyi",
"tancheng",
"yiyuanxian",
"wenshang",
"liangshanx",
"lijin",
"yinanxian",
"qixia",
"ningyang",
"dongping",
"changyishi",
"anqiu",
"changle",
"linqu",
"juancheng",
"ty",
"linfen",
"dt",
"yuncheng",
"jz",
"changzhi",
"jincheng",
"yq",
"lvliang",
"xinzhou",
"shuozhou",
"linyixian",
"qingxu",
"liulin",
"gaoping",
"zezhou",
"xiangyuanxian",
"xiaoyi",
"xianyang",
"baoji",
"wn",
"hanzhong",
"yl",
"yanan",
"ankang",
"sl",
"tc",
"shenmu",
"hancheng",
"fugu",
"jingbian",
"dingbian",
"mianyang",
"deyang",
"nanchong",
"yb",
"zg",
"ls",
"luzhou",
"dazhou",
"scnj",
"suining",
"panzhihua",
"ms",
"ga",
"zy",
"liangshan",
"guangyuan",
"ya",
"bazhong",
"ab",
"ganzi",
"anyuexian",
"guanghanshi",
"jianyangshi",
"renshouxian",
"shehongxian",
"dazu",
"xuanhan",
"qux",
"changningx",
"xj",
"changji",
"bygl",
"yili",
"aks",
"ks",
"hami",
"klmy",
"betl",
"tlf",
"ht",
"shz",
"kzls",
"ale",
"wjq",
"tmsk",
"kuerleshi",
"alt",
"tac",
"lasa",
"rkz",
"sn",
"linzhi",
"changdu",
"nq",
"al",
"rituxian",
"gaizexian",
"km",
"qj",
"dali",
"honghe",
"yx",
"lj",
"ws",
"cx",
"bn",
"zt",
"dh",
"pe",
"bs",
"lincang",
"diqing",
"nujiang",
"milexian",
"anningshi",
"xuanwushi",
"wz",
"jh",
"jx",
"tz",
"sx",
"huzhou",
"lishui",
"quzhou",
"zhoushan",
"yueqingcity",
"ruiancity",
"yiwu",
"yuyao",
"zhuji",
"xiangshanxian",
"wenling",
"tongxiang",
"cixi",
"changxing",
"jiashanx",
"haining",
"deqing",
"dongyang",
"anji",
"cangnanxian",
"linhai",
"yongkang",
"yuhuan",
"pinghushi",
"haiyan",
"wuyix",
"shengzhou",
"xinchang",
"jiangshanshi",
"pingyangxian",
"hk",
"am",
"tw"
],
"type": "string",
"description": "Choose a 58.com / 58同城 city. The actor maps the selected city internally.",
"default": "bj"
},
"keyword": {
"title": "关键词 Keyword",
"type": "string",
"description": "Free-text 二手房 search term, for example 望京 三居 满五.",
"default": "望京 三居 满五"
},
"sortBy": {
"title": "排序 Sort by",
"enum": [
"default",
"price_asc",
"price_desc",
"area_desc"
],
"type": "string",
"description": "Choose how matching listings should be ordered.",
"default": "default"
},
"district": {
"title": "区域 District",
"enum": [
"",
"chaoyang",
"haidian",
"changping",
"fengtai",
"daxing",
"tongzhouqu",
"fangshan",
"shunyi",
"xicheng",
"dongcheng",
"miyun",
"shijingshan",
"huairou",
"mentougou",
"yanqing",
"pinggu",
"beijingzhoubian"
],
"type": "string",
"description": "Beijing district filter. The actor maps the selected district internally.",
"default": ""
},
"customDistrictSlug": {
"title": "自定义区域 Custom district slug",
"type": "string",
"description": "Advanced: custom district slug from 58.com for the selected city. Overrides District when set."
},
"businessAreaSlug": {
"title": "商圈 Business area",
"type": "string",
"description": "Advanced: business-area/neighborhood slug from 58.com, for example wangjing."
},
"minPrice": {
"title": "最低总价 Min price (万)",
"minimum": 0,
"type": "integer",
"description": "Minimum total price in 万 RMB."
},
"maxPrice": {
"title": "最高总价 Max price (万)",
"minimum": 0,
"type": "integer",
"description": "Maximum total price in 万 RMB."
},
"minArea": {
"title": "最小面积 Min area (m²)",
"minimum": 0,
"type": "integer",
"description": "Minimum area in square meters."
},
"maxArea": {
"title": "最大面积 Max area (m²)",
"minimum": 0,
"type": "integer",
"description": "Maximum area in square meters."
},
"bedrooms": {
"title": "户型 Bedrooms",
"enum": [
"",
"1",
"2",
"3",
"4",
"5",
"6"
],
"type": "string",
"description": "Bedroom count, mapped to 58.com room_nums.",
"default": ""
},
"features": {
"title": "特色 Features",
"type": "array",
"description": "Optional listing badges and conditions to require.",
"items": {
"type": "string",
"enum": [
"near_subway",
"five_years",
"two_years"
],
"enumTitles": [
"近地铁 Near subway",
"满五 Over five years",
"满二 Over two years"
]
}
},
"fitment": {
"title": "装修 Fitment",
"enum": [
"",
"1",
"2",
"4",
"5"
],
"type": "string",
"description": "装修筛选 Decoration/fitment filter.",
"default": ""
},
"floorType": {
"title": "楼层 Floor type",
"enum": [
"",
"1",
"2",
"3",
"4",
"5"
],
"type": "string",
"description": "楼层位置筛选 Floor position filter.",
"default": ""
},
"houseAge": {
"title": "房龄 House age",
"enum": [
"",
"0_2",
"2_5",
"5_10",
"10_0"
],
"type": "string",
"description": "房龄范围筛选 Building age range.",
"default": ""
},
"orientation": {
"title": "朝向 Orientation",
"enum": [
"",
"1",
"2",
"3",
"4",
"6",
"5",
"7",
"8",
"9",
"10"
],
"type": "string",
"description": "房源朝向筛选 Facing/orientation filter.",
"default": ""
},
"propertyType": {
"title": "产权 Property type",
"enum": [
"",
"1",
"2",
"3",
"6"
],
"type": "string",
"description": "产权类型筛选 Ownership/property type filter.",
"default": ""
},
"useType": {
"title": "物业类型 Use type",
"enum": [
"",
"3",
"4",
"5",
"2",
"6"
],
"type": "string",
"description": "物业/用途类型筛选 Usage type filter.",
"default": ""
},
"circle": {
"title": "环线 Ring road",
"enum": [
"",
"1",
"2",
"3",
"4",
"5",
"6"
],
"type": "string",
"description": "北京环线筛选 Beijing ring-road filter when available.",
"default": ""
},
"shortcut": {
"title": "快捷筛选 Shortcut",
"enum": [
"",
"119",
"116",
"115",
"124"
],
"type": "string",
"description": "58.com 快捷筛选, for example VR or urgent-sale listings.",
"default": ""
},
"maxPages": {
"title": "Max pages",
"minimum": 1,
"maximum": 500,
"type": "integer",
"description": "Advanced limit for listing pages per search source.",
"default": 50
},
"pageSize": {
"title": "Page size",
"minimum": 1,
"maximum": 200,
"type": "integer",
"description": "Advanced batch-size setting. Keep the default for normal runs.",
"default": 200
}
}
},
"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
}
}
}
}
}
}
}
}
}
}