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

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

ParseJet извлекает текст из любого файла или URL. Один вызов API обрабатывает PDF, DOCX, YouTube, веб-страницы, изображения, аудио, видео и более 25 других форматов.

Быстрый старт

Получите первый результат парсинга менее чем за 60 секунд. Регистрация не требуется.

curl -X POST https://api.parsejet.com/v1/parse/auto/url \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com"}'

# Add your API key to requests
curl -X POST https://api.parsejet.com/v1/parse/auto/url \
  -H "Authorization: Bearer pj_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com"}'

{
  "text": "Extracted text content...",
  "title": "Document Title",
  "source_type": "webpage",
  "metadata": { "url": "https://example.com" }
}

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

ParseJet предлагает три уровня доступа. Вы можете начать использовать API немедленно без какой-либо аутентификации.

Основные концепции

Поддерживаемые форматы

ParseJet автоматически определяет формат по расширению файла или шаблону URL. Вам не нужно указывать формат — просто отправьте файл или URL на /v1/parse/auto, и ParseJet сделает всё остальное.

Кредиты

Каждый API-запрос расходует кредиты в зависимости от сложности разбираемого формата. Простые текстовые файлы стоят 1 кредит, а расшифровки YouTube — 5. Ваш ежемесячный лимит кредитов зависит от вашего тарифного плана.

Формат вывода

По умолчанию ParseJet возвращает извлечённый сырой текст. Добавьте ?output_format=markdown к любому запросу, чтобы получить обработанный вывод с обнаруженными заголовками, списками, таблицами и блоками кода.

Руководство

Разбор PDF

Извлеките текст из любого PDF-файла, включая сканированные документы и многостраничные отчёты.

Загрузите PDF-файл

curl -X POST https://api.parsejet.com/v1/parse/auto/file \
  -H "Authorization: Bearer pj_YOUR_KEY" \
  -F "[email protected]"

Конвертировать в Markdown

Добавьте output_format=markdown, чтобы сохранить структуру документа:

curl -X POST https://api.parsejet.com/v1/parse/auto/file?output_format=markdown \
  -H "Authorization: Bearer pj_YOUR_KEY" \
  -F "[email protected]"

Руководство

Расшифровки YouTube

Получите полную расшифровку любого видео на YouTube. Поддерживает автоматически сгенерированные субтитры на 100+ языках.

Получить расшифровку

curl -X POST https://api.parsejet.com/v1/parse/youtube \
  -H "Content-Type: application/json" \
  -d '{"url": "https://youtube.com/watch?v=VIDEO_ID"}'

Указать язык

Используйте параметр language для видео не на английском:

curl -X POST https://api.parsejet.com/v1/parse/youtube \
  -H "Content-Type: application/json" \
  -d '{"url": "https://youtube.com/watch?v=VIDEO_ID", "language": "ja"}'

Или используйте автоопределение

Эндпоинт /v1/parse/auto/url автоматически определяет URL YouTube:

curl -X POST https://api.parsejet.com/v1/parse/auto/url \
  -H "Content-Type: application/json" \
  -d '{"url": "https://youtu.be/VIDEO_ID"}'

Руководство

Веб-скрапинг

Извлекайте основной контент с любой веб-страницы. ParseJet автоматически удаляет навигацию, рекламу, боковые панели и шаблонные элементы.

curl -X POST https://api.parsejet.com/v1/parse/webpage \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/blog/article"}'

Руководство

Офисные документы

Парсите файлы Word (DOCX), Excel (XLSX), PowerPoint (PPTX) и CSV. Просто загрузите файл — ParseJet автоматически определит формат.

# Works with any Office format
curl -X POST https://api.parsejet.com/v1/parse/auto/file \
  -H "Authorization: Bearer pj_YOUR_KEY" \
  -F "[email protected]"

# Also works with spreadsheets
curl -X POST https://api.parsejet.com/v1/parse/auto/file \
  -H "Authorization: Bearer pj_YOUR_KEY" \
  -F "[email protected]"

Справочник API

Формат ответа

Все конечные точки возвращают одинаковую структуру JSON:

{
  "text": "Extracted text content...",
  "title": "Document Title",
  "source_type": "pdf",
  "metadata": { "pages": 12, "author": "Jane Doe" }
}

Рекомендуемая конечная точка. Автоматически определяет формат по расширению файла или типу URL. Принимает file (multipart) или url (поле формы), но не оба одновременно.

curl -X POST https://api.parsejet.com/v1/parse/auto \
  -H "Authorization: Bearer pj_YOUR_KEY" \
  -F "[email protected]"

Парсинг любого URL. Автоматически отличает YouTube от обычных веб-страниц.

curl -X POST https://api.parsejet.com/v1/parse/auto/url \
  -H "Authorization: Bearer pj_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com"}'

Парсинг любого загруженного файла. Определяет формат по расширению файла, при неудаче — по содержимому.

curl -X POST https://api.parsejet.com/v1/parse/auto/file \
  -H "Authorization: Bearer pj_YOUR_KEY" \
  -F "[email protected]"

Извлечение основного контента с веб-страницы. Удаляет навигацию, рекламу и шаблонные элементы.

curl -X POST https://api.parsejet.com/v1/parse/webpage \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/article"}'

Извлечение транскрипта из видео YouTube. Метаданные включают video_id, канал и длительность.

curl -X POST https://api.parsejet.com/v1/parse/youtube \
  -H "Content-Type: application/json" \
  -d '{"url": "https://youtube.com/watch?v=VIDEO_ID", "language": "en"}'

Парсинг аудиофайлов. Поддерживает MP3, WAV, M4A, OGG, FLAC, WebM. Макс. 25 МБ.

curl -X POST https://api.parsejet.com/v1/parse/audio \
  -H "Authorization: Bearer pj_YOUR_KEY" \
  -F "[email protected]" -F "language=en"

Извлечение аудио из видео для транскрипции. Поддерживает MP4, MKV, AVI, MOV, WebM.

curl -X POST https://api.parsejet.com/v1/parse/video \
  -H "Authorization: Bearer pj_YOUR_KEY" \
  -F "[email protected]" -F "language=en"

Парсинг EPUB-книги. Извлекает текст, организованный по главам.

curl -X POST https://api.parsejet.com/v1/parse/epub \
  -H "Authorization: Bearer pj_YOUR_KEY" \
  -F "[email protected]"

Парсинг RSS или Atom-ленты. Также поддерживает OPML через /v1/parse/opml.

curl -X POST https://api.parsejet.com/v1/parse/feed \
  -H "Authorization: Bearer pj_YOUR_KEY" \
  -F "[email protected]"

Анализ изображения. Поддерживает JPG, PNG, GIF, BMP, WebP, TIFF. Макс. 20 МБ.

curl -X POST https://api.parsejet.com/v1/parse/image \
  -H "Authorization: Bearer pj_YOUR_KEY" \
  -F "[email protected]" -F "prompt=Describe this image"

Извлечение текста из изображения с помощью OCR.

curl -X POST https://api.parsejet.com/v1/parse/image/ocr \
  -H "Authorization: Bearer pj_YOUR_KEY" \
  -F "[email protected]"

SDK

Официальные SDK

npm install parsejet

import { ParseJet } from "parsejet";

const client = new ParseJet({ apiKey: "pj_YOUR_KEY" });

// Parse a URL
const result = await client.parse.url("https://example.com");
console.log(result.text);

// Parse a file
const result = await client.parse.file(buffer, "report.pdf");
console.log(result.text);

pip install parsejet

from parsejet import ParseJet

client = ParseJet(api_key="pj_YOUR_KEY")

# Parse a URL
result = client.parse.url("https://example.com")
print(result.text)

# Parse a file
with open("report.pdf", "rb") as f:
    result = client.parse.file(f, "report.pdf")
    print(result.text)

AI-агенты

MCP сервер

Используйте ParseJet как MCP (Model Context Protocol) сервер с Claude Code, Cursor или любым совместимым с MCP AI-агентом.

Установка

npm install -g @parsejet/mcp-server

Claude Code

Добавьте в .claude/settings.json вашего проекта:

{
  "mcpServers": {
    "parsejet": {
      "command": "npx",
      "args": ["-y", "@parsejet/mcp-server"],
      "env": {
        "PARSEJET_API_KEY": "pj_YOUR_KEY"
      }
    }
  }
}

Cursor

Перейдите в Настройки → MCP серверы, добавьте новый сервер:

{
  "mcpServers": {
    "parsejet": {
      "command": "npx",
      "args": ["-y", "@parsejet/mcp-server"],
      "env": {
        "PARSEJET_API_KEY": "pj_YOUR_KEY"
      }
    }
  }
}

Claude.ai (Удалённый)

Для Claude.ai в браузере используйте удалённый HTTP endpoint — локальная установка не требуется:

Endpoint:  https://api.parsejet.com/mcp
Transport: Streamable HTTP
Auth:      Bearer pj_YOUR_KEY (in Authorization header)

Перейдите в Claude.ai → Настройки → Интеграции → Добавить MCP сервер → Введите URL выше.

Доступные инструменты

Лимиты запросов и цены

ParseJet использует систему кредитов. Каждый запрос расходует кредиты в зависимости от сложности формата.

Заголовки ответа включают X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset и Retry-After при ответах 429.

Коды ошибок

Все ошибки возвращают JSON с полями error и message.