Documentation Index

Fetch the complete documentation index at: https://api.ncloud-docs.com/llms.txt

Use this file to discover all available pages before exploring further.

ブログ検索結果の照会

Prev Next

Classic/VPC環境で利用できます。

NAVER検索のブログ検索結果を照会します。

参考

ブログ検索には検索 APIが使用され、検索 APIの1日あたりの呼び出し上限は25,000回です。

リクエスト

リクエスト形式を説明します。リクエスト形式は次の通りです。

メソッド URI
GET /search/v1/blog

リクエストヘッダ

NAVER API HUBで共通して使用されるヘッダの詳細は、NAVER API HUBのリクエストヘッダをご参照ください。

リクエストクエリパラメータ

リクエストクエリパラメータの説明は次の通りです。

フィールド タイプ 必須の有無 説明
query String Required 検索キーワード
  • UTF-8でエンコード
display Integer Optional 一度に表示する検索結果の数
  • 1~100 (デフォルト: 10)
start Integer Optional 検索の開始位置
  • 1~1000 (デフォルト: 1)
sort String Optional 検索結果のソート方法
  • sim (デフォルト) | date
    • sim: 正確度降順
    • date: 日付降順
format String Optional レスポンス結果
  • json(デフォルト) | xml

リクエスト例

リクエストのサンプルコードは次の通りです。

curl --location --request GET https://naverapihub.apigw.ntruss.com/search/v1/blog?query=コーヒー&display=2&start=1&sort=date&format=json
--header X-NCP-APIGW-API-KEY-ID: {Client ID}
--header X-NCP-APIGW-API-KEY: {Client Secret}

レスポンス

レスポンス形式を説明します。

レスポンスボディ

レスポンスボディの説明は次の通りです。

フィールド タイプ 必須の有無 説明
lastBuildDate String - 検索結果が生成された時間
total Integer - 検索結果の総数
start Integer - 検索の開始位置
display Integer - 一度に表示する検索結果の数
items Array - 個々の検索結果リスト: items

items

itemsの説明は次の通りです。

フィールド タイプ 必須の有無 説明
title String - ブログ記事の見出し
  • 検索キーワードと一致する部分は<b>タグで囲む
link String - ブログ記事の URL
description String - ブログ記事の内容を要約したパッセージ情報
  • 検索キーワードと一致する部分は<b>タグで囲む
bloggername String - ブログ記事があるブログの名前
bloggerlink String - ブログ記事が掲載されているブログのアドレス
postdate String - ブログ記事が投稿された日付

レスポンスステータスコード

レスポンスステータスコードの説明は次の通りです。

HTTPステータスコード コード メッセージ 説明
400 SE01 Incorrect query request (無効なクエリリクエストです) APIリクエスト URLのプロトコルやパラメータなどにエラーがないか確認
400 SE02 Invalid display value (無効な displayの値です) displayの値が有効な範囲内であるか確認
400 SE03 Invalid start value (無効な startの値です) startの値が有効な範囲内であるか確認
400 SE04 Invalid sort value (無効な sortの値です) sortの値に誤字がないか確認
400 SE06 Malformed encoding (無効な形式のエンコードです) 検索キーワードを UTF-8でエンコード
404 SE05 Invalid search api (存在しない検索 apiです) APIリクエスト URLに誤字がないか確認
500 SE99 System Error (システムエラー) サーバ内部でエラー発生
参考

NAVER API HUBで共通して使用されるレスポンスステータスコードの詳細は、NAVER API HUBのレスポンスステータスコードをご参照ください。

レスポンス例

レスポンスのサンプルコードは次の通りです。

{
    "lastBuildDate": "Thu, 11 Jun 2026 19:14:42 +0900",
    "total": 56692992,
    "start": 1,
    "display": 2,
    "items": [
        {
            "title": "<b>コーヒー</b>豆の選び方とおうちカフェ入門のコツ",
            "link": "https://blog.naver.com/{blogId}/{logNo}",
            "description": "今日は<b>コーヒー</b>豆を選ぶ基準をまとめてみました。酸味やコクによって... ",
            "bloggername": "{ブログの名前}",
            "bloggerlink": "blog.naver.com/{blogId}",
            "postdate": "20260611"
        },
        {
            "title": "近所の<b>美味しいコーヒー</b>ショップ巡りレポ",
            "link": "https://blog.naver.com/{blogId}/{logNo}",
            "description": "週末に訪れた<b>コーヒー</b>専門店のレポです。ハンドドリップもラテも... ",
            "bloggername": "{ブログの名前}",
            "bloggerlink": "blog.naver.com/{blogId}",
            "postdate": "20260611"
        }
    ]
}