connpass API リファレンス

イベントサーチAPI

検索クエリの条件に応じたイベント一覧を取得できます。

リクエストURL
http://connpass.com/api/v1/event/
検索クエリ
パラメータ 項目名 説明
event_id イベントID 整数 イベント毎に割り当てられた番号で検索します。複数指定可能です*1 URLが http://connpass.com/event/364/ のイベントの場合、イベントIDは 364 になります。
keyword キーワード (AND) 文字列(UTF-8) イベントのタイトル、キャッチ、概要、住所をAND条件部分一致で検索します。複数指定可能です*1
keyword_or キーワード (OR) 文字列(UTF-8) イベントのタイトル、キャッチ、概要、住所をOR条件部分一致で検索します。複数指定可能です*1
ym イベント開催年月 整数 指定した年月に開催されているイベントを検索します。複数指定可能です*1 yyyymm
(例) 201204
ymd イベント開催年月日 整数 指定した年月日に開催されているイベントを検索します。複数指定可能です*1 yyyymmdd
(例) 20120406
nickname 参加者のニックネーム 文字列(UTF-8) 指定したニックネームのユーザが参加しているイベントを検索します。複数指定可能です*1
owner_nickname 管理者のニックネーム 文字列(UTF-8) 指定したニックネームのユーザが管理しているイベントを検索します。複数指定可能です*1
series_id シリーズID 整数 シリーズ毎に割り当てられた番号で、ひもづいたイベントを検索します。複数指定可能です*1 URLが http://connpass.com/series/1/ のシリーズの場合、シリーズIDは 1 になります。
start 検索の開始位置 整数 検索結果の何件目から出力するかを指定します。 (初期値: 1)
order 検索結果の表示順 整数 検索結果の表示順を、更新日時順、開催日時順、新着順で指定します。 1: 更新日時順
2: 開催日時順
3: 新着順
(初期値: 1)
count 取得件数 整数 検索結果の最大出力データ数を指定します。 初期値: 10、最小値:1、最大値:100
format レスポンス形式 文字列(UTF-8) レスポンスの形式を指定します。 jsonに固定です。
パラメータを複数指定する場合は、 name=value1&name=value2&... または name=value1,value2... のように指定できます。
サンプル
pythonを含むイベントを検索
http://connpass.com/api/v1/event/?keyword=python
レスポンスフィールド
フィールド 説明
results_returned 整数 含まれる検索結果の件数 1
results_available 整数 検索結果の総件数 191
results_start 整数 検索の開始位置 1
events 配列(複数要素) 検索結果のイベントリスト
event_id 整数 イベントID 364
title 文字列(UTF-8) タイトル BPStudy#56
catch 文字列(UTF-8) キャッチ 株式会社ビープラウドが主催するWeb系技術討論の会
description 文字列(UTF-8) 概要(HTML形式) 今回は「Python プロフェッショナル プログラミング」執筆プロジェクトの継続的ビルドについて、お話しして頂きます。
event_url 文字列(UTF-8) connpass.com 上のURL http://connpass.com/event/364/
hash_tag 文字列(UTF-8) Twitterのハッシュタグ bpstudy
started_at 文字列(UTF-8) イベント開催日時 (ISO-8601形式) 2012-04-17T18:30:00+09:00
ended_at 文字列(UTF-8) イベント終了日時 (ISO-8601形式) 2012-04-17T20:30:00+09:00
limit 整数 定員 80
event_type 文字列(UTF-8) イベント参加タイプ participation: connpassで参加受付あり
advertisement: 告知のみ
series オブジェクト シリーズ
id 整数 シリーズID 1
title 文字列(UTF-8) シリーズタイトル BPStudy
url 文字列(UTF-8) シリーズのconnpass.com 上のURL http://connpass.com/series/1/
address 文字列(UTF-8) 開催場所 東京都渋谷区千駄ヶ谷5-32-7
place 文字列(UTF-8) 開催会場 BPオフィス (NOF南新宿ビル4F)
lat 浮動小数点数 開催会場の緯度 35.680236100000
lon 浮動小数点数 開催会場の経度 139.701308500000
owner_id 整数 管理者のID 8
owner_nickname 文字列(UTF-8) 管理者のニックネーム haru860
owner_display_name 文字列(UTF-8) 管理者の表示名 佐藤 治夫
accepted 整数 参加者数 80
waiting 整数 補欠者数 15
updated_at 文字列(UTF-8) 更新日時 (ISO-8601形式) 2012-03-20T12:07:32+09:00

connpass API Showcase

connpass API をご利用頂いているサービスやアプリの一覧です。
こちらに掲載されていないものや、残念ながら終了してしまったもの、その他掲載に関するお問い合わせがあれば、是非 お知らせ ください。

Webサービス
iOSアプリ
Androidアプリ
Chrome拡張
vimプラグイン
ライブラリ