KOPIS API
KOPIS(๊ณต์ฐ ์์ ํตํฉ ์ ์ฐ๋ง)์ ๋ฐ์ดํฐ๋ฅผ
์ฝ๊ฒ ํ์ฉํ๊ธฐ ์ํด ๋ง๋ API์
๋๋ค.
How to install
pip install kopisapi
How to use
from kopisapi import KopisAPI
kopis = KopisAPI("INPUT YOUR KOPIS SERVICE KEY")
kopis.get_performance_list(start_date="20220101",end_date="20220102")KOPIS SERVICE KEY ๋ ๋ฐ์ ๋งํฌ๋ฅผ ํตํ์ฌ ๋ฐ๊ธ ๋ฐ์ผ์ค ์ ์์ต๋๋ค.
https://www.kopis.or.kr/por/cs/openapi/openApiInfo.do?menuId=MNU_00074&searchType=total&searchWord=
๐ ์ด 14๊ฐ์ API ํญ๋ชฉ์ ์ง์ํ๋ฉฐ ๋ชฉ๋ก์ ๋ค์๊ณผ ๊ฐ์ต๋๋ค.
1. ๊ณต์ฐ ๋ชฉ๋ก get_performance_list(start_date="20210101", end_date="20220101", region="seoul", genre="musical")
2. ๊ณต์ฐ์์ค ๋ชฉ๋ก get_performance_facility_list(region="seoul")
3. ๊ธฐํ/์ ์์ฌ ๋ชฉ๋ก get_production_company_list(genre="musical")
4. ์ถ์ ๋ชฉ๋ก get_festival_list(start_date="20210101", end_date="20220101", region="seoul", genre="musical")
5. ์์์ ๋ชฉ๋ก get_award_list(start_date="20210101", end_date="20220101", region="seoul", genre="musical")
6. ๊ทน์๊ฐ ๋ชฉ๋ก get_playwright_list(start_date="20210101", end_date="20220101", region="seoul", genre="musical")
7. ์๋งค ์ํฉํ get_reservation_status_list(date_type="day", start_date="20220101", region="seoul", genre="musical")
8. ์ผ๋ณ ํฐ์ผํ๋งค์ ๋ฐ ํฐ์ผํ๋งค์ก get_daily_ticket_sales(start_month="202201")
9. ์๋ณ ํฐ์ผํ๋งค์ ๋ฐ ํฐ์ผํ๋งค์ก get_monthly_ticket_sales(start_year="2022")
10. ์์ผ๋ณ ํฐ์ผํ๋งค์ ๋ฐ ํฐ์ผํ๋งค์ก get_day_ticket_sales(start_date="20221217",end_date="20221224")
11. ๊ตญ๋ด/๋ดํ๋ณ ํต๊ณ get_statistics_by_domestic_abroad(start_date="20210101", end_date="20220101")
12. ๊ณต์ฐ ์์ค๋ณ ํต๊ณ get_statistics_by_facility(start_date="20210101", end_date="20220101", region="seoul")
13. ์ง์ญ๋ณ ํต๊ณ get_statistics_by_region(start_date="20210101", end_date="20220101")
14. ์ฅ๋ฅด๋ณ ํต๊ณ get_statistics_by_genre(start_date="20210101", end_date="20220101")
15. ๊ณต์ฐ๋ณ ํต๊ณ get_statistics_by_performance(start_date="20210101", end_date="20220101", genre="musical")
API์ ์
๋ ฅ๋๋ ์ธ์๊ฐ์ ๋ชจ๋ string type์
๋๋ค.
- start_date="๋ /์/์ผ"
- end_date="๋ /์/์ผ"
- start_month="๋ /์"
- start_year="๋ "
- date_type=["month","week","day"]
- region=["seoul","busan","daegu","inchon","gwangju","daejeon","ulsan","sejong","gyeonggi", "gangwon","chungbuk","chungnam","jeonbuk","jeonnam","gyeongbuk","gyeongnam","jeju"]
- genre=["act","musical","dance","classic","opera","korean_classical","complex"]
