电商数据 · 数据 API

Craigslist

Craigslist API

按城市分站和分类检索 Craigslist 商品、租房或职位帖子,返回挂牌价格、地点与原帖链接;须核对币种和计价周期,不保证仍在售或开放。 调用 POST /api/v1/social ;返回结构化 JSON,$1.39 / 千次;失败不计费。

1

个能力

$1.39 / 千次

能力价格

同步

调用模式

1 个

一把 Key 通用 89 个平台

Craigslist 能力清单

action必填参数可选参数单次条数模式单价返回字段
searchkeywordcategory, country, location, max_price, min_price, region, sort默认 20 · 最多 200同步$1.39 / 千次id · url · title · text · price · currency · category · location · posted_at · lat · lng · emails · phones · images · platform

Craigslist 每个接口分别做什么

下面逐个解释 action、必填参数、可选筛选项和允许值。 请求都发到 POST /api/v1/social, 切换 action 时,也要按对应接口调整参数。 同名参数在不同平台、不同接口中可能指向不同对象;请以该条说明中的格式和适用范围为准。

下方只展示平台官方资料,用于核对对象与术语,不表示平台对 EveryInfra 的授权或背书。 本接口接受的参数、字段与能力边界以各条说明为准,不与平台官方 API 直接等同。

Craigslist search 调用流程一次 Craigslist search 调用的全过程:向 POST /api/v1/social 发送 platform="craigslist"、action="search",以及必填参数 keyword;返回结构化 JSON,含 id、url、title、text、price 等字段;返回列表,单次最多 200 条,计费 $1.39 / 千次,失败与空结果不计费。1 · 请求POST /api/v1/socialplatform: "craigslist"action: "search"keywordEveryInfra$1.39 / 千次2 · 响应 · 列表idurltitletextprice
一次 Craigslist search 调用的全过程:向 POST /api/v1/social 发送 platform="craigslist"、action="search",以及必填参数 keyword;返回结构化 JSON,含 id、url、title、text、price 等字段;返回列表,单次最多 200 条,计费 $1.39 / 千次,失败与空结果不计费。

Craigslist 原始字段名

EveryInfra 统一字段名

左边是 Craigslist 数据里原本的字段名,右边是我们统一后的。点任意一行看对应关系。89 个平台复用通用字段命名,减少重复适配; 切换平台仍需核对参数、字段集合、类型与空值含义。这里展示映射关系,不是目标的实时返回数据。

Craigslist 的稀有字段名(当前目录)

这些字段名在当前目录中只出现在不超过 3 个平台,Craigslist 是其中之一。 这是字段命名的分布,不代表其他平台没有同类信息,也不保证每次响应都含这些字段;具体含义和返回条件仍需逐接口核对。

  • emails
  • phones

返回字段含义

通用字段采用统一命名;切换平台时仍需核对目标格式、字段是否存在、类型、空值与平台特有含义。 机器可读版:/api/v1/social/fields

id
该记录在原平台上的唯一标识。仅在同一平台内唯一,跨平台可能重复。
url
该记录在原平台上的可访问链接。
title
标题。平台无标题概念时(如纯文本帖)为 null。
text
正文内容,已去除 HTML 标签。长文可能被截断。
price
价格数值,不含货币符号;币种见 currency。
currency
价格币种代码(如 CNY、USD)。price 存在但 currency 为 null 时不要假定币种。
category
分类名称,取值为原平台的分类体系,未做跨平台归一。
location
地理位置描述,原文透传,格式随平台而异。
posted_at
发布时间,ISO 8601 格式、UTC 时区(如 2026-08-07T12:34:56+00:00)。平台只给非标准字符串时原样透传,解析前建议做容错。null 表示平台未公开。
lat
纬度。
lng
经度。
emails
联系邮箱。该站帖子本就公开联系方式。
phones
联系电话。
images
图片链接列表。
platform
数据来源平台标识,与请求里的 platform 一致(如 xiaohongshu、tiktok)。

请求填写示例

检索分类信息;城市由 region/location 等决定,不从商品词推断。

以下为填写格式示意,并非成功调用记录。请替换 API Key 和尖括号中的目标,确认可选筛选项后再调用;示例不保证目标当前有数据。

craigslist_search.sh
curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer omg_你的KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"craigslist","action":"search","params":{"keyword":"bicycle"}}'

记录字段预览(非真实响应)

仅展示 search 的记录字段,不包含外层响应、计费或任务状态。null 只作展示占位,不表示字段类型或实际空值;完整响应须以接口文档与实际调用为准。

fields.preview.json
{
  "id": null,
  "url": null,
  "title": null,
  "text": null,
  "price": null,
  "currency": null,
  "category": null,
  "location": null,
  "posted_at": null,
  "lat": null,
  "lng": null,
  "emails": null,
  "phones": null,
  "images": null,
  "platform": null
}

常见用例

以下是基于现有接口的接入思路,不是开箱即用的分析或告警功能。字段以实际返回为准,缺失值不按零处理。

按 Craigslist 城市分站与目录查找分类信息

先选城市和出售、租房或职位目录,再用 keyword 缩小结果范围。

查看 search 的 country 参数 →
  • country 在此处是 newyork、sfbay、toronto 这样的城市分站,不是国家码;同时提供时,country 会覆盖 region / location。region 的未知输入会默认使用 newyork,务必核对返回的 location,不能把结果当作已命中目标城市。
  • category 区分商品出售、整租、合租、职位和零工等目录;min_price / max_price 是挂牌价格筛选,不是调用费用。price 的币种和计价周期仍需回原帖核对,不能将住房租金与商品售价直接比较。
  • id / url 定位帖子,posted_at 描述发布时间;列表不证明商品仍在售或职位仍开放。emails / phones 仅在结果有值时可用,不保证有联系方式,也不附带批量联系许可。

Craigslist API 常见问题

Craigslist API 怎么调用?

调用 POST /api/v1/social,请求体传 platform="craigslist"、action 和 params。以 search 为例,必填 keyword,可选 category、country、location、max_price。检索分类信息;城市由 region/location 等决定,不从商品词推断。 Craigslist 共 1 个 action,鉴权用 Authorization: Bearer <API Key>,同一把 Key 通 89 个平台。

Craigslist API 怎么收费?

$1.39 / 千次,Craigslist 全部 1 个能力同价。按本页最高能力单价、每次单目标估算,$1 免费额度约可用于 719 次 Craigslist 调用。费用按所选能力与目标数量计算,多目标请求不要按单目标估算;参数错误、鉴权失败和空结果不计费。

Craigslist API 一次能返回多少条数据?

Craigslist 有 1 个列表接口,包括 search。数量参数要逐接口区分目标数、页数和记录数,不能将目录数值直接当作保证返回的条数;具体限制见对应参数与用例,不保证完整历史。

Craigslist API 返回哪些字段?

当前目录为 search 列出 id、url、title、text、price、currency 等 15 个字段名。字段不保证每次齐全,嵌套位置、类型与空值须按各接口说明核对,同名字段不代表语义可互换。

「按 Craigslist 城市分站与目录查找分类信息」怎样接入 Craigslist API?

先选城市和出售、租房或职位目录,再用 keyword 缩小结果范围。 country 在此处是 newyork、sfbay、toronto 这样的城市分站,不是国家码;同时提供时,country 会覆盖 region / location。region 的未知输入会默认使用 newyork,务必核对返回的 location,不能把结果当作已命中目标城市。 category 区分商品出售、整租、合租、职位和零工等目录;min_price / max_price 是挂牌价格筛选,不是调用费用。price 的币种和计价周期仍需回原帖核对,不能将住房租金与商品售价直接比较。 id / url 定位帖子,posted_at 描述发布时间;列表不证明商品仍在售或职位仍开放。emails / phones 仅在结果有值时可用,不保证有联系方式,也不附带批量联系许可。

可以先免费试用 Craigslist API 吗?

可以。注册免费,加微信领邀请码可得 $1 免费额度(≈720 次数据调用)。请先选择 Craigslist 的目标接口,用单目标请求核对结果;实际可调用次数取决于能力价格与目标数量,不保证覆盖全部 1 个能力。无需信用卡。

开始调用 Craigslist API

加微信领 $1 免费额度,先选一个 Craigslist 接口验证结果。实际可调用次数取决于能力价格与目标数量。

免费开始