{"openapi":"3.0.3","info":{"title":"APICK 구글 뉴스 검색","version":"1.0.0","description":"키워드의 구글 뉴스 검색 결과(제목·언론사·게시 시각·링크)를 조회합니다."},"servers":[{"url":"https://apick.app"}],"paths":{"/rest/google_news_search":{"post":{"summary":"구글 뉴스 검색","description":"키워드의 구글 뉴스 검색 결과(제목·언론사·게시 시각·링크)를 조회합니다.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"서비스별 성공·처리 상태 응답","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"keyword":{"type":"string","description":"검색에 쓴 검색어입니다(앞뒤 공백 제거)."},"page":{"type":"integer","description":"실제로 조회한 페이지 번호입니다."},"count":{"type":"integer","description":"items의 개수입니다."},"items":{"type":"array","items":{"type":"object","properties":{"rank":{"type":"integer","description":"이 페이지 안에서의 순서(1부터)입니다."},"title":{"type":"string","description":"기사 제목입니다(최대 300자)."},"link":{"type":"string","description":"기사 주소입니다."},"source":{"type":"string","description":"언론사 이름입니다."},"published":{"type":"string","description":"게시 시각 표기입니다. 1일 전, 3시간 전, 2026. 10. 5.처럼 화면 표기 그대로이므로 날짜로 쓰려면 직접 변환하세요."},"description":{"type":"string","description":"기사 요약입니다. 없으면 빈 문자열입니다."},"image_url":{"type":"string","description":"대표 이미지 주소입니다. 없으면 빈 문자열입니다."}}},"description":"기사 목록입니다. 결과가 없으면 빈 배열입니다."},"success":{"type":"integer","description":"1이면 정상 처리되어 과금된 응답입니다."},"error":{"type":"string","description":"실패 사유입니다. 이 필드가 있으면 과금되지 않습니다."}}},"api":{"type":"object","properties":{"success":{"type":"boolean"},"cost":{"type":"integer","description":"차감된 포인트입니다. 실패하면 0입니다."},"ms":{"type":"integer"},"pl_id":{"type":"integer","description":"결제 기록 번호입니다."}}}}}}}},"default":{"description":"HTTP 상태 및 서비스 오류코드 확인","content":{"application/json":{"schema":{"type":"object"}}}}},"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"keyword":{"type":"string","description":"검색할 키워드입니다. 1~200자까지 보낼 수 있으며, 여러 단어는 공백으로 구분합니다. 특수문자는 검색 결과에 영향을 줄 수 있습니다. (string)","example":"반도체 수출"},"page":{"type":"string","description":"결과 페이지 1~10 (기본값 1) 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)","example":"1"}},"required":["keyword"]}}}}}}},"x-code-tables":[{"title":"오류 코드","columns":["data.error","HTTP","대처"],"rows":[["입력 항목이 잘못됐습니다. keyword(검색어, 1~200자)를 입력해 주세요.","400","keyword가 비었거나 200자를 넘었습니다. 고쳐서 다시 요청합니다."],["처리 시간 초과로 실패했습니다. 잠시 후 다시 시도해 주세요.","408","잠시 뒤 같은 요청을 다시 보냅니다."],["외부 검색 처리에 실패했습니다. 잠시 후 다시 시도해 주세요.","424","일시적인 실패입니다. 잠시 뒤 다시 요청합니다."]]}],"x-service-errors":[],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}