カフェ投稿検索結果の照会

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

NAVER検索のカフェ投稿検索結果を照会します。

リクエスト

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

リクエストヘッダ

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

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

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

リクエスト例

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

curl --location --request GET https://naverapihub.apigw.ntruss.com/search/v1/cafearticle?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}

レスポンス

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

レスポンスボディ

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

items

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

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

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

レスポンス例

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

{
    "lastBuildDate": "Thu, 11 Jun 2026 18:43:27 +0900",
    "total": 18906061,
    "start": 1,
    "display": 2,
    "items": [
        {
            "title": "おうちカフェ初心者向け<b>コーヒー</b>豆のおすすめを教えてください",
            "link": "https://cafe.naver.com/{cafeId}/{articleId}",
            "description": "最近おうちカフェを始めたのですが、<b>コーヒー</b>豆のおすすめをお願いします。酸味のある豆とコクのある豆の中で... ",
            "cafename": "{カフェ名}",
            "cafeurl": "https://cafe.naver.com/{cafeId}"
        },
        {
            "title": "今日の<b>コーヒー</b>オフ会レポート",
            "link": "https://cafe.naver.com/{cafeId}/{articleId}",
            "description": "定期オフ会で<b>コーヒー</b>を飲みながらお話ししたレポートです。今回はハンドドリップ... ",
            "cafename": "{カフェ名}",
            "cafeurl": "https://cafe.naver.com/{cafeId}"
        }
    ]
}