Documentação

Documentação do ParseJet

O ParseJet extrai texto de qualquer arquivo ou URL. Uma chamada de API lida com PDF, DOCX, YouTube, páginas web, imagens, áudio, vídeo e mais de 25 formatos.

Início Rápido

Obtenha seu primeiro resultado de análise em menos de 60 segundos. Sem necessidade de cadastro.

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" }
}

Autenticação

O ParseJet oferece três níveis de acesso. Você pode começar a usar a API imediatamente sem qualquer autenticação.

Conceitos Fundamentais

Formatos suportados

O ParseJet detecta automaticamente o formato pela extensão do arquivo ou padrão da URL. Você não precisa especificar o formato — basta enviar o arquivo ou URL para /v1/parse/auto e o ParseJet cuida do resto.

Créditos

Cada requisição à API consome créditos com base na complexidade do formato sendo analisado. Arquivos de texto simples custam 1 crédito, enquanto transcrições do YouTube custam 5. Sua cota mensal de créditos depende do seu plano.

Formato de saída

Por padrão, o ParseJet retorna o texto extraído bruto. Adicione ?output_format=markdown a qualquer requisição para obter uma saída pós-processada com títulos, listas, tabelas e blocos de código detectados.

Guia

Analisar um PDF

Extraia texto de qualquer arquivo PDF, incluindo documentos digitalizados e relatórios com várias páginas.

Enviar um arquivo PDF

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

Converter para Markdown

Adicione output_format=markdown para preservar a estrutura do documento:

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

Guia

Transcrições do YouTube

Obtenha a transcrição completa de qualquer vídeo do YouTube. Suporta legendas geradas automaticamente em mais de 100 idiomas.

Obter uma transcrição

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

Especificar idioma

Use o parâmetro language para vídeos não em inglês:

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"}'

Ou use detecção automática

O endpoint /v1/parse/auto/url detecta automaticamente URLs do YouTube:

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

Guia

Web Scraping

Extraia o conteúdo principal de qualquer página da web. O ParseJet remove automaticamente navegação, anúncios, barras laterais e conteúdo padrão.

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

Guia

Documentos de Escritório

Analise arquivos do Word (DOCX), Excel (XLSX), PowerPoint (PPTX) e CSV. Basta fazer o upload do arquivo — o ParseJet detecta o formato automaticamente.

# 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]"

Planilhas como JSON estruturado

Adicione output_format=json para receber as linhas de CSV e Excel como um array JSON de objetos — cabeçalho como chaves, números com tipo preservado.

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

Referência da API

Formato da Resposta

Todos os endpoints retornam a mesma estrutura JSON:

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

O endpoint recomendado. Detecta automaticamente o formato pela extensão do arquivo ou tipo de URL. Aceita file (multipart) ou url (campo de formulário), não ambos.

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

Analise qualquer URL. Distingue automaticamente YouTube de páginas da web regulares.

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"}'

Analise qualquer arquivo enviado. Detecta o formato pela extensão do arquivo, com fallback para detecção baseada em conteúdo.

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

Extraia o conteúdo principal de uma página da web. Remove navegação, anúncios e conteúdo padrão.

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

Extraia a transcrição de um vídeo do YouTube. Os metadados incluem video_id, canal e duração.

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"}'

Transcreva áudio MP3, WAV, M4A, OGG, FLAC ou WebM com reconhecimento de fala integrado (executado em nossos servidores). Máximo 25 MB e 5 minutos de áudio por solicitação; a resposta inclui a transcrição mais segmentos cronometrados. 3 créditos.

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

Transcreva um vídeo: a trilha de áudio é extraída e transcrita em nossos servidores. Suporta MP4, MKV, AVI, MOV, WebM e mais; até 5 minutos de áudio por solicitação. 5 créditos.

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

Converte um arquivo de vídeo ou áudio em um arquivo de áudio para download — MP3, M4A, Opus, WAV ou FLAC. Diferente de /v1/parse/video, que devolve em JSON uma faixa otimizada para transcrição, este endpoint responde com o próprio áudio: estéreo, taxa de amostragem completa e bitrate à sua escolha. Custa 3 créditos por requisição.

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

Produza um arquivo em vez de texto. pdf: imagens e PDFs são combinados em um PDF na ordem de upload (fotos para PDF, mesclar PDFs), ou um arquivo único TXT/Markdown/HTML/Office é renderizado. docx: Markdown, texto, HTML, PDF, arquivos do Office, imagens e PDFs digitalizados (via OCR) tornam-se um documento do Word. xlsx/csv: todas as tabelas encontradas em um PDF, DOCX, HTML, CSV ou XLSX. png/jpg: páginas de PDF renderizadas em uma resolução escolhida ou conversão de formato de imagem. O corpo da resposta é o arquivo. 2 créditos por solicitação.

# 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

Analise e-book EPUB. Extrai texto organizado por capítulos.

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

Analise feed RSS ou Atom. Também suporta OPML via /v1/parse/opml.

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

Extraia texto de uma imagem com o engine OCR integrado. Suporta JPG, PNG, GIF, BMP, WebP, TIFF. Máx. 20MB.

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

Mesmo OCR que /v1/parse/image, tagged source_type "image_ocr". Páginas de PDF digitalizadas são automaticamente OCR'd por /v1/parse/auto/file.

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

SDKs

SDKs Oficiais

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

Agentes de IA

Servidor MCP

Use o ParseJet como um servidor MCP (Model Context Protocol) com Claude Code, Cursor ou qualquer agente de IA compatível com MCP.

Instalar

npm install -g @parsejet/mcp-server

Claude Code

Adicione ao .claude/settings.json do seu projeto:

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

Cursor

Vá para Configurações → Servidores MCP, adicione um novo servidor:

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

Claude.ai (Remoto)

Para o Claude.ai web, use o endpoint HTTP remoto — nenhuma instalação local necessária:

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

Vá para Claude.ai → Configurações → Integrações → Adicionar Servidor MCP → Insira a URL acima.

Ferramentas disponíveis

Limites de Taxa e Preços

O ParseJet usa um sistema baseado em créditos. Cada requisição consome créditos com base na complexidade do formato.

Os cabeçalhos de resposta incluem X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset e Retry-After em respostas 429.

Códigos de Erro

Todos os erros retornam JSON com os campos error e message.