{"openapi":"3.0.3","info":{"title":"APICK 구글 키워드 검색","version":"1.0.0","description":"특정 키워드의 구글 검색 결과를 페이지당 최대 10건 조회합니다."},"servers":[{"url":"https://apick.app"}],"paths":{"/rest/google_search":{"post":{"summary":"구글 키워드 검색","description":"특정 키워드의 구글 검색 결과를 페이지당 최대 10건 조회합니다.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"서비스별 성공·처리 상태 응답","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"search_result_page":{"type":"string","description":"에이픽 웹 화면의 검색 페이지 경로입니다. 항상 같은 값이며 연동에는 쓰지 않아도 됩니다."},"items":{"type":"array","items":{"type":"object","properties":{"link":{"type":"string","description":"검색 결과 페이지의 주소(http·https)입니다."},"text1":{"type":"string","description":"검색 결과 제목입니다."},"text2":{"type":"string","description":"검색 결과에 표시되는 요약 문장입니다. 없으면 빈 문자열입니다."}}},"description":"검색 결과 목록입니다. 페이지당 최대 10건이며 결과가 없으면 빈 배열입니다."},"success":{"type":"integer","description":"1이면 정상 처리되어 과금된 응답입니다. 실패하면 0입니다."},"error":{"type":"string","description":"실패 사유입니다. 이 필드가 있으면 과금되지 않습니다."}}},"api":{"type":"object","properties":{"success":{"type":"boolean"},"cost":{"type":"integer","description":"차감된 포인트입니다. 실패하면 0입니다."},"ms":{"type":"integer","description":"처리 시간(밀리초)입니다."},"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":"검색할 키워드입니다. 공백으로 여러 단어를 구분하며, 너무 짧거나 흔한 단어만 쓰면 결과가 부정확할 수 있습니다. (string)","example":"apick 주소 검색 API"},"page":{"type":"string","description":"검색 결과 조회 페이지 (기본값 1) 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)","example":"1"}},"required":["keyword"]}}}}}}},"x-code-tables":[{"title":"오류 코드","columns":["data.error","HTTP","대처"],"rows":[["필수 입력값이 없습니다.","400","keyword를 채워 다시 요청합니다."],["외부 검색 처리에 실패했습니다. 잠시 후 다시 시도해 주세요.","424","일시적인 실패입니다. 잠시 뒤 같은 요청을 다시 보냅니다."]]}],"x-service-errors":[],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}