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

Документация 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]"

Таблицы как структурированный JSON

Добавьте output_format=json, чтобы получить строки CSV и Excel как JSON-массив объектов — заголовок как ключи, числовые типы сохраняются.

curl -X POST "https://api.parsejet.com/v1/parse/auto/file?output_format=json" \
  -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 МБ и 5 минут аудио на запрос; ответ содержит транскрипцию и отметки времени. 3 кредита.

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 и другие; до 5 минут аудио на запрос. 5 кредитов.

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

Преобразует видео- или аудиофайл в готовый к скачиванию аудиофайл — MP3, M4A, Opus, WAV или FLAC. В отличие от /v1/parse/video, который возвращает в JSON дорожку, подготовленную для расшифровки, эта конечная точка отдаёт сам звук: стерео, полная частота дискретизации и выбранный вами битрейт. Стоит 3 кредита за запрос.

curl -X POST https://api.parsejet.com/v1/convert/audio \
  -H "Authorization: Bearer pj_YOUR_KEY" \
  -F "[email protected]" \
  -F "output_format=mp3" -F "bitrate=192k" \
  -o interview.mp3

Создайте файл вместо текста. pdf: изображения и PDF-файлы объединяются в один PDF в порядке загрузки (фото в PDF, объединение PDF-файлов) или отображается один файл TXT/Markdown/HTML/Office. docx: Markdown, текст, HTML, PDF, файлы Office, изображения и отсканированные PDF-файлы (через OCR) становятся документом Word. xlsx/csv: все таблицы, найденные в PDF, DOCX, HTML, CSV или XLSX. png/jpg: страницы PDF отображаются в выбранном разрешении или конвертирование формата изображения. Тело ответа — это файл. 2 кредита за запрос.

# PDF tables → Excel
curl -X POST https://api.parsejet.com/v1/convert/document \
  -H "Authorization: Bearer pj_YOUR_KEY" \
  -F "[email protected]" -F "output_format=xlsx" -o invoice.xlsx

# Photos → one PDF (upload order = page order); the same call merges PDFs
curl -X POST https://api.parsejet.com/v1/convert/document \
  -H "Authorization: Bearer pj_YOUR_KEY" \
  -F "[email protected]" -F "[email protected]" -F "output_format=pdf" -o scan.pdf

# Markdown → Word
curl -X POST https://api.parsejet.com/v1/convert/document \
  -H "Authorization: Bearer pj_YOUR_KEY" \
  -F "[email protected]" -F "output_format=docx" -o notes.docx

Парсинг 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]"

Распознавание текста в изображении встроенным OCR движком. Поддерживает 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]"

То же OCR что /v1/parse/image, помечено source_type "image_ocr". Отсканированные страницы PDF распознаются автоматически /v1/parse/auto/file.

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);

// Convert a video to MP3 (3 credits)
const audio = await client.convert.audio("./interview.mov", { bitrate: "192k" });
await writeFile(audio.filename, audio.data);

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)

# Convert a video to MP3 (3 credits)
audio = client.convert.audio("interview.mov", bitrate="192k")
audio.save()  # writes interview.mp3

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.