Завантаження результатів

На кожній сторінці результатів є кнопки, які завантажують знайдене: URLs, CSV і CSV+фрагменти. Якщо ви ввійшли в обліковий запис, є ще Кластер: ця кнопка не завантажує результати, а зберігає їх. Рядки йдуть у тому самому порядку, що й на сторінці результатів.

Що дає кожна кнопка

Файл називається за запитом, з якого викинуто все, крім латинських літер, цифр, - і _: з "static.hotjar.com" виходить statichotjarcom.csv.

Формат

• UTF-8. Перший рядок CSV і CSV+фрагменти називає стовпці: url;rank або url;rank;snippets. У файлі URLs такого рядка немає.
• Колонки розділено крапкою з комою ;. Клітинку, у якій є крапка з комою, кома, табуляція, подвійні лапки або розрив рядка, беруть у подвійні лапки, а лапки всередині неї подвоюють. Це звичайний CSV: електронна таблиця чи бібліотека CSV читає його як є, якщо вибрати роздільником крапку з комою, і клітинка лишається цілою, навіть якщо роздільником вибрати ще й кому чи табуляцію.
• Rank - місце сайту в рейтингу популярності. Для сайту без місця в рейтингу це поле порожнє.
• Усі фрагменти однієї сторінки стоять в одній клітинці через ....
• Перед фрагментом, що починається з =, +, - або @, ставиться апостроф, щоб електронна таблиця показала його, а не виконала як формулу. Числа, як-от номери телефонів, лишаються як є.

Скільки рядків

Рядки беруться з початку результатів, але не більше за ліміт тарифу: Результатів на один пошук або вивантаження для URLs і CSV, Завантаження з фрагментами (рядків) для CSV+фрагменти. Числа - на сторінці Тарифи. Без входу файл містить першу сторінку результатів: до 20 рядків.

Сайти, приховані на вашому тарифі, - рядки, де показано Зареєструйтеся, щоб побачити або Оформіть тариф, щоб побачити, - у файл не потрапляють. Результати йдуть за популярністю, і приховані сайти стоять після відкритих, тому файл може бути коротшим за ліміт або зовсім без рядків; тоді кнопки завантаження неактивні.

Підказка на кожній кнопці каже, скільки рядків буде у файлі, наприклад 7 з 1 059 рядків: сайти, приховані на вашому тарифі, не завантажуються. Коли зі сторінки не видно, де закінчуються відкриті рядки, у підказці стоїть Не більше: файл закінчується на першому сайті, прихованому на вашому тарифі, а він може трапитися раніше.

Якщо файл коротший за результати, останній рядок каже чому:

# Truncated at the plan limit: 1000 of 22694 results.
# 7 of 1059 results: websites hidden on your plan are left out.

Перша форма означає, що досягнуто ліміту рядків тарифу, друга - що сайти, приховані на вашому тарифі, у файл не ввійшли. Рядок починається з # і написаний мовою того сайту, з якого ви завантажували (приклади вище взято з англійської версії); числа в ньому - без роздільника тисяч. Це не результат: читаючи файл програмою, пропускайте його. Якщо його немає, у файлі всі результати.

За завантаження списується те саме, що й за сам пошук: один пошук із денного ліміту, а за CSV+фрагменти - ще й одне завантаження з фрагментами, див. ліміти й обмеження частоти. Коли пошуки на сьогодні вичерпано, завантаження містить стільки, скільки дозволяє безкоштовний тариф, і останній рядок повідомляє, що файл обрізано.

Зі скрипту

Кнопки - це посилання на сторінці результатів; адреса в них працює десять хвилин з тієї мережевої адреси, з якої відкрили сторінку. Щоб завантажувати з власного коду, використовуйте API: /v1/search з format=csv або format=txt. Старі URL експорту з ?key= зберігають свій давній формат у точності: клітинки не беруть у лапки, останнього рядка немає, а сайт без місця в рейтингу показує >30M.

Інші завантаження

• Кластер - значок завантаження в списку кластерів дає текстовий файл із його доменами, по одному на рядок.
• Витягування даних - CSV, розділений комами, а не крапками з комою, з рядком заголовків: домен, далі по колонці на кожен вираз. Кілька значень, знайдених на одному сайті, стоять в одній клітинці, по одному на рядок. Останній рядок, що починається з #, повідомляє, скільки балів витягування витратив прогін; коли бали на сьогодні закінчуються, рядок перед ним підказує, звідки продовжити. Див. Витягування даних.