التوثيق

توثيق 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 تكتشف تلقائيًا روابط 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 (متعدد الأجزاء) أو 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 معروضة بدقة محددة أو تحويل تنسيق الصورة. نص الاستجابة هو الملف. رصيدان لكل طلب.

# 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 الممسوحة تُشغّل OCR تلقائيًا بـ /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 الرسمية

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

وكلاء الذكاء الاصطناعي

خادم MCP

استخدم ParseJet كخادم MCP (بروتوكول سياق النموذج) مع Claude Code أو Cursor أو أي وكيل ذكاء اصطناعي متوافق مع MCP.

التثبيت

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