お知らせ 【メンテナンスのお知らせ】4月25日(木)10:00から1時間半ほど、メンテナンス作業を予定しております。作業の間はconnpassのご利用が出来ません。ご迷惑をおかけしますが何卒ご了承ください。

お知らせ connpassではさらなる価値のあるデータを提供するため、2024年5月23日(木)を以ちましてイベントサーチAPIの無料での提供の廃止を決定いたしました。
2024年5月23日(木)以降より開始予定の「connpass 有料API」の料金プランにつきましてはこちらをご覧ください。
なお有料の対象となるのはAPIのみであり、connpassのサービスにつきましては今後も無料でご利用いただけます。

connpass API リファレンス

イベントサーチAPI

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

2024年5月23日(木)を以ちましてイベントサーチAPIの無料での提供の廃止を決定いたしました。
料金・プラン等につきましてはこちらの ヘルプページ をご覧ください。

※過度な検索やクローリングに対しては、アクセス制限を施す可能性があります。robots.txt を遵守してください。

リクエストURL
https://connpass.com/api/v1/event/
検索クエリ
パラメータ 項目名 説明
event_id イベントID 整数 イベント毎に割り当てられた番号で検索します。複数指定可能です*1 URLが https://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が https://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を含むイベントを検索
https://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 https://connpass.com/event/364/
hash_tag 文字列(UTF-8) X(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 https://connpass.com/series/1/
address 文字列(UTF-8) 開催場所 東京都豊島区東池袋1-7-12
place 文字列(UTF-8) 開催会場 BPオフィス (日産ビルディング7F)
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を利用して開発したサービス等にお使いください。リサイズ以外の素材加工についてはお控えください。
ご不明な点は お問い合わせ ください。