결과 다운로드
모든 결과 페이지에는 검색으로 찾은 내용을 다운로드하는 버튼이 있습니다. URLs, CSV, CSV+스니펫입니다. 로그인한 계정에는 결과를 다운로드하지 않고 저장하는 클러스터 버튼도 있습니다. 행은 결과 페이지와 같은 순서로 들어갑니다.
버튼별 내용
| 버튼 | 파일 | 각 줄 |
|---|---|---|
| URLs | query.txt | 일치한 페이지의 주소. |
| CSV | query.csv | url;rank |
| CSV+스니펫 | query-snippets.csv | url;rank;snippets |
| 클러스터 | - | 도메인이 클러스터로 저장됩니다. 결과 중 몇 개가 들어갔는지는 메시지에 표시됩니다. |
파일 이름은 쿼리에서 라틴 문자, 숫자, -, _를 뺀 나머지를 모두
지운 것입니다. "static.hotjar.com"은 statichotjarcom.csv가
됩니다.
형식
- UTF-8이며 헤더 행이 없습니다.
- 열은 세미콜론
;으로 구분합니다. 세미콜론, 큰따옴표, 줄바꿈이 들어 있는 셀은 큰따옴표로 감싸고, 그 안의 따옴표는 두 번 씁니다. 표준 CSV이므로 구분자로 세미콜론을 고르면 스프레드시트나 CSV 라이브러리가 그대로 읽습니다. - 순위는 인기 순위에서 사이트가 차지하는 자리입니다. 순위가 없는 사이트는 비어 있습니다.
- 한 페이지의 스니펫은 모두 한 셀에 들어가며
...로 이어집니다. =,+,-,@로 시작하는 스니펫은 앞에 아포스트로피가 붙습니다. 스프레드시트가 이를 수식으로 실행하지 않고 그대로 보여 주게 하기 위해서입니다. 전화번호 같은 숫자는 그대로 둡니다.
행 수
파일에는 요금제가 공개하는 결과, 즉 결과 페이지에서 열어 볼 수 있는 행이 요금제 한도까지 들어갑니다. 한도는 URLs와 CSV는 검색당 결과 수 (다운로드도 동일), CSV+스니펫은 스니펫 포함 다운로드(행)입니다. 수치는 요금제 페이지에 있습니다. 행은 결과의 맨 위부터 가져옵니다.
요금제 때문에 결과가 잘리면 파일 마지막 줄에 그 사실이 적힙니다.
# Truncated at the plan limit: 1,000 of 22,694 results.
이 줄은 #으로 시작하며, 다운로드한 사이트의 언어로 적힙니다. 결과가 아니므로
프로그램에서 파일을 읽을 때는 건너뛰세요. 이 줄이 없으면 파일에 모든 결과가 들어 있는
것입니다.
다운로드는 검색 자체와 똑같이 차감됩니다. 일일 할당량에서 검색 1회, CSV+스니펫은 여기에 더해 스니펫 포함 다운로드 1회입니다. 할당량 및 속도 제한을 참고하세요. 그날의 검색을 다 쓰면 다운로드에는 무료 요금제가 허용하는 만큼만 담기고, 마지막 줄에 파일이 잘렸다고 적힙니다.
스크립트에서
버튼은 페이지 안에서 다운로드 주소를 만들며, 이 주소는 페이지를 연 브라우저에서 10분 동안
작동합니다. 직접 작성한 코드에서 다운로드하려면 API를 사용하세요.
/v1/search에 format=csv 또는 format=txt를 지정합니다.
?key=를 쓰는 기존 내보내기 URL은 예전 형식을
그대로 유지합니다. 셀을 따옴표로 감싸지 않고, 마지막 줄이 없으며, 순위가 없는 사이트는
>30M으로 표시됩니다.
기타 다운로드
- 클러스터 - 클러스터 목록의 다운로드 아이콘을 누르면 클러스터의 도메인을 한 줄에 하나씩 담은 텍스트 파일을 받습니다.
- 추출 - 세미콜론이 아니라 쉼표로 구분한 CSV이며 헤더 행이 있습니다. 도메인 다음에 표현식마다 열이 하나씩 이어집니다. 한 사이트에서 찾은 값이 여러 개면 한 셀에 한 줄에 하나씩 들어갑니다.
#으로 시작하는 마지막 줄에는 이번 실행에 쓴 추출 포인트가 적힙니다. 그날의 포인트가 바닥나면 그 앞 줄에 어디서부터 이어 가면 되는지 적힙니다. 추출을 참고하세요.