点评口碑 · 数据 API

Nextdoor

Nextdoor API

从 Nextdoor 公开地区页整理社区、本地商家和小组目录,并核对地区简介与页面类型;不读取居民私密动态,也不把地区统计当作逐户画像。 调用 POST /api/v1/social ;返回结构化 JSON,$1.39 / 千次;失败不计费。

2

个能力

$1.39 / 千次

能力价格

同步

调用模式

1 个

一把 Key 通用 89 个平台

Nextdoor 能力清单

action必填参数可选参数单次条数模式单价返回字段
profileurl——同步$1.39 / 千次name · page_type · url · description · tagline · state · country_code · lat · lng · residents_count · average_age · average_income · homeowner_pct · affordability_score · friendliness_score · neighborhood_count · business_directory_count · local_group_count · classifieds_count · events_count · safety_post_count · trending_post_count · photo_video_post_count · faq_count · faqs · image_url · access_status · platform
directoryurl—默认 25 · 最多 50同步$1.39 / 千次name · url · kind · description · member_count · image_url · area · platform

Nextdoor 每个接口分别做什么

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

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

怎么调用 Nextdoor 主页或对象详情 API?

profile

使用 platform="nextdoor"、action="profile" 调用“主页或对象详情”能力;返回单个对象,主要包含 name、page_type、url、description、tagline、state 等 28 个字段。

Nextdoor profile 的参数分别是什么意思?

url必填
公开的 Nextdoor 城市、社区、商家或目录页面完整 URL。profile 整理该页面的区域资料,directory 整理其公开目录条目;不是个人档案查询,也不读取登录后的私密动态。社区或商家页面可能只提供标题、简介和图片等有限资料。

Nextdoor 说明跨社区浏览以面向 Anyone 的内容为基础,邻里之外的信息仍可能受隐私限制。官网可浏览或关注社区不等于本接口能读取私密动态、完整姓名、居民名单或代用户关注。官方来源:Nextdoor:公开社区内容与邻里可见范围来源核查:

Nextdoor 特有返回字段与含义(23)
page_type
页面类型(社区/商家/城市等)。
tagline
社区或商家的一句话简介。
state
州。
country_code
国家代码。
lat
纬度。
lng
经度。
residents_count
该区域居民数。
neighborhood_count
包含的街区数量。
local_group_count
本地小组数量。
business_directory_count
商家目录收录数。
average_age
居民平均年龄。
average_income
居民平均收入。
homeowner_pct
自有住房比例,百分数。
affordability_score
生活成本可负担度评分,Nextdoor 自有模型。
friendliness_score
社区友好度评分,来自居民打分。
safety_post_count
安全类帖子数。这类帖多寡是判断治安体感的间接信号。
trending_post_count
热门帖数量。
photo_video_post_count
图片视频帖数量。
classifieds_count
二手交易帖数量。
events_count
活动数量。
access_status
访问权限状态(公开/需验证地址)。
faqs
常见问题列表。
faq_count
常见问题数量。

怎么调用 Nextdoor 目录与社区发现 API?

directory

使用 platform="nextdoor"、action="directory" 调用“目录与社区发现”能力;返回列表,默认 25 条、单次最多 50 条,主要包含 name、url、kind、description、member_count、image_url 等 8 个字段。

Nextdoor directory 的参数分别是什么意思?

url必填
公开的 Nextdoor 城市、社区、商家或目录页面完整 URL。profile 整理该页面的区域资料,directory 整理其公开目录条目;不是个人档案查询,也不读取登录后的私密动态。社区或商家页面可能只提供标题、简介和图片等有限资料。

Nextdoor 说明跨社区浏览以面向 Anyone 的内容为基础,邻里之外的信息仍可能受隐私限制。官网可浏览或关注社区不等于本接口能读取私密动态、完整姓名、居民名单或代用户关注。官方来源:Nextdoor:公开社区内容与邻里可见范围来源核查:

Nextdoor 特有返回字段与含义(3)
kind
条目类别。
area
区域名称。
member_count
社区成员数。
Nextdoor profile 调用流程一次 Nextdoor profile 调用的全过程:向 POST /api/v1/social 发送 platform="nextdoor"、action="profile",以及必填参数 url;返回结构化 JSON,含 name、page_type、url、description、tagline 等字段;返回单个对象,计费 $1.39 / 千次,失败与空结果不计费。1 · 请求POST /api/v1/socialplatform: "nextdoor"action: "profile"urlEveryInfra$1.39 / 千次2 · 响应 · 对象namepage_typeurldescriptiontagline
一次 Nextdoor profile 调用的全过程:向 POST /api/v1/social 发送 platform="nextdoor"、action="profile",以及必填参数 url;返回结构化 JSON,含 name、page_type、url、description、tagline 等字段;返回单个对象,计费 $1.39 / 千次,失败与空结果不计费。

Nextdoor 原始字段名

EveryInfra 统一字段名

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

Nextdoor 的独有字段名(当前目录)

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

  • page_type
  • residents_count
  • average_age
  • average_income
  • homeowner_pct
  • affordability_score
  • friendliness_score
  • neighborhood_count
  • business_directory_count
  • local_group_count
  • classifieds_count
  • events_count
  • safety_post_count
  • trending_post_count
  • photo_video_post_count
  • faq_count
  • faqs
  • access_status

返回字段含义

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

name
名称。用于账号/商品/商家类能力,指该对象本身的名字。
page_type
页面类型(社区/商家/城市等)。
url
该记录在原平台上的可访问链接。
description
简介或描述,通常比 text 短。
tagline
社区或商家的一句话简介。
state
州。
country_code
国家代码。
lat
纬度。
lng
经度。
residents_count
该区域居民数。
average_age
居民平均年龄。
average_income
居民平均收入。
homeowner_pct
自有住房比例,百分数。
affordability_score
生活成本可负担度评分,Nextdoor 自有模型。
friendliness_score
社区友好度评分,来自居民打分。
neighborhood_count
包含的街区数量。
business_directory_count
商家目录收录数。
local_group_count
本地小组数量。
classifieds_count
二手交易帖数量。
events_count
活动数量。
safety_post_count
安全类帖子数。这类帖多寡是判断治安体感的间接信号。
trending_post_count
热门帖数量。
photo_video_post_count
图片视频帖数量。
faq_count
常见问题数量。
faqs
常见问题列表。
image_url
图片链接。多图能力可能返回 image_urls 数组。
access_status
访问权限状态(公开/需验证地址)。
platform
数据来源平台标识,与请求里的 platform 一致(如 xiaohongshu、tiktok)。
kind
条目类别。
member_count
社区成员数。
area
区域名称。

请求填写示例

替换为公开区域或目录页;profile 在这里不是个人账号资料。

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

nextdoor_profile.sh
curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer omg_你的KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"nextdoor","action":"profile","params":{"url":"<公开 Nextdoor 城市、社区或商家完整 URL>"}}'

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

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

fields.preview.json
{
  "name": null,
  "page_type": null,
  "url": null,
  "description": null,
  "tagline": null,
  "state": null,
  "country_code": null,
  "lat": null,
  "lng": null,
  "residents_count": null,
  "average_age": null,
  "average_income": null,
  "homeowner_pct": null,
  "affordability_score": null,
  "friendliness_score": null,
  "neighborhood_count": null,
  "business_directory_count": null,
  "local_group_count": null,
  "classifieds_count": null,
  "events_count": null,
  "safety_post_count": null,
  "trending_post_count": null,
  "photo_video_post_count": null,
  "faq_count": null,
  "faqs": null,
  "image_url": null,
  "access_status": null,
  "platform": null
}

常见用例

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

读取 Nextdoor 地区资料,而不是个人档案

用 profile 核对公开城市或社区页面的资料范围。

查看 profile 的 url 参数 →
  • url 是公开城市、社区或商家页面;name / page_type / url 用于确认对象,不是居民姓名和个人主页。社区或商家页面可能只有标题、简介和图片,不能要求每页都返回人口与评分。
  • residents_count、average_age / average_income 是页面中的区域统计,不是逐户画像,也没有可据此验证的统计年份。safety_post_count 只是安全类帖子数量,不是犯罪率;affordability_score / friendliness_score 也不宜跨地区直接比较。
  • faqs 是问题与答案数组,不能因出现 FAQ 就认定内容经过政府认证。access_status 描述取得页面的状态,不授予私密动态、成员名单或地址验证权限。

按 Nextdoor 目录类别整理本地条目

用 directory 将公开地区页里的社区、商家和小组分别归类。

查看 directory 的 url 参数 →
  • url 指向待整理地区页;kind 区分 neighborhood、business、business_directory、local_group,area 保留来源地区。name / url 是目录条目标识,不表示已经取得该条目的完整资料或通过商家身份验证。
  • member_count 仅在条目有值时使用,不当作全城人口;limit 对每个目录分区起作用,合并后不保证总条数等于 limit。空列表也不能推断该地区没有商家或社区。
  • 本接口不返回居民私密帖子或逐个成员,不提供关注、发帖、评论或私信操作;平台帮助中的邻里互动功能不是这里的 API 能力。

Nextdoor API 常见问题

Nextdoor API 怎么调用?

调用 POST /api/v1/social,请求体传 platform="nextdoor"、action 和 params。以 profile 为例,必填 url,没有可选参数。替换为公开区域或目录页;profile 在这里不是个人账号资料。 Nextdoor 共 2 个 action,鉴权用 Authorization: Bearer <API Key>,同一把 Key 通 89 个平台。

Nextdoor API 怎么收费?

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

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

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

Nextdoor API 返回哪些字段?

当前目录为 profile 列出 name、page_type、url、description、tagline、state 等 28 个字段名。按全站当前目录统计,19 个字段名只在 Nextdoor 出现;这不表示其他平台没有同类信息。字段不保证每次齐全,嵌套位置、类型与空值须按各接口说明核对,同名字段不代表语义可互换。

「读取 Nextdoor 地区资料,而不是个人档案」怎样接入 Nextdoor API?

用 profile 核对公开城市或社区页面的资料范围。 url 是公开城市、社区或商家页面;name / page_type / url 用于确认对象,不是居民姓名和个人主页。社区或商家页面可能只有标题、简介和图片,不能要求每页都返回人口与评分。 residents_count、average_age / average_income 是页面中的区域统计,不是逐户画像,也没有可据此验证的统计年份。safety_post_count 只是安全类帖子数量,不是犯罪率;affordability_score / friendliness_score 也不宜跨地区直接比较。 faqs 是问题与答案数组,不能因出现 FAQ 就认定内容经过政府认证。access_status 描述取得页面的状态,不授予私密动态、成员名单或地址验证权限。

「按 Nextdoor 目录类别整理本地条目」怎样接入 Nextdoor API?

用 directory 将公开地区页里的社区、商家和小组分别归类。 url 指向待整理地区页;kind 区分 neighborhood、business、business_directory、local_group,area 保留来源地区。name / url 是目录条目标识,不表示已经取得该条目的完整资料或通过商家身份验证。 member_count 仅在条目有值时使用,不当作全城人口;limit 对每个目录分区起作用,合并后不保证总条数等于 limit。空列表也不能推断该地区没有商家或社区。 本接口不返回居民私密帖子或逐个成员,不提供关注、发帖、评论或私信操作;平台帮助中的邻里互动功能不是这里的 API 能力。

可以先免费试用 Nextdoor API 吗?

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

开始调用 Nextdoor API

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

免费开始