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

Добро пожаловать в справочный узел автоматизации рабочих процессов. API Legibilize использует распределенную бессерверную систему парсинга, работающую на основе оптимизированных алгоритмов режима чтения, которая мгновенно удаляет трекеры, рекламу, всплывающие баннеры скриптов и лишние элементы, возвращая чистый, очищенный семантический текст.

Аутентификация

Ключи доступа генерируются при подтверждении инициализации выполнения. Вы должны передавать свою криптографически подписанную секретную строку (Bearer-токен) внутри стандартного заголовка сетевого запроса с использованием HTTP-аутентификации Bearer.

Примечание по безопасности: Все токены API имеют уникальные глобальные префиксы (lg_live_...). Держите эти значения в безопасности, никогда не раскрывайте ключи внутри необработанных клиентских скриптов на стороне браузера (фронтенда).

Ожидаемая схема заголовка

Заголовок Authorization: Bearer lg_live_ВАШ_СЕКРЕТНЫЙ_КЛЮЧ

Тарифные планы и лимиты

Ваши лимиты доступа к ресурсам обновляются программно в каждом расчетном цикле в зависимости от выбранного вами пакета услуг:

Тарифный план	Месячный лимит запросов	Стратегия ограничения скорости
Developer Pro	15 000 запросов / месяц	До 60 выполнений / минута
Scale Production	75 000 запросов / месяц	До 300 выполнений / минута

Эндпоинт: извлечение чистого текста статьи

Мгновенно извлекает данные документов из URL-адресов, удаляет разметку макета раздутых страниц и возвращает сэмплы текстовых блоков без лишнего мусора.

POST https://legibilize.com/api.php?action=clean

Параметры тела запроса (POST Payload)

Параметр	Тип	Обязательный	Описание контекста
`url`	string	Да	Абсолютный URL-путь к целевой странице для парсинга (например, `https://example.com/article`).

Пример структуры ответа в формате JSON

{
  "status": "success",
  "meta": {
    "url": "https://example.com/target-news",
    "timestamp": 1781820401,
    "account": "developer@example.org",
    "tier": "Developer Pro",
    "usage_this_month": 142,
    "remaining_credits": 14858
  },
  "data": {
    "title": "Революционные изменения в веб-архитектуре",
    "word_count": 1204,
    "clean_html": "<p>Это очищенный контент статьи без тяжелых скриптов и элементов разметки.</p>",
    "plain_text": "Это очищенный контент статьи без тяжелых скриптов и элементов разметки."
  }
}

Примеры реализации SDK (экстракция URL)

Последовательность запросов cURL Shell CLI

curl -X POST "https://legibilize.com/api.php?action=clean" \
  -H "Authorization: Bearer lg_live_ВАШ_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://news-portal.com/breaking-story"}'

Процедура выполнения cURL в PHP

<?php
$api_key = 'lg_live_ВАШ_КЛЮЧ';
$target_url = 'https://news-portal.com/breaking-story';

$ch = curl_init('https://legibilize.com/api.php?action=clean');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer ' . $api_key,
    'Content-Type: application/json'
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode(['url' => $target_url]));

$response_json = curl_exec($ch);
curl_close($ch);

$result = json_decode($response_json, true);
print_r($result['data']['plain_text']);
?>

Node.js (интерфейс Fetch API)

const apiKey = 'lg_live_ВАШ_КЛЮЧ';

async function extractArticle(targetUrl) {
    const response = await fetch('https://legibilize.com/api.php?action=clean', {
        method: 'POST',
        headers: {
            'Authorization': `Bearer ${apiKey}`,
            'Content-Type': 'application/json'
        },
        body: JSON.stringify({ url: targetUrl })
    });
    
    const json = await response.json();
    console.log(json.data.title);
}