Naver Search API

POST

API health

24h health
Normal
24h average time
—
Last checked
September 26, 2026 at 18:04 (UTC)
  • Healthy / normal
  • Available
  • Limited
  • Mostly down
Health APINormal
How health is measured
  • Health = the share of calls that returned data, in percent. Empty results, failures and unknown outcomes do not count as returning data.
  • Levels: 90% and above is healthy, 70% and above is available, 40% and above is limited; anything lower is mostly down.
  • A period (the last 24 hours, one hour or one day) gets a score only once it has at least 50 calls. Periods with fewer calls show as normal: a few failures among a handful of calls do not mean the API is down.
  • Calls include real customer calls and our own daily probe calls. Request errors (wrong parameters, no balance) are excluded.
  • Average time counts only calls that completed normally: response time for sync calls, acceptance to completion for async ones.
By period
Time (UTC)StatusHealthAverage time
2026-09-26 18:00 - 18:59Normal——
2026-09-26 17:00 - 17:59Normal——
2026-09-26 16:00 - 16:59Normal——
2026-09-26 15:00 - 15:59Normal——
2026-09-26 14:00 - 14:59Normal——
2026-09-26 13:00 - 13:59Normal——
2026-09-26 12:00 - 12:59Normal——
2026-09-26 11:00 - 11:59Normal——
2026-09-26 10:00 - 10:59Normal——
2026-09-26 09:00 - 09:59Normal——
2026-09-26 08:00 - 08:59Normal——
2026-09-26 07:00 - 07:59Normal——
2026-09-26 06:00 - 06:59Normal——
2026-09-26 05:00 - 05:59Normal——
2026-09-26 04:00 - 04:59Normal——
2026-09-26 03:00 - 03:59Normal——
2026-09-26 02:00 - 02:59Normal——
2026-09-26 01:00 - 01:59Normal——
2026-09-26 00:00 - 00:59Normal——
2026-09-25 23:00 - 23:59Normal——
2026-09-25 22:00 - 22:59Normal——
2026-09-25 21:00 - 21:59Normal——
2026-09-25 20:00 - 20:59Normal——
2026-09-25 19:00 - 19:59Normal——
2026-09-26Normal——
2026-09-25Normal——
2026-09-24Normal——
2026-09-23Normal——
2026-09-22Normal——
2026-09-21Normal——
2026-09-20Normal——
2026-09-19Normal——
2026-09-18Normal——
2026-09-17Normal——
2026-09-16Normal——
2026-09-15Normal——
2026-09-14Normal——
2026-09-13Normal——
2026-09-12Normal——
2026-09-11Normal——
2026-09-10Normal——
2026-09-09Normal——
2026-09-08Normal——
2026-09-07Normal——
2026-09-06Normal——
2026-09-05Normal——
2026-09-04Normal——
2026-09-03Normal——
2026-09-02Normal——
2026-09-01Normal——
2026-08-31Normal——
2026-08-30Normal——
2026-08-29Normal——
2026-08-28Normal——

Search public results on Naver. Accepts these parameters: content_type, sort, and keyword. Returns these fields: mentioned_places, category, has_video, and title.

Price $1.39 per 1,000 requests ($0.001389 per call). Failed calls and empty results are not charged. Synchronous. For slow jobs add "mode": "async" to the body, take the job_id and poll.

Request parameters

NameInTypeRequiredDefaultDescription
AuthorizationheaderstringYes-Bearer followed by your API key. Create it in the console; never put it in a URL or a code repository.
platformbodystringYesnaverPlatform identifier, fixed value.
actionbodystringYessearchCapability identifier, fixed value.
keywordbody.paramsNot declaredYes-Specifies Korean or other search keywords to query Naver Blog and Naver Cafe content for the search action. It does not perform full-text search across map merchant reviews in the reviews action.
content_typebody.paramsenumNo-Filters content sources for the search action. Allowed values are blog_only, cafe_only, and both_blog_cafe. This parameter filters source channels rather than controlling output formats like plain text or HTML, and passing a fixed post URL directly does not execute a search.Allowed valuesblog_onlyboth_blog_cafecafe_only
sortbody.paramsenumNo-Sorts post results for the search action. Allowed values are relevance and newest. This parameter applies to search results and does not sort merchant reviews in the reviews action.Allowed valuesnewestrelevance
limitbody.paramsinteger (1–20)No10

Code samples

bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "naver",
  "action": "search",
  "params": {
    "keyword": "서울 카페"
  }
}'

[OpenAPI definition (JSON)]Samples read the key from the EVERYINFRA_API_KEY environment variable; copied code never contains your key.

Response example

Real response

Captured September 26, 2026 at 08:56 (UTC) by calling this API with the parameters in the code sample above. results and count are that call's real response with personal information (names, handles, avatars, profile links, contact details) removed; the list keeps the first 2. id, billing and quota differ on every call, so only their shape is shown.

json
{
  "id": "req_…",
  "platform": "naver",
  "action": "search",
  "results": [
    {
      "source": "blog",
      "title": "서울 북카페 추천 책방 데이트 채그로 주차",
      "url": "https://blog.naver.com/smc0863/223924495333",
      "text": "​\n\n​\n\n서울 북카페 추천 책방\n\n데이트 채그로 주차\n\n​\n\n​\n\nⓒ 2025. cheoli all right reserved.\n\n​\n\n​\n\n​\n\n​\n\n​\n\nCheoli's Travel ✈️\n\n​\n\n​\n\n​\n안녕하세요!\n여행 인플루언서 철이입니다.\n​\n오늘은 드넓게 펼쳐진 한강을 보며\n독서의 여유를 만끽할 수 있는 북카페\n소개해드리는 시간 가져보려고 해요.\n​\n\n​\n이번에 다녀온 채그로는 책 읽기\n좋은 분위기에 멋진 경치를 자랑해\n평일, 주말할 것 없이 많은 사람들이\n찾는 서울 데이트 코스이기도…",
      "author_name": "(已隐去)",
      "author_url": "https://blog.naver.com/(已隐去)",
      "like_count": 181,
      "comment_count": 34,
      "posted_at": "2025-07-11T11:20:00",
      "has_video": true,
      "platform": "naver",
      "tags": [
        "북카페",
        "서울책방",
        "서울데이트"
      ],
      "image_urls": [
        "https://postfiles.pstatic.net/MjAyNTA3MDdfMzAw/MDAxNzUxODUwODkxMDE5.rfMusDd01fipTML-c23O9sGHcTbMFmn2g-_9G3Jw-sMg.kEA17NGk47IVBP8DPd6975IZWG1KaaIONF_mVcPQjpUg.PNG/Snipaste_2025-07-07_10-14-38.png",
        "https://postfiles.pstatic.net/MjAyNTA3MDdfNSAg/MDAxNzUxODUwNDExODY0.Gl4sEzv0XutaiDyXylCmVy_QvLBnlhLW1fDilV_oeHwg.1PrDkP7oKjauCLczJWlsV8E8S-Vlqc7VT8lw-YBTjH0g.JPEG/IMG_0216.jpg",
        "https://postfiles.pstatic.net/MjAyNTA3MDdfMjgz/MDAxNzUxODUwNTIwMzM2.15fG6BMVpXKY9103dWVXvVDqRJXHXsey5re5Yd17NnAg.MKgTpdxyNdSe-kGx9FVMCe6GMBaT9vFz3F6ZnRJW3s4g.JPEG/IMG_0180.jpg"
      ],
      "mentioned_places": [
        {
          "name": "채그로",
          "address": "서울특별시 마포구 마포대로4다길 31",
          "tel": "(已隐去)",
          "latitude": "37.5356886",
          "longitude": "126.9442193",
          "place_id": "(已隐去)"
        }
      ]
    },
    {
      "source": "blog",
      "title": "서울근교 갈만한곳 일산 대형카페 추천 포레스트 아웃팅스",
      "url": "https://blog.naver.com/wkwmd81/223954693290",
      "text": "​\n요즘 서울근교 대형카페 정말 많더라고요. 지금 소개할 포레스트 아웃팅스는 일산점이 있고 송도점이 있는데 저는 일산점으로 다녀왔어요.\n\n여긴 몇 년 전에 한번 다녀왔던 기억이 있는 곳인데 블로그에는 포스팅을 안 했더라고요? 오랜만에 갔더니 내부 장식도 예뻐지고 브런치도 너무 만족스러워서 후다닥 올려봅니다.\n\n이런 서울근교 대형카페는 일단 주차장이 넉넉해서 좋아요. 저는 평일에 방문해서 그런 건지 모르겠지만 암튼 주차 공간 여유 있어서 친구들이랑 4명이서 각각 차 1대씩 가져와도 부담이 없더라고요…",
      "author_name": "(已隐去)",
      "author_url": "https://blog.naver.com/(已隐去)",
      "like_count": 97,
      "comment_count": 18,
      "posted_at": "2025-08-01T09:06:00",
      "has_video": false,
      "platform": "naver",
      "tags": [
        "포레스트아웃팅스"
      ],
      "image_urls": [
        "https://postfiles.pstatic.net/MjAyNTA2MDNfMTAz/MDAxNzQ4OTMyNzczMDY0.nH5BoeD9KFStR8nIWLU6ZbHPCgqy0BZfW8VYJFyzvmUg.LYCxWNGhVtZ4YbmQVdAirSMOlvmX19QdBGPR5_4kXpYg.JPEG/%EC%84%9C%EC%9A%B8%EA%B7%BC%EA%B5%90%EA%B0%88%EB%A7%8C%ED%95%9C%EA%B3%B3_%ED%8F%AC%EB%A0%88%EC%8A%A4%ED%8A%B8%EC%95%8…",
        "https://postfiles.pstatic.net/MjAyNTA2MDNfMTc1/MDAxNzQ4OTMyODA4NTIy.qMqVPN5ld5-rIqUAgBAeI3KP0UY79AszOeU2_UbCfmUg.Vqk_HO-WmTXmXtrWFLKvdwq-i5aa0N-cYDSbylYNdp0g.JPEG/%EC%84%9C%EC%9A%B8%EA%B7%BC%EA%B5%90%EA%B0%88%EB%A7%8C%ED%95%9C%EA%B3%B3_%ED%8F%AC%EB%A0%88%EC%8A%A4%ED%8A%B8%EC%95%8…",
        "https://postfiles.pstatic.net/MjAyNTA2MDNfMjk5/MDAxNzQ4OTMyODE3MDEz.gZXsySOl4RDm-Tsue2tmwqtSsoq5Qw1stu3ni48L6ywg.l20E-06qRbLvkNYsExaRmtgzWoUs0BNDu40GeLXmb9kg.JPEG/%EC%84%9C%EC%9A%B8%EA%B7%BC%EA%B5%90%EA%B0%88%EB%A7%8C%ED%95%9C%EA%B3%B3_%ED%8F%AC%EB%A0%88%EC%8A%A4%ED%8A%B8%EC%95%8…"
      ],
      "mentioned_places": [
        {
          "name": "포레스트아웃팅스",
          "address": "경기도 고양시 일산동구 고양대로 1124 포레스트 아웃팅스",
          "tel": "(已隐去)",
          "latitude": "37.6656764",
          "longitude": "126.8135439",
          "place_id": "(已隐去)"
        }
      ]
    }
  ],
  "count": 18,
  "billing": { … },
  "quota": { … }
}

Response fields

Business data is in results. The table lists the fields a record can contain; values the source does not provide are never made up.

FieldMeaning
sourceKeeps the platform's own meaning
titleTitle. null when the platform has no titles (for example text-only posts).
urlLink to the record on the source platform.
textBody text with HTML removed. Long text may be truncated.
author_nameAuthor's display name.
author_urlLink to the author's profile on the source platform.
cafe_nameKeeps the platform's own meaning
categoryCategory name in the source platform's own taxonomy, not normalized across platforms.
like_countLikes. null means the platform or this capability does not disclose it; it is not 0.
comment_countComments. null means not disclosed, not 0.
posted_atPublish time in ISO 8601, UTC (for example 2026-08-07T12:34:56+00:00). Non-standard strings from the platform are passed through as is, so parse defensively. null means the platform does not disclose it.
has_videoKeeps the platform's own meaning
is_sponsoredKeeps the platform's own meaning
platformSource platform identifier, the same as platform in the request (for example xiaohongshu, tiktok).
tagsArray of tags. An empty array, not null, when there are none.
image_urlsKeeps the platform's own meaning
mentioned_placesKeeps the platform's own meaning

Errors and billing

401
Missing or invalid key. Authentication runs before parameter checks, so unauthenticated requests never see the parameter schema.
422
Wrong parameter name or value. The error lists the parameters and allowed values this capability accepts and the closest match; it happens before any charge.
402
Insufficient balance. Top up first.
429
Per-minute request limit reached. Wait for Retry-After and try again.
503
Could not complete right now. Any charge for the call goes back to your balance automatically, and the billing receipt in the response states the actual outcome, including when it is not yet known. Do not resend blindly.
200 empty
The request completed without data and is not charged (billing.reason = empty_result_refunded).

Official references

Used only to check objects and terms. They do not imply authorization or endorsement of EveryInfra by the platform.

  • Naver Developer Documentation: Blog Search Object and Post Fields ↗

    Official documentation distinguishes blog search results, post links, snippets, blog names, and post dates, while explaining relevance and date sorting. This serves only as a platform terminology reference; official API quotas, parameter names, or authentication mechanisms cannot be applied directly to this endpoint.

    Checked 2026-09-04