EveryInfra

电商数据 · 数据 API

Craigslist

Craigslist API

本地分类信息与二手挂牌——区域供需与价格带观察。POST /api/v1/social 就行,返回结构化 JSON,$1.39 / 千次/次、失败不计费。

1

个能力

$1.39 / 千次

每次调用

秒级

响应

1 个

API Key 通 87 平台

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

怎么调用 Craigslist 关键词搜索 API?

search

使用 platform="craigslist"action="search" 调用“关键词搜索”能力;返回列表,默认 20 条、单次最多 200 条,主要包含 id、url、title、text、price、currency 等 15 个字段

keyword必填
检索关键词。
category可选
分类筛选。取值随平台而异,见该能力的 allowed_values。
查看全部 13 个允许值

cars_truckscommunityelectronicseventsfor_salefurnituregigshousing_apartments_houseshousing_rooms_shareshousing_sublets_temporaryjobsresumesservices

country可选
国家/地区,ISO 3166-1 代码(如 CN、US)。

允许值很多,示例:anchorage、atlanta、austin、baltimore、boston、calgary、charlotte、chicago、cincinnati、cleveland、columbus、dallas在机器目录查看全部 50 个值

location可选
地点,自由文本(如城市名或「城市, 州」)。取值格式随平台而异。
max_price可选
最高价格,数值。
min_price可选
最低价格,数值。
region可选
地区。取值可能是国家码也可能是平台自有的地区标识,见 allowed_values。
sort可选
排序方式。取值随平台而异,见该能力的 allowed_values。
查看全部 3 个允许值

newestprice_ascrelevance

Craigslist 特有返回字段与含义(5
emails
联系邮箱。该站帖子本就公开联系方式。
phones
联系电话。
images
图片链接列表。
lat
纬度。
lng
经度。
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 · 响应 · 最多 200 条idurltitletextprice
一次 Craigslist search 调用的全过程:向 POST /api/v1/social 发送 platform="craigslist"、action="search",以及必填参数 keyword;返回结构化 JSON,含 id、url、title、text、price 等字段;单次最多 200 条,计费 $1.39 / 千次,失败与空结果不计费。

Craigslist 原始字段名

EveryInfra 统一字段名

左边是 Craigslist 数据里原本的字段名,右边是我们统一后的。点任意一行看对应关系。右边这一列在 87 个平台上是同一套—— 换平台时只改请求里的 platform 一个字段, 解析代码一行不用动。

Craigslist 的稀有字段

这些字段全站只有不超过 3 个平台返回,Craigslist 是其中之一。 字段名与其余平台同样遵循 snake_case 命名,解析方式一致。

  • emails
  • phones
  • images

返回字段含义

字段名跨 87 个平台统一,同一个键在哪个平台都是同一个意思—— 这也是换平台只需改 platform 一个字段的原因。 机器可读版:/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 表示平台未公开。
platform
数据来源平台标识,与请求里的 platform 一致(如 xiaohongshu、tiktok)。

另有 Craigslist 特有字段 lat · lng · emails · phones · images,保留该平台自身的语义。

30 秒调用示例

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":"咖啡"}}'

返回长这样

response.json
{
  "id": "craigslist_…",
  "search": [
    {
      "id": "…",
      "url": "https://…",
      "title": "…",
      "text": "…",
      "price": "…",
      "currency": "…",
      "category": "…",
      "location": "…",
      "posted_at": "2026-08-01T09:30:00Z",
      "lat": "…",
      "lng": "…",
      "emails": "…",
      "phones": "…",
      "images": "…",
      "platform": "craigslist"
    }
  ],
  "count": 20,
  "billing": { "charged": true, "credits": 100, "cny": 0.009356 }
}

常见用例

关键词监控

按关键词轮询 Craigslist 的新内容,配合 Gemini 文本 API 做情绪分类与异常波动告警。

选品调研

类目热销与差评痛点,发现机会点。

Craigslist API 常见问题

Craigslist API 怎么调用?

调 POST /api/v1/social,请求体传 platform="craigslist"、action 和 params。以 search 为例,必填 keyword,可选 category、country、location、max_price。Craigslist 共 1 个 action,鉴权用 Authorization: Bearer <API Key>,同一把 Key 通 87 个平台。

Craigslist API 怎么收费?

$1.39 / 千次/次,Craigslist 全部 1 个能力同价。$1 免费额度约等于 719 次 Craigslist 调用。一次调用一次计费,不按条数或页数加价;参数错误、鉴权失败和空结果都不计费。

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

最多的是 search,单次上限 200 条(默认 20 条)。传 limit 控制,一次调用就返回这么多,不需要翻页也不多收钱。

Craigslist API 返回哪些字段?

search 返回 id、url、title、text、price、currency 等 15 个字段。字段名跨平台统一,换平台不用改解析代码。

Craigslist怎么按关键词批量采集?

调 POST /api/v1/social,传 platform="craigslist"、action="search",必填参数 keyword。单次最多 200 条,一次调用一次计费、不按条数加价;单价 $1.39 / 千次,失败与空结果不计费。返回结构化 JSON,关键词搜索字段为 id、url、title、text、price。

可以先免费试用 Craigslist API 吗?

可以。注册免费,加微信领邀请码可得 $1 免费额度(≈720 次数据调用或 576 次 AI 调用),足够把 Craigslist 的 1 个能力都试一遍。无需信用卡。

开始调用 Craigslist API

加微信领 $1 免费额度 —— ≈720 次数据调用或 576 次 AI 调用,足够把 Craigslist 的能力全试一遍。

免费开始