Dokümantasyon

ParseJet Dokümantasyonu

ParseJet, herhangi bir dosya veya URL'den metin çıkarır. Tek bir API çağrısı PDF, DOCX, YouTube, web sayfaları, görseller, ses, video ve 25+ formatı işler.

Hızlı Başlangıç

İlk ayrıştırma sonucunuzu 60 saniyeden kısa sürede alın. Kayıt gerekmez.

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

Kimlik Doğrulama

ParseJet üç erişim seviyesi sunar. API'yi herhangi bir kimlik doğrulama olmadan hemen kullanmaya başlayabilirsiniz.

Temel Kavramlar

Desteklenen formatlar

ParseJet, formatı dosya uzantısından veya URL deseninden otomatik olarak algılar. Formatı belirtmenize gerek yok — sadece dosyayı veya URL'yi /v1/parse/auto adresine gönderin, gerisini ParseJet halleder.

Krediler

Her API isteği, ayrıştırılan formatın karmaşıklığına göre kredi tüketir. Basit metin dosyaları 1 kredi, YouTube altyazıları ise 5 kredi maliyetindedir. Aylık kredi kotanız planınıza bağlıdır.

Çıktı formatı

Varsayılan olarak ParseJet ham, çıkarılmış metni döndürür. Algılanan başlıklar, listeler, tablolar ve kod blokları ile işlenmiş çıktı almak için herhangi bir isteğe ?output_format=markdown ekleyin.

Kılavuz

Bir PDF Ayrıştır

Taranmış belgeler ve çok sayfalı raporlar dahil olmak üzere herhangi bir PDF dosyasından metin çıkarın.

Bir PDF dosyası yükle

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

Markdown'a Dönüştür

Belge yapısını korumak için output_format=markdown ekleyin:

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

Kılavuz

YouTube Altyazıları

Herhangi bir YouTube videosunun tam altyazısını alın. 100+ dilde otomatik oluşturulmuş altyazıları destekler.

Bir altyazı al

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

Dil belirt

İngilizce olmayan videolar için language parametresini kullanın:

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

Veya otomatik algılamayı kullan

/v1/parse/auto/url endpoint'i YouTube URL'lerini otomatik olarak algılar:

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

Kılavuz

Web Kazıma

Herhangi bir web sayfasından ana içeriği çıkarın. ParseJet, navigasyonu, reklamları, kenar çubuklarını ve şablon metinleri otomatik olarak kaldırır.

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

Kılavuz

Ofis Belgeleri

Word (DOCX), Excel (XLSX), PowerPoint (PPTX) ve CSV dosyalarını ayrıştırın. Sadece dosyayı yükleyin — ParseJet formatı otomatik olarak algılar.

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

Tablolar yapılandırılmış JSON olarak

output_format=json ekleyin; CSV ve Excel satırları nesnelerden oluşan bir JSON dizisi olarak döner — başlık satırı anahtar olur, sayısal tipler korunur.

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

API Referansı

Yanıt Formatı

Tüm endpoint'ler aynı JSON yapısını döndürür:

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

Önerilen endpoint. Dosya uzantısından veya URL türünden formatı otomatik algılar. file (multipart) veya url (form alanı) kabul eder, ikisi birden değil.

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

Herhangi bir URL'yi ayrıştırın. YouTube'u normal web sayfalarından otomatik olarak ayırt eder.

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

Yüklenen herhangi bir dosyayı ayrıştırın. Formatı dosya uzantısından algılar, içerik tabanlı algılamaya yedeklenir.

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

Bir web sayfasından ana içeriği çıkarın. Navigasyonu, reklamları ve şablon metinleri kaldırır.

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

Bir YouTube videosundan transkript çıkarın. Meta veriler video_id, kanal ve süreyi içerir.

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 veya WebM ses dosyalarını transkripsiyon yapın. Yerleşik konuşma tanıma kullanılır (sunucularımızda çalışır). En fazla 25 MB ve istek başına 5 dakika ses; yanıt transkript ve zaman damgasıyla ayrılmış segmentleri içerir. 3 kredi.

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

Bir videoyu transkripsiyon yapın: ses izi çıkarılır ve sunucularımızda transkripsiyon yapılır. MP4, MKV, AVI, MOV, WebM ve diğerlerini destekler; istek başına en fazla 5 dakika ses. 5 kredi.

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

Bir video veya ses dosyasını indirilebilir bir ses dosyasına dönüştürür — MP3, M4A, Opus, WAV veya FLAC. Deşifre için optimize edilmiş parçayı JSON olarak döndüren /v1/parse/video'nun aksine bu uç nokta sesin kendisini döndürür: stereo, tam örnekleme hızı ve seçtiğiniz bit hızı. İstek başına 3 kredi.

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

Metin yerine bir dosya üretin. pdf: resimler ve PDF'ler karşıya yükleme sırasına göre bir PDF'de birleştirilir (fotoğrafları PDF'ye, PDF'leri birleştir) veya tek bir TXT/Markdown/HTML/Office dosyası işlenir. docx: Markdown, metin, HTML, PDF, Office dosyaları, resimler ve taranmış PDF'ler (OCR aracılığıyla) bir Word belgesine dönüşür. xlsx/csv: bir PDF, DOCX, HTML, CSV veya XLSX'te bulunan her tablo. png/jpg: seçilen çözünürlükte PDF sayfaları veya görüntü formatı dönüştürmesi. Yanıt gövdesi dosyadır. İstek başına 2 kredi.

# 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 e-kitabını ayrıştırın. Metni bölümlere göre düzenlenmiş şekilde çıkarır.

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

RSS veya Atom beslemesini ayrıştırın. Ayrıca /v1/parse/opml üzerinden OPML destekler.

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

Görüntü analiz edin, JPG, PNG, GIF, BMP, WebP, TIFF destekler. Maks. 20MB.

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

Görselden metin çıkarın, OCR ile. Taranmış PDF sayfaları /v1/parse/auto/file tarafından otomatik olarak OCR'lenir.

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

SDK'lar

Resmi SDK'lar

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 Ajanları

MCP Sunucusu

ParseJet'ı Claude Code, Cursor veya herhangi bir MCP uyumlu AI ajanı ile bir MCP (Model Context Protocol) sunucusu olarak kullanın.

Kurulum

npm install -g @parsejet/mcp-server

Claude Code

Projenizin .claude/settings.json dosyasına ekleyin:

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

Cursor

Ayarlar → MCP Sunucuları'na gidin, yeni bir sunucu ekleyin:

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

Claude.ai (Uzak)

Claude.ai web için, uzak HTTP endpoint'ini kullanın — yerel kurulum gerekmez:

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

Claude.ai → Ayarlar → Entegrasyonlar → MCP Sunucusu Ekle → Yukarıdaki URL'yi girin.

Kullanılabilir araçlar

Oran Sınırları & Fiyatlandırma

ParseJet, kredi tabanlı bir sistem kullanır. Her istek, format karmaşıklığına göre kredi tüketir.

Yanıt başlıkları, 429 yanıtlarında X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset ve Retry-After içerir.

Hata Kodları

Tüm hatalar, error ve message alanları içeren bir JSON döndürür.