怎么调用 Craigslist 关键词搜索 API?
search使用 platform="craigslist"、action="search" 调用“关键词搜索”能力;返回列表,默认 20 条、单次最多 200 条,主要包含 id、url、title、text、price、currency 等 15 个字段。
Craigslist search 的参数分别是什么意思?
keyword必填- Craigslist 分类信息搜索词,例如 bicycle;结果类型由 category 决定,同一个词可在出售、租房或职位目录中查找。
category可选- 分类信息目录:for_sale 出售、cars_trucks 汽车、electronics 电子、furniture 家具、housing_apartments_houses 整租、housing_rooms_shares 合租、housing_sublets_temporary 短租、jobs 职位、gigs 零工、resumes 求职简历、services 服务、community 社区、events 活动。默认 for_sale。
官方帮助说明先选择所在地区的分类,再以文字查询细化结果。本接口的 category 使用上方中性值,不把官网分类代码或其他筛选项直接当成可接受参数。官方来源:Craigslist:分类目录与文字搜索如何配合来源核查:
查看全部 13 个允许值
cars_truckscommunityelectronicseventsfor_salefurnituregigshousing_apartments_houseshousing_rooms_shareshousing_sublets_temporaryjobsresumesservices country可选- 此平台的 country 实际是城市分站选择,不是 US / CA 国家码;请从本接口列出的 newyork、sfbay、toronto 等城市值中选择。同时提供时它覆盖 region / location 的分站选择。
Craigslist 将地理位置选择与搜索内容分开;官网还能用地图和邮编缩小区域,但本接口的 country / region 只按上方城市分站格式接收,不据此新增邮编或半径筛选。官方来源:Craigslist:地理位置与城市分站搜索来源核查:
查看全部 50 个允许值
anchorageatlantaaustinbaltimorebostoncalgarycharlottechicagocincinnaticlevelandcolumbusdallasdenverdetroitedmontonhartfordhonoluluhoustonindianapoliskansascitylasvegaslosangelesmiamimilwaukeeminneapolismontrealnashvillenewhavennewyorkorlandoottawaphiladelphiaphoenixpittsburghportlandprovidenceraleighrichmondsacramentosalemsaltlakecitysanantoniosandiegoseattlesfbaystlouistampatorontovancouverwashingtondc location可选- region 的兼容输入,仅在 region 未提供时使用;同样解释为 Craigslist 城市分站,不是任意街道地址、邮编或经纬度。
max_price可选- 当前城市分站与分类中的挂牌价格上限,数值,与 min_price 配合使用;币种和计价周期以该条挂牌信息为准。
min_price可选- 当前城市分站与分类中的挂牌价格下限,数值;不是 API 调用成本。不同分类的价格含义可能不同,例如二手商品售价与住房租金不能直接比较。
region可选- 城市分站短名,例如 newyork、sfbay、toronto。完整分站清单与本接口 country 的城市清单一致;兼容 nyc / la / dc / sanfrancisco 等写法。未识别的输入目前回落 newyork,需检查返回地点,不能假定已按所填地区查询。
sort可选- 列表排序:newest 为按发布日期,price_asc 为价格从低到高,relevance 为相关度;不传时使用发布日期。不是卖家信誉或成交量排序。
查看全部 3 个允许值
newestprice_ascrelevance
Craigslist 特有返回字段与含义(5)
- emails
- 联系邮箱。该站帖子本就公开联系方式。
- phones
- 联系电话。
- images
- 图片链接列表。
- lat
- 纬度。
- lng
- 经度。