YOLP(地図)

クチコミ検索API

リクエストURL
XML
http://api.olp.yahooapis.jp/v1/review/{uid}
JSONP
http://api.olp.yahooapis.jp/v1/review/{uid}



目次




概要

  • クチコミ検索APIでは、Yahoo!ロコで投稿された、店舗のクチコミを検索できます。
  • 店舗IDを指定して、その店舗に投稿されたクチコミを取得できます。
  • クチコミは新しい投稿順に取得できます。



URIパラメーター一覧

RESTリクエストの構築(GET)」をご参照ください。

パラメーター 説明
uid(必須) string 店舗ID。店舗IDは、ローカルサーチAPIから取得することができます。

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

パラメーター 説明
appid(必須) string アプリケーションID。詳細はこちらをご覧ください。
results int 取得件数を指定します(最大100)。
start int 取得開始位置を指定します(最大9999)。
output string 出力形式:
  • xml - XML形式(デフォルト)
  • json - JSON形式
callback string
JSONPとして出力する際のコールバック関数名を入力するためのパラメーター。UTF-8でエンコードした文字列を入力します。

API使用上の注意

URLの最大の長さは2048バイトです。
URLをエンコードして指定するパラメーターもありますが、エンコード後のURLの長さが2048バイトを超えないようにしてください。




レスポンス

出力形式にXMLを指定(output=xml)の場合、XMLを返します。レスポンスフィールドをご参照ください。




レスポンスフィールド

フィールド 説明
YDF クエリーレスポンスのすべてを含みます。
ResultInfo レスポンスのまとめ情報です。
Count レスポンスに含まれるクチコミのデータ件数です。
Total 出力されているクチコミ以外も含めた全データ件数です。
Start レスポンスに含まれるクチコミの、全データからの取得開始位置です。
Status リクエスト元に処理結果を伝えるためのコードです。正常終了の場合、200を出力します。エラー時は、下記エラー項目を参照してください。
Latency レスポンスを生成するのに要した時間です。
Feature 検索結果1件分のデータ群です。
Id 内部識別用のIDです。
※後述のクチコミIDと同一ではありません。
Property 各種データを格納します。
Uid リクエスト時にURIパラメーターに指定した店舗IDです。
Comment クチコミの本体情報を格納します。
Id クチコミのIDです。
Subject クチコミのタイトル文です。
Body クチコミの本文です。
Guid クチコミ投稿者の識別IDです。
Author クチコミ投稿者の表示名称です。
Rating 店舗に対する評価情報です。1.0から5.0までの値となります。
VisitDate 店舗を訪問した日付です。
Scene シーン番号:
  • 1 - 昼
  • 2 - 夜
  • 3 - 終日
  • 4 - その他
UsefulCount クチコミを支持する人数です。
CreateDate クチコミが投稿された日付です。
UpdateDate クチコミが更新された日付です。



サンプルレスポンス

以下は、店舗ID:92e25cd1c952bf27fbe783663530ce603f9ab90bのクチコミのリクエストとレスポンスです。

http://api.olp.yahooapis.jp/v1/review/92e25cd1c952bf27fbe783663530ce603f9ab90b?appid=<あなたのアプリケーションID>

結果を以下に示します。

<?xml version="1.0" encoding="UTF-8"?>
<YDF totalResultsAvailable="7" totalResultsReturned="7" firstResultPosition="1">
  <ResultInfo>
    <Count>7</Count>
    <Total>7</Total>
    <Start>1</Start>
    <Status>200</Status>
    <Latency>1.000</Latency>
    <Description />
    <Copyright>Copyright (C) 2012 Yahoo Japan Corporation. All Rights Reserved.</Copyright>
  </ResultInfo>
    <Feature>
      <Id />
      <Property>
        <Uid>92e25cd1c952bf27fbe783663530ce603f9ab90b</Uid>
        <Comment>
          <Id>2-55429594</Id>
          <Body>以前通された部屋は、こぢんまりとした個室で雰囲気も良かったのですが、今回通された部屋は見てびっくり!!
すっごく狭かったです。二人並んで座るのが精一杯。しかも二人部屋らしく、並んで座り壁を見ながら食事をするのです。壁を見ながらなので、せっかくの料理も全く美味しいと感じません。あの作りは残念だし、あり得ません。二人部屋でも向き合う事ができるか、並んで座るにせよ、壁ではなく庭とかもうちょっと雰囲気の良い物にしてもらいたいです。</Body>
          <Subject>狭い!!</Subject>
          <Guid>5ZK7WHPKSVL3ECENZ4LA2IIGOA</Guid>
          <Author>あかぶー</Author>
          <Rating>1.5</Rating>
          <VisitDate />
          <Scene>2</Scene>
          <UsefulCount>0</UsefulCount>
          <LinkUrl />
        </Comment>
        <CreateDate>2012-03-23T10:41:13+09:00</CreateDate>
        <UpdateDate>2012-03-23T10:41:13+09:00</UpdateDate>
      </Property>
    </Feature>
    <Feature>
      <Id />
      <Property>
        <Uid>92e25cd1c952bf27fbe783663530ce603f9ab90b</Uid>
        <Comment>
          <Id>2-55429592</Id>
          <Body>以前通された部屋は、こぢんまりとした個室で雰囲気も良かったのですが、今回通された部屋は見てびっくり!!
すっごく狭かったです。二人並んで座るのが精一杯。しかも二人部屋らしく、並んで座り壁を見ながら食事をするのです。壁を見ながらなので、せっかくの料理も全く美味しいと感じません。あの作りは残念だし、あり得ません。二人部屋でも向き合う事ができるか、並んで座るにせよ、壁ではなく庭とかもうちょっと雰囲気の良い物にしてもらいたいです。</Body>
          <Subject>狭い!!</Subject>
          <Guid>5ZK7WHPKSVL3ECENZ4LA2IIGOA</Guid>
          <Author>あかぶー</Author>
          <Rating>1.5</Rating>
          <VisitDate />
          <Scene>2</Scene>
          <UsefulCount>0</UsefulCount>
          <LinkUrl />
        </Comment>
        <CreateDate>2012-03-23T10:41:12+09:00</CreateDate>
        <UpdateDate>2012-03-23T10:41:12+09:00</UpdateDate>
      </Property>
    </Feature>
    <Feature>
      <Id />
      <Property>
        <Uid>92e25cd1c952bf27fbe783663530ce603f9ab90b</Uid>
        <Comment>
          <Id>1-47098696</Id>
          <Body>今までに何度か使って雰囲気もよかったのでグループで接待として使いました。結果から言うと失敗。個室の雰囲気、コースの料理、そんなに悪くありません。何がダメかと言うと飲み放題の設定。ここでは例えば飲んだグラスがきっちり空かないと次の飲み物を持ってきてくれません。ここまでの話ならマナー上、当然と言う人もいるかと思います。注文してから生ビールを持ってくるのに平均5分はかかっているし長い時は10分以上待たされました。何度も続くと忘れているふりをして時間かせぎしているとしか思えません。料理もアラカルトで飲み物も飲み放題でなければいやな思いをせずにすむと思います。</Body>
          <Subject>個室なので雰囲気は良いのですが・・・・?</Subject>
          <Guid>DNJ7K4ZYQPRJZ3FILNXDBJBPI4</Guid>
          <Author>ufc*2*50</Author>
          <Rating>2</Rating>
          <VisitDate>2011-09-01T00:00:00+09:00</VisitDate>
          <Scene>2</Scene>
          <UsefulCount>5</UsefulCount>
          <LinkUrl />
        </Comment>
        <CreateDate>2011-10-15T13:12:52+09:00</CreateDate>
        <UpdateDate>2012-01-13T12:12:00+09:00</UpdateDate>
      </Property>
    </Feature>
    <Feature>
      <Id />
      <Property>
        <Uid>92e25cd1c952bf27fbe783663530ce603f9ab90b</Uid>
        <Comment>
          <Id>1-39381749</Id>
          <Body>女友達4人で行きました。個室なので他の人と顔を合わせることもなく
気兼ねなく過ごせました。お料理もおいしかったし店員さんの対応も
最近見かけないくらい良かったです。又行こうと思います</Body>
          <Subject>個室だから</Subject>
          <Guid>655U2HMPPBUS6RURA3LA7ZKHRI</Guid>
          <Author>んご</Author>
          <Rating>4</Rating>
          <VisitDate />
          <Scene>2</Scene>
          <UsefulCount>0</UsefulCount>
          <LinkUrl />
        </Comment>
        <CreateDate>2010-12-16T20:47:16+09:00</CreateDate>
        <UpdateDate>2010-12-16T20:47:16+09:00</UpdateDate>
      </Property>
    </Feature>
    <Feature>
      <Id />
      <Property>
        <Uid>92e25cd1c952bf27fbe783663530ce603f9ab90b</Uid>
        <Comment>
          <Id>1-53850715</Id>
          <Body>友達の結婚式の二次会で初めて行きました!
飲み放題コースだったのにお酒の種類が豊富で、カクテルとか普通の居酒屋にはおいてないメニューがいっぱいありました!
おしゃれなお店だったし、スタッフさんの対応もとても丁寧だったし大満足っ☆
今度は女子会で行きまーす☆</Body>
          <Subject>飲み放題の種類が豊富!</Subject>
          <Guid />
          <Author />
          <Rating>5</Rating>
          <VisitDate />
          <Scene>2</Scene>
          <UsefulCount>0</UsefulCount>
          <LinkUrl />
        </Comment>
        <CreateDate>2010-07-25T18:47:09+09:00</CreateDate>
        <UpdateDate>2010-07-25T18:47:09+09:00</UpdateDate>
      </Property>
    </Feature>
    <Feature>
      <Id />
      <Property>
        <Uid>92e25cd1c952bf27fbe783663530ce603f9ab90b</Uid>
        <Comment>
          <Id>1-54359340</Id>
          <Body>会社の上司、同僚達と利用しましたが上司達に気を使いたいところに気付いてくれる。楽しく飲めましたし楽でしたしね〜。大人な満足感でした。忘年会もヨロシク!</Body>
          <Subject>かゆいところに手がとどく</Subject>
          <Guid />
          <Author />
          <Rating>5</Rating>
          <VisitDate />
          <Scene>3</Scene>
          <UsefulCount>0</UsefulCount>
          <LinkUrl />
        </Comment>
        <CreateDate>2009-10-27T17:40:52+09:00</CreateDate>
        <UpdateDate>2009-10-27T17:40:52+09:00</UpdateDate>
      </Property>
    </Feature>
    <Feature>
      <Id />
      <Property>
        <Uid>92e25cd1c952bf27fbe783663530ce603f9ab90b</Uid>
        <Comment>
          <Id>1-49762943</Id>
          <Body>2人で並んで座る個室で、掘りごたつになっていてくつろげました。
料理もおいしくて、お酒の種類も多かったので長居してしまいました。
店長さんの応対もステキでした。</Body>
          <Subject>雰囲気が良かった!</Subject>
          <Guid>UDZTASH4ZQSP4RRV4S6WUS442A</Guid>
          <Author>mif**uri*27</Author>
          <Rating>4</Rating>
          <VisitDate />
          <Scene>2</Scene>
          <UsefulCount>0</UsefulCount>
          <LinkUrl />
        </Comment>
        <CreateDate>2009-08-27T13:12:19+09:00</CreateDate>
        <UpdateDate>2009-08-27T13:12:19+09:00</UpdateDate>
      </Property>
    </Feature>
</YDF>

    




エラー

コード 説明
400 渡されたパラメーターがWeb APIで期待されたものと一致しない場合に返されます。
403 リソースへのアクセスを許されていないか、利用制限を超えている場合に適用されます。
405 リソースに対して要求したメソッドが許可されていない場合に返されます。
503 内部的な問題によってデータを返すことができない場合に返されます。

以下は、リクエストに対するエラーレスポンスです。

<?xml version="1.0" encoding="UTF-8"?>
<Error>
  <Code>400</Code>
  <Message>Bad Request</Message>
</Error>



利用制限

クチコミ検索APIは、24時間中1アプリケーションIDにつき50000件のリクエストが上限となっています。詳しくは「利用制限」をご参照ください。