ひょうごの祭りAPI

概要

  • 兵庫県内で開催されている祭りデータを取得できるAPIです。
  • パラメータによって絞り込んで検索することが可能です。

リクエストURL
http://open-data.pref.hyogo.lg.jp/festival/api/index.php

リクエストパラメーター一覧

パラメータ最大指定件数・長さ説明
formatstring- 出力フォーマットを指定します。
  • xml - XML形式(デフォルト)
  • csv - CSV形式
  • json - JSON形式
keywordstring5件
各400文字
祭り名称、開催場所名称、概要文にマッチする祭りを検索します。コンマで連結して複数の条件に含まれる祭りを絞り込みます。
type_idint-祭り種別IDを指定して絞り込みます。
city_idint20件市町IDを指定して絞り込みます。コンマで連結して複数の条件に含まれる祭りを絞り込みます。
program_idint3件芸能・出し物IDを指定して絞り込みます。コンマで連結して複数の条件に含まれる祭りを絞り込みます。
priceint-無料、有料で絞り込みます。
  • 無指定 - すべて(デフォルト)
  • 0 - 無料
  • 1 - 有料
llnumeric-世界測地系緯度・経度の2点の範囲内に含まれる祭りを絞り込みます。2点の緯度・経度をコンマで繋げて指定します。
monthint-開催月を指定します。dateが指定された場合はそちらが優先されます。
datestring3件開催日を指定します。yyyy/MM/DDまたはyyyy-MM-DDの書式でコンマで結合して複数を対象とすることが可能です。

全角文字はUTF-8にエンコードしてください。


サンプルリクエストURL

キーワードに「文化」を含み、芸能・出し物に「パレード」もしくは「花火」(program_idは芸能・出し物APIから取得したもの)に属する祭りを検索します。

http://open-data.pref.hyogo.lg.jp/festival/api/?format=xml&keyword=文化&program_id=11,16

レスポンス

出力フォーマットに指定された形式で返します。


レスポンスフィールド

フィールド説明
resultレスポンスのすべてを含めます
  festivals検索結果のデータです。
    festival検索結果の1件分のデータです。
      type祭り種別情報です。
        id祭り種別IDです。
        title祭り種別名です。
      city開催市町情報です。
        id開催市町IDです。
        title開催市町名です。
      schedules開催日情報です。
        schedule開催日1件分の情報です。
          date開催日(yyyy-MM-dd)です。
          month開催月です。
          open_time開催時間です。
      programs芸能・出し物情報です。
        program芸能・出し物1件分の情報です。
          id芸能・出し物IDです。
          title芸能・出し物標題です。
      images代表画像です。
        url画像URLです。
        is_primary
  • 0 - その他画像
  • 1 - メイン画像
      id祭りIDです。
      title祭り名です。
      title_read祭り名よみです。
      place_title開催場所名です。
      place_title_read開催場所名よみです。
      address開催場所住所です。
      lat開催場所緯度です。
      lng開催場所経度です。
      event_date開催日(yyyy-MM-dd)です。
      price料金です。
無料の場合は0が入ります。
      description祭り概要です。
      updated_atUNIXTIME形式の更新日時です。
      created_atUNIXTIME形式の作成日時です。
  result_info検索結果の情報です。
    offsetデータ取得開始位置です。
    limitデータ取得数です。
    totalデータ総数です。
    statusリクエストの処理結果コードです。正常終了の場合200、エラーの場合は共通のエラーコードが返されます。

サンプルレスポンス

キーワードに「文化」を含み、芸能・出し物に「パレード」もしくは「花火」(program_idは芸能・出し物一覧APIから取得したもの)に属する祭りが含まれるXMLフォーマットのレスポンスです。

<result>
	<festivals>
		<festival>
			<id>98</id>
			<title>源氏まつり</title>
			<title_read>げんじまつり</title_read>
			<place_title>多田神社~多田駅前</place_title>
			<place_title_read>ただじんじゃ~ただえきまえ</place_title_read>
			<address>〒666-0127 川西市多田院多田所町1-1</address>
			<lat>34.860348</lat>
			<lng>135.402651</lng>
			<description>
				今から千年以上前、第56代清和天皇の曾孫にあたる「源満仲」公は、川西の多田盆地に移り住み、天禄元年(970年)に多田院(現在の多田神社)を創建し、清和源氏の礎を築きました。  後世、鎌倉幕府を開いた源頼朝や全国に名を馳せた源氏武将たちは、全てこの満仲公の子孫であることから、川西市はわが国における源氏と武士団発祥の地と言われています。  この「源氏まつり」は【源氏のふるさと川西】の歴史や文化を広く市内外に発信しようと、鎧、兜に身を固めた源氏ゆかりの武将や馬上の巴御前、姫君、少年少女武者などが、絢爛な時代絵巻を繰り広げる懐古行列を中心とした観光イベントです。
			</description>
			<price>0</price>
			<updated_at>1451925566</updated_at>
			<created_at>1451314542</created_at>
			<event_date>2016-04-10</event_date>
			<type>
				<id>1</id>
				<title>長年続く伝統的な神事・祭り・行事</title>
			</type>
			<city>
				<id>28217</id>
				<title>川西市</title>
			</city>
			<schedules>
				<schedule>
					<date>2016-04-10</date>
					<open_month>4</open_month>
					<open_time>10:00〜14:30</open_time>
					<description/>
				</schedule>
			</schedules>
			<programs>
				<program>
					<id>11</id>
					<title>パレード</title>
				</program>
			</programs>
			<images>
				<url>http://festival/images/festival/98.jpg</url>
				<is_primary>1</is_primary>
			</images>
		</festival>
		<festival>
			<id>30</id>
			<title>三田まつり</title>
			<title_read>さんだまつり</title_read>
			<place_title>三田市総合文化センター(郷の音ホール)駐車場、中心市街地商店街</place_title>
			<place_title_read>さんだしそうごうぶんかセンター(さとのねほーる)ちゅうしゃじょう、ちゅうしんしがいちしょうてんがい</place_title_read>
			<address>兵庫県三田市天神1丁目3番1号</address>
			<lat>34.890982</lat>
			<lng>135.221434</lng>
			<description>
				市民のまつりとして、相互の交流と連帯の輪を広げるとともに、「わがまち三田」のふるさと意識の醸成を図っていくことを目的とする。 ステージでは、市民グループ等による演技、広場では市民総踊りが行われ、夜には、2,500発の花火が打ち上げられます。
			</description>
			<price>0</price>
			<updated_at>1451926622</updated_at>
			<created_at>1451314540</created_at>
			<event_date>2016-08-06</event_date>
			<type>
				<id>3</id>
				<title>地域の歴史や文化を表す特徴的なまち 並み・場所・モノや特産物を活用したイベント</title>
			</type>
			<city>
				<id>28219</id>
				<title>三田市</title>
			</city>
			<schedules>
				<schedule>
					<date>2016-08-06</date>
					<open_month>8</open_month>
					<open_time>15:00〜21:00</open_time>
					<description/>
				</schedule>
			</schedules>
			<programs>
				<program>
					<id>5</id>
					<title>盆踊り</title>
				</program>
				<program>
					<id>16</id>
					<title>花火</title>
				</program>
			</programs>
			<images>
				<url>http://festival/images/festival/30.jpg</url>
				<is_primary>1</is_primary>
			</images>
		</festival>
		<festival>
			<id>96</id>
			<title>但馬“牛まつり“</title>
			<title_read>たじま“うしまつり”</title_read>
			<place_title>但馬牧場公園</place_title>
			<place_title_read>たじまぼくじょうこうえん</place_title_read>
			<address>兵庫県新温泉町丹土1033</address>
			<lat>35.518104</lat>
			<lng>134.487067</lng>
			<description>
				但馬“牛まつり”のメインイベントは但馬牛の造形物パレード。趣向を凝らしたパフォーマンスが披露されます。また、かつて但馬で行われていた牛車を使った花嫁行列の再現は、あでやかな花嫁姿で会場の注目を集めます。ステージではふるさと芸能発表として、但馬杜氏組合 酒づくり唄保存会の「酒づくり唄」や新温泉町の県無形民俗文化財である「丹土はねそ踊り」などが披露されます。  このほかにも但馬牛について楽しく学ぶ「但馬牛○×クイズ」やキャラクターショーなどのアトラクション、「但馬牛の絵展」などが行われ、イベントの最後には「造型物&パフォーマンスコンテスト」の表彰式と但馬ビーフが当たる福餅まき大会が行われます。  会場には、地元団体等による販売コーナーも設けられ、ミニステーキ、牛串焼きなど但馬牛を使用したいろいろな料理や、様々な特産品のお店などが並び、来場者は美味しくて楽しい一日を過ごします。
			</description>
			<price>0</price>
			<updated_at>1451925357</updated_at>
			<created_at>1451314542</created_at>
			<event_date>2016-09-25</event_date>
			<type>
				<id>3</id>
				<title>地域の歴史や文化を表す特徴的なまち 並み・場所・モノや特産物を活用したイベント</title>
			</type>
			<city>
				<id>28586</id>
				<title>新温泉町</title>
			</city>
			<schedules>
				<schedule>
					<date>2016-09-25</date>
					<open_month>9</open_month>
					<open_time>10:00〜16:00</open_time>
					<description/>
				</schedule>
			</schedules>
			<programs>
				<program>
					<id>11</id>
					<title>パレード</title>
				</program>
				<program>
					<id>19</id>
					<title>食まつり</title>
				</program>
			</programs>
			<images>
				<url>http://festival/images/festival/96.jpg</url>
				<is_primary>1</is_primary>
			</images>
		</festival>
		<festival>
			<id>23</id>
			<title>太子あすかふるさとまつり</title>
			<title_read>たいしあすかふるさとまつり</title_read>
			<place_title>太子町立文化会館(あすかホール)</place_title>
			<place_title_read>たいしちょうりつぶんかかいかん(あすかほーる)</place_title_read>
			<address>揖保郡太子町鵤1310-1</address>
			<lat>34.834366</lat>
			<lng>134.580918</lng>
			<description>
				太子あすかふるさとまつりは、ふるさと意識の高揚と一体感の醸成、地域づくりの一環として、平成8年より実施し、住民の皆さんに愛されるまつりです。 飛鳥衣裳やコスプレ衣装を身に着けた時代パレード、地域団体のコミュニティマーケット(屋台村)、お楽しみ抽選会、地域団体の演技、フリーマーケットなど盛り沢山。
			</description>
			<price>0</price>
			<updated_at>1451926969</updated_at>
			<created_at>1451314540</created_at>
			<event_date>2016-11-3</event_date>
			<type>
				<id>3</id>
				<title>地域の歴史や文化を表す特徴的なまち 並み・場所・モノや特産物を活用したイベント</title>
			</type>
			<city>
				<id>28464</id>
				<title>太子町</title>
			</city>
			<schedules>
				<schedule>
					<date>2016-11-3</date>
					<open_month>11</open_month>
					<open_time>10:00〜15:00</open_time>
					<description/>
				</schedule>
			</schedules>
			<programs>
				<program>
					<id>11</id>
					<title>パレード</title>
				</program>
			</programs>
			<images>
				<url>http://festival/images/festival/23.JPG</url>
				<is_primary>1</is_primary>
			</images>
		</festival>
	</festivals>
	<result_info>
	<offset>0</offset>
	<limit>10</limit>
	<total>4</total>
	<status>200</status>
	</result_info>
</result>

リクエストURL
http://open-data.pref.hyogo.lg.jp/festival/api/detail.php

リクエストパラメーター一覧

パラメータ説明
formatstring 出力フォーマットを指定します。
  • xml - XML形式(デフォルト)
  • csv - CSV形式
  • json - JSON形式
idint祭りIDを指定します。

全角文字はUTF-8にエンコードしてください。


サンプルリクエストURL

祭りIDに134を指定して祭りデータを取得します。

http://open-data.pref.hyogo.lg.jp/festival/api/detail.php?format=xml&id=134

レスポンス

出力フォーマットに指定された形式で返します。


レスポンスフィールド

フィールド説明
resultレスポンスのすべてを含めます
  festival検索結果の1件分のデータです。
    type祭り種別情報です。
      id祭り種別IDです。
      title祭り種別名です。
    city開催市町情報です。
      id開催市町IDです。
      title開催市町名です。
      schedules開催日情報です。
        schedule開催日1件分の情報です。
          date開催日(yyyy-MM-dd)です。
          month開催月です。
          open_time開催時間です。
    programs芸能・出し物情報です。
      program芸能・出し物1件分の情報です。
        id芸能・出し物IDです。
        title芸能・出し物名です。
    handicaps障害者対応情報です。
      handicap障害者対応1件分の情報です。
        id障害者対応IDです。
        title障害者対応名です。
    foreigns外国語対応情報です。
      foreign外国語対応1件分の情報です。
        id障害者対応IDです。
        title外国語名です。
          types外国語対応内容情報です。
            type外国語対応内容1件分の情報です。
              id外国語対応内容IDです。
              title外国語対応内容の標題です。
      images画像情報です。
        image画像1件分の情報です。
          url画像URLです。
          is_primary
  • 0 - その他画像
  • 1 - メイン画像
    title祭り名です。
    title_read祭り名よみです。
    place_title開催場所名です。
    place_title_read開催場所名よみです。
    address開催場所住所です。
    lat開催場所緯度です。
    lng開催場所経度です。
    contactお問い合わせ先です。
    telお問い合わせ先電話番号です。
    faxお問い合わせ先FAX番号です。
    hpホームページURLです。
    emailお問い合わせ先メールアドレスです。
    description祭り概要です。
    type_description祭り種別特記事項です。
    program_description芸能・出し物の補足文です。
    is_stall屋台ありなしです。
  • 0 - なし
  • 1 - あり
    price料金です。
無料の場合は0が入ります。
    open_description開催日の説明文です。
    open_time開催時間の補足文です。
    is_lavatoryトイレありなしです。
  • 0 - なし
  • 1 - あり
    access_car車でのアクセス説明文です。
    access_public公共交通機関でのアクセス説明文ですです。
    parking駐車場情報です。
    foreign_description外国語対応補足文です。
    handicapped_description障害者対応補足文です。
    is_nursing授乳室ありなしです。
  • 0 - なし
  • 1 - あり
    supplementその他補足等です。
    updated_atUNIXTIME形式の更新日時です。
    created_atUNIXTIME形式の作成日時です。
  result_info検索結果の情報です。
    offsetデータ取得開始位置です。
    limitデータ取得数です。
    totalデータ総数です。
    statusリクエストの処理結果コードです。正常終了の場合200、エラーの場合は共通のエラーコードが返されます。

サンプルレスポンス

祭りIDに1を指定した祭りデータのXMLフォーマットのレスポンスです。

<result>
	<festival>
		<id>134</id>
		<title>いたみ花火大会</title>
		<title_read>いたみはなびたいかい</title_read>
		<place_title>猪名川神津大橋南側河川敷</place_title>
		<place_title_read>いながわかみつおおはしみなみがわかせんじき</place_title_read>
		<address>伊丹市口酒井</address>
		<lat>34.774061</lat>
		<lng>135.433975</lng>
		<contact>いたみ花火大会実行委員会</contact>
		<tel>072-784-8047</tel>
		<fax>072-784-8048</fax>
		<hp>
			http://www.city.itami.lg.jp/SOSIKI/TOSHIKATSURYOKU/SYOKORODO/KANKO_EVENT/1390898896837.html
		</hp>
		<email>syokorodo@city.itami.lg.jp</email>
		<description>
			毎年、8月第4週目の土曜日に猪名川の神津大橋南側河川敷で開催し、平成27年度で35回目を迎えた。    約3,500発を打ち上げ予定。    音楽と連動した打ち上げの後、伊丹名物「黄金しだれ柳の重ね咲き」による圧巻のグランドフィナーレが待っている。    関西の夏をしめくくる風物詩である。
		</description>
		<type_description/>
		<program_description/>
		<is_stall>1</is_stall>
		<price>0</price>
		<open_description/>
		<open_time/>
		<is_lavatory>1</is_lavatory>
		<access_car>自動車での来場は不可</access_car>
		<access_public>JR伊丹駅より徒歩10分 阪急伊丹駅より徒歩20分</access_public>
		<parking>0</parking>
		<foreign_description/>
		<handicapped_description/>
		<is_nursing>0</is_nursing>
		<supplement/>
		<updated_at>1451922617</updated_at>
		<created_at>1451314543</created_at>
		<type>
			<id>1</id>
			<title>長年続く伝統的な神事・祭り・行事</title>
		</type>
		<city>
			<id>28207</id>
			<title>伊丹市</title>
		</city>
		<schedules>
			<schedule>
				<date>2016-08-27</date>
				<open_month>8</open_month>
				<open_time>20:00〜21:00</open_time>
				<description>荒天時は翌日に順延</description>
			</schedule>
		</schedules>
		<programs>
			<program>
				<id>16</id>
				<title>花火</title>
			</program>
		</programs>
		<handicaps></handicaps>
		<foreigns>
			<foreign>
				<id>1</id>
				<title>英語</title>
				<types>
					<id>1</id>
					<title>ホームページ</title>
				</types>
			</foreign>
			<foreign>
				<id>2</id>
				<title>中国語(簡体字)</title>
				<types>
					<id>1</id>
					<title>ホームページ</title>
				</types>
			</foreign>
			<foreign>
				<id>3</id>
				<title>中国語(繁体字)</title>
				<types>
					<id>1</id>
					<title>ホームページ</title>
				</types>
			</foreign>
			<foreign>
				<id>4</id>
				<title>韓国語</title>
				<types>
					<id>1</id>
					<title>ホームページ</title>
				</types>
			</foreign>
		</foreigns>
		<images>
			<image>
				<url>http://festival/images/festival/134.JPG</url>
				<is_primary>1</is_primary>
			</image>
			<image>
				<url>http://festival/images/festival/134_1.JPG</url>
				<is_primary>0</is_primary>
			</image>
			<image>
				<url>http://festival/images/festival/134_2.JPG</url>
				<is_primary>0</is_primary>
			</image>
		</images>
	</festival>
	<result_info>
	<offset>0</offset>
	<limit>1</limit>
	<total>1</total>
	<status>200</status>
	</result_info>
</result>

リクエストURL
http://open-data.pref.hyogo.lg.jp/festival/api/city.php

リクエストパラメーター一覧

パラメータ説明
formatstring 出力フォーマットを指定します。
  • xml - XML形式(デフォルト)
  • csv - CSV形式
  • json - JSON形式

サンプルリクエストURL

XMLフォーマットのリクエストです。

http://open-data.pref.hyogo.lg.jp/festival/api/city.php?format=xml

レスポンス

出力フォーマットに指定された形式で返します。


レスポンスフィールド

フィールド説明
resultレスポンスのすべてを含めます
  cities市町のデータです。
    city市町のデータ1件分です。
      id市町IDです。
      title市町名です。
  result_infoレスポンスの情報です。
    totalレスポンスに含まれるデータ件数です。
    statusリクエストの処理結果コードです。正常終了の場合200、エラーの場合は共通のエラーコードが返されます。

サンプルレスポンス

XMLフォーマットのレスポンスです。

<result>
  <cities>
    <city>
      <id>28100</id>
      <title>神戸市</title>
    </city>
    <city>
      <id>28201</id>
      <title>姫路市</title>
    </city>
    <city>
      <id>28202</id>
      <title>尼崎市</title>
    </city>
    ...
  </cities>
  <result_info>
    <total>0</total>
    <status>200</status>
  </result_info>
</result>

リクエストURL
http://open-data.pref.hyogo.lg.jp/festival/api/program.php

リクエストパラメーター一覧

パラメータ説明
formatstring 出力フォーマットを指定します。
  • xml - XML形式(デフォルト)
  • csv - CSV形式
  • json - JSON形式

サンプルリクエストURL

XMLフォーマットのリクエストです。

http://open-data.pref.hyogo.lg.jp/festival/api/program.php?format=xml

レスポンス

出力フォーマットに指定された形式で返します。


レスポンスフィールド

フィールド説明
resultレスポンスのすべてを含めます
  programs芸能・出し物名のデータです。
    program芸能・出し物名1件分のデータです。
      id芸能・出し物IDです。
      title芸能・出し物名です。
  result_infoレスポンスの情報です。
    totalレスポンスに含まれるデータ件数です。
    statusリクエストの処理結果コードです。正常終了の場合200、エラーの場合は共通のエラーコードが返されます。

サンプルレスポンス

XMLフォーマットのレスポンスです。

<result>
  <programs>
    <program>
      <id>1</id>
      <title>和太鼓</title>
    </program>
    <program>
      <id>2</id>
      <title>神輿</title>
    </program>
    <program>
      <id>3</id>
      <title>山車・だんじり・ねぶた・山笠</title>
    </program>
    ...
  </programs>
  <result_info>
    <total>14</total>
    <status>200</status>
  </result_info>
</result>

リクエストURL
http://open-data.pref.hyogo.lg.jp/festival/api/type.php

リクエストパラメーター一覧

パラメータ説明
formatstring 出力フォーマットを指定します。
  • xml - XML形式(デフォルト)
  • csv - CSV形式
  • json - JSON形式

サンプルリクエストURL

XMLフォーマットのリクエストです。

http://open-data.pref.hyogo.lg.jp/festival/api/type.php?format=xml

レスポンス

出力フォーマットに指定された形式で返します。


レスポンスフィールド

フィールド説明
resultレスポンスのすべてを含めます
  types祭り種別名のデータです。
    type祭り種別名1件分のデータです。
      id祭り種別IDです。
      title祭り種別名です。
  result_infoレスポンスの情報です。
    totalレスポンスに含まれるデータ件数です。
    statusリクエストの処理結果コードです。正常終了の場合200、エラーの場合は共通のエラーコードが返されます。

サンプルレスポンス

XMLフォーマットのレスポンスです。

<result>
  <types>
    <type>
      <id>1</id>
      <title>神事・儀式</title>
    </type>
    <type>
      <id>2</id>
      <title>催事・イベント</title>
    </type>
  </types>
  <result_info>
    <total>2</total>
    <status>200</status>
  </result_info>
</result>

コード説明
400Bad request. 渡されたパラメータがAPIで期待されたものと一致しない場合に返されます。
403Forbidden. リソースへのアクセスを許されていないか、利用制限を超えている場合に適用されます。
404Not Found. 指定されたリソースが見つからない場合に返されます。
500Internal Server Error. 内部的な問題によってデータを返すことができない場合に返されます。
503Service unavailable. 内部的な問題によってデータを返すことができない場合に返されます。

利用制限

このAPIは1IPごとに1時間あたりのリクエスト上限が500回となっています。毎時0分に上限がリセットされます。