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

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

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

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

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

## Формат

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

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

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

Якщо тариф обрізав результати, про це каже останній рядок файлу:

```
# Truncated at the plan limit: 1,000 of 22,694 results.
```

Рядок починається з `#` і написаний мовою того сайту, з якого ви завантажували. Це не результат: читаючи файл програмою, пропускайте його. Якщо його немає, у файлі всі результати.

За завантаження списується те саме, що й за сам пошук: один пошук із денного ліміту, а за 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/query-syntax/downloads/