# Справочник API

Параметры запросов, схемы ответов и рабочие примеры для каждого источника.

Каноническая ссылка: https://flashdata.dev/ru/docs/reference

<a id="request-basics"></a>

## Основы запросов

Установите источник для необходимого вам продукта и аутентифицируйте его с помощью X-API-Key. Страницы источников ниже содержат точные поля, примеры ответов и интерактивный конструктор запросов.

### Хостинг API

```text
Data API        https://data.flashdata.dev
Management API  https://api.flashdata.dev
Header          X-API-Key: YOUR_API_KEY
```

| Рабочий процесс | Запрос | Возвращение |
| --- | --- | --- |
| Realtime · Данные API | POST /v1/queries/realtime | Источник результатов в ответе |
| Async · Данные API | POST /v1/queries | Работа ID для статуса и результатов |
| Batch · Данные API | POST /v1/queries/batch | Отдельная квитанция за запрос |
| Bulk · Management API | POST /v2/bulk-jobs | Bulk ID и подписанный файл ввода загрузите URL |
| Работа · Управление API | GET /v2/jobs/{id} | Статус существующей работы |

### [API](https://flashdata.dev/ru/docs/guides/http-quickstart/reference.md)

Новый API? Установите ключ и запустите полный первый запрос.

<a id="api-basics"></a>

## Основы API

### [Realtime и асинхронизация](https://flashdata.dev/ru/docs/reference/realtime-and-async/reference.md)

Получите результаты в ответ или отправьте работу и получите их позже. Выберите, как ваше приложение или агент ждет работы.

### [Batch и оптом](https://flashdata.dev/ru/docs/reference/batch-and-bulk/reference.md)

Выберите Batch для независимых запросов с различными входами. Выберите Bulk для файла видео IDs, который требует одинаковой работы.

### [Форматы ответов](https://flashdata.dev/ru/docs/guides/response-formats/reference.md)

Выберите структурированный JSON для вашего приложения или Markdown для агента ИИ. Контролируйте ответ двумя заголовками.

### [Ошибки и коды состояния](https://flashdata.dev/ru/docs/errors/reference.md)

Прочитайте ответ с ошибкой и решите, нужно ли исправить запрос, повторить его или остановиться.

<a id="google-search"></a>

## Google Search

### [Поиск](https://flashdata.dev/ru/docs/sources/google_search/reference.md)

Получите органические результаты, связанные с ними вопросы и богатые результаты от Google Search в виде структурированного JSON. Фильтр по стране, языку и месту.

source: `google_search`

### [Изображения](https://flashdata.dev/ru/docs/sources/google_images/reference.md)

Поиск изображений Google и извлечение исходного изображения URLs, миниатюр, размеров и исходных страниц как JSON.

source: `google_images`

### [Новости](https://flashdata.dev/ru/docs/sources/google_news/reference.md)

Восстановите статьи Google News с заголовками, источниками публикаций, ссылками и датами публикации. Фильтр по стране, языку и диапазону дат.

source: `google_news`

### [Покупки](https://flashdata.dev/ru/docs/sources/google_shopping/reference.md)

Поиск Google Покупки для товаров и получения цен, продавцов, рейтингов и ссылок на продукты в структурированном JSON.

source: `google_shopping`

### [Видео](https://flashdata.dev/ru/docs/sources/google_videos/reference.md)

Найдите видео на сайтах с видео Google. Извлеките заголовки, видео ссылки, миниатюры, продолжительность и исходную информацию.

source: `google_videos`

### [Места](https://flashdata.dev/ru/docs/sources/google_places/reference.md)

Поиск местных предприятий и мест. Укажите имена, адреса, координаты, рейтинги и контактные данные, когда они доступны.

source: `google_places`

<a id="youtube-data"></a>

## YouTube Data

### [Поиск](https://flashdata.dev/ru/docs/sources/youtube_search/reference.md)

Поиск видео YouTube по ключевым словам и извлечение заголовков, каналов, продолжительности, количества просмотров и миниатюр как JSON.

source: `youtube_search`

### [Расширенный поиск](https://flashdata.dev/ru/docs/sources/youtube_search_extended/reference.md)

Восстановление до результатов поиска 700 YouTube по запросу с помощью видеоданных, миниатюр и фильтров поиска.

source: `youtube_search_extended`

### [Метаданные видео](https://flashdata.dev/ru/docs/sources/youtube_metadata/reference.md)

Восстановление метаданных видео YouTube видео ID, включая детали канала, количество вовлечений, миниатюры, доступные форматы и главы.

source: `youtube_metadata`

### [Расшифровка](https://flashdata.dev/ru/docs/sources/youtube_transcript/reference.md)

Восстановите текст транскрипта YouTube с временными метками и полной транскриптом. Автоматические подписи выбираются по умолчанию.

source: `youtube_transcript`

### [Субтитры](https://flashdata.dev/ru/docs/sources/youtube_captions/reference.md)

Восстановите подписи YouTube в виде текста с отметкой времени и полной транскрипции. Подписи, предоставленные загрузчиком, выбираются по умолчанию.

source: `youtube_captions`

### [Канал](https://flashdata.dev/ru/docs/sources/youtube_channel/reference.md)

Восстановление профиля канала YouTube и его последних видео по рукоятке, включая количество подписчиков, изображения каналов и детали видео.

source: `youtube_channel`

### [Подсказки](https://flashdata.dev/ru/docs/sources/youtube_suggestions/reference.md)

Восстановите предложения автозаполнения YouTube для ключевого слова или фразы с контролем языка и региона.

source: `youtube_suggestions`

### [Метки лицензий](https://flashdata.dev/ru/docs/sources/youtube_trainability/reference.md)

Проверьте метаданные лицензии видео YouTube для ярлыка Creative Commons и получите результат JSON.

source: `youtube_trainability`

<a id="youtube-download"></a>

## YouTube Download

### [Скачать](https://flashdata.dev/ru/docs/sources/youtube_download/reference.md)

Загрузите видео или аудио YouTube в облачное хранилище. Выберите разрешение, формат и продолжительность клипа, а затем отследите асинхронную работу через завершение.

source: `youtube_download`

<a id="bulk-processing"></a>

## Массовая обработка

### [API обработки Bulk](https://flashdata.dev/ru/docs/reference/bulk-processing/reference.md)

Создавайте и управляйте заданиями YouTube на основе файлов, а затем извлекайте их манифесты и части результатов.

<a id="group-5"></a>

## Справочники протоколов

### [API управления](https://flashdata.dev/ru/docs/api-reference/reference.md)

Задания, доступ к аккаунту, регистрация агентов, привязка аккаунта и передача учётных данных.

### [Инструменты и схемы MCP](https://flashdata.dev/ru/docs/mcp/reference.md)

Аргументы инструментов, инструменты аккаунта, фоновые задания и большие результаты.

<a id="group-6"></a>

## Спецификации и справочники клиентов

### [Спецификация OpenAPI (JSON)](https://flashdata.dev/docs/openapi.json)

Машиночитаемые операции и схемы для инструментов API.

### [Справочник команд CLI](https://github.com/flashdatadev/flashdata-cli/blob/v1.2.1/docs/commands.md)

Команды, флаги и коды выхода для v1.2.1. Открывает GitHub.

### [Справочник методов Go SDK](https://github.com/flashdatadev/flashdata-go/blob/v1.1.0/docs/api-reference.md)

Методы и типы клиента для v1.1.0. Открывает GitHub.
