​
接口说明

Naver Cafe Posts API 按关键词检索 Naver Cafe 公开帖子，返回正文及附带评论和回复。

​
请求URL

POST https://scrapeapi.pangolinfo.com/api/v1/social/naver-cafe/posts

​
请求头

参数名参数值类型说明
Content-Typeapplication/jsonstring数据格式
AuthorizationBearer xxxstring认证凭证

采集超时230秒，客户端超时建议至少245秒。

​
请求参数

参数必填类型说明
countryYesstring站点国家码；UK归一为GB。
keywordYesstring搜索关键词，1–100字符。
最少字符: 1
最多字符: 100
pageNointeger从1开始；用响应pagination.nextPage续页。汇总仅page=1。
最小值: 1
最大值: 1020
pageSizeNointeger各站点默认值和最大值见站点表；不传则沿用站点默认。
最小值: 1
最大值: 30
includeCommentsNoboolean默认true，返回帖子附带评论。
commentPageNointeger起始评论页，1–20。
最小值: 1
最大值: 20
commentPageSizeNointeger每页20或100条，默认100。
可用值: [20, 100]
commentPagesNointeger连续采集评论页数，默认1，最多20；从commentPage起。
最小值: 1
最大值: 20
includeNativeNoboolean默认true，保留原始平台字段。
refreshNoboolean默认false；true跳过新鲜缓存。
allowStaleNoboolean默认false；true允许失败时返回旧缓存，meta会注明。

仅支持韩国公开社区帖子。评论起始页1–20，每页20或100条；commentPages 从 commentPage 起连续获取，最多20页。搜索已验证最多遍历34个上游页，该范围并非平台硬上限。

​
响应值

返回值类型说明
codeinteger状态码，0 表示成功。
messagestring响应信息，成功时为 ok。
pointCostnumber本次完整响应实际消耗的积点。
dataobject | null返回数据，字段见下表。

​
返回参数 data 说明

返回值类型说明
countrystring采集站点国家，不代表评论作者的国家。
paginationobject分页结果，续页时使用 nextPage。
failuresany[]失败条目；需结合 meta.status 判断部分失败。
queryobject本次生效的检索参数。
warningsstring[]采集范围及数据口径提示。
totalsobject平台报告总量与本次返回数量，口径可能不同。
platformstring平台标识。
sourceUrlstringsourceUrl
providerstringprovider
metaobject采集状态、缓存信息等元数据。
capturedAtstring本次数据采集时间。
resultsobject[]本次返回的主体记录数组。
limitsobject已验证的搜索及评论分页范围。

​
data.pagination 字段说明

返回值类型说明
stopReasonstring停止采集或分页的原因。
nextPageinteger下一页页码；null 表示结束。
totalPagesnull总页数；未知时为 null。
pageSizeinteger每页记录数。
upstreamPagesFetchedintegerupstreamPagesFetched
hasNextboolean是否还有下一页。
pageinteger本次页码。

​
data.totals 字段说明

返回值类型说明
discoveredintegerdiscovered
commentsinteger帖子附带的评论及回复。
repliesintegerreplies
querynull本次生效的检索参数。
reportednullreported
returnedintegerreturned
selectedintegerselected

​
data.meta 字段说明

返回值类型说明
cachestringcache
stalebooleanstale
ageSecondsintegerageSeconds
operationIdstringoperationId
upstreamAttemptsintegerupstreamAttempts
coalescedbooleancoalesced
statusstring采集完成状态。

​
data.results[] 字段说明

返回值类型说明
commentsobject[]帖子附带的评论及回复。
commentPaginationobject该帖评论分页状态。
authorstring作者名称。
articleIdstringarticleId
titlestring评论或帖子标题，缺失时为 null。
contentHtmlstring原始 HTML 正文；展示前须清理不可信 HTML。
readCountintegerreadCount
contentstring正文，保留平台原文。
commentCountintegercommentCount
sourceUrlstringsourceUrl
createdAtstring发布时间，保留完整时间；不可用时为 null。
cafeobject帖子所属社区。
nativeobject平台原始字段；includeNative 控制是否返回。
idstring记录唯一标识。

​
data.results[].comments[] 字段说明

返回值类型说明
createdAtnull发布时间，保留完整时间；不可用时为 null。
deletedbooleandeleted
nativeobject平台原始字段；includeNative 控制是否返回。
authorstring作者名称。
idstring记录唯一标识。
typestringcomment 为评论，reply 为回复。
photosany[]保留图片各尺寸的原始对象。
parentIdnull所属评论 ID；一级评论为 null。
contentstring正文，保留平台原文。
updatedAtstring更新时间。

​
data.results[].commentPagination 字段说明

返回值类型说明
stopReasonstring停止采集或分页的原因。
lastPageintegerlastPage
nextPagenull下一页页码；null 表示结束。
pagesFetchedintegerpagesFetched
upstreamHasNextbooleanupstreamHasNext
totalPagesnull总页数；未知时为 null。
pageSizeinteger每页记录数。
hasNextboolean是否还有下一页。
pageinteger本次页码。
statusstring采集完成状态。

​
data.results[].cafe 字段说明

返回值类型说明
namestringname
idstring记录唯一标识。
slugstringslug
urlstringurl

下一页使用 data.pagination.nextPage，为 null 时结束。Cafe 评论还须检查每帖 commentPagination、failures 和 meta.status；complete 仅表示本次请求完成。

失败保留统一响应外壳及 data.error；参数错误 code=1002、限流4029、暂忙5001、采集失败9200。HTTP 503 冷却响应保留 Retry-After。

​
请求示例

curl --request POST \
  --url https://scrapeapi.pangolinfo.com/api/v1/social/naver-cafe/posts \
  --header 'Authorization: Bearer YOUR_PANGOLINFO_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "country": "KR",
  "pageSize": 1,
  "keyword": "로보락",
  "commentPageSize": 20
}'

​
返回示例

下例截取实际响应首条列表记录，长文本和链接作了缩写；pointCost 为完整响应的实际费用。

{
  "code": 0,
  "pointCost": 0.8,
  "data": {
    "country": "KR",
    "pagination": {
      "stopReason": "more_available",
      "nextPage": 2,
      "totalPages": null,
      "pageSize": 1,
      "upstreamPagesFetched": 1,
      "hasNext": true,
      "page": 1
    },
    "failures": [],
    "query": {
      "commentPage": 1,
      "commentPages": 1,
      "pageSize": 1,
      "page": 1,
      "keyword": "로보락",
      "includeComments": true,
      "commentPageSize": 20
    },
    "warnings": [
      "Search traverses up to 34 upstream pages; page/pageSize slice deduplicated links (up to 30 posts per API call). This verified range is not a platform hard li..."
    ],
    "totals": {
      "discovered": 30,
      "comments": 3,
      "replies": 4,
      "query": null,
      "reported": null,
      "returned": 1,
      "selected": 1
    },
    "platform": "naver-cafe",
    "sourceUrl": "https://search.naver.com/search.naver?ssc=tab.cafe.all&query=%EB%A1%9C%EB%B3%B4%EB%9D%BD",
    "provider": "naver-cafe",
    "meta": {
      "cache": "miss",
      "stale": false,
      "ageSeconds": 5,
      "operationId": "a8193c4a-e978-47ff-afc1-edf05009d21c",
      "upstreamAttempts": 4,
      "coalesced": false,
      "status": "complete"
    },
    "capturedAt": "2026-11-07T11:49:54.377Z",
    "results": [
      {
        "comments": [
          {
            "createdAt": null,
            "deleted": false,
            "native": {
              "updateDate": 1793845720000,
              "isDeleted": false,
              "id": "234561668",
              "refId": "234561668",
              "content": "전 정말 기본모델인데도 나요~ 어쩔 수 없는 거 같아요~ 걸레 한 번 싹~ 삶으면 괜찮아요~"
            },
            "author": "네잎클로버엄마",
            "id": "234561668",
            "type": "comment",
            "photos": [],
            "parentId": null,
            "content": "전 정말 기본모델인데도 나요~ 어쩔 수 없는 거 같아요~ 걸레 한 번 싹~ 삶으면 괜찮아요~",
            "updatedAt": "2026-11-05T02:28:40.000Z"
          }
        ],
        "commentPagination": {
          "stopReason": "upstream_end",
          "lastPage": 1,
          "nextPage": null,
          "pagesFetched": 1,
          "upstreamHasNext": false,
          "totalPages": null,
          "pageSize": 20,
          "hasNext": false,
          "page": 1,
          "status": "complete"
        },
        "author": "고요한바다",
        "articleId": "14991380",
        "title": "로보락 스팀아니어도 걸레냄새 안나나요?",
        "contentHtml": "<div class=\"se-viewer se-theme-default\" lang=\"ko-KR\">\n    <!-- SE_DOC_HEADER_START -->\n    <!--@CONTENTS_HEADER-->\n    <!-- SE_DOC_HEADER_END -->\n    <div cl...",
        "readCount": 117,
        "content": "스테이션 분리되서 자주 청소를 하는게\n중요할 것 같아서 슬림 모델로 결제했거든요.\n근데 이 모델은 또 걸레 스팀 세척은 안되고..\n해서 울트라랑 슬림중에 어떤게 나은 선택일지\n고민이돼요. \n​\n로보락 걸레 냄새 괜찮으신가요?",
        "commentCount": 7,
        "sourceUrl": "https://cafe.naver.com/skybluezw4rh/14991380",
        "createdAt": "2026-11-05T02:23:44.500Z",
        "cafe": {
          "name": "맘이베베",
          "id": "29434212",
          "slug": "skybluezw4rh",
          "url": "https://cafe.naver.com/skybluezw4rh"
        },
        "native": {
          "subject": "로보락 스팀아니어도 걸레냄새 안나나요?",
          "writeDate": 1793845424500,
          "id": "14991380",
          "contentHtml": "<div class=\"se-viewer se-theme-default\" lang=\"ko-KR\">\n    <!-- SE_DOC_HEADER_START -->\n    <!--@CONTENTS_HEADER-->\n    <!-- SE_DOC_HEADER_END -->\n    <div cl...",
          "readCount": 117,
          "menu": {
            "name": "자유 수다방",
            "id": "16"
          },
          "commentCount": 7
        },
        "id": "29434212:14991380"
      }
    ],
    "limits": {
      "search": {
        "maxUpstreamPages": 34,
        "upstreamPageSize": 30,
        "verifiedUniqueLinks": 1015,
        "verifiedBodies": 67,
        "defaultPageSize": 3,
        "evidence": "docs/NAVER-CAFE-SEARCH-PAGINATION-20261027.md",
        "maxPageSize": 30,
        "verifiedAt": "2026-10-27"
      },
      "comments": {
        "defaultPageSize": 100,
        "evidence": "docs/PAGINATION-LIMITS.md",
        "maxPages": 20,
        "maxPageSize": 100,
        "verifiedAt": "2026-10-30",
        "verifiedItems": 1959
      },
      "platformHardLimit": false,
      "updatedAt": "2026-10-30"
    }
  },
  "message": "ok"
}

​
积点消耗说明

每条帖子消耗0.8积点，附带评论及回复免费。

每次成功请求独立计费，命中缓存也按返回主体收费；失败及空列表不扣费，以 pointCost 为准。