Dokumentasi

Dokumentasi ParseJet

ParseJet mengekstrak teks dari file atau URL apa pun. Satu panggilan API menangani PDF, DOCX, YouTube, halaman web, gambar, audio, video, dan 25+ format lainnya.

Mulai Cepat

Dapatkan hasil parse pertama Anda dalam waktu kurang dari 60 detik. Tidak perlu mendaftar.

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

Autentikasi

ParseJet menawarkan tiga tingkat akses. Anda dapat mulai menggunakan API segera tanpa autentikasi apa pun.

Konsep Inti

Format yang didukung

ParseJet mendeteksi format secara otomatis dari ekstensi file atau pola URL. Anda tidak perlu menentukan formatnya — cukup kirim file atau URL ke /v1/parse/auto dan ParseJet akan menangani sisanya.

Kredit

Setiap permintaan API menggunakan kredit berdasarkan kompleksitas format yang diurai. File teks sederhana berharga 1 kredit, sedangkan transkrip YouTube berharga 5. Kuota kredit bulanan Anda bergantung pada paket Anda.

Format keluaran

Secara default, ParseJet mengembalikan teks mentah yang diekstrak. Tambahkan ?output_format=markdown ke permintaan apa pun untuk mendapatkan keluaran pasca-proses dengan heading, daftar, tabel, dan blok kode yang terdeteksi.

Panduan

Parse PDF

Ekstrak teks dari file PDF apa pun, termasuk dokumen pindaian dan laporan multi-halaman.

Unggah file PDF

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

Konversi ke Markdown

Tambahkan output_format=markdown untuk mempertahankan struktur dokumen:

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

Panduan

Transkrip YouTube

Dapatkan transkrip lengkap dari video YouTube apa pun. Mendukung teks otomatis dalam 100+ bahasa.

Dapatkan transkrip

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

Tentukan bahasa

Gunakan parameter language untuk video non-Inggris:

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

Atau gunakan deteksi otomatis

Endpoint /v1/parse/auto/url secara otomatis mendeteksi 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"}'

Panduan

Web Scraping

Ekstrak konten utama dari halaman web apa pun. ParseJet secara otomatis menghapus navigasi, iklan, sidebar, dan boilerplate.

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

Panduan

Dokumen Office

Parse file Word (DOCX), Excel (XLSX), PowerPoint (PPTX), dan CSV. Cukup unggah file — ParseJet mendeteksi formatnya secara otomatis.

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

Spreadsheet sebagai JSON terstruktur

Tambahkan output_format=json untuk menerima baris CSV dan Excel sebagai array JSON berisi objek — baris header menjadi kunci, tipe angka dipertahankan.

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

Referensi API

Format Respons

Semua endpoint mengembalikan struktur JSON yang sama:

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

Endpoint yang direkomendasikan. Mendeteksi format secara otomatis dari ekstensi file atau tipe URL. Menerima file (multipart) atau url (form field), tidak keduanya.

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

Parse URL apa pun. Secara otomatis membedakan YouTube dari halaman web biasa.

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

Parse file yang diunggah apa pun. Mendeteksi format dari ekstensi file, fallback ke deteksi berbasis konten.

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

Ekstrak konten utama dari halaman web. Menghapus navigasi, iklan, dan boilerplate.

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

Ekstrak transkrip dari video YouTube. Metadata mencakup video_id, channel, dan durasi.

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

Transkripsi berkas audio MP3, WAV, M4A, OGG, FLAC atau WebM dengan pengenalan ucapan bawaan (berjalan di server kami). Maksimal 25 MB dan 5 menit audio per permintaan; respons membawa transkript plus segmen yang diberi waktu. 3 kredit.

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

Transkripsi video: trek audio diekstrak dan ditranskripsi di server kami. Mendukung MP4, MKV, AVI, MOV, WebM dan lainnya; hingga 5 menit audio per permintaan. 5 kredit.

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

Mengubah berkas video atau audio menjadi berkas audio yang bisa diunduh — MP3, M4A, Opus, WAV, atau FLAC. Berbeda dengan /v1/parse/video yang mengembalikan trek khusus transkripsi dalam JSON, endpoint ini mengembalikan audionya sendiri: stereo, sample rate penuh, dan bitrate pilihan Anda. Biaya 3 kredit per permintaan.

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

Hasilkan berkas bukan teks. pdf: gambar dan PDF digabungkan menjadi satu PDF sesuai urutan unggah (foto ke PDF, gabung PDF) atau berkas TXT/Markdown/HTML/Office tunggal dirender. docx: Markdown, teks, HTML, PDF, berkas Office, gambar dan PDF yang dipindai (via OCR) menjadi dokumen Word. xlsx/csv: setiap tabel yang ditemukan dalam PDF, DOCX, HTML, CSV atau XLSX. png/jpg: halaman PDF dirender pada resolusi yang dipilih atau konversi format gambar. Isi respons adalah berkas. 2 kredit per permintaan.

# 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

Parse ebook EPUB. Mengekstrak teks yang diatur berdasarkan bab.

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

Parse feed RSS atau Atom. Juga mendukung OPML via /v1/parse/opml.

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

Ekstrak teks dari gambar dengan mesin OCR bawaan. Mendukung JPG, PNG, GIF, BMP, WebP, TIFF. Maks. 20MB.

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

OCR yang sama seperti /v1/parse/image, sumber_type berlabel "image_ocr". Halaman PDF pindaian secara otomatis di-OCR oleh /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 Resmi

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

Agen AI

Server MCP

Gunakan ParseJet sebagai server MCP (Model Context Protocol) dengan Claude Code, Cursor, atau agen AI apa pun yang kompatibel dengan MCP.

Instal

npm install -g @parsejet/mcp-server

Claude Code

Tambahkan ke .claude/settings.json proyek Anda:

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

Cursor

Buka Settings → MCP Servers, tambahkan server baru:

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

Claude.ai (Remote)

Untuk Claude.ai web, gunakan endpoint HTTP remote — tidak perlu instalasi lokal:

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

Buka Claude.ai → Settings → Integrations → Add MCP Server → Masukkan URL di atas.

Alat yang tersedia

Batas Laju & Harga

ParseJet menggunakan sistem berbasis kredit. Setiap permintaan mengonsumsi kredit berdasarkan kompleksitas format.

Header respons menyertakan X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset, dan Retry-After pada respons 429.

Kode Kesalahan

Semua kesalahan mengembalikan JSON dengan bidang error dan message.