Naver Cafe Posts API
Search public Naver Cafe posts by keyword, including full text, comments and replies.
API Description
Naver Cafe Posts API Search public Naver Cafe posts by keyword, including full text, comments and replies.
Request URL
Request Headers
| Parameters | Parameter value | Type | Description |
|---|---|---|---|
| Content-Type | application/json | string | Data format |
| Authorization | Bearer xxx | string | Authorization Token |
Collection timeout: 230 seconds. Allow at least 245 seconds in your client.
Request Parameters
| Parameter | Required | Type | Description |
|---|---|---|---|
| country | Yes | string | Storefront country code; UK is normalized to GB. |
| keyword | Yes | string | Search keyword, 1–100 characters. Minimum length: 1 Maximum length: 100 |
| page | No | integer | Starts at 1; continue with pagination.nextPage. Summaries accept page=1 only. Minimum: 1 Maximum: 1020 |
| pageSize | No | integer | See site table for defaults and limits; omit to use storefront default. Minimum: 1 Maximum: 30 |
| includeComments | No | boolean | Defaults to true; includes post comments. |
| commentPage | No | integer | Starting comment page, 1–20. Minimum: 1 Maximum: 20 |
| commentPageSize | No | integer | 20 or 100 comments per page; defaults to 100. Values: [20, 100] |
| commentPages | No | integer | Consecutive comment pages starting at commentPage; defaults to 1, up to 20. Minimum: 1 Maximum: 20 |
| includeNative | No | boolean | Defaults to true; includes original platform fields. |
| refresh | No | boolean | Defaults to false; true bypasses fresh cache. |
| allowStale | No | boolean | Defaults to false; true permits stale cache on failure, identified in meta. |
Public Korean community posts only. Comment pages start at 1–20 with 20 or 100 items per page. commentPages collects consecutive pages from commentPage, up to 20 pages. Search traversal has been verified up to 34 upstream pages; this is not a platform hard limit.
Response Fields
| Field | Type | Description |
|---|---|---|
| code | integer | Status code; 0 indicates success. |
| message | string | Response message; ok on success. |
| pointCost | number | Points charged for the complete response. |
| data | object | null | Collected data, described below. |
data Fields
| Field | Type | Description |
|---|---|---|
| country | string | Storefront country, not the review author’s country. |
| pagination | object | Pagination details; continue using nextPage. |
| failures | any[] | Failed items; inspect with meta.status for partial failures. |
| query | object | Effective search parameters. |
| warnings | string[] | Collection scope and data interpretation notes. |
| totals | object | Reported totals and returned counts, which may use different count semantics. |
| platform | string | Platform identifier. |
| sourceUrl | string | sourceUrl |
| provider | string | provider |
| meta | object | Collection status and cache metadata. |
| capturedAt | string | Collection timestamp. |
| results | object[] | Primary records returned by this request. |
| limits | object | Verified search and comment pagination ranges. |
data.pagination Fields
| Field | Type | Description |
|---|---|---|
| stopReason | string | Reason collection or pagination stopped. |
| nextPage | integer | Next page number; null indicates the end. |
| totalPages | null | Total pages; null when unknown. |
| pageSize | integer | Records per page. |
| upstreamPagesFetched | integer | upstreamPagesFetched |
| hasNext | boolean | Whether another page is available. |
| page | integer | Current page number. |
data.totals Fields
| Field | Type | Description |
|---|---|---|
| discovered | integer | discovered |
| comments | integer | Comments and replies included with the post. |
| replies | integer | replies |
| query | null | Effective search parameters. |
| reported | null | reported |
| returned | integer | returned |
| selected | integer | selected |
data.meta Fields
| Field | Type | Description |
|---|---|---|
| cache | string | cache |
| stale | boolean | stale |
| ageSeconds | integer | ageSeconds |
| operationId | string | operationId |
| upstreamAttempts | integer | upstreamAttempts |
| coalesced | boolean | coalesced |
| status | string | Collection completion status. |
data.results[] Fields
| Field | Type | Description |
|---|---|---|
| comments | object[] | Comments and replies included with the post. |
| commentPagination | object | Comment pagination for this post. |
| author | string | Author name. |
| articleId | string | articleId |
| title | string | Review or post title; null when unavailable. |
| contentHtml | string | Original HTML body; sanitize before displaying. |
| readCount | integer | readCount |
| content | string | Body text in the original language. |
| commentCount | integer | commentCount |
| sourceUrl | string | sourceUrl |
| createdAt | string | Full publication timestamp; null when unavailable. |
| cafe | object | Community containing the post. |
| native | object | Original platform fields, controlled by includeNative. |
| id | string | Unique record identifier. |
data.results[].comments[] Fields
| Field | Type | Description |
|---|---|---|
| createdAt | null | Full publication timestamp; null when unavailable. |
| deleted | boolean | deleted |
| native | object | Original platform fields, controlled by includeNative. |
| author | string | Author name. |
| id | string | Unique record identifier. |
| type | string | comment identifies a root comment; reply identifies a reply. |
| photos | any[] | Original image objects, including available sizes. |
| parentId | null | Parent comment ID; null for root comments. |
| content | string | Body text in the original language. |
| updatedAt | string | Last update timestamp. |
data.results[].commentPagination Fields
| Field | Type | Description |
|---|---|---|
| stopReason | string | Reason collection or pagination stopped. |
| lastPage | integer | lastPage |
| nextPage | null | Next page number; null indicates the end. |
| pagesFetched | integer | pagesFetched |
| upstreamHasNext | boolean | upstreamHasNext |
| totalPages | null | Total pages; null when unknown. |
| pageSize | integer | Records per page. |
| hasNext | boolean | Whether another page is available. |
| page | integer | Current page number. |
| status | string | Collection completion status. |
data.results[].cafe Fields
| Field | Type | Description |
|---|---|---|
| name | string | name |
| id | string | Unique record identifier. |
| slug | string | slug |
| url | string | url |
Continue using data.pagination.nextPage until null. For Cafe, also inspect each post’s commentPagination, failures and meta.status. complete describes this request only.
Errors retain the response envelope and data.error. Codes: invalid parameters 1002, rate limit 4029, busy 5001, collection failure 9200. HTTP 503 cooldown responses retain Retry-After.
Request Example
Response Example
This excerpt retains the first list item and shortens long text and URLs. pointCost is the charge for the complete response.
Points Usage
0.8 points per post. Included comments and replies are free.
Each successful call is billed independently, including cached responses. Errors and empty lists cost zero; pointCost reports the charge.

