Документация EasyFetch API
EasyFetch API предоставляет высокоскоростные эндпоинты для одиночного и пакетного сбора веб-данных. Движок автоматически решает Cloudflare Turnstile, Cloudflare WAF, Akamai Bot Manager, DataDome, DDoS-Guard, Yandex SmartCaptcha и эмулирует отпечатки реальных браузеров (TLS JA3/JA4) на уровне сетевых сокетов.
https://easyfetch.ru/api/v1
Аутентификация
Передавайте ваш персональный API-ключ в заголовке HTTP Authorization с префиксом Bearer или через заголовок X-API-Key. Для простых GET-запросов ключ можно также передать в query-параметре api_key.
Authorization: Bearer pe_live_ВАШ_API_КЛЮЧ
Одиночный сбор данных (GET & POST /api/v1/extract)
Отправьте адрес страницы для получения чистого HTML, текста или выборки по CSS-селекторам. Поддерживается как простой GET (формат ScrapingBee / ScraperAPI), так и расширенный POST с телом JSON.
Параметры запроса
| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
| target_url | string (обязательный) | — | Полный HTTP/HTTPS URL целевой страницы (алиас: url). |
| method | string | "GET" |
HTTP-метод, передаваемый целевому сайту ("GET", "POST", "PUT", "DELETE"). |
| body | object | string | null |
Тело запроса (payload/JSON/форма), передаваемое целевому сайту при POST/PUT запросах. |
| auto_detect | boolean | true |
Автономно распознает систему защиты и направляет запрос через оптимальный модуль обхода. |
| selectors | object | {} |
CSS-селекторы для точечного извлечения данных (например: {"title": "h1", "price": ".price"}). |
| clean_text | boolean | false |
Удаляет HTML-теги, стили и скрипты, возвращая только очищенный текст страницы (алиас: extract_text). |
| render_js | boolean | false |
Запуск стелс-браузера Playwright для клиентского JavaScript и Single Page Applications (5 кредитов). |
| country_code | string | "RU" |
Двухбуквенный ISO-код страны прокси (например: "RU", "BY", "KZ", "DE", "US"). |
| wait_for | integer | 0 |
Время ожидания в миллисекундах после загрузки страницы перед захватом DOM. |
| use_session | boolean | true |
Повторное использование пройденных сессий (cookie клиренса), повышающее скорость парсинга в 3–5 раз. |
Примеры вызова (cURL, Python, Node.js, PHP)
# 1. Быстрый GET-запрос через query-параметры:
curl "https://easyfetch.ru/api/v1/extract?target_url=https://target-portal.ru/catalog&country_code=RU&render_js=false" \
-H "Authorization: Bearer pe_live_ВАШ_API_КЛЮЧ"
# 2. POST с извлечением по CSS-селекторам:
curl -X POST https://easyfetch.ru/api/v1/extract \
-H "Authorization: Bearer pe_live_ВАШ_API_КЛЮЧ" \
-H "Content-Type: application/json" \
-d '{
"target_url": "https://target-portal.ru/item/123",
"country_code": "RU",
"selectors": {
"title": "h1",
"price": ".price"
}
}'
# 3. Парсинг закрытого API с пробросом метода POST:
curl -X POST https://easyfetch.ru/api/v1/extract \
-H "Authorization: Bearer pe_live_ВАШ_API_КЛЮЧ" \
-H "Content-Type: application/json" \
-d '{
"target_url": "https://target-portal.ru/api/search",
"method": "POST",
"body": {"query": "видеокарты", "in_stock": true},
"country_code": "RU"
}'
Пример ответа JSON
{
"status": "success",
"is_live": true,
"http_status": 200,
"target_url": "https://target-portal.ru/product",
"engine_used": "curl_cffi_tls_chrome120",
"data": {
"http_status": 200,
"page_title": "Товар в интернет-магазине",
"content_length": 48200,
"execution_time_seconds": 0.38,
"protection_bypassed": "Cloudflare Turnstile Managed Challenge",
"metadata": {
"title": "Товар в интернет-магазине",
"description": "Описание товара со страницы",
"canonical": "https://target-portal.ru/product"
},
"selectors_data": [
{ "selector": "h1", "matches": ["Ноутбук UltraBook 15"] },
{ "selector": ".price", "matches": ["89 990 ₽"] }
],
"html_sample": "<!DOCTYPE html><html>...</html>"
}
}
Пакетный сбор данных (POST /api/v1/batch)
Отправляйте массивы до 100 URL за один запрос. Сервис автоматически распределит нагрузку по пулу воркеров и уведомит ваш сервер по вебхуку при завершении.
curl -X POST https://easyfetch.ru/api/v1/batch \
-H "Authorization: Bearer pe_live_ВАШ_API_КЛЮЧ" \
-H "Content-Type: application/json" \
-d '{
"target_urls": [
"https://target-portal.ru/product/1",
"https://target-portal.ru/product/2",
"https://target-portal.ru/product/3"
],
"country_code": "RU",
"webhook_url": "https://your-server.ru/api/scrape-webhook"
}'
Вебхуки (Коллбэки)
EasyFetch может отправлять результаты парсинга на ваш вебхук. Для проверки подлинности входящих запросов используется заголовок X-Parse-Signature с подписью HMAC-SHA256, вычисленной от сырого тела запроса по вашему секретному ключу из личного кабинета.
# Пример проверки подписи вебхука на Python
import hmac
import hashlib
def verify_webhook(raw_body: bytes, signature_header: str, secret: str) -> bool:
computed = hmac.new(secret.encode(), raw_body, hashlib.sha256).hexdigest()
return hmac.compare_digest(computed, signature_header)