本ドキュメントは、はてなココにおけるJSON API実装を解説するものです。主にはてなスタッフがその作成と更新を行っています。
はてなココ内で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" } }
緯度経度を指定してスポットを検索した結果をJSONで取得できます。
http://c.hatena.com/s/nearby.json?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" }, ... ], }
あるスポットの近くにあるスポットをJSONで取得できます。
http://c.hatena.com/s/[スポットキー]/nearby.json?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" }, ... ], }
あるユーザのイマココ回数などを取得できます。
http://c.hatena.com/[USERNAME]/stats.json
例: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" }
本APIを利用されるにあたっては、以下の点にご注意ください。