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

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

Ses dosyalarını ayrıştırın. MP3, WAV, M4A, OGG, FLAC, WebM destekler. Maks. 25MB.

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

Transkripsiyon için videodan ses çıkarın. MP4, MKV, AVI, MOV, WebM destekler.

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

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örseli 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]" -F "prompt=Describe this image"

OCR ile görselden metin çıkarın.

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

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 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.