livedoor クリップについての Wiki です。

履歴

クリップ情報取得 API編集する

最終更新：staff_clipstaff_clip 2008年09月11日(木) 12:02:38

クリップ情報取得 API



概要


任意の URL に対するクリップ情報を JSON 形式で取得できます。

使用方法

GET "http://api.clip.livedoor.com/json/comments?link=ht..."

のようなリクエストを送信してください。
エントリポイント
http://api.clip.livedoor.com/json/comments
リクエストパラメータ
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 クリップ開発日誌でご確認ください。

サンプル

リクエスト
GET "http://api.clip.livedoor.com/json/comments?link=ht..."
レスポンス
{
    "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（ブログ）"
}
リクエスト(コメントなしのクリップも含む)
GET "http://api.clip.livedoor.com/json/comments?link=ht..."
レスポンス(コメントなしのクリップも含む)
{
    "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（ブログ）"
}
リクエスト(コールバック関数を指定)
GET "http://api.clip.livedoor.com/json/comments?link=ht..."
レスポンス(コールバック関数を指定)
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（ブログ）"
});

リクエスト(未クリップのページ)
GET "http://api.clip.livedoor.com/json/comments?link=ht..."
レスポンス(未クリップのページ)
{
    "link":"http://foo.example.com/",
    "StatusCode":404,
    "isSuccess":0,
    "Message":"page not found"
}

参考 URL

はてなブックマークエントリー情報取得API

はてなブックマークエントリー情報取得API
ECナビ デベロッパー ネットワーク: 登録情報取得API

ECナビ デベロッパー ネットワーク: 登録情報取得API
  • livedoor クリップ
  • はてなブックマーク
  • delicious
  • Yahoo! ブックマーク
  • niftyブックマーク
  • Buzzurl
 

Wikiをはじめる