クリップ情報取得 API 
概要
任意の URL に対するクリップ情報を JSON 形式で取得できます。
使用方法
リクエストパラメータ
- link
- クリップ情報を取得したい任意の URL を指定します。 URL は Javascript の encodeURIComponent() 関数でエンコードしてください。
- all
- 0以外の数値または空文字以外の文字列を指定するとコメントのないクリップ情報も含んだレスポンスを返します。0または空文字を指定するとコメントのみのクリップ情報のレスポンスを返します。
- callback
- コールバック関数名を指定すると、レスポンスをコールバック関数名で囲んだ JSONP データを返します。
レスポンスのデータ構造
- link
- クリップされている URL です。
- title
- クリップされている URL のタイトルです。
- Comments
- クリップ情報です。 Javascript オブジェクトの配列になっています。個々の Javascript オブジェクトのデータ構造は個々のクリップ情報のデータ構造をご覧ください。
- public_clip_count
- 公開でクリップされている数です。
- total_clip_count
- 公開/非公開クリップ両方を含めてクリップされている数です。
- created_on
- このページが最初にクリップされた日時です。日時のフォーマットは epoch 秒です。
- last_clipped_on
- このページが最も最近クリップされた日時です。日時のフォーマットは epoch 秒です。
- StatusCode
- リクエストが成功したかどうかのステータスコードです。成功時は 200 失敗時は 404 等を返します。
- Message
- リクエストのステータス情報を示す簡単なメッセージです。
- isSuccess
- リクエストが成功したかどうかの真偽値です。成功時は 1 失敗時は 0 を返します。
個々のクリップ情報のデータ構造 #
- livedoor_id
- クリップしたユーザーの livedoor ID です。
- notes
- クリップにつけられたコメントです。
- tags
- クリップにつけられたタグです。 Javascript の配列になっています。個々のタグは文字列です。
- created_on
- クリップした日時です。日時のフォーマットは epoch 秒です。
注意事項
JSON データをキャッシュしており、必ずしも最新の情報が取得できるとは限らないため、ページ詳細の内容と異なる場合があります。あらかじめご了承ください。
API への過度のアクセスはサービスへの悪影響を考慮して予告なく拒否する場合があります。リクエストごとに最低一秒の間隔をあけてください。
リクエストパラメータやレスポンスデータの構造は変更される場合があります。最新の情報はこのページかlivedoor クリップ開発日誌でご確認ください。
サンプル
レスポンス
{
"link":"http://blog.livedoor.jp/staff_clip/archives/510898...",
"Comments":[{
"notes":"ひゃほー",
"created_on":1193515063,
"livedoor_id":"libretto9",
"tags":[]
},{
"notes":"最近livedoorクリップの改良スピードがすごい",
"created_on":1193372574,
"livedoor_id":"kenji_418",
"tags":["livedoorクリップ"]
},{
"notes":"おおおお，これは GJ すぎる！！",
"created_on":1193357886,
"livedoor_id":"onk",
"tags":["LDC"]
},{
"notes":">>livedoor クリップをご利用いただきありがとうございます。\r\n\
担当の佐々木です。\r\n\ \r\n\ 「ページ詳細」に、「コメントのみ表示する」というトグルボタンを設置しました。これを利用すると、大量にあるクリップのなかから、",
"created_on":1193350266,
"livedoor_id":"ringod",
"tags":["livedoorクリップ","release","0710c"]
},{
"notes":"下記のリンクからは、「注目の動画」ページがみっくみくにされている様子をご覧いただけます。",
"created_on":1193328123,
"livedoor_id":"forestk",
"tags":["livedoor","clip"]
},{
"notes":"『下記のリンクからは、「注目の動画」ページがみっくみくにされている様子をご覧いただけます。』",
"created_on":1193312917,
"livedoor_id":"tsupo",
"tags":["livedoorClip","初音ミク","みくみく","Internet","summarySite"]
},{
"notes":"ニコニコ動画のサムネイル表示が嬉しい",
"created_on":1193310304,
"livedoor_id":"rancor",
"tags":["livedoor","SBM","ニコニコ動画"]
}],
"public_clip_count":9,
"last_clipped_on":1193515063,
"StatusCode":200,
"total_clip_count":9,
"isSuccess":1,
"Message":"comment list",
"created_on":1193310304,
"title":"livedoor クリップ開発日誌:「コメントのみ表示する」トグルボタン - livedoor Blog（ブログ）"
}
リクエスト(コメントなしのクリップも含む)
レスポンス(コメントなしのクリップも含む)
{
"link":"http://blog.livedoor.jp/staff_clip/archives/510898...",
"Comments":[{
"notes":"ひゃほー",
"created_on":1193515063,
"livedoor_id":"libretto9",
"tags":[]
},{
"notes":"最近livedoorクリップの改良スピードがすごい",
"created_on":1193372574,
"livedoor_id":"kenji_418",
"tags":["livedoorクリップ"]
},{
"notes":"おおおお，これは GJ すぎる！！",
"created_on":1193357886,
"livedoor_id":"onk",
"tags":["LDC"]
},{
"notes":">>livedoor クリップをご利用いただきありがとうございます。\r\n\ 担当の佐々木です。\r\n\ \r\n\ 「ページ詳細」に、「コメントのみ表示する」というトグルボタンを設置しました。これを利用すると、大量にあるクリップのなかから、",
"created_on":1193350266,
"livedoor_id":"ringod",
"tags":["livedoorクリップ","release","0710c"]
},{
"notes":"下記のリンクからは、「注目の動画」ページがみっくみくにされている様子をご覧いただけます。",
"created_on":1193328123,
"livedoor_id":"forestk",
"tags":["livedoor","clip"]
},{
"notes":"",
"created_on":1193317521,
"livedoor_id":"poolmmjp",
"tags":["livedoorクリップ"]
},{
"notes":"『下記のリンクからは、「注目の動画」ページがみっくみくにされている様子をご覧いただけます。』",
"created_on":1193312917,
"livedoor_id":"tsupo",
"tags":["livedoorClip","初音ミク","みくみく","Internet","summarySite"]
},{
"notes":"",
"created_on":1193311858,
"livedoor_id":"masafumi_otsune",
"tags":[]
},{
"notes":"ニコニコ動画のサムネイル表示が嬉しい",
"created_on":1193310304,
"livedoor_id":"rancor",
"tags":["livedoor","SBM","ニコニコ動画"]
}],
"public_clip_count":9,
"last_clipped_on":1193515063,
"StatusCode":200,
"total_clip_count":9,
"isSuccess":1,
"Message":"comment list",
"created_on":1193310304,
"title":"livedoor クリップ開発日誌:「コメントのみ表示する」トグルボタン - livedoor Blog（ブログ）"
}
リクエスト(コールバック関数を指定)
レスポンス(コールバック関数を指定)
foo({
"link":"http://blog.livedoor.jp/staff_clip/archives/510898...",
"Comments":[{
"notes":"ひゃほー",
"created_on":1193515063,
"livedoor_id":"libretto9",
"tags":[]
},{
"notes":"最近livedoorクリップの改良スピードがすごい",
"created_on":1193372574,
"livedoor_id":"kenji_418",
"tags":["livedoorクリップ"]
},{
"notes":"おおおお，これは GJ すぎる！！",
"created_on":1193357886,
"livedoor_id":"onk",
"tags":["LDC"]
},{
"notes":">>livedoor クリップをご利用いただきありがとうございます。\r\n\ 担当の佐々木です。\r\n\ \r\n\ 「ページ詳細」に、「コメントのみ表示する」というトグルボタンを設置しました。これを利用すると、大量にあるクリップのなかから、",
"created_on":1193350266,
"livedoor_id":"ringod",
"tags":["livedoorクリップ","release","0710c"]
},{
"notes":"下記のリンクからは、「注目の動画」ページがみっくみくにされている様子をご覧いただけます。",
"created_on":1193328123,
"livedoor_id":"forestk",
"tags":["livedoor","clip"]
},{
"notes":"『下記のリンクからは、「注目の動画」ページがみっくみくにされている様子をご覧いただけます。』",
"created_on":1193312917,
"livedoor_id":"tsupo",
"tags":["livedoorClip","初音ミク","みくみく","Internet","summarySite"]
},{
"notes":"ニコニコ動画のサムネイル表示が嬉しい",
"created_on":1193310304,
"livedoor_id":"rancor",
"tags":["livedoor","SBM","ニコニコ動画"]
}],
"public_clip_count":9,
"last_clipped_on":1193515063,
"StatusCode":200,
"total_clip_count":9,
"isSuccess":1,
"Message":"comment list",
"created_on":1193310304,
"title":"livedoor クリップ開発日誌:「コメントのみ表示する」トグルボタン - livedoor Blog（ブログ）"
});
リクエスト(未クリップのページ)
レスポンス(未クリップのページ)
{
"link":"http://foo.example.com/",
"StatusCode":404,
"isSuccess":0,
"Message":"page not found"
}