{"openapi":"3.1.0","info":{"title":"SCOPRI Reality Engine — South Korea","version":"1.1.1","description":"Evidence-backed South Korea reality decision API for AI agents and travel apps. Free preview exposes GO/CHECK/HOLD, evidence coverage and risk flags; paid requests unlock exact nearby fallbacks, navigation and bookable actions.","contact":{"name":"FavPulse / SCOPRI","email":"moneybug@favpulse.media","url":"https://favpulse.media/scopri/reality-api/"}},"servers":[{"url":"https://favpulse.media/scopri/api"}],"paths":{"/preview":{"get":{"summary":"Free Reality Preview — South Korea place decision","description":"Free pre-purchase preview. Resolve a Korean place and return GO/CHECK/HOLD, evidence coverage, risk flags and aggregate fallback counts while withholding the exact paid lists and URLs.","operationId":"scopriRealityPreview","tags":["Reality Preview","Decision Support","South Korea","Travel"],"parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":2,"maxLength":120},"description":"Korean place name or address"},{"name":"radius_m","in":"query","required":false,"schema":{"type":"integer","minimum":300,"maximum":5000,"default":1500}},{"name":"needs","in":"query","required":false,"schema":{"type":"string"},"description":"Comma-separated traveler constraints: car,stroller"}],"responses":{"200":{"description":"Free Reality Preview JSON"},"400":{"description":"Invalid query"},"404":{"description":"Place not found"}}}},"/address-to-coordinates":{"get":{"summary":"Geocoding address to coordinates — South Korea","description":"Convert a South Korea address, landmark or place name to latitude and longitude. Returns canonical address, region, category, match type and confidence score.","operationId":"geocodingAddressToCoordinatesSouthKorea","tags":["Geocoding","Address to Coordinates","South Korea","Geo"],"x-payment-info":{"protocols":["x402"],"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","price":{"mode":"fixed","currency":"USD","amount":"0.001"},"payTo":"0x078293f144c61d1e02b49d4cd3f33c283eb7dc73"},"parameters":[{"name":"address","in":"query","required":true,"schema":{"type":"string","minLength":2,"maxLength":160},"description":"South Korea address, landmark or place name"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":10,"default":5}}],"responses":{"200":{"description":"Ranked latitude/longitude matches"},"400":{"description":"Invalid input"},"402":{"description":"x402 payment required"}}}},"/geocode":{"get":{"summary":"South Korea address/place geocoding to coordinates","description":"Resolve a South Korea address or place name to latitude/longitude using SCOPRI place data.","operationId":"southKoreaGeocode","tags":["Korea","Geo","Geocoding","Address"],"x-payment-info":{"protocols":["x402"],"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","price":{"mode":"fixed","currency":"USD","amount":"0.001"},"payTo":"0x078293f144c61d1e02b49d4cd3f33c283eb7dc73"},"parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":2,"maxLength":160},"description":"South Korea address or place name"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":10,"default":5}}],"responses":{"200":{"description":"Geocoding matches with coordinates"},"400":{"description":"Invalid input"},"402":{"description":"x402 payment required"}}}},"/korea-nearby-poi":{"get":{"summary":"Korea Local Business & POI Search — nearby places by coordinates","description":"Search South Korea local places and points of interest around coordinates. Returns distance-sorted JSON from SCOPRI's Korea place corpus.","operationId":"koreaNearbyPoi","tags":["Korea","Geo","POI","Local Places"],"x-payment-info":{"protocols":["x402"],"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","price":{"mode":"fixed","currency":"USD","amount":"0.001"},"payTo":"0x078293f144c61d1e02b49d4cd3f33c283eb7dc73"},"parameters":[{"name":"lat","in":"query","required":true,"schema":{"type":"number","minimum":33,"maximum":39.5}},{"name":"lng","in":"query","required":true,"schema":{"type":"number","minimum":124,"maximum":132}},{"name":"radius_m","in":"query","required":false,"schema":{"type":"integer","minimum":100,"maximum":5000}},{"name":"category","in":"query","required":false,"schema":{"type":"string","maxLength":40}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":50}}],"responses":{"200":{"description":"Distance-sorted South Korea POI JSON"},"400":{"description":"Invalid input"},"402":{"description":"x402 payment required"}}}},"/south-korea-nearby-restaurants":{"get":{"summary":"Restaurants near me — South Korea","description":"Find nearby restaurants and local food in South Korea by latitude/longitude and radius. Distance-sorted structured JSON for AI agents, travel assistants and location-aware applications.","operationId":"southKoreaNearbyRestaurants","tags":["South Korea","Restaurants","Food","Nearby","Local Places","Geo"],"x-payment-info":{"protocols":["x402"],"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","price":{"mode":"fixed","currency":"USD","amount":"0.005"},"payTo":"0x078293f144c61d1e02b49d4cd3f33c283eb7dc73"},"parameters":[{"name":"lat","in":"query","required":true,"schema":{"type":"number","minimum":33,"maximum":39.5}},{"name":"lng","in":"query","required":true,"schema":{"type":"number","minimum":124,"maximum":132}},{"name":"radius_m","in":"query","required":false,"schema":{"type":"integer","minimum":100,"maximum":5000,"default":1500}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":50,"default":20}}],"responses":{"200":{"description":"Distance-sorted South Korea restaurant JSON"},"400":{"description":"Invalid input"},"402":{"description":"x402 payment required"}}}},"/south-korea-nearby-cafes":{"get":{"summary":"Cafes near me — South Korea","description":"Find nearby cafes and coffee shops in South Korea by latitude/longitude and radius. Distance-sorted structured JSON.","operationId":"cafesNearMeSouthKorea","tags":["South Korea","Cafes","Coffee","Nearby","Local Places","Geo"],"x-payment-info":{"protocols":["x402"],"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","price":{"mode":"fixed","currency":"USD","amount":"0.001"},"payTo":"0x078293f144c61d1e02b49d4cd3f33c283eb7dc73"},"parameters":[{"name":"lat","in":"query","required":true,"schema":{"type":"number","minimum":33,"maximum":39.5}},{"name":"lng","in":"query","required":true,"schema":{"type":"number","minimum":124,"maximum":132}},{"name":"radius_m","in":"query","required":false,"schema":{"type":"integer","minimum":100,"maximum":5000,"default":1500}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":50,"default":20}}],"responses":{"200":{"description":"Distance-sorted South Korea cafe JSON"},"400":{"description":"Invalid input"},"402":{"description":"x402 payment required"}}}},"/south-korea-nearby-attractions":{"get":{"summary":"Attractions near me — South Korea","description":"Find nearby attractions in South Korea: culture, history, nature, play and experience places around coordinates.","operationId":"attractionsNearMeSouthKorea","tags":["South Korea","Attractions","Things To Do","Nearby","Travel","Geo"],"x-payment-info":{"protocols":["x402"],"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","price":{"mode":"fixed","currency":"USD","amount":"0.001"},"payTo":"0x078293f144c61d1e02b49d4cd3f33c283eb7dc73"},"parameters":[{"name":"lat","in":"query","required":true,"schema":{"type":"number","minimum":33,"maximum":39.5}},{"name":"lng","in":"query","required":true,"schema":{"type":"number","minimum":124,"maximum":132}},{"name":"radius_m","in":"query","required":false,"schema":{"type":"integer","minimum":100,"maximum":5000,"default":1500}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":50,"default":20}}],"responses":{"200":{"description":"Distance-sorted South Korea attractions JSON"},"400":{"description":"Invalid input"},"402":{"description":"x402 payment required"}}}},"/south-korea-things-to-do-nearby":{"get":{"summary":"Things to do near me — South Korea","description":"Find things to do nearby in South Korea: attractions, culture, history, nature, play and experience places around coordinates.","operationId":"thingsToDoNearMeSouthKorea","tags":["South Korea","Things To Do","Attractions","Nearby","Travel","Geo"],"x-payment-info":{"protocols":["x402"],"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","price":{"mode":"fixed","currency":"USD","amount":"0.001"},"payTo":"0x078293f144c61d1e02b49d4cd3f33c283eb7dc73"},"parameters":[{"name":"lat","in":"query","required":true,"schema":{"type":"number","minimum":33,"maximum":39.5}},{"name":"lng","in":"query","required":true,"schema":{"type":"number","minimum":124,"maximum":132}},{"name":"radius_m","in":"query","required":false,"schema":{"type":"integer","minimum":100,"maximum":5000,"default":1500}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":50,"default":20}}],"responses":{"200":{"description":"Distance-sorted South Korea things-to-do JSON"},"400":{"description":"Invalid input"},"402":{"description":"x402 payment required"}}}},"/nearby":{"get":{"summary":"Nearby South Korea places and POI by coordinates","operationId":"koreaNearbyPoiGet","x-payment-info":{"protocols":["x402"],"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","price":{"mode":"fixed","currency":"USD","amount":"0.001"},"payTo":"0x078293f144c61d1e02b49d4cd3f33c283eb7dc73"},"parameters":[{"name":"lat","in":"query","required":true,"schema":{"type":"number","minimum":33,"maximum":39.5}},{"name":"lng","in":"query","required":true,"schema":{"type":"number","minimum":124,"maximum":132}},{"name":"radius_m","in":"query","required":false,"schema":{"type":"integer","minimum":100,"maximum":5000}},{"name":"category","in":"query","required":false,"schema":{"type":"string","maxLength":40}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":50}}],"responses":{"200":{"description":"Distance-sorted Korea POI JSON"},"400":{"description":"Invalid input"},"402":{"description":"x402 payment required"}}},"post":{"summary":"Nearby South Korea places and POI by coordinates","operationId":"koreaNearbyPoi","x-payment-info":{"protocols":["x402"],"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","price":{"mode":"fixed","currency":"USD","amount":"0.001"},"payTo":"0x078293f144c61d1e02b49d4cd3f33c283eb7dc73"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["lat","lng"],"properties":{"lat":{"type":"number","minimum":33,"maximum":39.5},"lng":{"type":"number","minimum":124,"maximum":132},"radius_m":{"type":"integer","minimum":100,"maximum":5000},"category":{"type":"string","maxLength":40},"limit":{"type":"integer","minimum":1,"maximum":50}}},"example":{"lat":37.5796,"lng":126.977,"radius_m":1000,"limit":20}}}},"responses":{"200":{"description":"Distance-sorted Korea POI JSON"},"400":{"description":"Invalid input"},"402":{"description":"x402 payment required"}}}},"/decision":{"post":{"summary":"South Korea Failure Intelligence — predict trip failure before departure","description":"Use before departure when an AI travel agent needs to know how a South Korea visit can fail. Resolve a Korean place or address, then return GO/CHECK/HOLD plus GO_WITH_PREP, evidence coverage, source-backed failure modes, severity, rescue actions, onsite-meal constraints, nearby food and attraction fallbacks, navigation handoffs and bookable next actions. This is failure intelligence, not generic recommendation.","operationId":"southKoreaFailureIntelligenceDecision","tags":["South Korea","Failure Intelligence","Pre-Departure","Trip Readiness","GO WITH PREP","GO CHECK HOLD","AI Travel Agent","Nearby Food","Nearby Attractions","Itinerary Risk","Decision Support"],"x-payment-info":{"protocols":["x402"],"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","price":{"mode":"fixed","currency":"USD","amount":"0.01"},"payTo":"0x078293f144c61d1e02b49d4cd3f33c283eb7dc73"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["query"],"properties":{"query":{"type":"string","minLength":2,"maxLength":120,"description":"South Korea place name or address, optionally with city/district context"},"radius_m":{"type":"integer","minimum":300,"maximum":5000},"visit_at":{"type":"string","description":"Optional ISO 8601 visit time; timezone omitted means Asia/Seoul"},"needs":{"type":"array","items":{"type":"string","enum":["car","stroller"]},"description":"Optional traveler constraints"}}},"example":{"query":"블루스퀘어 서울","radius_m":1500}}}},"x-probe-body":{"query":"경복궁 서울","radius_m":1500},"responses":{"200":{"description":"Evidence-backed South Korea travel reality decision bundle","content":{"application/json":{"schema":{},"example":{"ok":true,"service":"SCOPRI_TRAVEL_DECISION_X402_V1","place":{"id":"34d87688-df52-4f32-a01a-619f855ae955","name":"용산공원 부분개방부지 (미군 장교숙소5단지)","region":"서울특별시 용산구","address":"서울특별시 용산구 서빙고로 221","category":"역사"},"reality":{"verdict":"GO","verdict_scope":"NOW_IN_KOREA","reason":"Recent sourced readiness evidence supports the visit and a nearby food fallback exists.","decision_strength":"EVIDENCE_BACKED","evidence_coverage_pct":100,"readiness_source":"서울 공식 관광정보","failure_intelligence":{"version":"SCOPRI_FAILURE_INTELLIGENCE_V1","failure_pressure":"HIGH","departure_mode":"GO_WITH_PREP","source_backed_fact_count":2,"failure_modes":[{"code":"ONSITE_MEAL_LIMITED","severity":"HIGH","why":"Source-backed facility data lists 누리방카페 as the onsite food/beverage facility; a restaurant facility is not listed.","rescue":"식사 목적이면 방문 전 식사하거나 음식·간식을 준비"},{"code":"FOOD_FALLBACK_THIN","severity":"MEDIUM","why":"Nearest quality-eligible food fallback is about 411m away.","rescue":"Keep a nearby food fallback ready before entering the destination."},{"code":"ENTRY_QUEUE_POSSIBLE","severity":"MEDIUM","why":"Published visitor cap is 300 and waiting can occur.","rescue":"Allow waiting time and keep a nearby Plan B ready."}]},"fallback":{"nearby_food_count":5,"nearest_food_distance_m":411,"nearby_sights_count":5,"navigation_provider_count":3}},"quality":{"nearby_policy":"source_confidence>=0.75; suspicious coordinates excluded; Korean district mismatch excluded"},"price_usd":0.01}}}},"400":{"description":"Invalid input"},"402":{"description":"x402 payment required"},"404":{"description":"Place not found"}}}}}}