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/local

リクエストヘッダ

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

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

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

フィールド タイプ 必須の有無 説明
query String Required 検索キーワード
  • UTF-8でエンコード
display Integer Optional 一度に表示する検索結果の数
  • 1~5 (デフォルト: 1)
start Integer Optional 検索の開始位置
  • 1
sort String Optional 検索結果のソート方法
  • random (デフォルト) | comment
    • random: 正確度降順
    • comment: 企業・機関に関するカフェ・ブログのレビュー数(降順)
format String Optional レスポンス結果
  • json(デフォルト) | xml

リクエスト例

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

curl --location --request GET https://naverapihub.apigw.ntruss.com/search/v1/local?query=亭子洞カフェ&display=2&start=1&sort=comment&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 - 企業、機関の名前
link String - 企業、機関の詳細情報 URL
category String - 企業、機関の分類情報
description String - 企業、機関の説明
telephone String - 値を返さない要素
  • 下位互換性を維持するために存在
address String - 企業、機関名の地番住所
roadAddress String - 企業、機関名の道路名住所
mapx String - 企業、機関が所在する場所の x座標 (WGS84座標系基準)
mapy String - 会社、機関が所在する場所の y座標 (WGS84座標系基準)

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

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

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:41:08 +0900",
    "total": 5,
    "start": 1,
    "display": 2,
    "items": [
        {
            "title": "{企業名}",
            "link": "https://{企業の公式サイト}",
            "category": "カフェ、デザート>カフェ",
            "description": "",
            "telephone": "",
            "address": "{地番住所}",
            "roadAddress": "{道路名住所}",
            "mapx": "{経度}",
            "mapy": "{緯度}"
        },
        {
            "title": "{企業名}",
            "link": "https://{企業の公式サイト}",
            "category": "カフェ、デザート>ベーカリー",
            "description": "",
            "telephone": "",
            "address": "{地番住所}",
            "roadAddress": "{道路名住所}",
            "mapx": "{経度}",
            "mapy": "{緯度}"
        }
    ]
}