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

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

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

| Кнопка | Файл | Кожен рядок |
| --- | --- | --- |
| URLs | `statichotjarcom.txt` | Адреса сторінки, що відповідає запиту. |
| CSV | `statichotjarcom.csv` | `url;rank` |
| CSV+фрагменти | `statichotjarcom-snippets.csv` | `url;rank;snippets` |
| Кластер | - | Домени зберігаються як [кластер](https://ua.publicwww.com/docs/clusters/creating/); у повідомленні сказано, скільки результатів до нього ввійшло. |

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

## Формат

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

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

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

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

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

За завантаження списується те саме, що й за сам пошук: один пошук із денного ліміту, а за CSV+фрагменти - ще й одне завантаження з фрагментами, див. [ліміти й обмеження частоти](https://ua.publicwww.com/docs/api/limits/). Коли пошуки на сьогодні вичерпано, завантаження містить стільки, скільки дозволяє безкоштовний тариф.

## Зі скрипту

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

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

- **Кластер** - значок завантаження в списку [кластерів](https://ua.publicwww.com/profile/clusters/) дає текстовий файл із його доменами, по одному на рядок.
- **Витягування даних** - CSV, розділений комами, а не крапками з комою, з рядком заголовків. Див. [Витягування](https://ua.publicwww.com/docs/clusters/extraction/).

Source: https://ua.publicwww.com/docs/search/downloads/
