{"openapi":"3.0.3","info":{"title":"Korea Travel & K-pop Live Data (ja/en/ko)","version":"1.0.0","description":"Live Korea travel data for apps and AI agents, in Japanese, English or Korean: K-pop concert search and new-concert alerts, Seoul concert trip packs (tickets, venue, last trains, crowd, hotels/food nearby), Seoul live crowd + weather for 121 places, next subway trains, Incheon Airport security wait times."},"servers":[{"url":"https://api.k-agentpay.com"}],"paths":{"/v1/kpop/search":{"get":{"summary":"Matching concerts in Korea (next 6 months) with concert ids","description":"matching concerts in Korea (next 6 months) with concert ids. Free.","operationId":"kpopSearch","parameters":[{"name":"q","in":"query","required":true,"description":"artist or title","schema":{"type":"string"},"example":"CRAVITY"},{"name":"lang","in":"query","required":false,"description":"response language: ja (default), en or ko","schema":{"type":"string","enum":["ja","en","ko"],"default":"ja"}}],"responses":{"200":{"description":"JSON data","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"bad or missing parameter (not charged)"},"502":{"description":"upstream source temporarily unavailable (not charged)"}}}},"/v1/seoul/trip-pack":{"get":{"summary":"Trip pack: schedule","description":"trip pack: schedule, seat prices in yen, ticket sites, venue + map, nearest stations and last trains, live crowd and weather near the venue, popular areas nearby, nearby hotels/food/spots, same-week festivals. x402 price: ¥50 per call in JPYC or USDT on Kaia (or via an API marketplace plan).","x-payment-info":{"price":{"currency":"USD","mode":"fixed","amount":"0.32"},"protocols":[{"x402":{"version":2,"networks":["eip155:8453","eip155:8217"],"assets":["USDC","JPYC","USDT"]}}]},"operationId":"seoulTripPack","parameters":[{"name":"id","in":"query","required":true,"description":"concert id from /v1/kpop/search, e.g. PF303322","schema":{"type":"string"},"example":"PF303322"},{"name":"lang","in":"query","required":false,"description":"response language: ja (default), en or ko","schema":{"type":"string","enum":["ja","en","ko"],"default":"ja"}}],"responses":{"200":{"description":"JSON data","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"bad or missing parameter (not charged)"},"402":{"description":"x402 payment required (direct access without a marketplace key)"},"502":{"description":"upstream source temporarily unavailable (not charged)"}}}},"/v1/kpop/new":{"get":{"summary":"Newly registered or updated concerts in Korea (titles in the chosen language)","description":"newly registered or updated concerts in Korea (titles in the chosen language), for repeated checks. x402 price: ¥3 per call in JPYC or USDT on Kaia (or via an API marketplace plan).","x-payment-info":{"price":{"currency":"USD","mode":"fixed","amount":"0.02"},"protocols":[{"x402":{"version":2,"networks":["eip155:8453","eip155:8217"],"assets":["USDC","JPYC","USDT"]}}]},"operationId":"kpopNew","parameters":[{"name":"q","in":"query","required":false,"description":"artist (optional, Japanese OK)","schema":{"type":"string"},"example":"CRAVITY"},{"name":"since","in":"query","required":false,"description":"YYYYMMDD (optional, default 7 days)","schema":{"type":"string"},"example":"20261001"},{"name":"lang","in":"query","required":false,"description":"response language: ja (default), en or ko","schema":{"type":"string","enum":["ja","en","ko"],"default":"ja"}}],"responses":{"200":{"description":"JSON data","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"bad or missing parameter (not charged)"},"402":{"description":"x402 payment required (direct access without a marketplace key)"},"502":{"description":"upstream source temporarily unavailable (not charged)"}}}},"/v1/seoul/now":{"get":{"summary":"Live crowd level","description":"live crowd level, 12-hour crowd forecast, weather and events for a Seoul place, refreshed every ~5 minutes. x402 price: ¥1.5 per call in JPYC or USDT on Kaia (or via an API marketplace plan).","x-payment-info":{"price":{"currency":"USD","mode":"fixed","amount":"0.01"},"protocols":[{"x402":{"version":2,"networks":["eip155:8453","eip155:8217"],"assets":["USDC","JPYC","USDT"]}}]},"operationId":"seoulNow","parameters":[{"name":"place","in":"query","required":true,"description":"place name or code from /v1/seoul/places","schema":{"type":"string"},"example":"Myeongdong"},{"name":"lang","in":"query","required":false,"description":"response language: ja (default), en or ko","schema":{"type":"string","enum":["ja","en","ko"],"default":"ja"}}],"responses":{"200":{"description":"JSON data","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"bad or missing parameter (not charged)"},"402":{"description":"x402 payment required (direct access without a marketplace key)"},"502":{"description":"upstream source temporarily unavailable (not charged)"}}}},"/v1/seoul/subway":{"get":{"summary":"Next trains at a Seoul subway station right now","description":"next trains at a Seoul subway station right now. x402 price: ¥1.5 per call in JPYC or USDT on Kaia (or via an API marketplace plan).","x-payment-info":{"price":{"currency":"USD","mode":"fixed","amount":"0.01"},"protocols":[{"x402":{"version":2,"networks":["eip155:8453","eip155:8217"],"assets":["USDC","JPYC","USDT"]}}]},"operationId":"seoulSubway","parameters":[{"name":"station","in":"query","required":true,"description":"station name in English, Japanese or Korean, e.g. Hongik Univ.","schema":{"type":"string"},"example":"Hongik Univ."},{"name":"lang","in":"query","required":false,"description":"response language: ja (default), en or ko","schema":{"type":"string","enum":["ja","en","ko"],"default":"ja"}}],"responses":{"200":{"description":"JSON data","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"bad or missing parameter (not charged)"},"402":{"description":"x402 payment required (direct access without a marketplace key)"},"502":{"description":"upstream source temporarily unavailable (not charged)"}}}},"/v1/airport/icn":{"get":{"summary":"Incheon Airport departure-hall waiting minutes and queue per gate (T1","description":"Incheon Airport departure-hall waiting minutes and queue per gate (T1, T2), live. x402 price: ¥1.5 per call in JPYC or USDT on Kaia (or via an API marketplace plan).","x-payment-info":{"price":{"currency":"USD","mode":"fixed","amount":"0.01"},"protocols":[{"x402":{"version":2,"networks":["eip155:8453","eip155:8217"],"assets":["USDC","JPYC","USDT"]}}]},"operationId":"airportIcn","parameters":[{"name":"lang","in":"query","required":false,"description":"response language: ja (default), en or ko","schema":{"type":"string","enum":["ja","en","ko"],"default":"ja"}}],"responses":{"200":{"description":"JSON data","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"bad or missing parameter (not charged)"},"402":{"description":"x402 payment required (direct access without a marketplace key)"},"502":{"description":"upstream source temporarily unavailable (not charged)"}}}},"/v1/seoul/places":{"get":{"summary":"The 121 Seoul places with names and codes","description":"the 121 Seoul places with names and codes. Free.","operationId":"seoulPlaces","parameters":[{"name":"lang","in":"query","required":false,"description":"response language: ja (default), en or ko","schema":{"type":"string","enum":["ja","en","ko"],"default":"ja"}}],"responses":{"200":{"description":"JSON data","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"bad or missing parameter (not charged)"},"502":{"description":"upstream source temporarily unavailable (not charged)"}}}},"/v1/kpop/concerts":{"get":{"summary":"Seoul pop concerts","description":"Seoul pop concerts. x402 price: ¥3 per call in JPYC or USDT on Kaia (or via an API marketplace plan).","x-payment-info":{"price":{"currency":"USD","mode":"fixed","amount":"0.02"},"protocols":[{"x402":{"version":2,"networks":["eip155:8453","eip155:8217"],"assets":["USDC","JPYC","USDT"]}}]},"operationId":"kpopConcerts","parameters":[{"name":"from","in":"query","required":false,"description":"YYYYMMDD","schema":{"type":"string"},"example":"20261015"},{"name":"to","in":"query","required":false,"description":"YYYYMMDD","schema":{"type":"string"},"example":"20261215"},{"name":"lang","in":"query","required":false,"description":"response language: ja (default), en or ko","schema":{"type":"string","enum":["ja","en","ko"],"default":"ja"}}],"responses":{"200":{"description":"JSON data","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"bad or missing parameter (not charged)"},"402":{"description":"x402 payment required (direct access without a marketplace key)"},"502":{"description":"upstream source temporarily unavailable (not charged)"}}}},"/v1/korea/festivals":{"get":{"summary":"Festivals and events in Korea","description":"festivals and events in Korea. x402 price: ¥3 per call in JPYC or USDT on Kaia (or via an API marketplace plan).","x-payment-info":{"price":{"currency":"USD","mode":"fixed","amount":"0.02"},"protocols":[{"x402":{"version":2,"networks":["eip155:8453","eip155:8217"],"assets":["USDC","JPYC","USDT"]}}]},"operationId":"koreaFestivals","parameters":[{"name":"from","in":"query","required":false,"description":"YYYYMMDD","schema":{"type":"string"},"example":"20261015"},{"name":"lang","in":"query","required":false,"description":"response language: ja (default), en or ko","schema":{"type":"string","enum":["ja","en","ko"],"default":"ja"}}],"responses":{"200":{"description":"JSON data","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"bad or missing parameter (not charged)"},"402":{"description":"x402 payment required (direct access without a marketplace key)"},"502":{"description":"upstream source temporarily unavailable (not charged)"}}}},"/v1/request":{"get":{"summary":"Free: request Korea data we do not offer yet; the most requested data is added f","description":"free: request Korea data we do not offer yet; the most requested data is added first. Free.","operationId":"request","parameters":[{"name":"want","in":"query","required":false,"description":"the Korea data you need (free text)","schema":{"type":"string"}},{"name":"useCase","in":"query","required":false,"description":"optional","schema":{"type":"string"}},{"name":"contact","in":"query","required":false,"description":"optional","schema":{"type":"string"}},{"name":"lang","in":"query","required":false,"description":"response language: ja (default), en or ko","schema":{"type":"string","enum":["ja","en","ko"],"default":"ja"}}],"responses":{"200":{"description":"JSON data","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"bad or missing parameter (not charged)"},"502":{"description":"upstream source temporarily unavailable (not charged)"}}}}}}