スマートフォン用の表示で見る

はてなココJSON API

はてな

はてなココJSON API

はてなここじぇいそんえーぴーあい

このページは古い情報を掲載しています

このページの情報は更新されていません。新しい情報は「はてなココJSON API - Hatena Developer Center」に移転しました。


本ドキュメントに関する注意事項

本ドキュメントは、はてなココにおけるJSON API実装を解説するものです。主にはてなスタッフがその作成と更新を行っています。

変更履歴

  • 2010年9月14日 リリース
  • 2010年10月22日 スポット検索結果JSONのレスポンスでスポットの緯度経度を返すように変更 / スポット検索結果JSON(近くのスポット)を追加

API仕様

はてなココ内でJSON形式で取得できる情報を以下にまとめます。

イマココ情報JSON

あるイマココについての情報を取得するJSONです。

リクエスト

[イマココパーマリンクページURL].json

レスポンス

例:http://c.hatena.com/chris4403/h/243276837852647047.json

{
  "author_entity":
    {
      "url_name":"chris4403",
      "display_name":"クリント・クリストウッド"
    },
  "images":
    {
      "original":"http://img.f.hatena.ne.jp/images/fotolife/c/chris4403/20100911/20100911120216.jpg",
      "decorated_thumbnail":"http://img.f.hatena.ne.jp/images/fotolife/c/chris4403/20100911/20100911120221.jpg",
      "decorated":"http://img.f.hatena.ne.jp/images/fotolife/c/chris4403/20100911/20100911120218.jpg"
    },
  "here_id":"243276837852647047",
  "here_body_text":"ハンバーグうまかった!",
  "here_created_on":1284174137,
  "spot":
    {
      "spot_name":"俺のハンバーグ 山本 太陽",
      "spot_key":"u97smzmg7ioo"
    }
}
here_id
イマココに一意に割り振られたID
author_entity
イマココしたユーザの構造体
url_name
イマココしたユーザーのはてなID
display_name
イマココしたユーザーのニックネーム
images
イマココに投稿された画像情報
original
オリジナル画像URL
decorated_thumbnail
ハッピィが写りこんだサムネイル画像URL
decorated
ハッピィが写りこんだ画像URL
here_body_text
イマココに投稿されたひとこと
here_created_on
イマココした時間(epoch)
spot
スポット情報の構造体
spot_name
スポット名
spot_key
スポットに一意に定められたキー。http://c.hatena.ne.jp/s/[spot_key]がスポットのURLになる

スポット検索結果JSON

緯度経度を指定してスポットを検索した結果をJSONで取得できます。

リクエスト

http://c.hatena.com/s/nearby.json?ll=[緯度,経度]&page=[ページ数]
ll
緯度経度を,(カンマ)区切りでつなげる
page
ページ数

レスポンス

例:http://c.hatena.com/s/nearby.json?ll=35.6573,139.7023&page=2

{
  "has_next":"1",
  "page":"2",
  "items":[
    {
      "review_text":"宮益坂脇道のコンコンブル、新宿クレッソニエール系列の牛肉料理中心のビストロ。20席もない極小さが基本2〜3人のスタッフとの距離を縮め、気軽さを増してくれる店。ランチは定番が4種、日替り1種で1000円〜。デザートを食べたいなら夜が吉(ランチ時は一律にパンプディングがつくのみなので)。",
      "spot_name":"COWBELL(フレンチ牛肉食堂)",
      "spot_key":"bt847uolrcm3",
      "lat":"35.6581545948285",
      "lon":"139.699380490738"
    },
    ...
  ],
}
has_next
次のページがあるかどうか
page
現在のページ数
items
スポットオブジェクト配列
review_text
最新のレビューテキスト
spot_name
スポット名
spot_key
スポットに一意に定められたキー。http://c.hatena.ne.jp/s/[spot_key]がスポットのURLになる
lat
緯度
lon
経度

スポット検索結果JSON(近くのスポット)

あるスポットの近くにあるスポットをJSONで取得できます。

リクエスト

http://c.hatena.com/s/[スポットキー]/nearby.json?page=[ページ数]
page
ページ数

レスポンス

例:http://c.hatena.com/s/bt847uolrcm3/nearby.json

{
  "has_next":"1",
  "page":1,
  "items":[
    {
      "review_text":"雨の日は混んでいる印象がありますが、ある程度広いので一度座ると集中して勉強ができます。",
      "lat":"35.6585427581529",
      "lon":"139.699067345786",
      "spot_name":"エクセルシオールカフェ 渋谷マークシティ店",
      "spot_key":"cdamtbz7qhmn"
    },
    ...
  ],
}
has_next
次のページがあるかどうか
page
現在のページ数
items
スポットオブジェクト配列
review_text
最新のレビューテキスト
spot_name
スポット名
spot_key
スポットに一意に定められたキー。http://c.hatena.ne.jp/s/[spot_key]がスポットのURLになる
lat
緯度
lon
経度

ユーザ情報JSON

あるユーザのイマココ回数などを取得できます。

リクエスト

http://c.hatena.com/[USERNAME]/stats.json
USERNAME
情報を取得したいユーザのはてなID

レスポンス

例:http://c.hatena.com/chris4403/stats.json

{
  "cocohere_count":"1046",
  "cococoin_count":"2207",
  "cocospot_review_count":"12",
  "regular_cocospot_count":"10",
  "display_name":"クリント・クリストウッド",
  "url_name":"chris4403",
  "visited_cocospot_count":"233",
  "travel_distance_of_this_week":"3970",
  "created_cocospot_count":"96"
}
display_name
ニックネーム
url_name
はてなID
cocohere_count
イマココ回数
cococoin_count
コココイン枚数
travel_distance_of_this_week
今週の移動距離
cocospot_review_count
レビュー投稿数
visited_cocospot_count
開拓スポット数
created_cocospot_count
作成スポット数
regular_cocospot_count
常連スポット数

ご利用にあたっての注意事項

APIを利用されるにあたっては、以下の点にご注意ください。

  • APIは実験的に公開されているものであり、API の仕様変更ならびに API の公開停止を予告なしに行う場合があります。