legaleye התחל כאן · הקורפוס · EN reference ↗
API ציבורי JSON-over-HTTPS ללא LLM חיצוני ללא אימות לקריאה Rate-limited

legal-eye API

RAG משפטי דרך REST — שאילתות מילוליות מתוך פסיקה ישראלית, בלי הזיות.

legal-eye חושפת API ציבורי שמאפשר לבנות מעליה אפליקציות — צ'אטים משפטיים, סוכני BI לעורכי דין, אינטגרציות CRM, או פיצ'רים בתוך WordPress / Drupal / מערכת ניהול קיימת. התשובות מוחזרות מילה במילה מתוך פסקי דין אמיתיים, עם ציטוט מלא לפסיקה ולסעיף החוק.

ה-API אינו דורש מפתח לקריאה (read endpoints). הוא מוגבל בקצב על ידי IP, כדי למנוע שימוש לרעה. עבור שימוש מסחרי כבד או SLA, פנה אלינו דרך /contact/.

Playground אינטראקטיבי ↗ דוגמת curl מהירה ↓ תיעוד מלא באנגלית ↗

Base URL

https://legal-i-legal-eye.hf.space

Format: JSON request → JSON response. Encoding: UTF-8. Hebrew: native, RTL.

דוגמה מהירה

שאלה ב-curl, תשובה מילולית מתוך פסיקה:

curl -X POST https://legal-i-legal-eye.hf.space/v1/lawyer/ask \
  -H "Content-Type: application/json" \
  -d '{"question": "מהי חובת תום הלב במשא ומתן?"}'

תשובה (קוצרה):

{
  "qa_id": "qa_abc123",
  "answer": "סעיף 12 לחוק החוזים (חלק כללי) קובע ...",
  "sources": [
    {
      "case_name": "ע\"א 207/79 רביב נ' בית יולס",
      "section": "ס׳ 12",
      "quote": "צד הנמצא במשא ומתן ..."
    }
  ],
  "confidence": "high",
  "answered_at": "2026-05-26T12:00:00Z"
}

נקודות קצה ציבוריות

POST /v1/lawyer/ask

שאלה משפטית בעברית → תשובה verbatim מ-graph_bundle (פסק הדין המוביל). תומך בכל תחומי המשפט הישראלי.

Body: {"question": "string"}

Returns: qa_id, answer, sources[], confidence

POST /v1/lawyer/ask-stream

גרסת streaming של /ask — מחזיר SSE עם chunks (UI שלנו משתמש בה).

Body: {"question": "string"}

Content-Type: text/event-stream

GET /v1/lawyer/answer/{qa_id}

אחזור תשובה ספציפית לפי qa_id — שימושי לקישור עומק (deep-linking) ולשיתוף.

Path: qa_id מה-response של /ask

GET /v1/lawyer/popular

רשימת השאלות הפופולריות (אנונימיות, ללא PII). שימושי לבניית "התחל מכאן" באפליקציה שלך.

Query: ?limit=10 (אופציונלי)

GET /v1/ping

בדיקת חיים — מחזיר {"ok": true}. שימושי ל-health checks ו-uptime monitors.

GET /v1/judgments/{doc_id}/structured

פס״ד מובנה לפי doc_id — מחזיר sections עם icons + colors + תוויות דו-לשוניות (רקע / טענות / ratio / דיון / סעד).

Path: doc_id (URL-encoded, e.g. heb_caselaw/supreme/...)

GET /v1/judgments/{doc_id}/entities

NER — מחלץ ישויות: שופטים, צדדים, חוקים, פסיקה מאוזכרת.

GET /v1/judgments/{doc_id}/network

רשת ציטוטים של פס״ד יחיד — מצטט / מצוטט ע״י / קו-ציטוט.

GET /v1/laws/search

חיפוש סעיפי-חוק בקורפוס (~13K סעיפים, 18 חוקים). פלט: hits עם law_name, section, para_num, snippet.

Query: ?q=string&top=30

GET /v1/laws/popular

חוקים הכי מצוטטים בקורפוס לפי n_citers.

Query: ?top=40

GET /v1/citations/popular

ציטוטים הכי פופולריים בקורפוס. מסנן: kind=caselaw|statute.

Query: ?top_k=25&kind=caselaw

GET /v1/precedents/overruled

הלכות שבוטלו/סויגו — זיהוי אוטומטי ע״י סריקת ביטויים כמו "הלכה זו בוטלה".

GET /v1/stats/domains

פירוט תחומי משפט עם icons + colors + caselaw/statute split.

GET /v1/stats/judges

שופטים מובילים עם outcomes breakdown (accepted/rejected/partial).

Query: ?top_k=10

GET /v1/stats/outcomes

שיעור קבלה לפי תחום (פסיקות מסווגות בלבד).

GET /v1/corpus/inventory

פירוט מלא של הקורפוס: Tier A (אינדקס פעיל), Tier B (metadata). 749K+ מסמכים.

POST /v1/strategy/analyze

סינתזת אסטרטגיה — מקבל user_facts, מחזיר arguments_for_user/against, supporting_cases, missing_facts, detected_domain.

Body: {"user_facts": "string"}

POST /v1/classify

סיווג טקסט לתחום משפטי. מחזיר top + ranked עם label_he, icon, color, matched terms.

Body: {"text": "string"}

POST /v1/feedback/submit

משוב על תשובה. anonymous-friendly, IP rate-limited (5/min).

Body: {"message": "string", "kind": "bug|suggestion|praise", "rating": 1-5}

אימות וקצב בקשות

אימות: אין צורך במפתח לקריאה (/ask, /popular, /answer, /ping). מספיק לקרוא ב-HTTPS.

Rate limit: מגבלות per-IP מוגדרות בצד השרת ונאכפות אוטומטית. סטטוס 429 מוחזר במידה ועברת. עבור שימוש מסחרי כבד — דבר איתנו על SLA ייעודי.

שגיאות

400 — body לא תקין / question חסרה

404 — qa_id לא נמצא

429 — חרגת מ-rate limit

500 — שגיאת שרת (פתח issue)

503 — תחזוקה (זמני)

הברית המקצועית

legal-eye בנויה על verbatim-from-precedent: אין LLM שמייצר טקסט חופשי. כל תשובה היא ציטוט מילולי מתוך פסק דין ספציפי, עם הפניה לסעיף החוק. מתודולוגיה מלאה →

מה זה אומר עבורך כמפתח:

רוצה לבנות אינטגרציה עמוקה? דבר איתנו דרך /contact/ — אנחנו עוזרים לבנות PoC עם תיעוד מותאם, JSON Schemas, ודוגמאות SDK ב-Python / JS / PHP / Go.

תיעוד מלא באנגלית ↗ צור קשר לאינטגרציה