クリップ検索用フィードとは
クリップのフィードは、FlipClipに投稿されたクリップのリストです。以下のクリップの一覧を取得、検索することができます。
- 一般公開クリップ
- 特定ユーザーのクリップ
- 特定ユーザーの友だちのクリップ
- 特定ユーザーのお気に入りクリップ
パラメータの指定により、タグやカテゴリ、撮影日時など様々な条件でフィードを絞り込むこともできます。
WSSEによるフィードの認証機能を使えば、プライバシーが設定されたクリップを含むクリップの一覧を取得することも可能です。
簡単なサンプル
# 一般公開されているクリップ(動画、写真共)を撮影日時降順に並べたものをAtomフィード形式で取得
http://www.flipclip.net/clips/?_accept=atomfeed
# 一般公開されている動画クリップを撮影日時降順に並べたものをAtomフィード形式で取得
http://www.flipclip.net/clips/?_accept=atomfeed&ctype=video
# ユーザーhoriuchiのカテゴリ「グルメ」のクリップを再生回数が多い順に並べたものをJSONフィード形式で取得
http://www.flipclip.net/clips/horiuchi/?_accept=json&category=gourmet&order=view
※ Acceptヘッダによりフォーマットを指定した場合、_accept=xxxは不要です。
フォーマットについての詳しい情報は
フィードのフォーマットを参照ください。
URL
# 一般公開クリップ
http://www.flipclip.net/clips/
# 特定ユーザーのクリップ
http://www.flipclip.net/clips/{userid}
# 特定ユーザーのお気に入りクリップ
http://www.flipclip.net/clips/{userid}/favorites/
# 特定ユーザーの友だちのクリップ
http://www.flipclip.net/clips/{userid}/friends/
クエリパラメータ
クエリパラメータを指定することで、フィードの絞り込みやソートを行うことができます。
パラメータに日本語を使用する場合は、UTF-8でURLエンコードしてください。
| パラメータ名 |
型 |
説明 |
| page |
int |
ページ番号 |
| rows |
int |
1ページあたりの取得件数(最大100) |
| order |
String |
ソート方法、指定できる値はorderに指定できる値を参照ください。 |
| privacy |
String |
プライバシー、本人のフィードの場合のみ指定できます。指定できる値はprivacyに指定できる値を参照ください。 |
| ctype |
String |
コンテンツのタイプ(動画か画像か)。videoもしくはimageを指定してください。指定がなければ両方取得します。 |
| q |
String |
キーワード |
| tag |
String |
タグ名 |
| category |
String |
カテゴリ名、指定できる値はcategoryに指定できる値を参照ください。 |
| subcategory |
String |
サブカテゴリ名、指定できる値はsubcategoryに指定できる値を参照ください。 |
| date |
String |
撮影日 (フォーマットはYYYYMMDD形式) |
| date_from |
String |
撮影日範囲指定の開始日（フォーマットはYYYYMMDD形式、dateが指定された場合は無効) |
| date_to |
String |
撮影日範囲指定の終了日（フォーマットはYYYYMMDD形式、dateが指定された場合は無効) |
| lat_sw |
long |
場所範囲指定の南西端の緯度（lat_sw,lat_ne,lng_sw,lng_neすべてが指定されていなければ無効） |
| lat_ne |
long |
場所範囲指定の北西端の緯度（lat_sw,lat_ne,lng_sw,lng_neすべてが指定されていなければ無効） |
| lng_sw |
long |
場所範囲指定の南西端の経度（lat_sw,lat_ne,lng_sw,lng_neすべてが指定されていなければ無効） |
| lng_ne |
long |
場所範囲指定の北西端の経度（lat_sw,lat_ne,lng_sw,lng_neすべてが指定されていなければ無効） |
| lat |
long |
orderにdistanceを指定（距離の近い順にソート）した時の基準となる緯度 |
| lng |
long |
orderにdistanceを指定（距離の近い順にソート）した時の基準となる経度 |
| _accept |
String |
レスポンスのフォーマット。詳細はフィードのフォーマットを参照ください。 |
orderに指定できる値
| 値 |
説明 |
| cdate |
作成日時降順 |
| date (Default) |
撮影日時降順 |
| view |
再生回数降順、同数の場合は撮影日時降順 |
| vote |
投票数降順、同数の場合は撮影日時降順 |
| comment |
コメント件数降順、同数の場合は撮影日時降順 |
| favorite |
お気に入り被登録数降順、同数の場合は撮影日時降順 |
| score |
スコア（独自に算出した点数）降順、同数の場合は撮影日時降順 |
| cdate_asc |
作成日時昇順 |
| date_asc |
撮影日時昇順 |
| view_asc |
再生回数昇順、同数の場合は撮影日時昇順 |
| vote_asc |
投票数昇順、同数の場合は撮影日時昇順 |
| comment_asc |
コメント件数昇順、同数の場合は撮影日時昇順 |
| favorite_asc |
お気に入り被登録数昇順、同数の場合は撮影日時昇順 |
| score_asc |
スコア（独自に算出した点数）昇順、同数の場合は撮影日時昇順 |
| distance |
パラメータlat,lngで指定された座標から近い順 |
privacyに指定できる値
プライバシーの指定は特定ユーザのフィードを取得する場合で、フィードの認証により、フィードのユーザと認証されたユーザが一致した場合にのみ指定が可能です。
| 値 |
説明 |
| public |
一般公開 |
| private |
非公開 |
| blog |
ブログ公開 |
| friend |
友達公開 |
| group |
グループ公開 |
categoryに指定できる値
| 値 |
カテゴリ名 |
| promotion |
プロモーション |
| family |
ファミリー |
| gourmet |
グルメ |
| hobby |
趣味 |
| leisure |
レジャー |
| personal |
パーソナル |
| pet |
ペット |
| travel |
観光・街 |
| vehicle |
乗り物 |
subcategoryに指定できる値
| 親カテゴリ |
値 |
サブカテゴリ名 |
| promotion |
goods-intro |
商品紹介 |
| event-intro |
イベント紹介 |
| shop-intro |
店舗紹介 |
| music-intro |
音楽紹介 |
| movie-intro |
映画紹介 |
| book-intro |
書籍紹介 |
| company-intro |
会社・組織紹介 |
| family |
baby |
赤ちゃん |
| memory |
家族・思い出 |
| wedding |
結婚式・披露宴 |
| burial |
お葬式・法事 |
| shool-events |
学校行事 |
| gourmet |
sweets |
スイーツ |
| dish |
料理 |
| drink |
お酒・ドリンク |
| restaurant |
レストラン・バー |
| health |
健康食品・ダイエット |
| foodstuf |
食材 |
| recipe |
レシピ |
| hobby |
music |
音楽・楽器 |
| dance |
ダンス・演劇 |
| fortune |
占い |
| toy |
おもちゃ |
| game |
ゲーム |
| model |
模型 |
| art |
アート |
| living |
住まい |
| leisure |
outdoor |
釣り・アウトドア |
| baseball |
野球 |
| soccer |
サッカー・フットサル |
| golf |
ゴルフ |
| ball-sport |
球技 |
| marine-sports |
マリンスポーツ |
| winter-sports |
ウィンタースポーツ |
| indoor-sports |
インドアスポーツ |
| sky-sports |
スカイスポーツ |
| fighting |
格闘技・武道 |
| motoring |
ドライブ |
| personal |
friends |
お友達 |
| scoop |
スクープ |
| fashion |
ファッション・ビューティー |
| self |
自己紹介・日記 |
| joke |
ネタ・ジョーク |
| performance |
ストリートパフォーマンス |
| pet |
dog |
犬 |
| cat |
猫 |
| small-animals |
小動物 |
| bird |
小鳥・鳥類 |
| fish |
魚・水中生物 |
| crawler |
爬虫類 |
| inspect |
昆虫 |
| travel |
domestic-tour |
国内旅行 |
| foreign-travel |
海外旅行 |
| hotel |
ホテル・旅館 |
| beauty-spot |
各地の名所・旧跡 |
| landscape |
街・風景・自然・季節 |
| souvenir |
お土産 |
| vehicle |
auto |
自動車 |
| bike |
バイク |
| bicycle |
自転車 |
| train |
電車 |
| ship |
船 |
| aircraft |
飛行機 |
