# 구글 키워드 검색 특정 키워드의 구글 검색 결과를 조회합니다. 인증: Authorization: Bearer $APICK_API_KEY 본문 있는 REST 요청: multipart/form-data. GET 본문 및 MCP JSON-RPC 규격은 해당 명세를 따릅니다. 인증키는 서버에 보관하세요. 모든 예제는 정적 자료입니다. ## POST /rest/google_search 응답 필드 - `data` (object): 조회 데이터 - `data.search_result_page` (string): 검색 결과 링크 - `data.items` (array): 검색 결과 목록페이지 당 20개 - `data.items[].link` (string): 페이지 링크 - `data.items[].text1` (string): 제목 - `data.items[].text2` (string): 내용 - `data.success` (integer): 과금 여부0: 실패1: 성공3: 실패(timeout) - `api` (object): API 호출 공통 데이터 - `api.success` (boolean): API 서버 정상 응답 여부 - `api.cost` (integer): API 호출 요금 - `api.pl_id` (integer): API 결제 로그 ID - `api.ms` (integer): API 응답 시간 ## API 요청: POST /rest/google_search ### 입력 - `keyword` (string, 필수): 검색할 키워드 - `page` (string, 선택): 검색 결과 조회 페이지 (기본값 1) ### 응답 명세 ```json { "type": "object", "properties": { "data": { "type": "object", "properties": { "search_result_page": { "type": "string", "description": "검색 결과 링크" }, "items": { "type": "array", "items": { "type": "object", "properties": { "link": { "type": "string", "description": "페이지 링크" }, "text1": { "type": "string", "description": "제목" }, "text2": { "type": "string", "description": "내용" } } }, "description": "검색 결과 목록페이지 당 20개" }, "success": { "type": "integer", "description": "과금 여부0: 실패1: 성공3: 실패(timeout)" } }, "description": "조회 데이터" }, "api": { "type": "object", "properties": { "success": { "type": "boolean", "description": "API 서버 정상 응답 여부" }, "cost": { "type": "integer", "description": "API 호출 요금" }, "pl_id": { "type": "integer", "description": "API 결제 로그 ID" }, "ms": { "type": "integer", "description": "API 응답 시간" } }, "description": "API 호출 공통 데이터" } } } ``` ### 정적 응답 예시 ```json { "data": { "search_result_page": "/search_google_page", "items": [ { "link": "https://www.google.com/url?esrc=s&q=&rct=j&sa=U&url=https://namu.wiki/w/%25ED%2599%258D%25EA%25B8%25B8%25EB%258F%2599&ved=2ahUKEwjH1uqtzMWDAxVNafUHHd2_BbUQFnoECAUQAg&usg=AOvVaw1Xpe2KgbkcTdPSfKwDLdAo", "text1": "홍길동 - 나무위키", "text2": "2023. 12. 20. · 소설 '홍길동전'의 주인공으로 초능력을 부리는 인물로 코리안 슈퍼히어로의 시초이자 대표 격이다. 승상 홍문과 몸종 춘섬 사이에서 태어난 얼자이다.[1] ...홍길동전 · 홍길동(조선) · 쾌도 홍길동 · 돌아온 영웅 홍길동" }, { "link": "https://www.google.com/url?esrc=s&q=&rct=j&sa=U&url=https://ko.wikipedia.org/wiki/%25ED%2599%258D%25EA%25B8%25B8%25EB%258F%2599_(%25EC%25A1%25B0%25EC%2584%25A0)&ved=2ahUKEwjH1uqtzMWDAxVNafUHHd2_BbUQFnoECAYQAg&usg=AOvVaw37p3RTiw1Rbxt8LTrbRfqB", "text1": "홍길동 (조선) - 위키백과, 우리 모두의 백과사전", "text2": "홍길동(洪吉同)은 1443년경 전라도 장성현 아차곡에서 경성절제사(鏡城節制使) 홍상직(洪尙直)과 관기 옥영향(玉英香) 사이에서 태어난 얼자(孼子)로 알려지고 있다." }, { "link": "https://www.google.com/url?esrc=s&q=&rct=j&sa=U&url=https://namu.wiki/w/%25ED%2599%258D%25EA%25B8%25B8%25EB%258F%2599(%25EC%25A1%25B0%25EC%2584%25A0)&ved=2ahUKEwjH1uqtzMWDAxVNafUHHd2_BbUQFnoECAcQAg&usg=AOvVaw0C1OXH1ljWp-jtfrK624Y1", "text1": "홍길동(조선) - 나무위키", "text2": "2023. 12. 14. · 조선 시대에 실존했던 유명한 전국구 도적. 소설 홍길동전의 주인공 홍길동의 모티브가 된 인물로 조선왕조실록의 연산군편에 기록되어 있다. 정승과 판서 ..." }, { "link": "https://www.google.comhttp://www.google.com/url?esrc=s&q=&rct=j&sa=U&url=http://newsteacher.chosun.com/site/data/html_dir/2021/07/28/2021072802464.html&ved=2ahUKEwjH1uqtzMWDAxVNafUHHd2_BbUQFnoECAEQAg&usg=AOvVaw1XtHo3XGnOffxO8-LLln2V", "text1": "[뉴스 속의 한국사] 홍길동 실존 인물은 '노인 도적'… 소설 속 '청년 의적 ...", "text2": "2021. 7. 29. · 홍길동은 연산군(재위 1494~1506) 시절 충청도 일대를 중심으로 활동한 도적 떼의 우두머리였어요. 명종 때 임꺽정, 숙종 때 장길산과 함께 '조선 왕조 3 ..." }, { "link": "https://www.google.com/url?esrc=s&q=&rct=j&sa=U&url=https://ko.wikipedia.org/wiki/%25ED%2599%258D%25EA%25B8%25B8%25EB%258F%2599%25EC%25A0%2584&ved=2ahUKEwjH1uqtzMWDAxVNafUHHd2_BbUQFnoECAMQAg&usg=AOvVaw0PRS1rK_JEvU1kWYD8pmH2", "text1": "홍길동전 - 위키백과, 우리 모두의 백과사전", "text2": "《홍길동전》(洪吉童傳)은 19세기에 널리 읽힌 한글 고전소설이다. 오랫동안 허균이 지은 소설로 알려졌으며 다수설이나, 이에 대해서는 찬반 논쟁이 있다." }, { "link": "https://www.google.com/url?esrc=s&q=&rct=j&sa=U&url=https://www.youtube.com/watch%3Fv%3DSOY8XNenyVw&ved=2ahUKEwjH1uqtzMWDAxVNafUHHd2_BbUQtwJ6BAgLEAE&usg=AOvVaw24tUumInxDsQNTOVwFYhkP", "text1": "아버지를 아버지라 부르..다? 우리가 몰랐던 홍길동전 이야기! 그가 ...", "text2": "3일 전 · 본격 우리 역사 스토리텔링쇼 #벌거벗은한국사 00:00 의적 홍길동의 탄생 01:18 청룡의 기운을 타고난 아이 06:28 얼자 신 ...\n기간: 24:12\n게시: 3일 전" }, { "link": "https://www.google.com/url?esrc=s&q=&rct=j&sa=U&url=https://www.youtube.com/watch%3Fv%3DL6E1Pgs7rxc&ved=2ahUKEwjH1uqtzMWDAxVNafUHHd2_BbUQtwJ6BAgKEAE&usg=AOvVaw3yMg6swEP7EbU6Feiqecop", "text1": "얼자에서 왕의 자리까지 오른 의적 홍길동! 사실은 흉악한 도적이었다 ...", "text2": "3일 전 · 본격 우리 역사 스토리텔링쇼 #벌거벗은한국사 00:00 수배령이 떨어진 홍길동 02:33 사람들을 놀라게 만든 홍길동의 도술 ...\n기간: 23:17\n게시: 3일 전" }, { "link": "https://www.google.com/url?esrc=s&q=&rct=j&sa=U&url=https://www.youtube.com/watch%3Fv%3DwcXignso3pk&ved=2ahUKEwjH1uqtzMWDAxVNafUHHd2_BbUQtwJ6BAgJEAE&usg=AOvVaw0w19qRocxGaAHRieurmuhS", "text1": "홍길동(1967) 복원본 / A Story of Hong Gil-dong ( Hong ... - YouTube", "text2": "2022. 6. 14. · 홍길동 (신동헌, 1967) 복원기 https://www.kmdb.or.kr/story/237/6627 홍길동 발견 경위와 역사적 의 ...\n기간: 1:06:48\n게시: 2022. 6. 14." }, { "link": "https://www.google.com/url?esrc=s&q=&rct=j&sa=U&url=https://encykorea.aks.ac.kr/Article/E0063994&ved=2ahUKEwjH1uqtzMWDAxVNafUHHd2_BbUQFnoECAQQAg&usg=AOvVaw1vl5KnVGT5BCMxZKs8Nypk", "text1": "홍길동전(洪吉童傳) - 한국민족문화대백과사전", "text2": "조선시대 왕비의 예복. ... 커다란 돌이나 원목(原木) 등 무거운 짐을 운반할 때 사용하는 수레. ... 목재면을 매끈하게 하거나 표면을 필요에 따라 여러 가지 모양으로 깎아 ..." }, { "link": "https://www.google.comhttp://www.google.com/url?esrc=s&q=&rct=j&sa=U&url=http://www.gjdream.com/news/articleView.html%3Fidxno%3D465308&ved=2ahUKEwjH1uqtzMWDAxVNafUHHd2_BbUQFnoECAIQAg&usg=AOvVaw35rakkLn_FxhXM1wMum5ZA", "text1": "[역사 속 전라도]홍길동, 장성서 태어난 실존인물 < 역사 속 ... - 광주드림", "text2": "2015. 5. 14. · 홍길동은 조선 연산군 때 아버지 경성절제사 홍상직과 어머니 관기 옥영향 사이에서 전라도 장성현 아차곡에서 서자로 태어난 도적이다. 귀동은 길동의 ..." } ], "success": 1 }, "api": { "success": true, "cost": 5, "pl_id": 1595645, "ms": 1553 } } ``` ### curl ```curl curl --fail-with-body --request POST 'https://apick.app/rest/google_search' \ --header "Authorization: Bearer $APICK_API_KEY" \ --form-string 'keyword=홍길동' \ --form-string 'page=1' ``` ### Node.js (서버 ESM) ```javascript const form = new FormData(); form.append("keyword", "홍길동"); form.append("page", "1"); const response = await fetch("https://apick.app/rest/google_search", { method: "POST", headers: { Authorization: "Bearer " + process.env.APICK_API_KEY }, body: form, signal: AbortSignal.timeout(120_000), }); if (!response.ok) throw new Error(`HTTP ${response.status}: ${await response.text()}`); const result = await response.json(); console.log(result); ``` ### python ```python import os import requests parts = [ ("keyword", (None, "홍길동")), ("page", (None, "1")), ] response = requests.request("POST", "https://apick.app/rest/google_search", headers={"Authorization": "Bearer " + os.environ["APICK_API_KEY"]}, files=parts, timeout=(10, 120)) response.raise_for_status() result = response.json() print(result) ``` ### php ```php '홍길동', 'page' => '1', ]; $curl = curl_init('https://apick.app/rest/google_search'); curl_setopt_array($curl, [ CURLOPT_CUSTOMREQUEST => 'POST', CURLOPT_HTTPHEADER => $headers, CURLOPT_POSTFIELDS => $form, CURLOPT_RETURNTRANSFER => true, CURLOPT_CONNECTTIMEOUT => 10, CURLOPT_TIMEOUT => 120, ]); $body = curl_exec($curl); if ($body === false) { throw new RuntimeException(curl_error($curl)); } $status = curl_getinfo($curl, CURLINFO_HTTP_CODE); curl_close($curl); if ($status >= 400) { throw new RuntimeException($body); } $result = json_decode($body, true, 512, JSON_THROW_ON_ERROR); print_r($result); ``` ## 코드·오류 ## 상세 기능·요금 Method URL POST https://apick.app/rest/google_search 페이지를 입력하지 않으면 자동으로 1페이지 검색 결과를 조회합니다. 페이지 당 최대 20개의 검색 결과를 표시합니다. ## 상세 요청 Header 이름 필수 설명 Authorization O Bearer 인증키 ## 상세 응답 Body 이름 타입 설명 data Object 조회 데이터 search_result_page String 검색 결과 링크 items Array 검색 결과 목록페이지 당 20개 {} Object 검색된 정보 link String 페이지 링크 text1 String 제목 text2 String 내용 success Integer 과금 여부0: 실패1: 성공3: 실패(timeout) api Object API 호출 공통 데이터 success Boolean API 서버 정상 응답 여부 cost Integer API 호출 요금 ms Integer API 응답 시간 pl_id Integer API 결제 로그 ID ## 상세 예제 요청 예시 form-data 전체 예제 보기 응답 예시 { "data": { "search_result_page": "/search_google_page", "items": [ { "link": "https://www.google.com/url?esrc=s&q=&rct=j&sa=U&url=https://namu.wiki/w/%25ED%2599%258D%25EA%25B8%25B8%25EB%258F%2599&ved=2ahUKEwjH1uqtzMWDAxVNafUHHd2_BbUQFnoECAUQAg&usg=AOvVaw1Xpe2KgbkcTdPSfKwDLdAo", "text1": "홍길동 - 나무위키", "text2": "2023. 12. 20. · 소설 '홍길동전'의 주인공으로 초능력을 부리는 인물로 코리안 슈퍼히어로의 시초이자 대표 격이다. 승상 홍문과 몸종 춘섬 사이에서 태어난 얼자이다.[1] ...홍길동전 · 홍길동(조선) · 쾌도 홍길동 · 돌아온 영웅 홍길동" }, { "link": "https://www.google.com/url?esrc=s&q=&rct=j&sa=U&url=https://ko.wikipedia.org/wiki/%25ED%2599%258D%25EA%25B8%25B8%25EB%258F%2599_(%25EC%25A1%25B0%25EC%2584%25A0)&ved=2ahUKEwjH1uqtzMWDAxVNafUHHd2_BbUQFnoECAYQAg&usg=AOvVaw37p3RTiw1Rbxt8LTrbRfqB", "text1": "홍길동 (조선) - 위키백과, 우리 모두의 백과사전", "text2": "홍길동(洪吉同)은 1443년경 전라도 장성현 아차곡에서 경성절제사(鏡城節制使) 홍상직(洪尙直)과 관기 옥영향(玉英香) 사이에서 태어난 얼자(孼子)로 알려지고 있다." }, { "link": "https://www.google.com/url?esrc=s&q=&rct=j&sa=U&url=https://namu.wiki/w/%25ED%2599%258D%25EA%25B8%25B8%25EB%258F%2599(%25EC%25A1%25B0%25EC%2584%25A0)&ved=2ahUKEwjH1uqtzMWDAxVNafUHHd2_BbUQFnoECAcQAg&usg=AOvVaw0C1OXH1ljWp-jtfrK624Y1", "text1": "홍길동(조선) - 나무위키", "text2": "2023. 12. 14. · 조선 시대에 실존했던 유명한 전국구 도적. 소설 홍길동전의 주인공 홍길동의 모티브가 된 인물로 조선왕조실록의 연산군편에 기록되어 있다. 정승과 판서 ..." }, { "link": "https://www.google.comhttp://www.google.com/url?esrc=s&q=&rct=j&sa=U&url=http://newsteacher.chosun.com/site/data/html_dir/2021/07/28/2021072802464.html&ved=2ahUKEwjH1uqtzMWDAxVNafUHHd2_BbUQFnoECAEQAg&usg=AOvVaw1XtHo3XGnOffxO8-LLln2V", "text1": "[뉴스 속의 한국사] 홍길동 실존 인물은 '노인 도적'… 소설 속 '청년 의적 ...", "text2": "2021. 7. 29. · 홍길동은 연산군(재위 1494~1506) 시절 충청도 일대를 중심으로 활동한 도적 떼의 우두머리였어요. 명종 때 임꺽정, 숙종 때 장길산과 함께 '조선 왕조 3 ..." }, { "link": "https://www.google.com/url?esrc=s&q=&rct=j&sa=U&url=https://ko.wikipedia.org/wiki/%25ED%2599%258D%25EA%25B8%25B8%25EB%258F%2599%25EC%25A0%2584&ved=2ahUKEwjH1uqtzMWDAxVNafUHHd2_BbUQFnoECAMQAg&usg=AOvVaw0PRS1rK_JEvU1kWYD8pmH2", "text1": "홍길동전 - 위키백과, 우리 모두의 백과사전", "text2": "《홍길동전》(洪吉童傳)은 19세기에 널리 읽힌 한글 고전소설이다. 오랫동안 허균이 지은 소설로 알려졌으며 다수설이나, 이에 대해서는 찬반 논쟁이 있다." }, { "link": "https://www.google.com/url?esrc=s&q=&rct=j&sa=U&url=https://www.youtube.com/watch%3Fv%3DSOY8XNenyVw&ved=2ahUKEwjH1uqtzMWDAxVNafUHHd2_BbUQtwJ6BAgLEAE&usg=AOvVaw24tUumInxDsQNTOVwFYhkP", "text1": "아버지를 아버지라 부르..다? 우리가 몰랐던 홍길동전 이야기! 그가 ...", "text2": "3일 전 · 본격 우리 역사 스토리텔링쇼 #벌거벗은한국사 00:00 의적 홍길동의 탄생 01:18 청룡의 기운을 타고난 아이 06:28 얼자 신 ...\n기간: 24:12\n게시: 3일 전" }, { "link": "https://www.google.com/url?esrc=s&q=&rct=j&sa=U&url=https://www.youtube.com/watch%3Fv%3DL6E1Pgs7rxc&ved=2ahUKEwjH1uqtzMWDAxVNafUHHd2_BbUQtwJ6BAgKEAE&usg=AOvVaw3yMg6swEP7EbU6Feiqecop", "text1": "얼자에서 왕의 자리까지 오른 의적 홍길동! 사실은 흉악한 도적이었다 ...", "text2": "3일 전 · 본격 우리 역사 스토리텔링쇼 #벌거벗은한국사 00:00 수배령이 떨어진 홍길동 02:33 사람들을 놀라게 만든 홍길동의 도술 ...\n기간: 23:17\n게시: 3일 전" }, { "link": "https://www.google.com/url?esrc=s&q=&rct=j&sa=U&url=https://www.youtube.com/watch%3Fv%3DwcXignso3pk&ved=2ahUKEwjH1uqtzMWDAxVNafUHHd2_BbUQtwJ6BAgJEAE&usg=AOvVaw0w19qRocxGaAHRieurmuhS", "text1": "홍길동(1967) 복원본 / A Story of Hong Gil-dong ( Hong ... - YouTube", "text2": "2022. 6. 14. · 홍길동 (신동헌, 1967) 복원기 https://www.kmdb.or.kr/story/237/6627 홍길동 발견 경위와 역사적 의 ...\n기간: 1:06:48\n게시: 2022. 6. 14." }, { "link": "https://www.google.com/url?esrc=s&q=&rct=j&sa=U&url=https://encykorea.aks.ac.kr/Article/E0063994&ved=2ahUKEwjH1uqtzMWDAxVNafUHHd2_BbUQFnoECAQQAg&usg=AOvVaw1vl5KnVGT5BCMxZKs8Nypk", "text1": "홍길동전(洪吉童傳) - 한국민족문화대백과사전", "text2": "조선시대 왕비의 예복. ... 커다란 돌이나 원목(原木) 등 무거운 짐을 운반할 때 사용하는 수레. ... 목재면을 매끈하게 하거나 표면을 필요에 따라 여러 가지 모양으로 깎아 ..." }, { "link": "https://www.google.comhttp://www.google.com/url?esrc=s&q=&rct=j&sa=U&url=http://www.gjdream.com/news/articleView.html%3Fidxno%3D465308&ved=2ahUKEwjH1uqtzMWDAxVNafUHHd2_BbUQFnoECAIQAg&usg=AOvVaw35rakkLn_FxhXM1wMum5ZA", "text1": "[역사 속 전라도]홍길동, 장성서 태어난 실존인물 < 역사 속 ... - 광주드림", "text2": "2015. 5. 14. · 홍길동은 조선 연산군 때 아버지 경성절제사 홍상직과 어머니 관기 옥영향 사이에서 전라도 장성현 아차곡에서 서자로 태어난 도적이다. 귀동은 길동의 ..." } ], "success": 1 }, "api": { "success": true, "cost": 5, "pl_id": 1595645, "ms": 1553 } }