はてなココJSON API

はてなココJSON API はてなここじぇいそんえーぴーあい（はてな）

編集

言及数のトレンド

今週のPV:16(54,917位)

グラフで詳しく見る

含むブログ
新着エントリー
含むキーワード

注目キーワード

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

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

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

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

変更履歴

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

API仕様

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

イマココ情報JSON

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

リクエスト

[イマココパーマリンクページURL].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: 常連スポット数