万有引擎
搜索⌘K
中文
登录免费开始

社交内容 · 数据 API

Naver

Naver API

分别读取 Naver Blog 博客、Cafe 社区文章及评论，并按 Place 地点链接整理访客点评、到访信息和商家回复，供韩国内容与门店调研使用。 调用 POST /api/v1/social ；返回结构化 JSON，$1.39 / 千次；失败不计费。

免费开始 看文档

4

个能力

$1.39 / 千次

能力价格

同步

调用模式

1 个

一把 Key 通用 89 个平台

Naver 能力清单

action必填参数可选参数单次条数模式单价返回字段
searchkeywordcontent_type, sort默认 10 · 最多 20同步$1.39 / 千次source · title · url · text · author_name · author_url · cafe_name · category · like_count · comment_count · posted_at · has_video · is_sponsored · platform · tags · image_urls · mentioned_places
posturl——同步$1.39 / 千次source · title · url · text · author_name · author_url · cafe_name · category · like_count · comment_count · posted_at · has_video · is_sponsored · platform · tags · image_urls · mentioned_places
commentsurl——同步$1.39 / 千次author_name · text · posted_at · is_reply · platform · post_url
reviewsurl—默认 50 · 最多 200同步$1.39 / 千次id · place_id · place_name · text · rating · rating_scale · visited_at · posted_at · visit_count · view_count · item_name · origin_type · language · owner_reply · author_id · author_name · author_review_count · place_total_reviews · place_average_rating · platform

Naver 每个接口分别做什么

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

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

怎么调用 Naver 单条内容 API？

post

使用 platform="naver"、action="post" 调用“单条内容”能力；返回单个对象，主要包含 source、title、url、text、author_name、author_url 等 17 个字段。

Naver post 的参数分别是什么意思？

url必填
具体 Naver Blog 或 Cafe 文章 URL；返回该文章正文，不接受 Naver Place 商户链接。

Naver 官方 Blog 搜索结果区分文章标题、摘要、博客名称、发布日期和 link。EveryInfra post 以具体 Blog 或 Cafe URL 定位单篇内容是自身实现；该来源不证明任意链接可读、正文完整或私密与已删除内容可访问。官方来源：Naver Blog：搜索结果中的文章链接与公开正文来源核查：

Naver 特有返回字段与含义（4）
cafe_name
Naver Cafe（社区）名称。
is_sponsored
是否为推广内容。Naver 搜索结果广告位很多，过滤靠它。
source
来源。
has_video
是否有视频。

怎么调用 Naver 评论 API？

comments

使用 platform="naver"、action="comments" 调用“评论”能力；返回列表，主要包含 author_name、text、posted_at、is_reply、platform、post_url。

Naver comments 的参数分别是什么意思？

url必填
具体 Naver Blog 或 Cafe 文章 URL；返回该文章的评论，不是 Naver Place 商户评价。

Naver 官方帮助确认 Blog 文章可启用或关闭评论，公开设置也会影响他人能否读取内容；官方开放接口没有提供读取任意 Blog 或 Cafe 文章评论列表的通用能力，不能为 EveryInfra 的完整 URL、浏览器读取、分页或最大数量背书。官方来源：Naver：Blog 文章评论与公开设置来源核查：

Naver 特有返回字段与含义（1）
is_reply
是否为回复。

怎么调用 Naver 评价 API？

reviews

使用 platform="naver"、action="reviews" 调用“评价”能力；返回列表，默认 50 条、单次最多 200 条，主要包含 id、place_id、place_name、text、rating、rating_scale 等 20 个字段。

Naver reviews 的参数分别是什么意思？

url必填
Naver Place 商户链接，例如路径含 /restaurant/商户ID 或 /place/商户ID；用于读取该地点的访客评价。

Naver 官方说明 MY Place 评论可来自预约、订单或收据认证，评论详情可含文本、关键词、照片、商户信息和浏览量；官方没有逐条地点评论读取 API，Local Search 中的 comment 也只是评论数量排序。EveryInfra 的地点 URL、数字 ID 提取、逐条正文、maxReviewPages 和排序均属于自身实现。官方来源：Naver MY Place：访问评论的来源和详情字段来源核查：

Naver 特有返回字段与含义（10）
place_id
地点 ID。
place_name
地点名称。
place_average_rating
地点均分。
place_total_reviews
地点总评价数。
item_name
商品/条目名称。
owner_reply
商家回复。
author_review_count
评价人的历史评价数。
visit_count
评价人到访次数（Naver 点评带回访记录）。
visited_at
到访时间。
origin_type
内容来源类型。
Naver search 调用流程一次 Naver search 调用的全过程：向 POST /api/v1/social 发送 platform="naver"、action="search"，以及必填参数 keyword;返回结构化 JSON，含 source、title、url、text、author_name 等字段；返回列表，单次最多 20 条，计费 $1.39 / 千次，失败与空结果不计费。1 · 请求POST /api/v1/socialplatform: "naver"action: "search"keywordEveryInfra$1.39 / 千次2 · 响应 · 列表sourcetitleurltextauthor_name
一次 Naver search 调用的全过程：向 POST /api/v1/social 发送 platform="naver"、action="search"，以及必填参数 keyword;返回结构化 JSON，含 source、title、url、text、author_name 等字段；返回列表，单次最多 20 条，计费 $1.39 / 千次，失败与空结果不计费。

Naver 原始字段名

EveryInfra 统一字段名

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

Naver 的独有字段名（当前目录）

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

  • cafe_name
  • mentioned_places
  • visited_at
  • visit_count
  • item_name
  • origin_type
  • place_total_reviews
  • place_average_rating

返回字段含义

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

source
来源。
title
标题。平台无标题概念时（如纯文本帖）为 null。
url
该记录在原平台上的可访问链接。
text
正文内容，已去除 HTML 标签。长文可能被截断。
author_name
作者昵称（显示名）。
author_url
作者在原平台的主页链接。
cafe_name
Naver Cafe（社区）名称。
category
分类名称，取值为原平台的分类体系，未做跨平台归一。
like_count
点赞数。null 表示该平台或该接口不公开此数据，不等于 0。
comment_count
评论数。null 表示不公开，不等于 0。
posted_at
发布时间，ISO 8601 格式、UTC 时区（如 2026-08-07T12:34:56+00:00）。平台只给非标准字符串时原样透传，解析前建议做容错。null 表示平台未公开。
has_video
是否有视频。
is_sponsored
是否为推广内容。Naver 搜索结果广告位很多，过滤靠它。
platform
数据来源平台标识，与请求里的 platform 一致（如 xiaohongshu、tiktok）。
tags
标签数组。无标签时为空数组，不是 null。
is_reply
是否为回复。
id
该记录在原平台上的唯一标识。仅在同一平台内唯一，跨平台可能重复。
place_id
地点 ID。
place_name
地点名称。
rating
评分。分制随平台而异，同一行的 rating_scale 给出该平台满分 (多数是 5，Booking/豆瓣/爱奇艺/NAVER 是 10)。跨平台比较前必须先按 rating_scale 换算 —— 直接比数字会得出反的结论。
rating_scale
上一列 rating 的满分。5 表示五星制、10 表示十分制。只在该行有 rating 时出现。
visited_at
到访时间。
visit_count
评价人到访次数（Naver 点评带回访记录）。
view_count
浏览/播放数。null 表示不公开，不等于 0。
item_name
商品/条目名称。
origin_type
内容来源类型。
language
内容语言代码（如 zh、en），由平台判定，可能不准。
owner_reply
商家回复。
author_id
作者在原平台的唯一 ID。
author_review_count
评价人的历史评价数。
place_total_reviews
地点总评价数。
place_average_rating
地点均分。

当前目录另列出 image_urls · mentioned_places · post_url，这些字段尚无逐项释义；请先核对 Naver 对应接口的用例与实际响应，不按字段名猜测类型或含义。

请求填写示例

search 查 Naver Blog / Cafe 内容；这里是咖啡馆相关内容词，不是地图商户或评价全文检索。

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

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

记录字段预览（非真实响应）

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

fields.preview.json
{
  "source": null,
  "title": null,
  "url": null,
  "text": null,
  "author_name": null,
  "author_url": null,
  "cafe_name": null,
  "category": null,
  "like_count": null,
  "comment_count": null,
  "posted_at": null,
  "has_video": null,
  "is_sponsored": null,
  "platform": null,
  "tags": null,
  "image_urls": null,
  "mentioned_places": null
}

常见用例

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

怎样区分 Naver Blog 博客与 Cafe 社区的搜索结果？

search 用韩文或其他 keyword 发现文章，再用 content_type 指定 Blog、Cafe 或两类内容，避免把 Cafe 当作线下咖啡店。

查看 search 的 content_type 参数 →
  • content_type 的 blog_only、cafe_only、both_blog_cafe 是内容来源，不是文本与 HTML 的输出格式。sort 的 newest 与 relevance 分别指文章日期和相关性，不是 Place 评价排序。
  • source 用于分辨来源，cafe_name 是社区名，author_url 在 Cafe 结果中可能是社区入口，不能统一当成个人作者页。title、text 和 posted_at 用于初筛，搜索文本不保证始终是完整文章。

怎样读取一篇 Naver Blog 或 Cafe 文章？

post 用具体文章 url 读取文章对象，适合从搜索发现的内容继续查看正文、互动和是否包含视频。

查看 post 的 url 参数 →
  • url 填文章页面，不是 Blog 首页、Cafe 社区总页或 Place 商户页；返回单个文章对象，不是全站文章列表。共享的 content_type 不会把指定 URL 改成关键词搜索。
  • text 与 title 是文章内容，comment_count 是评论数量而非评论正文；has_video 是视频存在标识，不是视频下载能力。is_sponsored 只是响应中的标识，缺失不能推断为非商业内容。

怎样分析 Naver 文章下的评论而非店铺点评？

comments 接收一篇 Blog 或 Cafe 文章 url，提取文章讨论中的作者、正文和回复标识。

查看 comments 的 url 参数 →
  • 此 url 与 post 使用同一种文章对象；Naver Place 商户评价应使用 reviews。当前没有专用评论排序或翻页参数，不能根据文章排序选项承诺评论顺序。
  • is_reply 表示该条是否为回复，但当前字段没有父评论 ID，不能据此重建完整讨论树。posted_at 的部分日期只做格式整理且不带时区，不应一律解释为 UTC。

怎样把 Naver Place 到访评价与商户统计区分开？

reviews 用包含 Place 商户数字 ID 的完整链接定位地点，整理逐条访客评价、到访信息及商家回复。

查看 reviews 的 url 参数 →
  • 建议 url 使用含 /restaurant/商户ID 或 /place/商户ID 的链接；它不是文章 URL。虽然列出 keyword，当前必填 url 会优先作为定位对象，不能把 keyword 当作评论全文过滤器。
  • visited_at 是到访信息，posted_at 是评价发布信息；rating 是单条分数，place_average_rating 与 place_total_reviews 属于整个地点，不是本次返回条数。text 最多保留 3000 字符，owner_reply 最多 1000 字符，不承诺原文无截断，也不承诺返回全部评价。

Naver API 常见问题

Naver API 怎么调用？

调用 POST /api/v1/social，请求体传 platform="naver"、action 和 params。以 search 为例，必填 keyword，可选 content_type、sort。search 查 Naver Blog / Cafe 内容；这里是咖啡馆相关内容词，不是地图商户或评价全文检索。 Naver 共 4 个 action，鉴权用 Authorization: Bearer <API Key>,同一把 Key 通 89 个平台。

Naver API 怎么收费？

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

Naver API 一次能返回多少条数据？

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

Naver API 返回哪些字段？

当前目录为 search 列出 source、title、url、text、author_name、author_url 等 17 个字段名。按全站当前目录统计，8 个字段名只在 Naver 出现；这不表示其他平台没有同类信息。字段不保证每次齐全，嵌套位置、类型与空值须按各接口说明核对，同名字段不代表语义可互换。

怎样区分 Naver Blog 博客与 Cafe 社区的搜索结果？

search 用韩文或其他 keyword 发现文章，再用 content_type 指定 Blog、Cafe 或两类内容，避免把 Cafe 当作线下咖啡店。 content_type 的 blog_only、cafe_only、both_blog_cafe 是内容来源，不是文本与 HTML 的输出格式。sort 的 newest 与 relevance 分别指文章日期和相关性，不是 Place 评价排序。 source 用于分辨来源，cafe_name 是社区名，author_url 在 Cafe 结果中可能是社区入口，不能统一当成个人作者页。title、text 和 posted_at 用于初筛，搜索文本不保证始终是完整文章。

怎样读取一篇 Naver Blog 或 Cafe 文章？

post 用具体文章 url 读取文章对象，适合从搜索发现的内容继续查看正文、互动和是否包含视频。 url 填文章页面，不是 Blog 首页、Cafe 社区总页或 Place 商户页；返回单个文章对象，不是全站文章列表。共享的 content_type 不会把指定 URL 改成关键词搜索。 text 与 title 是文章内容，comment_count 是评论数量而非评论正文；has_video 是视频存在标识，不是视频下载能力。is_sponsored 只是响应中的标识，缺失不能推断为非商业内容。

怎样分析 Naver 文章下的评论而非店铺点评？

comments 接收一篇 Blog 或 Cafe 文章 url，提取文章讨论中的作者、正文和回复标识。 此 url 与 post 使用同一种文章对象；Naver Place 商户评价应使用 reviews。当前没有专用评论排序或翻页参数，不能根据文章排序选项承诺评论顺序。 is_reply 表示该条是否为回复，但当前字段没有父评论 ID，不能据此重建完整讨论树。posted_at 的部分日期只做格式整理且不带时区，不应一律解释为 UTC。

怎样把 Naver Place 到访评价与商户统计区分开？

reviews 用包含 Place 商户数字 ID 的完整链接定位地点，整理逐条访客评价、到访信息及商家回复。 建议 url 使用含 /restaurant/商户ID 或 /place/商户ID 的链接；它不是文章 URL。虽然列出 keyword，当前必填 url 会优先作为定位对象，不能把 keyword 当作评论全文过滤器。 visited_at 是到访信息，posted_at 是评价发布信息；rating 是单条分数，place_average_rating 与 place_total_reviews 属于整个地点，不是本次返回条数。text 最多保留 3000 字符，owner_reply 最多 1000 字符，不承诺原文无截断，也不承诺返回全部评价。

可以先免费试用 Naver API 吗？

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

更多社交内容 API

Behance APIB站 APIBluesky APIDailymotion APIDeviantArt APIDiscord API豆瓣 API抖音 API全部 89 平台 ↗

开始调用 Naver API

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

免费开始