イベント検索API
eventcastに登録されたイベントを取得することができるAPIです。
クリップ数やそのイベントにつけられたタグ、場所が登録されている場合には、位置情報（緯度、経度）も含めて返します。
イベント検索APIや他の公開APIを組み合わせてまったく新しいアプリケーションを作成することができます。
リクエストURL
http://clip.eventcast.jp/api/v1/Search?
リクエストサンプル
- 2007年2月1日から2007年2月28日までのテレビタグのついたイベントを日付の古い順で返します。
http://clip.eventcast.jp/api/v1/Search?
Tag=テレビ
&StartDate=2007/02/01
&EndDate=2007/02/28
&Sort=date
&Order=asc - キーワード「Google」でイベントを検索し、jsonフォーマットで返します。
http://clip.eventcast.jp/api/v1/Search?
Keyword=Google
&Format=json - ユーザ melonのDVDタグがついた2007年1月1日以降のイベントを日付の古い順で返します。
http://clip.eventcast.jp/api/v1/Search?
Username=melon
&Tag=DVD
&StartDate=2007/01/01
&Sort=date
&Order=asc
リクエストパラメータ
| フィールド名 | 項目名 | 型 | 初期値 | 備考 |
|---|---|---|---|---|
| Format | フォーマット | string (optional) |
xml | xml:XML php:phpシリアライズ json:JSON |
| Callback | コールバック | string (optional) |
- | フォーマットがjsonの場合に指定可能 |
| Keyword | キーワード | string (optional) |
- | UTF-8でURLエンコードした文字列 |
| Username | ユーザ名 | string (optional) |
- | - |
| Tag | タグ | string (optional) |
- | UTF-8でURLエンコードした文字列 |
| Prefecture | 都道府県 | string (optional) |
- | UTF-8でURLエンコードした文字列 |
| City | 市区町村 | string (optional) |
- | UTF-8でURLエンコードした文字列 |
| StartDate | イベント開始日 | date (optional) |
- | yyyy/mm/dd |
| EndDate | イベント終了日 | date (optional) |
- | yyyy/mm/dd |
| Sort | ソート基準 | string (optional) |
registdate | registdate:登録日 date:イベント日 clip:クリップ数 |
| Order | 並び順 | string (optional) |
desc | desc:降順 asc:昇順 |
| Start | ページ番号 | interger (optional) |
1 | 1から100までの整数 |
| Results | 取得件数 | interger (optional) |
20 | 1から50までの整数 |
| Trim | 開催中のイベント | interger (optional) |
0 | 開催中のイベントを含まない:0 開催中のイベントのみ:1 開催中のイベントを含む:2 |
レスポンスパラメータ
| 要素 | 属性 | サンプル | 説明 |
|---|---|---|---|
| Response | - | - | 結果全体の親要素 |
| Request | - | - | Argumentsの親要素 |
| Arguments | Keyword | 東京 | キーワード |
| Username | melon | ユーザ名 | |
| Tag | 映画 | タグ | |
| Prefecture | 東京都 | 都道府県 | |
| City | 杉並区 | 市区町村 | |
| StartDate | 2007-02-01 | 開始日 | |
| EndDate | 2007-02-28 | 終了日 | |
| Sort | date | ソート基準 | |
| Order | asc | 並び順 | |
| Start | 1 | ページ番号 | |
| Results | 20 | 取得件数 | |
| Trim | 0 | 開催中のイベント | |
| Status | OK | ステータス | |
| Items | - | - | TotalResult、Itemの親要素 |
| TotalResult | - | 123 | 件数 |
| Item | - | - | 各イベントの親要素 |
| Id | - | 515593aa92db4194259207bef91ba557 | イベントID |
| Title | - | 六本木ヴェルファーレが閉店 | イベントタイトル |
| Url | - | http://www.example.com/ | クリップ元URL |
| Link | - | http://clip.eventcast.jp/event/ 515593aa92db4194259207bef91ba557 |
URL |
| StartDate | - | 2007-02-01 | イベントの開始日 |
| EndDate | - | 2007-02-01 | イベントの終了日 |
| StartTime | - | 12:00 | イベントの開始時間 |
| EndTime | - | 22:00 | イベントの終了時間 |
| ClipCount | - | 6 | クリップ数 |
| RegistDate | - | 2006/11/16 22:30:41 | 最初にクリップされた日時 |
| Tags | - | - | Tagの親要素 |
| Tag | - | 映画 | タグ |
| Count | - | 3 | タグがつけられた数 |
| Location | Address | 港区六本木7-14-22(六本木ヴェルファーレ) | 住所 |
| Location | Lat | 35.66378 | 緯度(世界測地系) |
| Location | Lng | 139.730881 | 経度(世界測地系) |
レスポンスサンプル
エラー
エラーが発生した場合には、次の形式でエラーメッセージを返します。
| Message | 説明 |
|---|---|
| ItemNotFound | データが存在しない |
| InvalidParameterValue | 不正なパラメータ |
制限事項
- システムの速度低下や停止を招くような大量のリクエストはご遠慮ください。一定期間アクセスを遮断することがあります。
- 商用利用される場合は、必ず事前にご相談ください。