{"openapi":"3.1.0","info":{"title":"눈치(nunchi.biz) API","version":"0.62.0","description":"경쟁사 첫 화면 · 판촉 · 메뉴 · 새 글 · 카카오톡 채널 변화와 정기 브리핑을 조회하고 지켜보기 설정을 바꾸는 API입니다. AI 에이전트는 메일 인증 코드로 로그인한 뒤 /v1/onboard 로 한 번에 시작하거나 /v1/keys 로 키를 받아 씁니다. Freemium은 읽기 전용 · 하루 3회, Pro는 읽기 · 쓰기. 결제는 사용자가 결제 페이지에서 직접 합니다. 응답은 합니다체 문장(message)과 코드(error)를 함께 돌려줍니다.","contact":{"name":"BizSpring Inc.","url":"https://nunchi.biz/contact.html","email":"sales@bizspring.co.kr"},"termsOfService":"https://nunchi.biz/terms.html"},"externalDocs":{"description":"AI 에이전트 안내(llms.txt)","url":"https://nunchi.biz/llms.txt"},"servers":[{"url":"https://api.gmp.ai/nunchi"}],"tags":[{"name":"start","description":"가입 없이 확인 · 한 번에 시작하기"},{"name":"keys","description":"사용자 API 키"},{"name":"account"},{"name":"sites"},{"name":"services","description":"부가 서비스"}],"components":{"securitySchemes":{"apiKey":{"type":"http","scheme":"bearer","description":"nkey_… (POST /v1/keys 로 발급)"},"loginToken":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"눈치 로그인 access_token: POST https://nunchi.biz/api/login-code (action send → verify)"}}},"paths":{"/v1/try":{"get":{"summary":"가입 없이 경쟁사 첫 화면 비교","description":"키 없음 · 같은 IP 하루 3회 · 저장하지 않음","tags":["start"],"responses":{"200":{"description":"성공","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"키 · 로그인이 필요합니다"},"429":{"description":"호출 한도"}},"security":[],"parameters":[{"name":"site","in":"query","required":true,"description":"내 사이트 주소","schema":{"type":"string"}},{"name":"rival","in":"query","required":true,"description":"경쟁사 첫 화면 주소","schema":{"type":"string"}},{"name":"rival2","in":"query","required":false,"description":"두 번째 경쟁사(선택)","schema":{"type":"string"}}]},"post":{"summary":"가입 없이 경쟁사 첫 화면 비교","description":"본문 {site, rivals:[…두 곳까지]}","tags":["start"],"responses":{"200":{"description":"성공","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"키 · 로그인이 필요합니다"},"429":{"description":"호출 한도"}},"security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/v1/onboard":{"post":{"summary":"한 번 승인으로 시작하기(2단 확인)","description":"Authorization: Bearer 눈치 로그인 access_token. 본문 {apex, brand, rivals:[{name,url}], keywords?, cadence?, key?:{name, write?}, first_brief?:true, privacy_consent?, confirm_token?}. 첫 호출은 진행할 내용과 confirm_token, 두 번째 호출은 사이트 · 경쟁사 등록, API 키 발급(원문 한 번), 첫 브리핑 시작.","tags":["start"],"responses":{"200":{"description":"성공","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"키 · 로그인이 필요합니다"},"429":{"description":"호출 한도"}},"security":[{"loginToken":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/v1/keys":{"post":{"summary":"내 API 키 발급","description":"Authorization: Bearer 로그인 access_token. 본문 {name, write?, expires_days?, sites?}","tags":["keys"],"responses":{"200":{"description":"성공","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"키 · 로그인이 필요합니다"},"429":{"description":"호출 한도"}},"security":[{"loginToken":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}}},"get":{"summary":"내 API 키 목록","description":"","tags":["keys"],"responses":{"200":{"description":"성공","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"키 · 로그인이 필요합니다"},"429":{"description":"호출 한도"}},"security":[{"loginToken":[]}]}},"/v1/keys/{id}":{"delete":{"summary":"내 API 키 폐기","description":"","tags":["keys"],"responses":{"200":{"description":"성공","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"키 · 로그인이 필요합니다"},"429":{"description":"호출 한도"}},"security":[{"loginToken":[]}],"parameters":[{"name":"id","in":"path","required":true,"description":"","schema":{"type":"string"}}]}},"/v1/me":{"get":{"summary":"계정 · 요금제 · 사이트 · 이 키의 권한","description":"","tags":["account"],"responses":{"200":{"description":"성공","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"키 · 로그인이 필요합니다"},"429":{"description":"호출 한도"}},"security":[{"apiKey":[]}]}},"/v1/payment-link":{"post":{"summary":"결제 링크 만들기(2단 확인)","description":"본문 {plan: pro_m|pro_y|svc, product?, cond?, confirm_token?}. 결제는 사용자가 payment_url에서 직접 합니다.","tags":["account"],"responses":{"200":{"description":"성공","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"키 · 로그인이 필요합니다"},"429":{"description":"호출 한도"}},"security":[{"apiKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/v1/sites":{"get":{"summary":"지켜보는 사이트 목록","description":"","tags":["sites"],"responses":{"200":{"description":"성공","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"키 · 로그인이 필요합니다"},"429":{"description":"호출 한도"}},"security":[{"apiKey":[]}],"parameters":[{"name":"group","in":"query","required":false,"description":"묶음 이름","schema":{"type":"string"}}]},"post":{"summary":"사이트 등록(2단 확인)","description":"본문 {apex, brand, rivals, keywords?, privacy_consent?, confirm_token?, first_brief?}","tags":["sites"],"responses":{"200":{"description":"성공","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"키 · 로그인이 필요합니다"},"429":{"description":"호출 한도"}},"security":[{"apiKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/v1/sites/{apex}":{"get":{"summary":"사이트 지켜보기 설정","description":"","tags":["sites"],"responses":{"200":{"description":"성공","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"키 · 로그인이 필요합니다"},"429":{"description":"호출 한도"}},"security":[{"apiKey":[]}],"parameters":[{"name":"apex","in":"path","required":true,"description":"사이트 대표 도메인(GET /v1/me 의 sites)","schema":{"type":"string"}}]},"patch":{"summary":"지켜보기 설정 바꾸기","description":"본문 {themes, cadence, format, paused, keywords, rivals, …}","tags":["sites"],"responses":{"200":{"description":"성공","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"키 · 로그인이 필요합니다"},"429":{"description":"호출 한도"}},"security":[{"apiKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}},"parameters":[{"name":"apex","in":"path","required":true,"description":"사이트 대표 도메인(GET /v1/me 의 sites)","schema":{"type":"string"}}]}},"/v1/sites/{apex}/brief":{"get":{"summary":"마지막 브리핑","description":"","tags":["sites"],"responses":{"200":{"description":"성공","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"키 · 로그인이 필요합니다"},"429":{"description":"호출 한도"}},"security":[{"apiKey":[]}],"parameters":[{"name":"apex","in":"path","required":true,"description":"사이트 대표 도메인(GET /v1/me 의 sites)","schema":{"type":"string"}},{"name":"view","in":"query","required":false,"description":"summary | detail","schema":{"type":"string"}}]},"post":{"summary":"브리핑 지금 받기(Pro)","description":"본문 {\"confirm\": true}","tags":["sites"],"responses":{"200":{"description":"성공","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"키 · 로그인이 필요합니다"},"429":{"description":"호출 한도"}},"security":[{"apiKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}},"parameters":[{"name":"apex","in":"path","required":true,"description":"사이트 대표 도메인(GET /v1/me 의 sites)","schema":{"type":"string"}}]}},"/v1/sites/{apex}/rival-activity":{"get":{"summary":"경쟁사 움직임","description":"","tags":["sites"],"responses":{"200":{"description":"성공","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"키 · 로그인이 필요합니다"},"429":{"description":"호출 한도"}},"security":[{"apiKey":[]}],"parameters":[{"name":"apex","in":"path","required":true,"description":"사이트 대표 도메인(GET /v1/me 의 sites)","schema":{"type":"string"}},{"name":"rival","in":"query","required":false,"description":"","schema":{"type":"string"}},{"name":"kind","in":"query","required":false,"description":"promo|content|menu|title|kakao","schema":{"type":"string"}},{"name":"days","in":"query","required":false,"description":"1 ~ 90","schema":{"type":"string"}}]}},"/v1/sites/{apex}/results":{"get":{"summary":"저장된 회차 목록","description":"","tags":["sites"],"responses":{"200":{"description":"성공","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"키 · 로그인이 필요합니다"},"429":{"description":"호출 한도"}},"security":[{"apiKey":[]}],"parameters":[{"name":"apex","in":"path","required":true,"description":"사이트 대표 도메인(GET /v1/me 의 sites)","schema":{"type":"string"}}]}},"/v1/sites/{apex}/results/{id}":{"get":{"summary":"저장된 회차 요약","description":"","tags":["sites"],"responses":{"200":{"description":"성공","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"키 · 로그인이 필요합니다"},"429":{"description":"호출 한도"}},"security":[{"apiKey":[]}],"parameters":[{"name":"apex","in":"path","required":true,"description":"사이트 대표 도메인(GET /v1/me 의 sites)","schema":{"type":"string"}},{"name":"id","in":"path","required":true,"description":"회차 번호 또는 latest","schema":{"type":"string"}}]}},"/v1/sites/{apex}/hints":{"get":{"summary":"확인하시면 좋은 점","description":"","tags":["sites"],"responses":{"200":{"description":"성공","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"키 · 로그인이 필요합니다"},"429":{"description":"호출 한도"}},"security":[{"apiKey":[]}],"parameters":[{"name":"apex","in":"path","required":true,"description":"사이트 대표 도메인(GET /v1/me 의 sites)","schema":{"type":"string"}}]}},"/v1/sites/{apex}/brief-status":{"get":{"summary":"브리핑 진행 상태","description":"","tags":["sites"],"responses":{"200":{"description":"성공","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"키 · 로그인이 필요합니다"},"429":{"description":"호출 한도"}},"security":[{"apiKey":[]}],"parameters":[{"name":"apex","in":"path","required":true,"description":"사이트 대표 도메인(GET /v1/me 의 sites)","schema":{"type":"string"}}]}},"/v1/sites/{apex}/usage":{"get":{"summary":"이번 달 남은 확인 횟수","description":"","tags":["sites"],"responses":{"200":{"description":"성공","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"키 · 로그인이 필요합니다"},"429":{"description":"호출 한도"}},"security":[{"apiKey":[]}],"parameters":[{"name":"apex","in":"path","required":true,"description":"사이트 대표 도메인(GET /v1/me 의 sites)","schema":{"type":"string"}}]}},"/v1/services":{"get":{"summary":"부가 서비스 상품 목록","description":"","tags":["services"],"responses":{"200":{"description":"성공","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"키 · 로그인이 필요합니다"},"429":{"description":"호출 한도"}},"security":[{"apiKey":[]}]}},"/v1/services/passes":{"get":{"summary":"내 부가 서비스 이용권","description":"","tags":["services"],"responses":{"200":{"description":"성공","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"키 · 로그인이 필요합니다"},"429":{"description":"호출 한도"}},"security":[{"apiKey":[]}]}},"/v1/services/passes/{id}":{"get":{"summary":"이용권 결과 보고서","description":"","tags":["services"],"responses":{"200":{"description":"성공","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"키 · 로그인이 필요합니다"},"429":{"description":"호출 한도"}},"security":[{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"description":"","schema":{"type":"string"}},{"name":"n","in":"query","required":false,"description":"회차","schema":{"type":"string"}}]},"patch":{"summary":"부가 서비스 설정 바꾸기","description":"","tags":["services"],"responses":{"200":{"description":"성공","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"키 · 로그인이 필요합니다"},"429":{"description":"호출 한도"}},"security":[{"apiKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}},"parameters":[{"name":"id","in":"path","required":true,"description":"","schema":{"type":"string"}}]}},"/v1/services/passes/{id}/run":{"post":{"summary":"다시 받기 · 지금 받아 보기(2단 확인)","description":"","tags":["services"],"responses":{"200":{"description":"성공","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"키 · 로그인이 필요합니다"},"429":{"description":"호출 한도"}},"security":[{"apiKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}},"parameters":[{"name":"id","in":"path","required":true,"description":"","schema":{"type":"string"}}]}},"/v1/tools/{name}":{"post":{"summary":"MCP 도구와 같은 이름 · 인자로 부르기","description":"","tags":["account"],"responses":{"200":{"description":"성공","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"키 · 로그인이 필요합니다"},"429":{"description":"호출 한도"}},"security":[{"apiKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}},"parameters":[{"name":"name","in":"path","required":true,"description":"","schema":{"type":"string"}}]}}}}