{"openapi":"3.1.0","info":{"title":"InternetTrend API","version":"1.1.0","description":"국내 웹사이트 실측 인터넷 이용 통계(인터넷트렌드, BizSpring Inc.). /v1/try/* 는 키 없이 쓰는 맛보기이며 끝난 월 범위의 값만 응답합니다. 값은 로거 설치 사이트의 표본 집계이므로 기준 기간과 출처를 함께 표기해 주십시오.","termsOfService":"https://internettrend.co.kr/mcp/terms","contact":{"name":"BizSpring Inc.","email":"service@bizspring.co.kr","url":"https://internettrend.co.kr/mcp"}},"servers":[{"url":"https://api.gmp.ai/internettrend"}],"externalDocs":{"url":"https://internettrend.co.kr/llms.txt","description":"AI 에이전트 안내"},"components":{"securitySchemes":{"itk":{"type":"http","scheme":"bearer","description":"기업 시스템 연동 키 itk_…(문의 뒤 발급)"}},"schemas":{"Envelope":{"type":"object","properties":{"ok":{"type":"boolean"},"data":{"type":"object"},"source":{"type":"string"},"error":{"type":"string"},"message":{"type":"string"}}}}},"security":[{"itk":[]}],"paths":{"/v1":{"get":{"operationId":"index","summary":"시작 순서(getting_started)와 항목 목록","security":[],"responses":{"200":{"description":"성공"}}}},"/v1/try":{"get":{"operationId":"try_index","summary":"맛보기 항목 목록과 한도","security":[],"responses":{"200":{"description":"성공"}}}},"/v1/try/reports":{"get":{"operationId":"try_reports","summary":"리포트 목록 · 업종 대분류 · 조회 가능 기간","security":[],"parameters":[{"name":"X-InternetTrend-Agent","in":"header","required":false,"description":"AI 에이전트 · 서비스 이름(밝히시면 맛보기 한도가 늘어납니다)","schema":{"type":"string"}}],"responses":{"200":{"description":"성공","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"409":{"description":"데이터 점검 중 리포트"},"429":{"description":"맛보기 한도 초과"}}}},"/v1/try/distribution":{"get":{"operationId":"try_distribution","summary":"끝난 월 기준 구성비 상위 20개","security":[],"parameters":[{"name":"X-InternetTrend-Agent","in":"header","required":false,"description":"AI 에이전트 · 서비스 이름(밝히시면 맛보기 한도가 늘어납니다)","schema":{"type":"string"}},{"name":"code","in":"query","required":true,"description":"리포트 코드 4자리(예: 2140 AI 플랫폼, 2010 검색엔진)","schema":{"type":"string"}},{"name":"from","in":"query","required":false,"description":"시작 월 YYYY-MM","schema":{"type":"string"}},{"name":"to","in":"query","required":false,"description":"끝 월 YYYY-MM(직전에 끝난 월까지, 최대 12개월)","schema":{"type":"string"}}],"responses":{"200":{"description":"성공","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"409":{"description":"데이터 점검 중 리포트"},"429":{"description":"맛보기 한도 초과"}}}},"/v1/try/time-pattern":{"get":{"operationId":"try_time_pattern","summary":"시간대 · 요일 분포","security":[],"parameters":[{"name":"X-InternetTrend-Agent","in":"header","required":false,"description":"AI 에이전트 · 서비스 이름(밝히시면 맛보기 한도가 늘어납니다)","schema":{"type":"string"}},{"name":"code","in":"query","required":true,"description":"1010 · 1020 · 3010 · 3020","schema":{"type":"string"}},{"name":"from","in":"query","required":false,"description":"시작 월 YYYY-MM","schema":{"type":"string"}},{"name":"to","in":"query","required":false,"description":"끝 월 YYYY-MM(직전에 끝난 월까지, 최대 12개월)","schema":{"type":"string"}}],"responses":{"200":{"description":"성공","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"409":{"description":"데이터 점검 중 리포트"},"429":{"description":"맛보기 한도 초과"}}}},"/v1/try/totals":{"get":{"operationId":"try_totals","summary":"누적 방문 · 주문 수와 월별 합계","security":[],"parameters":[{"name":"X-InternetTrend-Agent","in":"header","required":false,"description":"AI 에이전트 · 서비스 이름(밝히시면 맛보기 한도가 늘어납니다)","schema":{"type":"string"}}],"responses":{"200":{"description":"성공","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"409":{"description":"데이터 점검 중 리포트"},"429":{"description":"맛보기 한도 초과"}}}},"/v1/try/insights":{"get":{"operationId":"try_insights","summary":"AI 인사이트","security":[],"parameters":[{"name":"X-InternetTrend-Agent","in":"header","required":false,"description":"AI 에이전트 · 서비스 이름(밝히시면 맛보기 한도가 늘어납니다)","schema":{"type":"string"}},{"name":"month","in":"query","required":false,"description":"YYYY-MM","schema":{"type":"string"}}],"responses":{"200":{"description":"성공","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"409":{"description":"데이터 점검 중 리포트"},"429":{"description":"맛보기 한도 초과"}}}},"/v1/try/industry":{"get":{"operationId":"try_industry","summary":"업종 시장 기준선","security":[],"parameters":[{"name":"X-InternetTrend-Agent","in":"header","required":false,"description":"AI 에이전트 · 서비스 이름(밝히시면 맛보기 한도가 늘어납니다)","schema":{"type":"string"}},{"name":"cat","in":"query","required":false,"description":"업종 대분류 번호","schema":{"type":"string"}},{"name":"nunchi_industry","in":"query","required":false,"description":"눈치 업종 값","schema":{"type":"string"}},{"name":"from","in":"query","required":false,"description":"시작 월 YYYY-MM","schema":{"type":"string"}},{"name":"to","in":"query","required":false,"description":"끝 월 YYYY-MM(직전에 끝난 월까지, 최대 12개월)","schema":{"type":"string"}}],"responses":{"200":{"description":"성공","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"409":{"description":"데이터 점검 중 리포트"},"429":{"description":"맛보기 한도 초과"}}}},"/v1/try/status":{"get":{"operationId":"try_status","summary":"리포트별 데이터 상태","security":[],"parameters":[{"name":"X-InternetTrend-Agent","in":"header","required":false,"description":"AI 에이전트 · 서비스 이름(밝히시면 맛보기 한도가 늘어납니다)","schema":{"type":"string"}},{"name":"code","in":"query","required":false,"description":"리포트 코드 4자리","schema":{"type":"string"}}],"responses":{"200":{"description":"성공","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"409":{"description":"데이터 점검 중 리포트"},"429":{"description":"맛보기 한도 초과"}}}},"/v1/try/skills":{"get":{"operationId":"try_skills","summary":"해석 절차서 목록 · 본문","security":[],"parameters":[{"name":"X-InternetTrend-Agent","in":"header","required":false,"description":"AI 에이전트 · 서비스 이름(밝히시면 맛보기 한도가 늘어납니다)","schema":{"type":"string"}},{"name":"id","in":"query","required":false,"description":"절차서 id","schema":{"type":"string"}}],"responses":{"200":{"description":"성공","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"409":{"description":"데이터 점검 중 리포트"},"429":{"description":"맛보기 한도 초과"}}}},"/v1/try/signup":{"get":{"operationId":"try_signup","summary":"무료 회원 가입 주소와 MCP 연결 방법","security":[],"parameters":[{"name":"X-InternetTrend-Agent","in":"header","required":false,"description":"AI 에이전트 · 서비스 이름(밝히시면 맛보기 한도가 늘어납니다)","schema":{"type":"string"}}],"responses":{"200":{"description":"성공","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"409":{"description":"데이터 점검 중 리포트"},"429":{"description":"맛보기 한도 초과"}}}},"/v1/try/plans":{"get":{"operationId":"try_plans","summary":"이용 등급별 기능 · 한도","security":[],"parameters":[{"name":"X-InternetTrend-Agent","in":"header","required":false,"description":"AI 에이전트 · 서비스 이름(밝히시면 맛보기 한도가 늘어납니다)","schema":{"type":"string"}}],"responses":{"200":{"description":"성공","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"409":{"description":"데이터 점검 중 리포트"},"429":{"description":"맛보기 한도 초과"}}}},"/v1/try/enterprise-contact":{"post":{"operationId":"try_enterprise_contact","summary":"기업 이용 문의 접수(2단 확인: confirm_token 없이 보내면 접수할 내용만 돌려줍니다)","security":[],"parameters":[{"name":"X-InternetTrend-Agent","in":"header","required":false,"description":"AI 에이전트 · 서비스 이름(밝히시면 맛보기 한도가 늘어납니다)","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["org","email","purpose"],"properties":{"org":{"type":"string"},"email":{"type":"string"},"contact_name":{"type":"string"},"purpose":{"type":"string"},"kind":{"type":"string","enum":["enterprise","api_key","bulk"]},"volume":{"type":"string"},"privacy_consent":{"type":"boolean"},"confirm_token":{"type":"string"}}}}}},"responses":{"200":{"description":"성공","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"409":{"description":"데이터 점검 중 리포트"},"429":{"description":"맛보기 한도 초과"}}}},"/v1/meta":{"get":{"operationId":"keyed_meta","summary":"리포트 목록(키)","parameters":[],"responses":{"200":{"description":"성공"},"401":{"description":"키 필요"}}}},"/v1/distribution":{"get":{"operationId":"keyed_distribution","summary":"기간 구성비(키)","parameters":[{"name":"code","in":"query","required":true,"description":"리포트 코드","schema":{"type":"string"}},{"name":"from","in":"query","required":false,"description":"YYYY-MM-DD","schema":{"type":"string"}},{"name":"to","in":"query","required":false,"description":"YYYY-MM-DD","schema":{"type":"string"}},{"name":"cat","in":"query","required":false,"description":"업종 대분류","schema":{"type":"string"}}],"responses":{"200":{"description":"성공"},"401":{"description":"키 필요"}}}},"/v1/series":{"get":{"operationId":"keyed_series","summary":"항목별 시계열(키)","parameters":[{"name":"code","in":"query","required":true,"description":"리포트 코드","schema":{"type":"string"}},{"name":"from","in":"query","required":false,"description":"YYYY-MM-DD","schema":{"type":"string"}},{"name":"to","in":"query","required":false,"description":"YYYY-MM-DD","schema":{"type":"string"}},{"name":"step","in":"query","required":false,"description":"day|week|month","schema":{"type":"string"}},{"name":"cat","in":"query","required":false,"description":"업종 대분류","schema":{"type":"string"}}],"responses":{"200":{"description":"성공"},"401":{"description":"키 필요"}}}},"/v1/me":{"get":{"operationId":"keyed_me","summary":"키 정보 · 한도 · 사용량(키)","parameters":[],"responses":{"200":{"description":"성공"},"401":{"description":"키 필요"}}}}}}