Завантаження результатів
На кожній сторінці результатів є кнопки, які завантажують знайдене: 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 читає його як є, якщо вибрати роздільником крапку з комою. - Rank - місце сайту в рейтингу популярності. Для сайту без місця в рейтингу це поле порожнє.
- Усі фрагменти однієї сторінки стоять в одній клітинці через
.... - Перед фрагментом, що починається з
=,+,-або@, ставиться апостроф, щоб електронна таблиця показала його, а не виконала як формулу. Числа, як-от номери телефонів, лишаються як є.
Скільки рядків
У файл потрапляють результати, які відкриває ваш тариф, - ті рядки, що їх можна відкрити на сторінці результатів, - але не більше за ліміт тарифу: Результатів на один пошук або вивантаження для URLs і CSV, Завантаження з фрагментами (рядків) для CSV+фрагменти. Числа - на сторінці Тарифи. Рядки беруться з початку результатів.
Якщо тариф обрізав результати, про це каже останній рядок файлу:
# Truncated at the plan limit: 1,000 of 22,694 results.
Рядок починається з # і написаний мовою того сайту, з якого ви
завантажували. Це не результат: читаючи файл програмою, пропускайте його. Якщо
його немає, у файлі всі результати.
За завантаження списується те саме, що й за сам пошук: один пошук із денного ліміту, а за CSV+фрагменти - ще й одне завантаження з фрагментами, див. ліміти й обмеження частоти. Коли пошуки на сьогодні вичерпано, завантаження містить стільки, скільки дозволяє безкоштовний тариф, і останній рядок повідомляє, що файл обрізано.
Зі скрипту
Кнопки складають адресу завантаження прямо на сторінці, і вона працює десять
хвилин у тому браузері, який відкрив сторінку. Щоб завантажувати з власного
коду, використовуйте API: /v1/search з
format=csv або format=txt.
Старі URL експорту з ?key=
зберігають свій давній формат у точності: клітинки не беруть у лапки,
останнього рядка немає, а сайт без місця в рейтингу показує >30M.
Інші завантаження
- Кластер - значок завантаження в списку кластерів дає текстовий файл із його доменами, по одному на рядок.
- Витягування даних - CSV, розділений комами, а не крапками з комою: домен, далі по колонці на кожен вираз. Кілька значень, знайдених на одному сайті, стоять в одній клітинці, по одному на рядок. Коли бали на сьогодні закінчуються, останній рядок підказує, звідки продовжити. Див. Витягування даних.