Документация EasyFetch API

EasyFetch API предоставляет высокоскоростные эндпоинты для одиночного и пакетного сбора веб-данных. Движок автоматически решает Cloudflare Turnstile, Cloudflare WAF, Akamai Bot Manager, DataDome, DDoS-Guard, Yandex SmartCaptcha и эмулирует отпечатки реальных браузеров (TLS JA3/JA4) на уровне сетевых сокетов.

⚡ Базовый URL API: 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.

🛡️ Политика нулевых списаний (100% бесплатно при сбоях): Если целевой сайт упал, заблокировал IP или вернул ошибку, с баланса списывается ровно 0 кредитов. Списание происходит только при успешном ответе (HTTP 200–399).

Параметры запроса

Параметр Тип По умолчанию Описание
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)

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 Batch Request
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)