イベント検索APIリファレンス
イベントンではイベント情報を検索できるAPIを公開しています。
注意事項:APIの仕様は予告なく変更される可能性があります。
リクエストURL
| フォーマット | リクエストURL | 備考 |
|---|---|---|
| xml | http(s)://eventon.jp/api/events.xml |
|
| json | http(s)://eventon.jp/api/events.json |
パラメータ
| パラメータ | 名前 | タイプ | 初期値 | 複数 | 備考 |
|---|---|---|---|---|---|
event_id |
イベントID | 数値 | - | イベントページのURLのxxxxがイベントIDとなります。 http://eventon.jp/xxxx/ |
|
prefecture_id |
都道府県ID | 数値 | - | 1 - 47 までの都道府県IDを指定 ※下表参照 |
|
ym |
開催年月 | 数値 | - | yyyymm形式 例）201801 |
|
ym_between |
開催年月範囲 | 数値 | - | 2個 | yyyymm形式 例）201801,201805 |
ymd |
開催年月日 | 数値 | - | yyyymmdd形式 例）20180125 |
|
ymd_between |
開催年月日範囲 | 数値 | - | 2個 | yyyymmdd形式 例）20180320,20180505 |
owner_id |
主催者ID | 数値 | - | 主催者ページのURLのxxxxが主催者IDとなります。 http://eventon.jp/user/xxxx/ |
|
place |
会場名 | 文字列 | - | 会場名が公開されているイベントのみ 部分一致検索 |
|
keyword |
キーワード(OR) | 文字列 | - | イベント名、概要、イベント内容から部分一致検索 | |
keyword_and |
キーワード(AND) | 文字列 | - | イベント名、概要、イベント内容から部分一致検索 | |
start |
検索開始位置 | 数値 | 1 | - | 1以上 |
limit |
取得件数 | 数値 | 10 | - | 最大100 |
order |
並び順 | 文字列 | started_at_desc | - | 以下のキーワードが指定可能 started_at_asc：開催日昇順 started_at_desc：開催日降順 address_asc：住所昇順 address_desc：住所降順 |
※パラメータを複数指定する場合には、カンマ区切りで指定してください。
例）
※APIのリクエスト数は1時間あたり60回までとなります。
例）
event_id=1,3,4&ym=201712,201801&...
※APIのリクエスト数は1時間あたり60回までとなります。
サンプルクエリ
2016年8月と9月に開催される「3Dプリンター」関連のイベントを5件取得https://eventon.jp/api/events.json?ym=201608,201609&keyword=3Dプリンター&limit=52018年7月25日から9月26日までの間に開催されるイベントを取得
https://eventon.jp/api/events.json?ymd_between=20180725,20180926関東で開催されるイベントをxml形式で取得
https://eventon.jp/api/events.xml?prefecture_id=8,9,10,11,12,13,14
レスポンス
| フィールド | 名前 | 備考 | ||||
|---|---|---|---|---|---|---|
count |
検索ヒット数 | start、limit以外の検索パラメータによりヒットした総件数 |
||||
start |
検索開始位置 | startパラメータで指定した値 |
||||
limit |
取得件数 | limitパラメータで指定した値※実際の取得件数とは異なります。 |
||||
events |
イベント情報 | |||||
| +- | event |
[複数要素] | ||||
| +- | event_id |
イベントID | ||||
| +- | title |
イベント名 | ||||
| +- | summary |
概要 | ||||
| +- | contents |
イベント内容 | ※HTML形式 | |||
| +- | image_path |
イベント画像パス | ||||
| +- | started_at |
イベント開催日時 | 例）2018-02-27T12:30:00+09:00 | |||
| +- | ended_at |
イベント終了日時 | 例）2018-02-27T12:30:00+09:00 | |||
| +- | opened_at |
入場可能日時 | 例）2018-02-27T12:30:00+09:00 | |||
| +- | entry_started_at |
申込み受付開始日時 | 例）2018-02-27T12:30:00+09:00 | |||
| +- | entry_ended_at |
申込み受付終了日時 | 例）2018-02-27T12:30:00+09:00 | |||
| +- | cancel_at |
キャンセル可能日時 | 例）2018-02-27T12:30:00+09:00 | |||
| +- | capacity |
定員 | ||||
| +- | event_url |
イベントンのURL | ||||
| +- | url |
参考URL | ||||
| +- | payment_types |
支払い方法 | ||||
| +- | payment_type |
[複数要素] | 会場払い、銀行振込、クレジット決済 | |||
| +- | tickets |
チケット情報 | ||||
| +- | ticket |
[複数要素] | ||||
| +- | name |
チケット名 | ||||
| +- | price |
チケット料金 | ||||
| +- | cancel_policy |
キャンセル規約 | ||||
| +- | prefecture_id |
都道府県ID | ※下表参照 | |||
| +- | address |
開催場所 | 開催場所が公開の場合のみ取得 ※非公開の場合は市区町村まで取得 |
|||
| +- | place |
会場名 | 開催場所が公開の場合のみ取得 | |||
| +- | lat |
緯度 | 開催場所が公開の場合のみ取得 | |||
| +- | lng |
経度 | 開催場所が公開の場合のみ取得 | |||
| +- | accepted |
参加者数 | ||||
| +- | waiting |
キャンセル待ち数 | ||||
| +- | categories |
カテゴリー情報 | ||||
| +- | category |
[複数要素] | IT、体験イベント、スポーツ 等 | |||
| +- | owners |
主催者情報 | ||||
| +- | owner |
[複数要素] | ||||
| +- | id |
主催者ID | ||||
| +- | name |
主催者名 | ||||
| +- | url |
主催者URL | ||||
| +- | embed_code |
埋め込みコード | ※HTML形式 | |||
| +- | updated_at |
更新日時 | 例）2018-02-27T12:30:00+09:00 |
※json形式の場合、[複数要素]の要素は値のみの配列となります。
都道府県一覧 (JISコード準拠)
| 都道府県ID | 都道府県名 |
|---|---|
| 1 | 北海道 |
| 2 | 青森県 |
| 3 | 岩手県 |
| 4 | 宮城県 |
| 5 | 秋田県 |
| 6 | 山形県 |
| 7 | 福島県 |
| 8 | 茨城県 |
| 9 | 栃木県 |
| 10 | 群馬県 |
| 11 | 埼玉県 |
| 12 | 千葉県 |
| 13 | 東京都 |
| 14 | 神奈川県 |
| 15 | 新潟県 |
| 16 | 富山県 |
| 17 | 石川県 |
| 18 | 福井県 |
| 19 | 山梨県 |
| 20 | 長野県 |
| 21 | 岐阜県 |
| 22 | 静岡県 |
| 23 | 愛知県 |
| 24 | 三重県 |
| 25 | 滋賀県 |
| 26 | 京都府 |
| 27 | 大阪府 |
| 28 | 兵庫県 |
| 29 | 奈良県 |
| 30 | 和歌山県 |
| 31 | 鳥取県 |
| 32 | 島根県 |
| 33 | 岡山県 |
| 34 | 広島県 |
| 35 | 山口県 |
| 36 | 徳島県 |
| 37 | 香川県 |
| 38 | 愛媛県 |
| 39 | 高知県 |
| 40 | 福岡県 |
| 41 | 佐賀県 |
| 42 | 長崎県 |
| 43 | 熊本県 |
| 44 | 大分県 |
| 45 | 宮崎県 |
| 46 | 鹿児島県 |
| 47 | 沖縄県 |