diff --git a/docs/openAPI.json b/docs/openAPI.json index f2f360f1f4..7d069cf9aa 100644 --- a/docs/openAPI.json +++ b/docs/openAPI.json @@ -1,13203 +1,13267 @@ { - "openapi": "3.0.2", - "info": { - "title": "Sefaria API", - "version": "1.0.0", - "description": "The Sefaria API endpoints allows live access to Sefaria's structured database of Jewish texts and their interconnections.", - "contact": { - "url": "https://www.sefaria.org", - "email": "developers@sefaria.org" - }, - "license": { - "name": "GNU AGPLv3", - "url": "https://www.gnu.org/licenses/agpl.txt" - } + "openapi": "3.0.2", + "info": { + "title": "Sefaria API", + "version": "1.0.0", + "description": "The Sefaria API endpoints allows live access to Sefaria's structured database of Jewish texts and their interconnections.", + "contact": { + "url": "https://www.sefaria.org", + "email": "developers@sefaria.org" }, - "servers": [ - { - "url": "https://www.sefaria.org/", - "description": "" - } - ], - "paths": { - "/api/v3/texts/{tref}": { - "summary": "v3 Texts", - "description": "The most up-to-date way to retrieve Sefaria texts, with language data that can handle displaying a right-to-left text with a right-to-left translation. ", - "get": { - "tags": [ - "Text" - ], - "responses": { - "200": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/v3TextsJson" - }, - "examples": { - "Esther 1.1": { - "value": { - "versions": [ - { - "status": "locked", - "priority": 2, - "license": "CC-BY-SA", - "versionNotes": "Miqra According to the Masorah (MAM) is a digital Hebrew edition of the Tanakh based on the Aleppo Codex and related manuscripts. It is designed for readers, and as such it contains added elements to aid vocalization of the text. For instance: When an accent is marked in an unstressed syllable, an extra accent is added in the proper place (pashta, zarqa, segol, telisha). Legarmeih and paseq are visibly distinguished. Qamaz qatan is indicated by its designated Unicode character (alternatives are documented where traditions differ about its application).
The text of MAM is fully documented. The complete introduction to the edition (Hebrew) explains the types of editorial decisions that have been made and the reasons for them (English abstract). In addition, every word in the Bible about which there is some textual concern or ambiguity includes a documentation note; these notes can be viewed conveniently here. If an error is discovered, it may be reported to User:Dovi at Hebrew Wikisource. Please check the documentation notes before reporting an error.", - "formatAsPoetry": "", - "digitizedBySefaria": "", - "method": "", - "heversionSource": "", - "versionUrl": "", - "versionTitleInHebrew": "מקרא על פי המסורה", - "versionNotesInHebrew": "", - "shortVersionTitle": "", - "shortVersionTitleInHebrew": "", - "extendedNotes": "", - "extendedNotesHebrew": "", - "purchaseInformationImage": "", - "purchaseInformationURL": "", - "hasManuallyWrappedRefs": "", - "actualLanguage": "he", - "languageFamilyName": "hebrew", - "isBaseText": true, - "isSource": true, - "isPrimary": true, - "direction": "rtl", - "language": "he", - "versionSource": "https://he.wikisource.org/wiki/%D7%9E%D7%A9%D7%AA%D7%9E%D7%A9:Dovi/%D7%9E%D7%A7%D7%A8%D7%90_%D7%A2%D7%9C_%D7%A4%D7%99_%D7%94%D7%9E%D7%A1%D7%95%D7%A8%D7%94", - "versionTitle": "Miqra according to the Masorah", - "text": "וַיְהִ֖י בִּימֵ֣י אֲחַשְׁוֵר֑וֹשׁ ה֣וּא אֲחַשְׁוֵר֗וֹשׁ הַמֹּלֵךְ֙ מֵהֹ֣דּוּ וְעַד־כּ֔וּשׁ שֶׁ֛בַע וְעֶשְׂרִ֥ים וּמֵאָ֖ה מְדִינָֽה׃" - } - ], - "available_versions": [ - { - "status": "locked", - "priority": 2, - "license": "CC-BY-SA", - "versionNotes": "Miqra According to the Masorah (MAM) is a digital Hebrew edition of the Tanakh based on the Aleppo Codex and related manuscripts. It is designed for readers, and as such it contains added elements to aid vocalization of the text. For instance: When an accent is marked in an unstressed syllable, an extra accent is added in the proper place (pashta, zarqa, segol, telisha). Legarmeih and paseq are visibly distinguished. Qamaz qatan is indicated by its designated Unicode character (alternatives are documented where traditions differ about its application).
The text of MAM is fully documented. The complete introduction to the edition (Hebrew) explains the types of editorial decisions that have been made and the reasons for them (English abstract). In addition, every word in the Bible about which there is some textual concern or ambiguity includes a documentation note; these notes can be viewed conveniently here. If an error is discovered, it may be reported to User:Dovi at Hebrew Wikisource. Please check the documentation notes before reporting an error.", - "formatAsPoetry": "", - "digitizedBySefaria": "", - "method": "", - "heversionSource": "", - "versionUrl": "", - "versionTitleInHebrew": "מקרא על פי המסורה", - "versionNotesInHebrew": "", - "shortVersionTitle": "", - "shortVersionTitleInHebrew": "", - "extendedNotes": "", - "extendedNotesHebrew": "", - "purchaseInformationImage": "", - "purchaseInformationURL": "", - "hasManuallyWrappedRefs": "", - "actualLanguage": "he", - "languageFamilyName": "hebrew", - "isBaseText": true, - "isSource": true, - "isPrimary": true, - "direction": "rtl", - "language": "he", - "title": "Esther", - "versionSource": "https://he.wikisource.org/wiki/%D7%9E%D7%A9%D7%AA%D7%9E%D7%A9:Dovi/%D7%9E%D7%A7%D7%A8%D7%90_%D7%A2%D7%9C_%D7%A4%D7%99_%D7%94%D7%9E%D7%A1%D7%95%D7%A8%D7%94", - "versionTitle": "Miqra according to the Masorah" - }, - { - "status": "locked", - "priority": 2, - "license": "CC-BY-NC", - "versionNotes": "", - "formatAsPoetry": "", - "digitizedBySefaria": "", - "method": "", - "heversionSource": "", - "versionUrl": "", - "versionTitleInHebrew": "", - "versionNotesInHebrew": "", - "shortVersionTitle": "JPS, 1985", - "shortVersionTitleInHebrew": "", - "extendedNotes": "", - "extendedNotesHebrew": "", - "purchaseInformationImage": "https://storage.googleapis.com/sefaria-physical-editions/JPS_1985.png", - "purchaseInformationURL": "https://www.nebraskapress.unl.edu/jps/9780827602526/", - "hasManuallyWrappedRefs": "", - "actualLanguage": "en", - "languageFamilyName": "english", - "isBaseText": false, - "isSource": false, - "isPrimary": "", - "direction": "ltr", - "language": "en", - "title": "Esther", - "versionSource": "https://jps.org/books/tanakh-the-holy-scriptures-blue/", - "versionTitle": "Tanakh: The Holy Scriptures, published by JPS" - }, - { - "status": "locked", - "priority": 1, - "license": "Public Domain", - "versionNotes": "This 1917 translation by the Jewish Publication Society is in the public domain. JPS graciously shared digital images of this text with the Open Siddur Project, from which the text was imported by Sefaria.", - "formatAsPoetry": "", - "digitizedBySefaria": "", - "method": "", - "heversionSource": "", - "versionUrl": "", - "versionTitleInHebrew": "כתבי הקודש: תרגום חדש (1917 JPS)", - "versionNotesInHebrew": "תרגום JPS 1917 קיים בנחלת הכלל. הסריקות באדיבות JPS. שעתוק הטקסט תודות לפרויקט Open Siddur, משם יובא הטקסט למאגר ספריא", - "shortVersionTitle": "JPS 1917", - "shortVersionTitleInHebrew": "", - "extendedNotes": "", - "extendedNotesHebrew": "", - "purchaseInformationImage": "", - "purchaseInformationURL": "", - "hasManuallyWrappedRefs": "", - "actualLanguage": "en", - "languageFamilyName": "english", - "isBaseText": false, - "isSource": false, - "isPrimary": "", - "direction": "ltr", - "language": "en", - "title": "Esther", - "versionSource": "http://opensiddur.org/2010/08/%D7%AA%D7%A0%D7%B4%D7%9A-the-holy-scriptures-a-new-translation-jps-1917/", - "versionTitle": "The Holy Scriptures: A New Translation (JPS 1917)" - }, - { - "status": "locked", - "priority": 1, - "license": "Public Domain", - "versionNotes": "", - "formatAsPoetry": "", - "digitizedBySefaria": "", - "method": "", - "heversionSource": "", - "versionUrl": "", - "versionTitleInHebrew": "תנ״ך מלווה בטעמי מקרא", - "versionNotesInHebrew": "", - "shortVersionTitle": "", - "shortVersionTitleInHebrew": "", - "extendedNotes": "", - "extendedNotesHebrew": "", - "purchaseInformationImage": "", - "purchaseInformationURL": "", - "hasManuallyWrappedRefs": "", - "actualLanguage": "he", - "languageFamilyName": "hebrew", - "isBaseText": true, - "isSource": true, - "isPrimary": true, - "direction": "rtl", - "language": "he", - "title": "Esther", - "versionSource": "http://www.tanach.us/Tanach.xml", - "versionTitle": "Tanach with Ta'amei Hamikra" - }, - { - "status": "locked", - "priority": "", - "license": "Public Domain", - "versionNotes": "", - "formatAsPoetry": "", - "digitizedBySefaria": "", - "method": "", - "heversionSource": "", - "versionUrl": "", - "versionTitleInHebrew": "תנ״ך - טקסט בלבד", - "versionNotesInHebrew": "", - "shortVersionTitle": "", - "shortVersionTitleInHebrew": "", - "extendedNotes": "", - "extendedNotesHebrew": "", - "purchaseInformationImage": "", - "purchaseInformationURL": "", - "hasManuallyWrappedRefs": "", - "actualLanguage": "he", - "languageFamilyName": "hebrew", - "isBaseText": true, - "isSource": true, - "isPrimary": true, - "direction": "rtl", - "language": "he", - "title": "Esther", - "versionSource": "http://www.tanach.us/Tanach.xml", - "versionTitle": "Tanach with Text Only" - }, - { - "status": "locked", - "priority": "", - "license": "Public Domain", - "versionNotes": "", - "formatAsPoetry": "", - "digitizedBySefaria": "", - "method": "", - "heversionSource": "", - "versionUrl": "", - "versionTitleInHebrew": "תנ״ך עם ניקוד", - "versionNotesInHebrew": "", - "shortVersionTitle": "", - "shortVersionTitleInHebrew": "", - "extendedNotes": "", - "extendedNotesHebrew": "", - "purchaseInformationImage": "", - "purchaseInformationURL": "", - "hasManuallyWrappedRefs": "", - "actualLanguage": "he", - "languageFamilyName": "hebrew", - "isBaseText": true, - "isSource": true, - "isPrimary": true, - "direction": "rtl", - "language": "he", - "title": "Esther", - "versionSource": "http://www.tanach.us/Tanach.xml", - "versionTitle": "Tanach with Nikkud" - }, - { - "status": "", - "priority": "", - "license": "", - "versionNotes": "", - "formatAsPoetry": "", - "digitizedBySefaria": "", - "method": "", - "heversionSource": "", - "versionUrl": "", - "versionTitleInHebrew": "תרגום קהילת ספריא", - "versionNotesInHebrew": "", - "shortVersionTitle": "", - "shortVersionTitleInHebrew": "", - "extendedNotes": "", - "extendedNotesHebrew": "", - "purchaseInformationImage": "", - "purchaseInformationURL": "", - "hasManuallyWrappedRefs": "", - "actualLanguage": "en", - "languageFamilyName": "english", - "isBaseText": false, - "isSource": false, - "isPrimary": "", - "direction": "ltr", - "language": "en", - "title": "Esther", - "versionSource": "https://www.sefaria.org", - "versionTitle": "Sefaria Community Translation" - }, - { - "status": "locked", - "priority": "", - "license": "CC-BY", - "versionNotes": "To enhance the quality of this text, obvious translation errors were corrected in accordance with the Hebrew source", - "formatAsPoetry": "", - "digitizedBySefaria": "", - "method": "", - "heversionSource": "", - "versionUrl": "", - "versionTitleInHebrew": "כתובים' על פי רש״י, רבי שרגא זילברשטיין", - "versionNotesInHebrew": "כדי לשפר את איכות הטקסט הזה, שונו שגיאות תרגום ברורות בהתאם למקור העברי", - "shortVersionTitle": "", - "shortVersionTitleInHebrew": "", - "extendedNotes": "", - "extendedNotesHebrew": "", - "purchaseInformationImage": "", - "purchaseInformationURL": "", - "hasManuallyWrappedRefs": "", - "actualLanguage": "en", - "languageFamilyName": "english", - "isBaseText": false, - "isSource": false, - "isPrimary": "", - "direction": "ltr", - "language": "en", - "title": "Esther", - "versionSource": "http://www.sefaria.org/shraga-silverstein", - "versionTitle": "The Rashi Ketuvim by Rabbi Shraga Silverstein" - }, - { - "status": "locked", - "priority": "", - "license": "CC-BY-NC", - "versionNotes": "", - "formatAsPoetry": "", - "digitizedBySefaria": "", - "method": "", - "heversionSource": "", - "versionUrl": "", - "versionTitleInHebrew": "", - "versionNotesInHebrew": "", - "shortVersionTitle": "", - "shortVersionTitleInHebrew": "", - "extendedNotes": "", - "extendedNotesHebrew": "", - "purchaseInformationImage": "https://storage.googleapis.com/sefaria-physical-editions/9f4b3fedfe5a8889a3a7b3b7f3022091.png", - "purchaseInformationURL": "https://korenpub.com/collections/tanakh", - "hasManuallyWrappedRefs": "", - "actualLanguage": "en", - "languageFamilyName": "english", - "isBaseText": false, - "isSource": false, - "isPrimary": "", - "direction": "ltr", - "language": "en", - "title": "Esther", - "versionSource": "https://www.korenpub.com/koren_en_usd/koren/tanakh-bible/the-koren-jerusalem-bible.html", - "versionTitle": "The Koren Jerusalem Bible" - }, - { - "status": "locked", - "priority": "", - "license": "CC-BY", - "versionNotes": "", - "formatAsPoetry": "", - "digitizedBySefaria": "", - "method": "", - "heversionSource": "", - "versionUrl": "", - "versionTitleInHebrew": "", - "versionNotesInHebrew": "", - "shortVersionTitle": "", - "shortVersionTitleInHebrew": "", - "extendedNotes": "", - "extendedNotesHebrew": "", - "purchaseInformationImage": "https://storage.googleapis.com/sefaria-physical-editions/958565938f3a7ed617834d467ac93c9f.png", - "purchaseInformationURL": "https://www.israelbookshoppublications.com/store/pc/Metsudah-Five-Megilloth-w-Rashi-26p309.htm", - "hasManuallyWrappedRefs": "", - "actualLanguage": "en", - "languageFamilyName": "english", - "isBaseText": false, - "isSource": false, - "isPrimary": "", - "direction": "ltr", - "language": "en", - "title": "Esther", - "versionSource": "https://www.judaicaplace.com/search/brand/Metsudah-Publications/", - "versionTitle": "The Metsudah Five Megillot, Lakewood, N.J., 2001" - }, - { - "status": "locked", - "priority": "", - "license": "CC-BY", - "versionNotes": "", - "formatAsPoetry": "", - "digitizedBySefaria": "", - "method": "", - "heversionSource": "", - "versionUrl": "", - "versionTitleInHebrew": "חמש מגילות, הוצאת 'מצודה', לייקווד תשס\"א", - "versionNotesInHebrew": "", - "shortVersionTitle": "", - "shortVersionTitleInHebrew": "", - "extendedNotes": "", - "extendedNotesHebrew": "", - "purchaseInformationImage": "https://storage.googleapis.com/sefaria-physical-editions/232433ac3323606604f21e0c70f0c061.png", - "purchaseInformationURL": "https://www.israelbookshoppublications.com/store/pc/Metsudah-Five-Megilloth-w-Rashi-26p309.htm", - "hasManuallyWrappedRefs": "", - "actualLanguage": "he", - "languageFamilyName": "hebrew", - "isBaseText": true, - "isSource": true, - "isPrimary": true, - "direction": "rtl", - "language": "he", - "title": "Esther", - "versionSource": "https://www.judaicaplace.com/search/brand/Metsudah-Publications/", - "versionTitle": "The Metsudah Five Megillot, Lakewood, N.J., 2001" - }, - { - "status": "locked", - "priority": "", - "license": "", - "versionNotes": "", - "formatAsPoetry": "", - "digitizedBySefaria": "", - "method": "", - "heversionSource": "", - "versionUrl": "", - "versionTitleInHebrew": "מגילת אסתר - מהדורה פורימית!!", - "versionNotesInHebrew": "", - "shortVersionTitle": "", - "shortVersionTitleInHebrew": "", - "extendedNotes": "", - "extendedNotesHebrew": "", - "purchaseInformationImage": "", - "purchaseInformationURL": "", - "hasManuallyWrappedRefs": "", - "actualLanguage": "he", - "languageFamilyName": "hebrew", - "isBaseText": true, - "isSource": true, - "isPrimary": true, - "direction": "rtl", - "language": "he", - "title": "Esther", - "versionSource": "https://www.sefaria.org", - "versionTitle": "Megillat Esther - Purim Edition!!" - }, - { - "status": "locked", - "priority": "", - "license": "Public Domain", - "versionNotes": "", - "formatAsPoetry": "", - "digitizedBySefaria": "", - "method": "", - "heversionSource": "", - "versionUrl": "", - "versionTitleInHebrew": "", - "versionNotesInHebrew": "", - "shortVersionTitle": "", - "shortVersionTitleInHebrew": "", - "extendedNotes": "", - "extendedNotesHebrew": "", - "purchaseInformationImage": "", - "purchaseInformationURL": "", - "hasManuallyWrappedRefs": "", - "actualLanguage": "fr", - "languageFamilyName": "french", - "isBaseText": false, - "isSource": false, - "isPrimary": "", - "direction": "ltr", - "language": "en", - "title": "Esther", - "versionSource": "https://fr.wikisource.org/wiki/Bible_du_Rabbinat_1899", - "versionTitle": "Bible du Rabbinat 1899 [fr]" - }, - { - "status": "", - "priority": "", - "license": "CC0", - "versionNotes": "", - "formatAsPoetry": "", - "digitizedBySefaria": "", - "method": "", - "heversionSource": "", - "versionUrl": "", - "versionTitleInHebrew": "מגילת אמוג'י", - "versionNotesInHebrew": "", - "shortVersionTitle": "", - "shortVersionTitleInHebrew": "", - "extendedNotes": "", - "extendedNotesHebrew": "", - "purchaseInformationImage": "", - "purchaseInformationURL": "", - "hasManuallyWrappedRefs": "", - "actualLanguage": "he", - "languageFamilyName": "hebrew", - "isBaseText": true, - "isSource": true, - "isPrimary": true, - "direction": "rtl", - "language": "he", - "title": "Esther", - "versionSource": "https://www.sefaria.org", - "versionTitle": "Emoji Megillah" - }, - { - "status": "", - "priority": "", - "license": "CC0", - "versionNotes": "", - "formatAsPoetry": "", - "digitizedBySefaria": "", - "method": "", - "heversionSource": "", - "versionUrl": "", - "versionTitleInHebrew": "", - "versionNotesInHebrew": "", - "shortVersionTitle": "", - "shortVersionTitleInHebrew": "", - "extendedNotes": "", - "extendedNotesHebrew": "", - "purchaseInformationImage": "", - "purchaseInformationURL": "", - "hasManuallyWrappedRefs": "", - "actualLanguage": "en", - "languageFamilyName": "english", - "isBaseText": false, - "isSource": false, - "isPrimary": "", - "direction": "ltr", - "language": "en", - "title": "Esther", - "versionSource": "https://www.sefaria.org", - "versionTitle": "Emoji Megillah" - }, - { - "status": "", - "priority": "", - "license": "Public Domain", - "versionNotes": "", - "formatAsPoetry": "", - "digitizedBySefaria": "", - "method": "", - "heversionSource": "", - "versionUrl": "", - "versionTitleInHebrew": "", - "versionNotesInHebrew": "", - "shortVersionTitle": "Izaak Cylkow, 1841 - 1908 ", - "shortVersionTitleInHebrew": "", - "extendedNotes": "", - "extendedNotesHebrew": "", - "purchaseInformationImage": "", - "purchaseInformationURL": "", - "hasManuallyWrappedRefs": "", - "actualLanguage": "pl", - "languageFamilyName": "polish", - "isBaseText": false, - "isSource": false, - "isPrimary": "", - "direction": "ltr", - "language": "en", - "title": "Esther", - "versionSource": "http://bibliepolskie.pl/", - "versionTitle": "Bible in Polish, trans. Izaak Cylkow, 1841 - 1908 [pl]" - }, - { - "status": "", - "priority": "", - "license": "Public Domain", - "versionNotes": "", - "formatAsPoetry": "", - "digitizedBySefaria": "", - "method": "", - "heversionSource": "", - "versionUrl": "", - "versionTitleInHebrew": "", - "versionNotesInHebrew": "", - "shortVersionTitle": "", - "shortVersionTitleInHebrew": "", - "extendedNotes": "", - "extendedNotesHebrew": "", - "purchaseInformationImage": "", - "purchaseInformationURL": "", - "hasManuallyWrappedRefs": "", - "actualLanguage": "it", - "languageFamilyName": "italian", - "isBaseText": false, - "isSource": false, - "isPrimary": "", - "direction": "ltr", - "language": "en", - "title": "Esther", - "versionSource": "http://www.archivio-torah.it", - "versionTitle": "Ester. Traduzione italiana di Samuel David Luzzatto, 1872 [it]" - }, - { - "status": "", - "priority": "", - "license": "", - "versionNotes": "", - "formatAsPoetry": "", - "digitizedBySefaria": "", - "method": "", - "heversionSource": "", - "versionUrl": "", - "versionTitleInHebrew": "", - "versionNotesInHebrew": "", - "shortVersionTitle": "", - "shortVersionTitleInHebrew": "", - "extendedNotes": "", - "extendedNotesHebrew": "", - "purchaseInformationImage": "", - "purchaseInformationURL": "", - "hasManuallyWrappedRefs": "", - "actualLanguage": "fa", - "languageFamilyName": "persian", - "isBaseText": false, - "isSource": false, - "isPrimary": "", - "direction": "rtl", - "language": "he", - "title": "Esther", - "versionSource": "http://www.iranjewish.com/megilla/megilla_main.htm", - "versionTitle": "Book of Esther in Farsi, trans. by Pole-Choubi, synagogue Talmood Torah [fa]" - }, - { - "status": "", - "priority": "", - "license": "", - "versionNotes": "", - "formatAsPoetry": "", - "digitizedBySefaria": "", - "method": "", - "heversionSource": "", - "versionUrl": "", - "versionTitleInHebrew": "", - "versionNotesInHebrew": "", - "shortVersionTitle": "", - "shortVersionTitleInHebrew": "", - "extendedNotes": "", - "extendedNotesHebrew": "", - "purchaseInformationImage": "", - "purchaseInformationURL": "", - "hasManuallyWrappedRefs": "", - "actualLanguage": "fa", - "languageFamilyName": "persian", - "isBaseText": false, - "isSource": false, - "isPrimary": "", - "direction": "ltr", - "language": "en", - "title": "Esther", - "versionSource": "http://www.iranjewish.com/megilla/megilla_main.htm", - "versionTitle": "Book of Esther in Farsi, trans. by Pole-Choubi, synagogue Talmood Torah, LTR [fa]" - }, - { - "status": "", - "priority": "", - "license": "Public Domain", - "versionNotes": "This 1941 translation published by Yehoʼash Farlag Gezelshaft is in the public domain. A transcribed digitized version was produced by Itsik \"Robert\" Goldenberg, et al, by the Yehoyesh Project (1998-2006) under the direction of Leonard Prager. That version was graciously shared with the Open Siddur Project, from which the text was imported by Sefaria.", - "formatAsPoetry": "", - "digitizedBySefaria": "", - "method": "", - "heversionSource": "", - "versionUrl": "", - "versionTitleInHebrew": "", - "versionNotesInHebrew": "", - "shortVersionTitle": "", - "shortVersionTitleInHebrew": "", - "extendedNotes": "", - "extendedNotesHebrew": "", - "purchaseInformationImage": "", - "purchaseInformationURL": "", - "hasManuallyWrappedRefs": "", - "actualLanguage": "yi", - "languageFamilyName": "yiddish", - "isBaseText": false, - "isSource": false, - "isPrimary": "", - "direction": "rtl", - "language": "he", - "title": "Esther", - "versionSource": "http://opensiddur.org/praxes/study/yehoyeshs-yiddish-translation-of-the-tanakh/", - "versionTitle": "Yehoyesh's Yiddish Tanakh Translation [yi]" - }, - { - "status": "locked", - "priority": "", - "license": "", - "versionNotes": "Translator: Marion Kaufmann, based on german translations of Tur-Sinai, Martín Buber and Franz Rosenzwig
Review and correction: Manes Kogan
Final Review: Batia Dorfman", - "formatAsPoetry": "", - "digitizedBySefaria": "", - "method": "", - "heversionSource": "", - "versionUrl": "", - "versionTitleInHebrew": "", - "versionNotesInHebrew": "", - "shortVersionTitle": "", - "shortVersionTitleInHebrew": "", - "extendedNotes": "", - "extendedNotesHebrew": "", - "purchaseInformationImage": "", - "purchaseInformationURL": "", - "hasManuallyWrappedRefs": "", - "actualLanguage": "es", - "languageFamilyName": "spanish", - "isBaseText": false, - "isSource": false, - "isPrimary": "", - "direction": "ltr", - "language": "en", - "title": "Esther", - "versionSource": "https://www.seminariorabinico.org/wp-content/uploads/El-libro-de-Ester-Meguila-Ester.pdf", - "versionTitle": "El libro de Ester - Meguila Ester - Seminario Rabínico [es]" - }, - { - "status": "", - "priority": "", - "license": "", - "versionNotes": "", - "formatAsPoetry": "", - "digitizedBySefaria": "", - "method": "", - "heversionSource": "", - "versionUrl": "", - "versionTitleInHebrew": "", - "versionNotesInHebrew": "", - "shortVersionTitle": "Samuel Cahen, 1831 ", - "shortVersionTitleInHebrew": "", - "extendedNotes": "", - "extendedNotesHebrew": "", - "purchaseInformationImage": "", - "purchaseInformationURL": "", - "hasManuallyWrappedRefs": "", - "actualLanguage": "fr", - "languageFamilyName": "french", - "isBaseText": false, - "isSource": false, - "isPrimary": "", - "direction": "ltr", - "language": "en", - "title": "Esther", - "versionSource": "https://www.levangile.com/Bible-CAH-1-1-1-complet-Contexte-oui.htm", - "versionTitle": "La Bible, Traduction Nouvelle, Samuel Cahen, 1831 [fr]" - }, - { - "status": "locked", - "priority": "", - "license": "Public Domain", - "versionNotes": "", - "formatAsPoetry": "", - "digitizedBySefaria": "", - "method": "", - "heversionSource": "", - "versionUrl": "", - "versionTitleInHebrew": "", - "versionNotesInHebrew": "", - "shortVersionTitle": "", - "shortVersionTitleInHebrew": "", - "extendedNotes": "", - "extendedNotesHebrew": "", - "purchaseInformationImage": "", - "purchaseInformationURL": "", - "hasManuallyWrappedRefs": "", - "actualLanguage": "eo", - "languageFamilyName": "esperanto", - "isBaseText": false, - "isSource": false, - "isPrimary": "", - "direction": "ltr", - "language": "en", - "title": "Esther", - "versionSource": "https://eo.wikisource.org/wiki/Malnova_Testamento_(Zamenhof)/Ester/1", - "versionTitle": "La Malnova Testamento, L.L.Zamenhof [eo]" - }, - { - "status": "", - "priority": "", - "license": "", - "versionNotes": "Digitized by Chajm Guski and Marina Struse", - "formatAsPoetry": "", - "digitizedBySefaria": "", - "method": "", - "heversionSource": "", - "versionUrl": "", - "versionTitleInHebrew": "", - "versionNotesInHebrew": "", - "shortVersionTitle": "", - "shortVersionTitleInHebrew": "", - "extendedNotes": "", - "extendedNotesHebrew": "", - "purchaseInformationImage": "", - "purchaseInformationURL": "", - "hasManuallyWrappedRefs": "", - "actualLanguage": "de", - "languageFamilyName": "german", - "isBaseText": false, - "isSource": false, - "isPrimary": "", - "direction": "ltr", - "language": "en", - "title": "Esther", - "versionSource": "https://www.talmud.de/tlmd/tanach/", - "versionTitle": "Die Heilige Schrift, trans. Dr. Simon Bernfeld, Berlin, 1902 - German [de]" - }, - { - "status": "locked", - "priority": "", - "license": "PD", - "versionNotes": "", - "formatAsPoetry": "", - "digitizedBySefaria": true, - "method": "", - "heversionSource": "", - "versionUrl": "", - "versionTitleInHebrew": "", - "versionNotesInHebrew": "", - "shortVersionTitle": "", - "shortVersionTitleInHebrew": "", - "extendedNotes": "", - "extendedNotesHebrew": "", - "purchaseInformationImage": "", - "purchaseInformationURL": "", - "hasManuallyWrappedRefs": "", - "actualLanguage": "he", - "languageFamilyName": "hebrew", - "isBaseText": "", - "isSource": true, - "isPrimary": true, - "direction": "rtl", - "language": "he", - "title": "Esther", - "versionSource": "https://he.wikisource.org/wiki/%D7%9E%D7%A7%D7%A8%D7%90_%D7%9E%D7%91%D7%95%D7%90%D7%A8", - "versionTitle": "Miqra Mevoar, trans. and edited by David Kokhav, Jerusalem 2020" - }, - { - "status": "", - "priority": "", - "license": "", - "versionNotes": "Read the Preface to the Revised JPS Edition\n

\nRead the Notes on Gender in Translation for the Revised JPS Edition\n

\nRead a Commentary on the Hebrew word 'ish in the Revised JPS Edition", - "formatAsPoetry": "", - "digitizedBySefaria": "", - "method": "", - "heversionSource": "", - "versionUrl": "", - "versionTitleInHebrew": "", - "versionNotesInHebrew": "", - "shortVersionTitle": "Revised JPS, 2023", - "shortVersionTitleInHebrew": "", - "extendedNotes": "", - "extendedNotesHebrew": "", - "purchaseInformationImage": "https://storage.googleapis.com/sefaria-physical-editions/JPS-Tanakh-Gender-Sensitive-Edition-Cover-300x450.jpg", - "purchaseInformationURL": "https://jps.org/books/the-jps-tanakh-gender-sensitive-edition/", - "hasManuallyWrappedRefs": "", - "actualLanguage": "en", - "languageFamilyName": "english", - "isBaseText": "", - "isSource": false, - "isPrimary": "", - "direction": "ltr", - "language": "en", - "title": "Esther", - "versionSource": "https://jps.org/books/the-jps-tanakh-gender-sensitive-edition/", - "versionTitle": "THE JPS TANAKH: Gender-Sensitive Edition" - } - ], - "ref": "Esther 1:1", - "heRef": "אסתר א׳:א׳", - "sections": [ - "1", - "1" - ], - "toSections": [ - "1", - "1" - ], - "sectionRef": "Esther 1", - "heSectionRef": "אסתר א׳", - "firstAvailableSectionRef": "Esther 1:1", - "isSpanning": false, - "spanningRefs": [ - "Esther 1:1" - ], - "next": "Esther 2", - "title": "Esther 1", - "book": "Esther", - "heTitle": "אסתר", - "primary_category": "Tanakh", - "type": "Tanakh", - "indexTitle": "Esther", - "categories": [ - "Tanakh", - "Writings" - ], - "heIndexTitle": "אסתר", - "isComplex": false, - "isDependant": false, - "order": [ - 34, - 8 - ], - "collectiveTitle": "", - "heCollectiveTitle": "", - "alts": [], - "lengths": [ - 10, - 167 - ], - "length": 10, - "textDepth": 2, - "sectionNames": [ - "Chapter", - "Verse" - ], - "addressTypes": [ - "Perek", - "Pasuk" - ], - "titleVariants": [ - "Est.", - "Est", - "Ester", - "Esth.", - "Esth", - "Esther" - ], - "heTitleVariants": [ - "מגילת אסתר", - "אסתר" - ], - "index_offsets_by_depth": {}, - "warnings": [] - } - } - } - } - }, - "description": "Successful retrieval of the desired texts." - } - }, - "summary": "Texts (v3)", - "description": "The most up-to-date way to retrieve texts from Sefaria via the API, with enhanced control over language, language direction, and other parameters. " - }, - "parameters": [ - { - "examples": { - "language": { - "value": "hebrew" - }, - "language|version": { - "value": "hebrew|Miqra according to the Masorah" - } - }, - "name": "version", - "description": "There are two possible forms for the string passed as the `version`:\n1. `language`\n2. `language|versionTitle`\n\nWhen in the form of `language`, the primary version of that language is returned in the `versions` field of the response object. When in the form of `language>|Miqra According to the Masorah (MAM) is a digital Hebrew edition of the Tanakh based on the Aleppo Codex and related manuscripts. It is designed for readers, and as such it contains added elements to aid vocalization of the text. For instance: When an accent is marked in an unstressed syllable, an extra accent is added in the proper place (pashta, zarqa, segol, telisha). Legarmeih and paseq are visibly distinguished. Qamaz qatan is indicated by its designated Unicode character (alternatives are documented where traditions differ about its application).
The text of MAM is fully documented. The complete introduction to the edition (Hebrew) explains the types of editorial decisions that have been made and the reasons for them (English abstract). In addition, every word in the Bible about which there is some textual concern or ambiguity includes a documentation note; these notes can be viewed conveniently here. If an error is discovered, it may be reported to User:Dovi at Hebrew Wikisource. Please check the documentation notes before reporting an error.", + "formatAsPoetry": "", + "digitizedBySefaria": "", + "method": "", + "heversionSource": "", + "versionUrl": "", + "versionTitleInHebrew": "מקרא על פי המסורה", + "versionNotesInHebrew": "", + "shortVersionTitle": "", + "shortVersionTitleInHebrew": "", + "extendedNotes": "", + "extendedNotesHebrew": "", + "purchaseInformationImage": "", + "purchaseInformationURL": "", + "hasManuallyWrappedRefs": "", + "actualLanguage": "he", + "languageFamilyName": "hebrew", + "isBaseText": true, + "isSource": true, + "isPrimary": true, + "direction": "rtl", + "language": "he", + "versionSource": "https://he.wikisource.org/wiki/%D7%9E%D7%A9%D7%AA%D7%9E%D7%A9:Dovi/%D7%9E%D7%A7%D7%A8%D7%90_%D7%A2%D7%9C_%D7%A4%D7%99_%D7%94%D7%9E%D7%A1%D7%95%D7%A8%D7%94", + "versionTitle": "Miqra according to the Masorah", + "text": "וַיְהִ֖י בִּימֵ֣י אֲחַשְׁוֵר֑וֹשׁ ה֣וּא אֲחַשְׁוֵר֗וֹשׁ הַמֹּלֵךְ֙ מֵהֹ֣דּוּ וְעַד־כּ֔וּשׁ שֶׁ֛בַע וְעֶשְׂרִ֥ים וּמֵאָ֖ה מְדִינָֽה׃" } - }, - "name": "return_format", - "description": "This parameter formats the text that will be returned from the `v3` `texts/` API. It can have one of four values:\n1. `text_only` - This strips footnotes, inline references and all html tags from the returned text\n2. `strip_only_footnotes` - This only strips the footnotes and commentator tags without stripping the other HTML tags.This is useful for the native app, where we do not display footnotes.\n3. `wrap_all_entities` - This wraps the HTML for links and topic links\n4. `default` - This returns the basic text as it’s saved in Sefaria’s DB\n", - "schema": { - "enum": [ - "default", - "wrap_all_entities", - "strip_only_footnotes", - "text_only" - ], - "type": "string", - "default": "default" - }, - "in": "query" - } - ] - }, - "/api/texts/{tref}": { - "get": { - "tags": [ - "Text" - ], - "parameters": [ - { - "name": "callback", - "schema": { - "type": "string" + ], + "available_versions": [ + { + "status": "locked", + "priority": 2, + "license": "CC-BY-SA", + "versionNotes": "Miqra According to the Masorah (MAM) is a digital Hebrew edition of the Tanakh based on the Aleppo Codex and related manuscripts. It is designed for readers, and as such it contains added elements to aid vocalization of the text. For instance: When an accent is marked in an unstressed syllable, an extra accent is added in the proper place (pashta, zarqa, segol, telisha). Legarmeih and paseq are visibly distinguished. Qamaz qatan is indicated by its designated Unicode character (alternatives are documented where traditions differ about its application).
The text of MAM is fully documented. The complete introduction to the edition (Hebrew) explains the types of editorial decisions that have been made and the reasons for them (English abstract). In addition, every word in the Bible about which there is some textual concern or ambiguity includes a documentation note; these notes can be viewed conveniently here. If an error is discovered, it may be reported to User:Dovi at Hebrew Wikisource. Please check the documentation notes before reporting an error.", + "formatAsPoetry": "", + "digitizedBySefaria": "", + "method": "", + "heversionSource": "", + "versionUrl": "", + "versionTitleInHebrew": "מקרא על פי המסורה", + "versionNotesInHebrew": "", + "shortVersionTitle": "", + "shortVersionTitleInHebrew": "", + "extendedNotes": "", + "extendedNotesHebrew": "", + "purchaseInformationImage": "", + "purchaseInformationURL": "", + "hasManuallyWrappedRefs": "", + "actualLanguage": "he", + "languageFamilyName": "hebrew", + "isBaseText": true, + "isSource": true, + "isPrimary": true, + "direction": "rtl", + "language": "he", + "title": "Esther", + "versionSource": "https://he.wikisource.org/wiki/%D7%9E%D7%A9%D7%AA%D7%9E%D7%A9:Dovi/%D7%9E%D7%A7%D7%A8%D7%90_%D7%A2%D7%9C_%D7%A4%D7%99_%D7%94%D7%9E%D7%A1%D7%95%D7%A8%D7%94", + "versionTitle": "Miqra according to the Masorah" }, - "in": "query" - }, - { - "name": "context", - "description": "The `context` param defaults to `1`, which allows for the API to return the entire context for the desired segment. When you explicitly set `context=0` only the desired segment is returned, without any of the accompanying context.", - "schema": { - "type": "boolean" + { + "status": "locked", + "priority": 2, + "license": "CC-BY-NC", + "versionNotes": "", + "formatAsPoetry": "", + "digitizedBySefaria": "", + "method": "", + "heversionSource": "", + "versionUrl": "", + "versionTitleInHebrew": "", + "versionNotesInHebrew": "", + "shortVersionTitle": "JPS, 1985", + "shortVersionTitleInHebrew": "", + "extendedNotes": "", + "extendedNotesHebrew": "", + "purchaseInformationImage": "https://storage.googleapis.com/sefaria-physical-editions/JPS_1985.png", + "purchaseInformationURL": "https://www.nebraskapress.unl.edu/jps/9780827602526/", + "hasManuallyWrappedRefs": "", + "actualLanguage": "en", + "languageFamilyName": "english", + "isBaseText": false, + "isSource": false, + "isPrimary": "", + "direction": "ltr", + "language": "en", + "title": "Esther", + "versionSource": "https://jps.org/books/tanakh-the-holy-scriptures-blue/", + "versionTitle": "Tanakh: The Holy Scriptures, published by JPS" }, - "in": "query" - }, - { - "name": "commentary", - "description": "The `commentary` param defaults to `0`, which turns off commentary being returned in the response. When you explicitly set `commentary=1` all of commentary to that specific connection is returned in list of JSON objects containing the text of the commentaries", - "schema": { - "maximum": 1, - "minimum": 0, - "type": "integer" + { + "status": "locked", + "priority": 1, + "license": "Public Domain", + "versionNotes": "This 1917 translation by the Jewish Publication Society is in the public domain. JPS graciously shared digital images of this text with the Open Siddur Project, from which the text was imported by Sefaria.", + "formatAsPoetry": "", + "digitizedBySefaria": "", + "method": "", + "heversionSource": "", + "versionUrl": "", + "versionTitleInHebrew": "כתבי הקודש: תרגום חדש (1917 JPS)", + "versionNotesInHebrew": "תרגום JPS 1917 קיים בנחלת הכלל. הסריקות באדיבות JPS. שעתוק הטקסט תודות לפרויקט Open Siddur, משם יובא הטקסט למאגר ספריא", + "shortVersionTitle": "JPS 1917", + "shortVersionTitleInHebrew": "", + "extendedNotes": "", + "extendedNotesHebrew": "", + "purchaseInformationImage": "", + "purchaseInformationURL": "", + "hasManuallyWrappedRefs": "", + "actualLanguage": "en", + "languageFamilyName": "english", + "isBaseText": false, + "isSource": false, + "isPrimary": "", + "direction": "ltr", + "language": "en", + "title": "Esther", + "versionSource": "http://opensiddur.org/2010/08/%D7%AA%D7%A0%D7%B4%D7%9A-the-holy-scriptures-a-new-translation-jps-1917/", + "versionTitle": "The Holy Scriptures: A New Translation (JPS 1917)" }, - "in": "query" - }, - { - "name": "pad", - "description": "By default this is set to `1` which ensures that any references at the title level will return only the first section of a book instead of its entirety. If you want the API to return the entire content of the book set pad to `0`", - "schema": { - "type": "boolean" + { + "status": "locked", + "priority": 1, + "license": "Public Domain", + "versionNotes": "", + "formatAsPoetry": "", + "digitizedBySefaria": "", + "method": "", + "heversionSource": "", + "versionUrl": "", + "versionTitleInHebrew": "תנ״ך מלווה בטעמי מקרא", + "versionNotesInHebrew": "", + "shortVersionTitle": "", + "shortVersionTitleInHebrew": "", + "extendedNotes": "", + "extendedNotesHebrew": "", + "purchaseInformationImage": "", + "purchaseInformationURL": "", + "hasManuallyWrappedRefs": "", + "actualLanguage": "he", + "languageFamilyName": "hebrew", + "isBaseText": true, + "isSource": true, + "isPrimary": true, + "direction": "rtl", + "language": "he", + "title": "Esther", + "versionSource": "http://www.tanach.us/Tanach.xml", + "versionTitle": "Tanach with Ta'amei Hamikra" }, - "in": "query" - }, - { - "examples": { - "The Contemporay Torah: JPS 2006": { - "value": "The_Contemporary_Torah,_Jewish_Publication_Society,_2006" - } + { + "status": "locked", + "priority": "", + "license": "Public Domain", + "versionNotes": "", + "formatAsPoetry": "", + "digitizedBySefaria": "", + "method": "", + "heversionSource": "", + "versionUrl": "", + "versionTitleInHebrew": "תנ״ך - טקסט בלבד", + "versionNotesInHebrew": "", + "shortVersionTitle": "", + "shortVersionTitleInHebrew": "", + "extendedNotes": "", + "extendedNotesHebrew": "", + "purchaseInformationImage": "", + "purchaseInformationURL": "", + "hasManuallyWrappedRefs": "", + "actualLanguage": "he", + "languageFamilyName": "hebrew", + "isBaseText": true, + "isSource": true, + "isPrimary": true, + "direction": "rtl", + "language": "he", + "title": "Esther", + "versionSource": "http://www.tanach.us/Tanach.xml", + "versionTitle": "Tanach with Text Only" }, - "name": "ven", - "description": "Unless explicitly specified, the texts API returns a default version of a text with roman characters as of the content in the `text` response. Passing a specific `versionTitle` here will load that text version if it exists instead of the default.\n", - "schema": { - "type": "string" + { + "status": "locked", + "priority": "", + "license": "Public Domain", + "versionNotes": "", + "formatAsPoetry": "", + "digitizedBySefaria": "", + "method": "", + "heversionSource": "", + "versionUrl": "", + "versionTitleInHebrew": "תנ״ך עם ניקוד", + "versionNotesInHebrew": "", + "shortVersionTitle": "", + "shortVersionTitleInHebrew": "", + "extendedNotes": "", + "extendedNotesHebrew": "", + "purchaseInformationImage": "", + "purchaseInformationURL": "", + "hasManuallyWrappedRefs": "", + "actualLanguage": "he", + "languageFamilyName": "hebrew", + "isBaseText": true, + "isSource": true, + "isPrimary": true, + "direction": "rtl", + "language": "he", + "title": "Esther", + "versionSource": "http://www.tanach.us/Tanach.xml", + "versionTitle": "Tanach with Nikkud" }, - "in": "query" - }, - { - "name": "firstAvailableRef", - "description": "If a given text reference doesn't return any content, setting this to `1` will return the first reference that does. \n\nSometimes this occurs when a text reference may pass our ref checking logic, but doesn't exist e.g. `https://www.sefaria.org/api/texts/Berakhot 1a?firstAvailableRef=1`, and sometimes this occurs when a translation is incomplete. Defaults to `0`", - "schema": { - "type": "boolean" + { + "status": "", + "priority": "", + "license": "", + "versionNotes": "", + "formatAsPoetry": "", + "digitizedBySefaria": "", + "method": "", + "heversionSource": "", + "versionUrl": "", + "versionTitleInHebrew": "תרגום קהילת ספריא", + "versionNotesInHebrew": "", + "shortVersionTitle": "", + "shortVersionTitleInHebrew": "", + "extendedNotes": "", + "extendedNotesHebrew": "", + "purchaseInformationImage": "", + "purchaseInformationURL": "", + "hasManuallyWrappedRefs": "", + "actualLanguage": "en", + "languageFamilyName": "english", + "isBaseText": false, + "isSource": false, + "isPrimary": "", + "direction": "ltr", + "language": "en", + "title": "Esther", + "versionSource": "https://www.sefaria.org", + "versionTitle": "Sefaria Community Translation" }, - "in": "query" - }, - { - "name": "vhe", - "description": "Unless explicitly specified, the texts API returns a default version of a text with Hebrew characters as of the content in the `he` response. Passing a specific `versionTitle` here will load that text version if it exists instead of the default.\n", - "schema": { - "type": "string" + { + "status": "locked", + "priority": "", + "license": "CC-BY", + "versionNotes": "To enhance the quality of this text, obvious translation errors were corrected in accordance with the Hebrew source", + "formatAsPoetry": "", + "digitizedBySefaria": "", + "method": "", + "heversionSource": "", + "versionUrl": "", + "versionTitleInHebrew": "כתובים' על פי רש״י, רבי שרגא זילברשטיין", + "versionNotesInHebrew": "כדי לשפר את איכות הטקסט הזה, שונו שגיאות תרגום ברורות בהתאם למקור העברי", + "shortVersionTitle": "", + "shortVersionTitleInHebrew": "", + "extendedNotes": "", + "extendedNotesHebrew": "", + "purchaseInformationImage": "", + "purchaseInformationURL": "", + "hasManuallyWrappedRefs": "", + "actualLanguage": "en", + "languageFamilyName": "english", + "isBaseText": false, + "isSource": false, + "isPrimary": "", + "direction": "ltr", + "language": "en", + "title": "Esther", + "versionSource": "http://www.sefaria.org/shraga-silverstein", + "versionTitle": "The Rashi Ketuvim by Rabbi Shraga Silverstein" }, - "in": "query" - }, - { - "name": "layer", - "schema": { - "type": "string" + { + "status": "locked", + "priority": "", + "license": "CC-BY-NC", + "versionNotes": "", + "formatAsPoetry": "", + "digitizedBySefaria": "", + "method": "", + "heversionSource": "", + "versionUrl": "", + "versionTitleInHebrew": "", + "versionNotesInHebrew": "", + "shortVersionTitle": "", + "shortVersionTitleInHebrew": "", + "extendedNotes": "", + "extendedNotesHebrew": "", + "purchaseInformationImage": "https://storage.googleapis.com/sefaria-physical-editions/9f4b3fedfe5a8889a3a7b3b7f3022091.png", + "purchaseInformationURL": "https://korenpub.com/collections/tanakh", + "hasManuallyWrappedRefs": "", + "actualLanguage": "en", + "languageFamilyName": "english", + "isBaseText": false, + "isSource": false, + "isPrimary": "", + "direction": "ltr", + "language": "en", + "title": "Esther", + "versionSource": "https://www.korenpub.com/koren_en_usd/koren/tanakh-bible/the-koren-jerusalem-bible.html", + "versionTitle": "The Koren Jerusalem Bible" }, - "in": "query" - }, - { - "name": "alts", - "description": "Returns the `alt structures` for the target text in the JSON response object.", - "schema": { - "type": "boolean" + { + "status": "locked", + "priority": "", + "license": "CC-BY", + "versionNotes": "", + "formatAsPoetry": "", + "digitizedBySefaria": "", + "method": "", + "heversionSource": "", + "versionUrl": "", + "versionTitleInHebrew": "", + "versionNotesInHebrew": "", + "shortVersionTitle": "", + "shortVersionTitleInHebrew": "", + "extendedNotes": "", + "extendedNotesHebrew": "", + "purchaseInformationImage": "https://storage.googleapis.com/sefaria-physical-editions/958565938f3a7ed617834d467ac93c9f.png", + "purchaseInformationURL": "https://www.israelbookshoppublications.com/store/pc/Metsudah-Five-Megilloth-w-Rashi-26p309.htm", + "hasManuallyWrappedRefs": "", + "actualLanguage": "en", + "languageFamilyName": "english", + "isBaseText": false, + "isSource": false, + "isPrimary": "", + "direction": "ltr", + "language": "en", + "title": "Esther", + "versionSource": "https://www.judaicaplace.com/search/brand/Metsudah-Publications/", + "versionTitle": "The Metsudah Five Megillot, Lakewood, N.J., 2001" }, - "in": "query" - }, - { - "name": "wrapLinks", - "schema": { - "type": "boolean" + { + "status": "locked", + "priority": "", + "license": "CC-BY", + "versionNotes": "", + "formatAsPoetry": "", + "digitizedBySefaria": "", + "method": "", + "heversionSource": "", + "versionUrl": "", + "versionTitleInHebrew": "חמש מגילות, הוצאת 'מצודה', לייקווד תשס\"א", + "versionNotesInHebrew": "", + "shortVersionTitle": "", + "shortVersionTitleInHebrew": "", + "extendedNotes": "", + "extendedNotesHebrew": "", + "purchaseInformationImage": "https://storage.googleapis.com/sefaria-physical-editions/232433ac3323606604f21e0c70f0c061.png", + "purchaseInformationURL": "https://www.israelbookshoppublications.com/store/pc/Metsudah-Five-Megilloth-w-Rashi-26p309.htm", + "hasManuallyWrappedRefs": "", + "actualLanguage": "he", + "languageFamilyName": "hebrew", + "isBaseText": true, + "isSource": true, + "isPrimary": true, + "direction": "rtl", + "language": "he", + "title": "Esther", + "versionSource": "https://www.judaicaplace.com/search/brand/Metsudah-Publications/", + "versionTitle": "The Metsudah Five Megillot, Lakewood, N.J., 2001" }, - "in": "query" - }, - { - "name": "wrapNamedEntities", - "schema": { - "type": "boolean" + { + "status": "locked", + "priority": "", + "license": "", + "versionNotes": "", + "formatAsPoetry": "", + "digitizedBySefaria": "", + "method": "", + "heversionSource": "", + "versionUrl": "", + "versionTitleInHebrew": "מגילת אסתר - מהדורה פורימית!!", + "versionNotesInHebrew": "", + "shortVersionTitle": "", + "shortVersionTitleInHebrew": "", + "extendedNotes": "", + "extendedNotesHebrew": "", + "purchaseInformationImage": "", + "purchaseInformationURL": "", + "hasManuallyWrappedRefs": "", + "actualLanguage": "he", + "languageFamilyName": "hebrew", + "isBaseText": true, + "isSource": true, + "isPrimary": true, + "direction": "rtl", + "language": "he", + "title": "Esther", + "versionSource": "https://www.sefaria.org", + "versionTitle": "Megillat Esther - Purim Edition!!" }, - "in": "query" - }, - { - "name": "stripItags", - "description": "Sefaria texts include footnotes and other `iTags` in the response. This param defaults to `0` which leaves them in. Changing it to `1` will remove them.", - "schema": { - "type": "boolean" + { + "status": "locked", + "priority": "", + "license": "Public Domain", + "versionNotes": "", + "formatAsPoetry": "", + "digitizedBySefaria": "", + "method": "", + "heversionSource": "", + "versionUrl": "", + "versionTitleInHebrew": "", + "versionNotesInHebrew": "", + "shortVersionTitle": "", + "shortVersionTitleInHebrew": "", + "extendedNotes": "", + "extendedNotesHebrew": "", + "purchaseInformationImage": "", + "purchaseInformationURL": "", + "hasManuallyWrappedRefs": "", + "actualLanguage": "fr", + "languageFamilyName": "french", + "isBaseText": false, + "isSource": false, + "isPrimary": "", + "direction": "ltr", + "language": "en", + "title": "Esther", + "versionSource": "https://fr.wikisource.org/wiki/Bible_du_Rabbinat_1899", + "versionTitle": "Bible du Rabbinat 1899 [fr]" }, - "in": "query" - }, - { - "name": "multiple", - "description": "If the absolute value of this param is greater than `1` the API response will return include `|n|` text API responses which include `|n|-1` additional consecutive sections of the targeted text if they exist. If the integer is positive, it will return the next consecutive chapter[s], and if negative it will contain the previous consecutive chapter[s].", - "schema": { - "type": "integer" + { + "status": "", + "priority": "", + "license": "CC0", + "versionNotes": "", + "formatAsPoetry": "", + "digitizedBySefaria": "", + "method": "", + "heversionSource": "", + "versionUrl": "", + "versionTitleInHebrew": "מגילת אמוג'י", + "versionNotesInHebrew": "", + "shortVersionTitle": "", + "shortVersionTitleInHebrew": "", + "extendedNotes": "", + "extendedNotesHebrew": "", + "purchaseInformationImage": "", + "purchaseInformationURL": "", + "hasManuallyWrappedRefs": "", + "actualLanguage": "he", + "languageFamilyName": "hebrew", + "isBaseText": true, + "isSource": true, + "isPrimary": true, + "direction": "rtl", + "language": "he", + "title": "Esther", + "versionSource": "https://www.sefaria.org", + "versionTitle": "Emoji Megillah" }, - "in": "query" - }, - { - "examples": { - "German": { - "value": "DE" - }, - "Arabic": { - "value": "AR" - } + { + "status": "", + "priority": "", + "license": "CC0", + "versionNotes": "", + "formatAsPoetry": "", + "digitizedBySefaria": "", + "method": "", + "heversionSource": "", + "versionUrl": "", + "versionTitleInHebrew": "", + "versionNotesInHebrew": "", + "shortVersionTitle": "", + "shortVersionTitleInHebrew": "", + "extendedNotes": "", + "extendedNotesHebrew": "", + "purchaseInformationImage": "", + "purchaseInformationURL": "", + "hasManuallyWrappedRefs": "", + "actualLanguage": "en", + "languageFamilyName": "english", + "isBaseText": false, + "isSource": false, + "isPrimary": "", + "direction": "ltr", + "language": "en", + "title": "Esther", + "versionSource": "https://www.sefaria.org", + "versionTitle": "Emoji Megillah" }, - "name": "transLangPref", - "description": "Unless explicitly specified, the texts API returns a default version for the `he` and `text` responses (usually in Hebrew & English respectfully). Passing an ISO 639-1 language code here will prioritize text versions in that target language if available.", - "schema": { - "type": "string" + { + "status": "", + "priority": "", + "license": "Public Domain", + "versionNotes": "", + "formatAsPoetry": "", + "digitizedBySefaria": "", + "method": "", + "heversionSource": "", + "versionUrl": "", + "versionTitleInHebrew": "", + "versionNotesInHebrew": "", + "shortVersionTitle": "Izaak Cylkow, 1841 - 1908 ", + "shortVersionTitleInHebrew": "", + "extendedNotes": "", + "extendedNotesHebrew": "", + "purchaseInformationImage": "", + "purchaseInformationURL": "", + "hasManuallyWrappedRefs": "", + "actualLanguage": "pl", + "languageFamilyName": "polish", + "isBaseText": false, + "isSource": false, + "isPrimary": "", + "direction": "ltr", + "language": "en", + "title": "Esther", + "versionSource": "http://bibliepolskie.pl/", + "versionTitle": "Bible in Polish, trans. Izaak Cylkow, 1841 - 1908 [pl]" }, - "in": "query" - }, - { - "name": "fallbackOnDefaultVersion", - "schema": { - "type": "boolean" + { + "status": "", + "priority": "", + "license": "Public Domain", + "versionNotes": "", + "formatAsPoetry": "", + "digitizedBySefaria": "", + "method": "", + "heversionSource": "", + "versionUrl": "", + "versionTitleInHebrew": "", + "versionNotesInHebrew": "", + "shortVersionTitle": "", + "shortVersionTitleInHebrew": "", + "extendedNotes": "", + "extendedNotesHebrew": "", + "purchaseInformationImage": "", + "purchaseInformationURL": "", + "hasManuallyWrappedRefs": "", + "actualLanguage": "it", + "languageFamilyName": "italian", + "isBaseText": false, + "isSource": false, + "isPrimary": "", + "direction": "ltr", + "language": "en", + "title": "Esther", + "versionSource": "http://www.archivio-torah.it", + "versionTitle": "Ester. Traduzione italiana di Samuel David Luzzatto, 1872 [it]" }, - "in": "query" - }, - { - "name": "sheets", - "description": "The `sheets` param defaults to `0`, which turns off user-generated Sefaria Sheet data from being returned in the response. When you explicitly set `sheets=1` all of the user-generated sheet content to that specific connection is returned in list of JSON objects.\n\n_This usage is deprecated. Instead you should use the `Related API`._", - "schema": { - "type": "boolean" + { + "status": "", + "priority": "", + "license": "", + "versionNotes": "", + "formatAsPoetry": "", + "digitizedBySefaria": "", + "method": "", + "heversionSource": "", + "versionUrl": "", + "versionTitleInHebrew": "", + "versionNotesInHebrew": "", + "shortVersionTitle": "", + "shortVersionTitleInHebrew": "", + "extendedNotes": "", + "extendedNotesHebrew": "", + "purchaseInformationImage": "", + "purchaseInformationURL": "", + "hasManuallyWrappedRefs": "", + "actualLanguage": "fa", + "languageFamilyName": "persian", + "isBaseText": false, + "isSource": false, + "isPrimary": "", + "direction": "rtl", + "language": "he", + "title": "Esther", + "versionSource": "http://www.iranjewish.com/megilla/megilla_main.htm", + "versionTitle": "Book of Esther in Farsi, trans. by Pole-Choubi, synagogue Talmood Torah [fa]" }, - "in": "query" - }, - { - "examples": { - "Tanakh": { - "value": "Kohelet 5:10" - }, - "Talmud": { - "value": "Shabbat 22a.10" - }, - "Talmud Amud": { - "value": "Shabbat 22a" - }, - "Tanakh Chapter": { - "value": "Exodus 10" - }, - "Commentary": { - "value": "Rashi on Genesis 1:1:1" - } + { + "status": "", + "priority": "", + "license": "", + "versionNotes": "", + "formatAsPoetry": "", + "digitizedBySefaria": "", + "method": "", + "heversionSource": "", + "versionUrl": "", + "versionTitleInHebrew": "", + "versionNotesInHebrew": "", + "shortVersionTitle": "", + "shortVersionTitleInHebrew": "", + "extendedNotes": "", + "extendedNotesHebrew": "", + "purchaseInformationImage": "", + "purchaseInformationURL": "", + "hasManuallyWrappedRefs": "", + "actualLanguage": "fa", + "languageFamilyName": "persian", + "isBaseText": false, + "isSource": false, + "isPrimary": "", + "direction": "ltr", + "language": "en", + "title": "Esther", + "versionSource": "http://www.iranjewish.com/megilla/megilla_main.htm", + "versionTitle": "Book of Esther in Farsi, trans. by Pole-Choubi, synagogue Talmood Torah, LTR [fa]" }, - "name": "tref", - "description": "A valid textual `Ref` to a Sefaria text.", - "schema": { - "$ref": "#/components/schemas/ref" + { + "status": "", + "priority": "", + "license": "Public Domain", + "versionNotes": "This 1941 translation published by Yehoʼash Farlag Gezelshaft is in the public domain. A transcribed digitized version was produced by Itsik \"Robert\" Goldenberg, et al, by the Yehoyesh Project (1998-2006) under the direction of Leonard Prager. That version was graciously shared with the Open Siddur Project, from which the text was imported by Sefaria.", + "formatAsPoetry": "", + "digitizedBySefaria": "", + "method": "", + "heversionSource": "", + "versionUrl": "", + "versionTitleInHebrew": "", + "versionNotesInHebrew": "", + "shortVersionTitle": "", + "shortVersionTitleInHebrew": "", + "extendedNotes": "", + "extendedNotesHebrew": "", + "purchaseInformationImage": "", + "purchaseInformationURL": "", + "hasManuallyWrappedRefs": "", + "actualLanguage": "yi", + "languageFamilyName": "yiddish", + "isBaseText": false, + "isSource": false, + "isPrimary": "", + "direction": "rtl", + "language": "he", + "title": "Esther", + "versionSource": "http://opensiddur.org/praxes/study/yehoyeshs-yiddish-translation-of-the-tanakh/", + "versionTitle": "Yehoyesh's Yiddish Tanakh Translation [yi]" }, - "in": "path", - "required": true - } - ], - "responses": { - "200": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/textAPIReponse" - }, - "examples": { - "Shabbat 22a.1": { - "value": { - "ref": "Shabbat 22a:1", - "heRef": "שבת כ״ב א:א׳", - "isComplex": false, - "text": [], - "he": [], - "versions": [], - "textDepth": 2, - "sectionNames": [], - "addressTypes": [], - "lengths": [], - "length": 314, - "heTitle": "שבת כ״ב א", - "titleVariants": [], - "heTitleVariants": [], - "type": "Talmud", - "primary_category": "Talmud", - "book": "Shabbat", - "categories": [], - "order": [], - "sections": [], - "toSections": [], - "isDependant": false, - "indexTitle": "Shabbat", - "heIndexTitle": "שבת", - "sectionRef": "Shabbat 22a", - "firstAvailableSectionRef": "Shabbat 22a:1", - "heSectionRef": "שבת כ״ב א", - "isSpanning": false, - "versionTitle": "William Davidson Edition - English", - "versionTitleInHebrew": "מהדורת וויליאם דייוידסון - אנגלית", - "shortVersionTitle": "Koren - Steinsaltz", - "shortVersionTitleInHebrew": "", - "versionSource": "https://korenpub.com/collections/the-noe-edition-koren-talmud-bavli-1", - "versionStatus": "locked", - "versionNotes": "English from The William Davidson digital edition of the Koren Noé Talmud, with commentary by Rabbi Adin Even-Israel Steinsaltz", - "extendedNotes": "", - "extendedNotesHebrew": "", - "versionNotesInHebrew": "תרגום אנגלי של תלמוד מהדורת ויליאם דיוידסון מתוך מהדורת Noé עם פירוש הרב עדין אבן ישראל שטיינזלץ, בהוצאת קורן ירושלים", - "digitizedBySefaria": false, - "license": "CC-BY-NC", - "formatEnAsPoetry": false, - "heVersionTitle": "William Davidson Edition - Vocalized Aramaic", - "heVersionTitleInHebrew": "מהדורת וויליאם דייוידסון - ארמית המנוקד", - "heShortVersionTitle": "", - "heShortVersionTitleInHebrew": "", - "heVersionSource": "https://www.sefaria.org", - "heVersionStatus": "locked", - "heVersionNotes": "Aramaic from The William Davidson digital edition of the Koren Noé Talmud, with commentary by Rabbi Adin Even-Israel Steinsaltz\nNikud (vocalization) by Dicta - the Israel Center for Text Analysis", - "heExtendedNotes": "", - "heExtendedNotesHebrew": "", - "heVersionNotesInHebrew": "הטקסט הארמי של מהדורת וויליאם דייוידסון הדיגיטלית מתוך תלמוד קורן מהדורת נאה, עם באור מאת הרב אבן־ישראל (שטיינזלץ)\nמנוקד על ידי דיקטה - המרכז הישראלי לניתוח טקסטים", - "heDigitizedBySefaria": false, - "heLicense": "CC-BY-NC", - "formatHeAsPoetry": false, - "title": "Shabbat 22a", - "heBook": "שבת", - "alts": [], - "index_offsets_by_depth": {}, - "next": "Shabbat 22b", - "prev": "Shabbat 21b", - "commentary": [], - "sheets": [], - "layer": [] - } - } - } - } + { + "status": "locked", + "priority": "", + "license": "", + "versionNotes": "Translator: Marion Kaufmann, based on german translations of Tur-Sinai, Martín Buber and Franz Rosenzwig
Review and correction: Manes Kogan
Final Review: Batia Dorfman", + "formatAsPoetry": "", + "digitizedBySefaria": "", + "method": "", + "heversionSource": "", + "versionUrl": "", + "versionTitleInHebrew": "", + "versionNotesInHebrew": "", + "shortVersionTitle": "", + "shortVersionTitleInHebrew": "", + "extendedNotes": "", + "extendedNotesHebrew": "", + "purchaseInformationImage": "", + "purchaseInformationURL": "", + "hasManuallyWrappedRefs": "", + "actualLanguage": "es", + "languageFamilyName": "spanish", + "isBaseText": false, + "isSource": false, + "isPrimary": "", + "direction": "ltr", + "language": "en", + "title": "Esther", + "versionSource": "https://www.seminariorabinico.org/wp-content/uploads/El-libro-de-Ester-Meguila-Ester.pdf", + "versionTitle": "El libro de Ester - Meguila Ester - Seminario Rabínico [es]" }, - "description": "Successful response" - } - }, - "deprecated": true, - "summary": "Texts (v1)", - "description": "Retrieve the text and some additional metadata for a specific Sefaria textual `Ref`" - }, - "parameters": [ - { - "examples": { - "Tanakh": { - "value": "Kohelet 5:10" + { + "status": "", + "priority": "", + "license": "", + "versionNotes": "", + "formatAsPoetry": "", + "digitizedBySefaria": "", + "method": "", + "heversionSource": "", + "versionUrl": "", + "versionTitleInHebrew": "", + "versionNotesInHebrew": "", + "shortVersionTitle": "Samuel Cahen, 1831 ", + "shortVersionTitleInHebrew": "", + "extendedNotes": "", + "extendedNotesHebrew": "", + "purchaseInformationImage": "", + "purchaseInformationURL": "", + "hasManuallyWrappedRefs": "", + "actualLanguage": "fr", + "languageFamilyName": "french", + "isBaseText": false, + "isSource": false, + "isPrimary": "", + "direction": "ltr", + "language": "en", + "title": "Esther", + "versionSource": "https://www.levangile.com/Bible-CAH-1-1-1-complet-Contexte-oui.htm", + "versionTitle": "La Bible, Traduction Nouvelle, Samuel Cahen, 1831 [fr]" }, - "Talmud": { - "value": "Shabbat 22a.10" + { + "status": "locked", + "priority": "", + "license": "Public Domain", + "versionNotes": "", + "formatAsPoetry": "", + "digitizedBySefaria": "", + "method": "", + "heversionSource": "", + "versionUrl": "", + "versionTitleInHebrew": "", + "versionNotesInHebrew": "", + "shortVersionTitle": "", + "shortVersionTitleInHebrew": "", + "extendedNotes": "", + "extendedNotesHebrew": "", + "purchaseInformationImage": "", + "purchaseInformationURL": "", + "hasManuallyWrappedRefs": "", + "actualLanguage": "eo", + "languageFamilyName": "esperanto", + "isBaseText": false, + "isSource": false, + "isPrimary": "", + "direction": "ltr", + "language": "en", + "title": "Esther", + "versionSource": "https://eo.wikisource.org/wiki/Malnova_Testamento_(Zamenhof)/Ester/1", + "versionTitle": "La Malnova Testamento, L.L.Zamenhof [eo]" }, - "Talmud Amud": { - "value": "Shabbat 22a" + { + "status": "", + "priority": "", + "license": "", + "versionNotes": "Digitized by Chajm Guski and Marina Struse", + "formatAsPoetry": "", + "digitizedBySefaria": "", + "method": "", + "heversionSource": "", + "versionUrl": "", + "versionTitleInHebrew": "", + "versionNotesInHebrew": "", + "shortVersionTitle": "", + "shortVersionTitleInHebrew": "", + "extendedNotes": "", + "extendedNotesHebrew": "", + "purchaseInformationImage": "", + "purchaseInformationURL": "", + "hasManuallyWrappedRefs": "", + "actualLanguage": "de", + "languageFamilyName": "german", + "isBaseText": false, + "isSource": false, + "isPrimary": "", + "direction": "ltr", + "language": "en", + "title": "Esther", + "versionSource": "https://www.talmud.de/tlmd/tanach/", + "versionTitle": "Die Heilige Schrift, trans. Dr. Simon Bernfeld, Berlin, 1902 - German [de]" }, - "Tanakh Chapter": { - "value": "Exodus 10" + { + "status": "locked", + "priority": "", + "license": "PD", + "versionNotes": "", + "formatAsPoetry": "", + "digitizedBySefaria": true, + "method": "", + "heversionSource": "", + "versionUrl": "", + "versionTitleInHebrew": "", + "versionNotesInHebrew": "", + "shortVersionTitle": "", + "shortVersionTitleInHebrew": "", + "extendedNotes": "", + "extendedNotesHebrew": "", + "purchaseInformationImage": "", + "purchaseInformationURL": "", + "hasManuallyWrappedRefs": "", + "actualLanguage": "he", + "languageFamilyName": "hebrew", + "isBaseText": "", + "isSource": true, + "isPrimary": true, + "direction": "rtl", + "language": "he", + "title": "Esther", + "versionSource": "https://he.wikisource.org/wiki/%D7%9E%D7%A7%D7%A8%D7%90_%D7%9E%D7%91%D7%95%D7%90%D7%A8", + "versionTitle": "Miqra Mevoar, trans. and edited by David Kokhav, Jerusalem 2020" }, - "Commentary": { - "value": "Rashi on Genesis 1:1:1" + { + "status": "", + "priority": "", + "license": "", + "versionNotes": "Read the Preface to the Revised JPS Edition\n

\nRead the Notes on Gender in Translation for the Revised JPS Edition\n

\nRead a Commentary on the Hebrew word 'ish in the Revised JPS Edition", + "formatAsPoetry": "", + "digitizedBySefaria": "", + "method": "", + "heversionSource": "", + "versionUrl": "", + "versionTitleInHebrew": "", + "versionNotesInHebrew": "", + "shortVersionTitle": "Revised JPS, 2023", + "shortVersionTitleInHebrew": "", + "extendedNotes": "", + "extendedNotesHebrew": "", + "purchaseInformationImage": "https://storage.googleapis.com/sefaria-physical-editions/JPS-Tanakh-Gender-Sensitive-Edition-Cover-300x450.jpg", + "purchaseInformationURL": "https://jps.org/books/the-jps-tanakh-gender-sensitive-edition/", + "hasManuallyWrappedRefs": "", + "actualLanguage": "en", + "languageFamilyName": "english", + "isBaseText": "", + "isSource": false, + "isPrimary": "", + "direction": "ltr", + "language": "en", + "title": "Esther", + "versionSource": "https://jps.org/books/the-jps-tanakh-gender-sensitive-edition/", + "versionTitle": "THE JPS TANAKH: Gender-Sensitive Edition" } - }, - "name": "tref", - "description": "A valid textual `Ref` to a Sefaria text.", - "schema": { - "$ref": "#/components/schemas/ref" - }, - "in": "path", - "required": true + ], + "ref": "Esther 1:1", + "heRef": "אסתר א׳:א׳", + "sections": [ + "1", + "1" + ], + "toSections": [ + "1", + "1" + ], + "sectionRef": "Esther 1", + "heSectionRef": "אסתר א׳", + "firstAvailableSectionRef": "Esther 1:1", + "isSpanning": false, + "spanningRefs": [ + "Esther 1:1" + ], + "next": "Esther 2", + "title": "Esther 1", + "book": "Esther", + "heTitle": "אסתר", + "primary_category": "Tanakh", + "type": "Tanakh", + "indexTitle": "Esther", + "categories": [ + "Tanakh", + "Writings" + ], + "heIndexTitle": "אסתר", + "isComplex": false, + "isDependant": false, + "order": [ + 34, + 8 + ], + "collectiveTitle": "", + "heCollectiveTitle": "", + "alts": [], + "lengths": [ + 10, + 167 + ], + "length": 10, + "textDepth": 2, + "sectionNames": [ + "Chapter", + "Verse" + ], + "addressTypes": [ + "Perek", + "Pasuk" + ], + "titleVariants": [ + "Est.", + "Est", + "Ester", + "Esth.", + "Esth", + "Esther" + ], + "heTitleVariants": [ + "מגילת אסתר", + "אסתר" + ], + "index_offsets_by_depth": {}, + "warnings": [] + } + } } - ] + } + }, + "description": "Successful retrieval of the desired texts." + } }, - "/api/texts/versions/{index}": { - "summary": "All Available Versions of a Text", - "description": "This endpoint return all of the available versions of a text given an index title passed as a parameter. ", - "get": { - "tags": [ - "Text" - ], - "responses": { - "200": { - "content": { - "VersionJSON": { - "schema": { - "type": "array", - "items": { - "$ref": "#/components/schemas/VersionJSON" - } - }, - "examples": { - "Rashi on Kohelet": { - "value": [ - { - "title": "Rashi on Ecclesiastes", - "versionTitle": "The Metsudah Five Megillot, Lakewood, N.J., 2001", - "versionSource": "https://www.nli.org.il/he/books/NNL_ALEPH002162036", - "language": "he", - "status": "locked", - "license": "CC-BY", - "versionNotes": "", - "digitizedBySefaria": "", - "priority": 2, - "versionTitleInHebrew": "", - "versionNotesInHebrew": "", - "extendedNotes": "", - "extendedNotesHebrew": "", - "purchaseInformationImage": "https://storage.googleapis.com/sefaria-physical-editions/ba0b4357b240eff4b28b7fcfc4669d56.png", - "purchaseInformationURL": "https://www.israelbookshoppublications.com/store/pc/Metsudah-Five-Megilloth-w-Rashi-26p309.htm", - "shortVersionTitle": "", - "shortVersionTitleInHebrew": "", - "isBaseText": true, - "firstSectionRef": "Rashi on Ecclesiastes 1:1" - }, - { - "title": "Rashi on Ecclesiastes", - "versionTitle": "The Metsudah Five Megillot, Lakewood, N.J., 2001", - "versionSource": "https://www.nli.org.il/he/books/NNL_ALEPH002162036", - "language": "en", - "status": "locked", - "license": "CC-BY", - "versionNotes": "", - "digitizedBySefaria": "", - "priority": 2, - "versionTitleInHebrew": "", - "versionNotesInHebrew": "", - "extendedNotes": "", - "extendedNotesHebrew": "", - "purchaseInformationImage": "https://storage.googleapis.com/sefaria-physical-editions/00c61bd3103f9398bf080832c4a0221f.png", - "purchaseInformationURL": "https://www.israelbookshoppublications.com/store/pc/Metsudah-Five-Megilloth-w-Rashi-26p309.htm", - "shortVersionTitle": "", - "shortVersionTitleInHebrew": "", - "isBaseText": false, - "firstSectionRef": "Rashi on Ecclesiastes 1:1" - }, - { - "title": "Rashi on Ecclesiastes", - "versionTitle": "On Your Way", - "versionSource": "http://mobile.tora.ws/", - "language": "he", - "status": "locked", - "license": "Public Domain", - "versionNotes": "", - "digitizedBySefaria": "", - "priority": 1, - "versionTitleInHebrew": "ובלכתך בדרך", - "versionNotesInHebrew": "", - "extendedNotes": "", - "extendedNotesHebrew": "", - "purchaseInformationImage": "", - "purchaseInformationURL": "", - "shortVersionTitle": "", - "shortVersionTitleInHebrew": "", - "isBaseText": true, - "firstSectionRef": "Rashi on Ecclesiastes 1:1" - }, - { - "title": "Rashi on Ecclesiastes", - "versionTitle": "Sefaria Community Translation", - "versionSource": "https://www.sefaria.org", - "language": "en", - "status": "", - "license": "", - "versionNotes": "", - "digitizedBySefaria": "", - "priority": "", - "versionTitleInHebrew": "תרגום קהילת ספריא", - "versionNotesInHebrew": "", - "extendedNotes": "", - "extendedNotesHebrew": "", - "purchaseInformationImage": "", - "purchaseInformationURL": "", - "shortVersionTitle": "", - "shortVersionTitleInHebrew": "", - "isBaseText": false, - "firstSectionRef": "Rashi on Ecclesiastes 3:3" - }, - { - "title": "Rashi on Ecclesiastes", - "versionTitle": "The Five Megilloth, English translation by A. Cohen, Soncino Press, 1946", - "versionSource": "https://www.nli.org.il/en/books/NNL_ALEPH002644163/NLI", - "language": "en", - "status": "locked", - "license": "CC-BY", - "versionNotes": "", - "digitizedBySefaria": "", - "priority": "", - "versionTitleInHebrew": "", - "versionNotesInHebrew": "", - "extendedNotes": "", - "extendedNotesHebrew": "", - "purchaseInformationImage": "", - "purchaseInformationURL": "", - "shortVersionTitle": "Abraham Cohen, Soncino Press, 1946", - "shortVersionTitleInHebrew": "", - "isBaseText": false, - "firstSectionRef": "Rashi on Ecclesiastes 1:1" - } - ] - } - } - } - }, - "description": "Returns a list containing the JSON Objects for each version available for the given `index` title. Each JSON Object contains all of the metadata for a given version. " - } - }, - "summary": "Versions", - "description": "The versions API takes a title of a valid Sefaria `index` as a parameter, and will return all available versions of the text in the Sefaria database, alongside metadata for each version. A version can be a translation of the text, an alternative language, or any other text associated with that index. \n\n*Note:* In order to see the expected results, you need to make sure you are passing a recognized `index`. For example, `Rashi on Genesis` is a valid `index` but `Rashi` is not. To see the entire list of valid Sefaria indices, click [here](https://www.sefaria.org/api/index/)" + "summary": "Texts (v3)", + "description": "The most up-to-date way to retrieve texts from Sefaria via the API, with enhanced control over language, language direction, and other parameters. " + }, + "parameters": [ + { + "examples": { + "language": { + "value": "hebrew" }, - "parameters": [ - { - "examples": { - "Mishnah": { - "value": "Mishnah Berakhot" - }, - "Tanakh": { - "value": "Kohelet" - }, - "Commentary": { - "value": "Rashi on Exodus" - }, - "Halacha": { - "value": "Shulchan Aruch Orach Chaim" - } - }, - "name": "index", - "description": "A valid Sefaria Index", - "schema": { - "type": "string" - }, - "in": "path", - "required": true - } - ] + "language|version": { + "value": "hebrew|Miqra according to the Masorah" + } + }, + "name": "version", + "description": "There are two possible forms for the string passed as the `version`:\n1. `language`\n2. `language|versionTitle`\n\nWhen in the form of `language`, the primary version of that language is returned in the `versions` field of the response object. When in the form of `language>| tags without stripping the other HTML tags.This is useful for the native app, where we do not display footnotes.\n3. `wrap_all_entities` - This wraps the HTML for links and topic links\n4. `default` - This returns the basic text as it’s saved in Sefaria’s DB\n", + "schema": { + "enum": [ + "default", + "wrap_all_entities", + "strip_only_footnotes", + "text_only" + ], + "type": "string", + "default": "default" + }, + "in": "query" + } + ] + }, + "/api/texts/{tref}": { + "get": { + "tags": [ + "Text" + ], + "parameters": [ + { + "name": "callback", + "schema": { + "type": "string" + }, + "in": "query" + }, + { + "name": "context", + "description": "The `context` param defaults to `1`, which allows for the API to return the entire context for the desired segment. When you explicitly set `context=0` only the desired segment is returned, without any of the accompanying context.", + "schema": { + "enum": [ + "0", + "1" + ], + "type": "string" + }, + "in": "query" + }, + { + "name": "commentary", + "description": "The `commentary` param defaults to `0`, which turns off commentary being returned in the response. When you explicitly set `commentary=1` all of commentary to that specific connection is returned in list of JSON objects containing the text of the commentaries", + "schema": { + "maximum": 1, + "minimum": 0, + "type": "integer" + }, + "in": "query" + }, + { + "name": "pad", + "description": "By default this is set to `1` which ensures that any references at the title level will return only the first section of a book instead of its entirety. If you want the API to return the entire content of the book set pad to `0`", + "schema": { + "enum": [ + "0", + "1" + ], + "type": "string" + }, + "in": "query" + }, + { + "examples": { + "The Contemporay Torah: JPS 2006": { + "value": "The_Contemporary_Torah,_Jewish_Publication_Society,_2006" + } + }, + "name": "ven", + "description": "Unless explicitly specified, the texts API returns a default version of a text with roman characters as of the content in the `text` response. Passing a specific `versionTitle` here will load that text version if it exists instead of the default.\n", + "schema": { + "type": "string" + }, + "in": "query" + }, + { + "name": "firstAvailableRef", + "description": "If a given text reference doesn't return any content, setting this to `1` will return the first reference that does. \n\nSometimes this occurs when a text reference may pass our ref checking logic, but doesn't exist e.g. `https://www.sefaria.org/api/texts/Berakhot 1a?firstAvailableRef=1`, and sometimes this occurs when a translation is incomplete. Defaults to `0`", + "schema": { + "enum": [ + "0", + "1" + ], + "type": "string" + }, + "in": "query" + }, + { + "name": "vhe", + "description": "Unless explicitly specified, the texts API returns a default version of a text with Hebrew characters as of the content in the `he` response. Passing a specific `versionTitle` here will load that text version if it exists instead of the default.\n", + "schema": { + "type": "string" + }, + "in": "query" + }, + { + "name": "layer", + "schema": { + "type": "string" + }, + "in": "query" + }, + { + "name": "alts", + "description": "Returns the `alt structures` for the target text in the JSON response object.", + "schema": { + "enum": [ + "0", + "1" + ], + "type": "string" + }, + "in": "query" + }, + { + "name": "wrapLinks", + "schema": { + "enum": [ + "0", + "1" + ], + "type": "string" + }, + "in": "query" + }, + { + "name": "wrapNamedEntities", + "schema": { + "enum": [ + "0", + "1" + ], + "type": "string" + }, + "in": "query" + }, + { + "name": "stripItags", + "description": "Sefaria texts include footnotes and other `iTags` in the response. This param defaults to `0` which leaves them in. Changing it to `1` will remove them.", + "schema": { + "enum": [ + "0", + "1" + ], + "type": "string" + }, + "in": "query" + }, + { + "name": "multiple", + "description": "If the absolute value of this param is greater than `1` the API response will return include `|n|` text API responses which include `|n|-1` additional consecutive sections of the targeted text if they exist. If the integer is positive, it will return the next consecutive chapter[s], and if negative it will contain the previous consecutive chapter[s].", + "schema": { + "enum": [ + "0", + "1" + ], + "type": "string" + }, + "in": "query" + }, + { + "examples": { + "German": { + "value": "DE" + }, + "Arabic": { + "value": "AR" + } + }, + "name": "transLangPref", + "description": "Unless explicitly specified, the texts API returns a default version for the `he` and `text` responses (usually in Hebrew & English respectfully). Passing an ISO 639-1 language code here will prioritize text versions in that target language if available.", + "schema": { + "type": "string" + }, + "in": "query" + }, + { + "name": "fallbackOnDefaultVersion", + "schema": { + "enum": [ + "0", + "1" + ], + "type": "string" + }, + "in": "query" + }, + { + "name": "sheets", + "description": "The `sheets` param defaults to `0`, which turns off user-generated Sefaria Sheet data from being returned in the response. When you explicitly set `sheets=1` all of the user-generated sheet content to that specific connection is returned in list of JSON objects.\n\n_This usage is deprecated. Instead you should use the `Related API`._", + "schema": { + "enum": [ + "0", + "1" + ], + "type": "string" + }, + "in": "query" + }, + { + "examples": { + "Tanakh": { + "value": "Kohelet 5:10" + }, + "Talmud": { + "value": "Shabbat 22a.10" + }, + "Talmud Amud": { + "value": "Shabbat 22a" + }, + "Tanakh Chapter": { + "value": "Exodus 10" + }, + "Commentary": { + "value": "Rashi on Genesis 1:1:1" + } + }, + "name": "tref", + "description": "A valid textual `Ref` to a Sefaria text.", + "schema": { + "$ref": "#/components/schemas/ref" + }, + "in": "path", + "required": true + } + ], + "responses": { + "200": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/textAPIReponse" + }, + "examples": { + "Shabbat 22a.1": { + "value": { + "ref": "Shabbat 22a:1", + "heRef": "שבת כ״ב א:א׳", + "isComplex": false, + "text": [], + "he": [], + "versions": [], + "textDepth": 2, + "sectionNames": [], + "addressTypes": [], + "lengths": [], + "length": 314, + "heTitle": "שבת כ״ב א", + "titleVariants": [], + "heTitleVariants": [], + "type": "Talmud", + "primary_category": "Talmud", + "book": "Shabbat", + "categories": [], + "order": [], + "sections": [], + "toSections": [], + "isDependant": false, + "indexTitle": "Shabbat", + "heIndexTitle": "שבת", + "sectionRef": "Shabbat 22a", + "firstAvailableSectionRef": "Shabbat 22a:1", + "heSectionRef": "שבת כ״ב א", + "isSpanning": false, + "versionTitle": "William Davidson Edition - English", + "versionTitleInHebrew": "מהדורת וויליאם דייוידסון - אנגלית", + "shortVersionTitle": "Koren - Steinsaltz", + "shortVersionTitleInHebrew": "", + "versionSource": "https://korenpub.com/collections/the-noe-edition-koren-talmud-bavli-1", + "versionStatus": "locked", + "versionNotes": "English from The William Davidson digital edition of the Koren Noé Talmud, with commentary by Rabbi Adin Even-Israel Steinsaltz", + "extendedNotes": "", + "extendedNotesHebrew": "", + "versionNotesInHebrew": "תרגום אנגלי של תלמוד מהדורת ויליאם דיוידסון מתוך מהדורת Noé עם פירוש הרב עדין אבן ישראל שטיינזלץ, בהוצאת קורן ירושלים", + "digitizedBySefaria": false, + "license": "CC-BY-NC", + "formatEnAsPoetry": false, + "heVersionTitle": "William Davidson Edition - Vocalized Aramaic", + "heVersionTitleInHebrew": "מהדורת וויליאם דייוידסון - ארמית המנוקד", + "heShortVersionTitle": "", + "heShortVersionTitleInHebrew": "", + "heVersionSource": "https://www.sefaria.org", + "heVersionStatus": "locked", + "heVersionNotes": "Aramaic from The William Davidson digital edition of the Koren Noé Talmud, with commentary by Rabbi Adin Even-Israel Steinsaltz\nNikud (vocalization) by Dicta - the Israel Center for Text Analysis", + "heExtendedNotes": "", + "heExtendedNotesHebrew": "", + "heVersionNotesInHebrew": "הטקסט הארמי של מהדורת וויליאם דייוידסון הדיגיטלית מתוך תלמוד קורן מהדורת נאה, עם באור מאת הרב אבן־ישראל (שטיינזלץ)\nמנוקד על ידי דיקטה - המרכז הישראלי לניתוח טקסטים", + "heDigitizedBySefaria": false, + "heLicense": "CC-BY-NC", + "formatHeAsPoetry": false, + "title": "Shabbat 22a", + "heBook": "שבת", + "alts": [], + "index_offsets_by_depth": {}, + "next": "Shabbat 22b", + "prev": "Shabbat 21b", + "commentary": [], + "sheets": [], + "layer": [] } + } + } + } + }, + "description": "Successful response" + } + }, + "deprecated": true, + "summary": "Texts (v1)", + "description": "Retrieve the text and some additional metadata for a specific Sefaria textual `Ref`" + }, + "parameters": [ + { + "examples": { + "Tanakh": { + "value": "Kohelet 5:10" + }, + "Talmud": { + "value": "Shabbat 22a.10" + }, + "Talmud Amud": { + "value": "Shabbat 22a" + }, + "Tanakh Chapter": { + "value": "Exodus 10" + }, + "Commentary": { + "value": "Rashi on Genesis 1:1:1" + } + }, + "name": "tref", + "description": "A valid textual `Ref` to a Sefaria text.", + "schema": { + "$ref": "#/components/schemas/ref" + }, + "in": "path", + "required": true + } + ] + }, + "/api/texts/versions/{index}": { + "summary": "All Available Versions of a Text", + "description": "This endpoint return all of the available versions of a text given an index title passed as a parameter. ", + "get": { + "tags": [ + "Text" + ], + "responses": { + "200": { + "content": { + "VersionJSON": { + "schema": { + "type": "array", + "items": { + "$ref": "#/components/schemas/VersionJSON" + } }, - "summary": "Translations", - "description": "Returns a dictionary of texts translated into `lang`, organized by the Sefaria category & secondary category of each title." + "examples": { + "Rashi on Kohelet": { + "value": [ + { + "title": "Rashi on Ecclesiastes", + "versionTitle": "The Metsudah Five Megillot, Lakewood, N.J., 2001", + "versionSource": "https://www.nli.org.il/he/books/NNL_ALEPH002162036", + "language": "he", + "status": "locked", + "license": "CC-BY", + "versionNotes": "", + "digitizedBySefaria": "", + "priority": 2, + "versionTitleInHebrew": "", + "versionNotesInHebrew": "", + "extendedNotes": "", + "extendedNotesHebrew": "", + "purchaseInformationImage": "https://storage.googleapis.com/sefaria-physical-editions/ba0b4357b240eff4b28b7fcfc4669d56.png", + "purchaseInformationURL": "https://www.israelbookshoppublications.com/store/pc/Metsudah-Five-Megilloth-w-Rashi-26p309.htm", + "shortVersionTitle": "", + "shortVersionTitleInHebrew": "", + "isBaseText": true, + "firstSectionRef": "Rashi on Ecclesiastes 1:1" + }, + { + "title": "Rashi on Ecclesiastes", + "versionTitle": "The Metsudah Five Megillot, Lakewood, N.J., 2001", + "versionSource": "https://www.nli.org.il/he/books/NNL_ALEPH002162036", + "language": "en", + "status": "locked", + "license": "CC-BY", + "versionNotes": "", + "digitizedBySefaria": "", + "priority": 2, + "versionTitleInHebrew": "", + "versionNotesInHebrew": "", + "extendedNotes": "", + "extendedNotesHebrew": "", + "purchaseInformationImage": "https://storage.googleapis.com/sefaria-physical-editions/00c61bd3103f9398bf080832c4a0221f.png", + "purchaseInformationURL": "https://www.israelbookshoppublications.com/store/pc/Metsudah-Five-Megilloth-w-Rashi-26p309.htm", + "shortVersionTitle": "", + "shortVersionTitleInHebrew": "", + "isBaseText": false, + "firstSectionRef": "Rashi on Ecclesiastes 1:1" + }, + { + "title": "Rashi on Ecclesiastes", + "versionTitle": "On Your Way", + "versionSource": "http://mobile.tora.ws/", + "language": "he", + "status": "locked", + "license": "Public Domain", + "versionNotes": "", + "digitizedBySefaria": "", + "priority": 1, + "versionTitleInHebrew": "ובלכתך בדרך", + "versionNotesInHebrew": "", + "extendedNotes": "", + "extendedNotesHebrew": "", + "purchaseInformationImage": "", + "purchaseInformationURL": "", + "shortVersionTitle": "", + "shortVersionTitleInHebrew": "", + "isBaseText": true, + "firstSectionRef": "Rashi on Ecclesiastes 1:1" + }, + { + "title": "Rashi on Ecclesiastes", + "versionTitle": "Sefaria Community Translation", + "versionSource": "https://www.sefaria.org", + "language": "en", + "status": "", + "license": "", + "versionNotes": "", + "digitizedBySefaria": "", + "priority": "", + "versionTitleInHebrew": "תרגום קהילת ספריא", + "versionNotesInHebrew": "", + "extendedNotes": "", + "extendedNotesHebrew": "", + "purchaseInformationImage": "", + "purchaseInformationURL": "", + "shortVersionTitle": "", + "shortVersionTitleInHebrew": "", + "isBaseText": false, + "firstSectionRef": "Rashi on Ecclesiastes 3:3" + }, + { + "title": "Rashi on Ecclesiastes", + "versionTitle": "The Five Megilloth, English translation by A. Cohen, Soncino Press, 1946", + "versionSource": "https://www.nli.org.il/en/books/NNL_ALEPH002644163/NLI", + "language": "en", + "status": "locked", + "license": "CC-BY", + "versionNotes": "", + "digitizedBySefaria": "", + "priority": "", + "versionTitleInHebrew": "", + "versionNotesInHebrew": "", + "extendedNotes": "", + "extendedNotesHebrew": "", + "purchaseInformationImage": "", + "purchaseInformationURL": "", + "shortVersionTitle": "Abraham Cohen, Soncino Press, 1946", + "shortVersionTitleInHebrew": "", + "isBaseText": false, + "firstSectionRef": "Rashi on Ecclesiastes 1:1" + } + ] + } + } + } }, - "parameters": [ - { - "examples": { - "English": { - "value": "en" - }, - "Hebrew": { - "value": "he" - }, - "Yiddish": { - "value": "yi\n" - }, - "French": { - "value": "fr" - }, - "German": { - "value": "de" - }, - "Arabic": { - "value": "ar" - } + "description": "Returns a list containing the JSON Objects for each version available for the given `index` title. Each JSON Object contains all of the metadata for a given version. " + } + }, + "summary": "Versions", + "description": "The versions API takes a title of a valid Sefaria `index` as a parameter, and will return all available versions of the text in the Sefaria database, alongside metadata for each version. A version can be a translation of the text, an alternative language, or any other text associated with that index. \n\n*Note:* In order to see the expected results, you need to make sure you are passing a recognized `index`. For example, `Rashi on Genesis` is a valid `index` but `Rashi` is not. To see the entire list of valid Sefaria indices, click [here](https://www.sefaria.org/api/index/)" + }, + "parameters": [ + { + "examples": { + "Mishnah": { + "value": "Mishnah Berakhot" + }, + "Tanakh": { + "value": "Kohelet" + }, + "Commentary": { + "value": "Rashi on Exodus" + }, + "Halacha": { + "value": "Shulchan Aruch Orach Chaim" + } + }, + "name": "index", + "description": "A valid Sefaria Index", + "schema": { + "type": "string" + }, + "in": "path", + "required": true + } + ] + }, + "/api/texts/translations": { + "get": { + "tags": [ + "Text" + ], + "responses": { + "200": { + "content": { + "application/json": { + "schema": { + "type": "array", + "items": { + "type": "string" + } + }, + "examples": { + "translationEx": { + "value": [ + "ar", + "cs", + "de", + "en", + "eo", + "es", + "fa", + "fi", + "fr", + "he", + "hu", + "it", + "ko", + "pl", + "pt", + "ru", + "yi" + ] + } + } + } + }, + "description": "Successful Response" + } + }, + "summary": "Languages", + "description": "Returns a list of distinct languages for which translations exist in the database." + } + }, + "/api/texts/translations/{lang}": { + "get": { + "tags": [ + "Text" + ], + "responses": { + "200": { + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "title": { + "description": "Title of the book on Sefaria", + "type": "string" }, - "name": "lang", - "description": "An ISO 639-1 language code.", - "schema": { - "type": "string" + "url": { + "description": "Base URL of the book on Sefaria", + "type": "string" }, - "in": "path", - "required": true + "versionTitle": { + "description": "Title of this specific translation of the title", + "type": "string" + }, + "rtlLanguage": { + "description": "Is this version a RTL text (i.e. `he`) or LTR text (i.e. `en`)", + "enum": [ + "he", + "en" + ], + "type": "string" + } + } } - ] + } + }, + "description": "Successful Response" + } }, - "/api/manuscripts/{tref}": { - "summary": "For a given `tref` (textual ref), if a manuscript exists, returns a list of all relevant data as well as the image URL for each associated manuscript.", - "get": { - "tags": [ - "Text" - ], - "parameters": [ - { - "examples": { - "Tanakh Example": { - "value": "Numbers 12.1" - }, - "Talmud Example": { - "value": "Berakhot 2a.1" - } - }, - "name": "tref", - "description": "The `tref` parameter must a valid Sefaria ref to a text.", - "schema": { - "type": "string" - }, - "in": "path", - "required": true - } - ], - "responses": { - "200": { - "content": { - "Manuscript JSON": { - "schema": { - "type": "array", - "items": { - "$ref": "#/components/schemas/ManuscriptJSON" - } - }, - "examples": { - "Esther 4:14-15": { - "value": [ - { - "manuscript_slug": "leningrad-codex-(1008-ce)", - "page_id": "LC_Folio_435r", - "image_url": "https://manuscripts.sefaria.org/leningrad-color/BIB_LENCDX_F435A.jpg", - "thumbnail_url": "https://manuscripts.sefaria.org/leningrad-color/BIB_LENCDX_F435A_thumbnail.jpg", - "anchorRef": "Esther 4:17-6:2", - "anchorRefExpanded": [ - "Esther 5:14" - ], - "manuscript": { - "slug": "leningrad-codex-(1008-ce)", - "title": "Leningrad Codex (1008 CE)", - "he_title": "כתב יד לנינגרד (1008)", - "source": "https://dornsife.usc.edu/wsrp/biblical-manuscripts", - "description": "Bruce Zuckerman, West Semitic Research, in collaboration with the Ancient Biblical Manuscript Center; courtesy Russian National Library, Saltykov-Schedrin", - "he_description": "" - } - }, - { - "manuscript_slug": "megilat-ester-or-1047-(17th-century)", - "page_id": "Esther", - "image_url": "https://storage.googleapis.com/sefaria-manuscripts/misc/Megilat%20Ester%2C%20Or%201047%20-%20mid.jpg", - "thumbnail_url": "https://storage.googleapis.com/sefaria-manuscripts/misc/Megilat%20Ester%2C%20Or%201047%20-%20thumb.png", - "anchorRef": "Esther", - "anchorRefExpanded": [ - "Esther 5:14" - ], - "manuscript": { - "slug": "megilat-ester-or-1047-(17th-century)", - "title": "Megilat Ester, Or 1047 (17th Century)", - "he_title": "מגילת אסתר Or 1047 (מאה 17)", - "source": "https://www.bl.uk/collection-items/megilat-ester-or-1047", - "description": "", - "he_description": "" - } - } - ] - } - } - } - }, - "description": "Successful response" - } - }, - "summary": "Manuscripts", - "description": "This call retrieves all associated manuscript data and metadata for a given Sefaria `tref`. " + "summary": "Translations", + "description": "Returns a dictionary of texts translated into `lang`, organized by the Sefaria category & secondary category of each title." + }, + "parameters": [ + { + "examples": { + "English": { + "value": "en" }, - "parameters": [ - { - "examples": { - "Tanakh Example": { - "value": "Numbers.17.2" - }, - "Talmud Example": { - "value": "Berakhot.2a.1" - } - }, - "name": "tref", - "description": "A valid Sefaria ref", - "schema": { - "type": "string" - }, - "in": "path", - "required": true - } - ] - }, - "/api/texts/random": { - "get": { - "tags": [ - "Text" - ], - "parameters": [ - { - "name": "titles", - "description": "A string of book titles from the Sefaria library separated with the character `|`. If it exists it will limit the random selection to those titles.", - "schema": { - "type": "string" - }, - "in": "query" - }, - { - "name": "categories", - "description": "A string of categories from the Sefaria library separated with the character `|`. If it exists it will limit the random selection to those categories.", - "schema": { - "type": "string" - }, - "in": "query" - } - ], - "responses": { - "200": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/textAPIReponse" - } - } - }, - "description": "Successful response" - } - }, - "summary": "Random Text", - "description": "Returns a random text reference from the Sefaria library. Results can be limited to a specific category or from a selection of titles given the correct query params." + "Hebrew": { + "value": "he" + }, + "Yiddish": { + "value": "yi\n" + }, + "French": { + "value": "fr" + }, + "German": { + "value": "de" + }, + "Arabic": { + "value": "ar" } - }, - "/api/v2/raw/index/{index_title}": { - "summary": "v2 Raw Index API", - "description": "This API endpoint will retrieve the full mongo record of the given `Index` as it appears in the database.", - "get": { - "tags": [ - "Index" - ], - "responses": { - "200": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/RawIndexJSON" - }, - "examples": { - "Pesachim": { - "value": { - "title": "Pesachim", - "categories": [ - "Talmud", - "Bavli", - "Seder Moed" - ], - "schema": { - "nodeType": "JaggedArrayNode", - "depth": 2, - "addressTypes": [ - "Talmud", - "Integer" - ], - "sectionNames": [ - "Daf", - "Line" - ], - "match_templates": [ - { - "term_slugs": [ - "talmud", - "bavli", - "pesachim" - ] - }, - { - "term_slugs": [ - "talmud", - "bavli", - "tractate", - "pesachim" - ] - }, - { - "term_slugs": [ - "talmud", - "pesachim" - ] - }, - { - "term_slugs": [ - "bavli", - "pesachim" - ] - }, - { - "term_slugs": [ - "gemara", - "pesachim" - ] - }, - { - "term_slugs": [ - "bavli", - "tractate", - "pesachim" - ] - }, - { - "term_slugs": [ - "gemara", - "tractate", - "pesachim" - ] - }, - { - "term_slugs": [ - "tractate", - "pesachim" - ] - }, - { - "term_slugs": [ - "pesachim" - ] - } - ], - "lengths": [ - 242, - 3519 - ], - "referenceableSections": [ - true, - false - ], - "titles": [ - { - "text": "Masekhet Pesachim", - "lang": "en" - }, - { - "text": "Talmud Pesachim", - "lang": "en" - }, - { - "text": "Tractate Pesachim", - "lang": "en" - }, - { - "text": "Pesahim", - "lang": "en" - }, - { - "text": "Pes.", - "lang": "en" - }, - { - "text": "P’saḥim", - "lang": "en" - }, - { - "text": "Pessachim", - "lang": "en" - }, - { - "text": "BT Pesachim", - "lang": "en" - }, - { - "text": "Psachim", - "lang": "en" - }, - { - "text": "Pesaḥim ", - "lang": "en" - }, - { - "text": "פסחי'", - "lang": "he" - }, - { - "text": "פסחי׳", - "lang": "he" - }, - { - "text": "פסחים", - "lang": "he", - "primary": true - }, - { - "text": "Pesachim", - "lang": "en", - "primary": true - } - ], - "key": "Pesachim", - "checkFirst": { - "he": "משנה פסחים", - "en": "Mishnah Pesachim" - } - }, - "alt_structs": { - "Chapters": { - "nodes": [ - { - "nodeType": "ArrayMapNode", - "depth": 0, - "wholeRef": "Pesachim 2a:1-21a:7", - "includeSections": true, - "match_templates": [ - { - "term_slugs": [ - "perek", - "chapter-129" - ], - "scope": "any" - }, - { - "term_slugs": [ - "perek", - "first" - ] - }, - { - "term_slugs": [ - "chapter-129" - ], - "scope": "any" - }, - { - "term_slugs": [ - "first" - ] - } - ], - "numeric_equivalent": 1, - "titles": [ - { - "primary": true, - "text": "Chapter 1", - "lang": "en" - }, - { - "primary": true, - "text": "אור לארבעה עשר", - "lang": "he" - } - ] - }, - { - "nodeType": "ArrayMapNode", - "depth": 0, - "wholeRef": "Pesachim 21a:8-42a:14", - "includeSections": true, - "match_templates": [ - { - "term_slugs": [ - "perek", - "chapter-224" - ], - "scope": "any" - }, - { - "term_slugs": [ - "perek", - "second" - ] - }, - { - "term_slugs": [ - "chapter-224" - ], - "scope": "any" - }, - { - "term_slugs": [ - "second" - ] - } - ], - "numeric_equivalent": 2, - "titles": [ - { - "primary": true, - "text": "Chapter 2", - "lang": "en" - }, - { - "primary": true, - "text": "כל שעה", - "lang": "he" - } - ] - }, - { - "nodeType": "ArrayMapNode", - "depth": 0, - "wholeRef": "Pesachim 42a:15-50a:22", - "includeSections": true, - "match_templates": [ - { - "term_slugs": [ - "perek", - "chapter-324" - ], - "scope": "any" - }, - { - "term_slugs": [ - "perek", - "third" - ] - }, - { - "term_slugs": [ - "chapter-324" - ], - "scope": "any" - }, - { - "term_slugs": [ - "third" - ] - } - ], - "numeric_equivalent": 3, - "titles": [ - { - "primary": true, - "text": "Chapter 3", - "lang": "en" - }, - { - "primary": true, - "text": "אלו עוברין", - "lang": "he" - } - ] - }, - { - "nodeType": "ArrayMapNode", - "depth": 0, - "wholeRef": "Pesachim 50a:23-57b:3", - "includeSections": true, - "match_templates": [ - { - "term_slugs": [ - "perek", - "chapter-420" - ], - "scope": "any" - }, - { - "term_slugs": [ - "perek", - "fourth" - ] - }, - { - "term_slugs": [ - "chapter-420" - ], - "scope": "any" - }, - { - "term_slugs": [ - "fourth" - ] - } - ], - "numeric_equivalent": 4, - "titles": [ - { - "primary": true, - "text": "Chapter 4", - "lang": "en" - }, - { - "primary": true, - "text": "מקום שנהגו", - "lang": "he" - } - ] - }, - { - "nodeType": "ArrayMapNode", - "depth": 0, - "wholeRef": "Pesachim 58a:1-65b:9", - "includeSections": true, - "match_templates": [ - { - "term_slugs": [ - "perek", - "chapter-518" - ], - "scope": "any" - }, - { - "term_slugs": [ - "perek", - "fifth" - ] - }, - { - "term_slugs": [ - "chapter-518" - ], - "scope": "any" - }, - { - "term_slugs": [ - "fifth" - ] - } - ], - "numeric_equivalent": 5, - "titles": [ - { - "primary": true, - "text": "Chapter 5", - "lang": "en" - }, - { - "primary": true, - "text": "תמיד נשחט", - "lang": "he" - } - ] - }, - { - "nodeType": "ArrayMapNode", - "depth": 0, - "wholeRef": "Pesachim 65b:10-73b:16", - "includeSections": true, - "match_templates": [ - { - "term_slugs": [ - "perek", - "chapter-616" - ], - "scope": "any" - }, - { - "term_slugs": [ - "perek", - "sixth" - ] - }, - { - "term_slugs": [ - "chapter-616" - ], - "scope": "any" - }, - { - "term_slugs": [ - "sixth" - ] - } - ], - "numeric_equivalent": 6, - "titles": [ - { - "primary": true, - "text": "Chapter 6", - "lang": "en" - }, - { - "primary": true, - "text": "אלו דברים", - "lang": "he" - } - ] - }, - { - "nodeType": "ArrayMapNode", - "depth": 0, - "wholeRef": "Pesachim 74a:1-86b:13", - "includeSections": true, - "match_templates": [ - { - "term_slugs": [ - "perek", - "chapter-714" - ], - "scope": "any" - }, - { - "term_slugs": [ - "perek", - "seventh" - ] - }, - { - "term_slugs": [ - "chapter-714" - ], - "scope": "any" - }, - { - "term_slugs": [ - "seventh" - ] - } - ], - "numeric_equivalent": 7, - "titles": [ - { - "primary": true, - "text": "Chapter 7", - "lang": "en" - }, - { - "primary": true, - "text": "כיצד צולין", - "lang": "he" - } - ] - }, - { - "nodeType": "ArrayMapNode", - "depth": 0, - "wholeRef": "Pesachim 87a:1-92b:3", - "includeSections": true, - "match_templates": [ - { - "term_slugs": [ - "perek", - "chapter-814" - ], - "scope": "any" - }, - { - "term_slugs": [ - "perek", - "eighth" - ] - }, - { - "term_slugs": [ - "chapter-814" - ], - "scope": "any" - }, - { - "term_slugs": [ - "eighth" - ] - } - ], - "numeric_equivalent": 8, - "titles": [ - { - "primary": true, - "text": "Chapter 8", - "lang": "en" - }, - { - "primary": true, - "text": "האשה", - "lang": "he" - } - ] - }, - { - "nodeType": "ArrayMapNode", - "depth": 0, - "wholeRef": "Pesachim 92b:4-99a:5", - "includeSections": true, - "match_templates": [ - { - "term_slugs": [ - "perek", - "chapter-914" - ], - "scope": "any" - }, - { - "term_slugs": [ - "perek", - "ninth" - ] - }, - { - "term_slugs": [ - "chapter-914" - ], - "scope": "any" - }, - { - "term_slugs": [ - "ninth" - ] - } - ], - "numeric_equivalent": 9, - "titles": [ - { - "primary": true, - "text": "Chapter 9", - "lang": "en" - }, - { - "primary": true, - "text": "מי שהיה טמא", - "lang": "he" - } - ] - }, - { - "nodeType": "ArrayMapNode", - "depth": 0, - "wholeRef": "Pesachim 99b:1-121b:3", - "includeSections": true, - "match_templates": [ - { - "term_slugs": [ - "perek", - "chapter-109" - ], - "scope": "any" - }, - { - "term_slugs": [ - "perek", - "tenth" - ] - }, - { - "term_slugs": [ - "chapter-109" - ], - "scope": "any" - }, - { - "term_slugs": [ - "tenth" - ] - }, - { - "term_slugs": [ - "perek", - "last" - ] - }, - { - "term_slugs": [ - "last" - ] - } - ], - "numeric_equivalent": 10, - "titles": [ - { - "primary": true, - "text": "Chapter 10", - "lang": "en" - }, - { - "primary": true, - "text": "ערבי פסחים", - "lang": "he" - } - ] - } - ] - } - }, - "default_struct": "Chapters", - "exclude_structs": [ - "schema" - ], - "order": [ - 4, - 3 - ], - "authors": [], - "enDesc": "Pesachim (“Passover Festivals”) is the third tractate in Seder Moed (“Festivals”). Its ten chapters discuss laws relating to Passover: the consumption of matzah (unleavened bread) and maror (bitter herbs), the prohibitions against owning or consuming chametz (leavened bread) on the festival, the paschal lamb that used to be offered at the Temple in Jerusalem, and the order of the seder (ritual feast) held on the first evening of the holiday.\n.", - "enShortDesc": "Passover: ridding of chametz, the Paschal lamb offering, matzah, maror, and the Seder.", - "heShortDesc": "דינים הקשורים לחג הפסח: איסור חמץ, קורבן הפסח, מצה, מרור וליל הסדר.", - "pubDate": [ - 1523 - ], - "hasErrorMargin": true, - "compDate": [ - 450, - 550 - ], - "compPlace": "Talmudic Babylon", - "pubPlace": "Venice", - "era": "A", - "is_cited": true, - "corpora": [ - "Bavli" - ] - } - } - } - } - }, - "description": "Successful Request" - } - }, - "summary": "Index (v2)", - "description": "This API endpoint will retrieve the full mongo record of the given `Index` as it appears in the database." + }, + "name": "lang", + "description": "An ISO 639-1 language code.", + "schema": { + "type": "string" + }, + "in": "path", + "required": true + } + ] + }, + "/api/manuscripts/{tref}": { + "summary": "For a given `tref` (textual ref), if a manuscript exists, returns a list of all relevant data as well as the image URL for each associated manuscript.", + "get": { + "tags": [ + "Text" + ], + "parameters": [ + { + "examples": { + "Tanakh Example": { + "value": "Numbers 12.1" + }, + "Talmud Example": { + "value": "Berakhot 2a.1" + } }, - "parameters": [ - { - "examples": { - "Tanakh": { - "value": "Genesis" - }, - "Talmud": { - "value": "Pesachim" + "name": "tref", + "description": "The `tref` parameter must a valid Sefaria ref to a text.", + "schema": { + "type": "string" + }, + "in": "path", + "required": true + } + ], + "responses": { + "200": { + "content": { + "Manuscript JSON": { + "schema": { + "type": "array", + "items": { + "$ref": "#/components/schemas/ManuscriptJSON" + } + }, + "examples": { + "Esther 4:14-15": { + "value": [ + { + "manuscript_slug": "leningrad-codex-(1008-ce)", + "page_id": "LC_Folio_435r", + "image_url": "https://manuscripts.sefaria.org/leningrad-color/BIB_LENCDX_F435A.jpg", + "thumbnail_url": "https://manuscripts.sefaria.org/leningrad-color/BIB_LENCDX_F435A_thumbnail.jpg", + "anchorRef": "Esther 4:17-6:2", + "anchorRefExpanded": [ + "Esther 5:14" + ], + "manuscript": { + "slug": "leningrad-codex-(1008-ce)", + "title": "Leningrad Codex (1008 CE)", + "he_title": "כתב יד לנינגרד (1008)", + "source": "https://dornsife.usc.edu/wsrp/biblical-manuscripts", + "description": "Bruce Zuckerman, West Semitic Research, in collaboration with the Ancient Biblical Manuscript Center; courtesy Russian National Library, Saltykov-Schedrin", + "he_description": "" } - }, - "name": "index_title", - "description": "A title of a valid Sefaria `Index`. For a complete list of works in the [Sefaria](sefaria.org) library, as well as their index titles, query the [api/index](https://www.sefaria.org/api/index/) endpoint. ", - "schema": { - "type": "string" - }, - "in": "path", - "required": true + }, + { + "manuscript_slug": "megilat-ester-or-1047-(17th-century)", + "page_id": "Esther", + "image_url": "https://storage.googleapis.com/sefaria-manuscripts/misc/Megilat%20Ester%2C%20Or%201047%20-%20mid.jpg", + "thumbnail_url": "https://storage.googleapis.com/sefaria-manuscripts/misc/Megilat%20Ester%2C%20Or%201047%20-%20thumb.png", + "anchorRef": "Esther", + "anchorRefExpanded": [ + "Esther 5:14" + ], + "manuscript": { + "slug": "megilat-ester-or-1047-(17th-century)", + "title": "Megilat Ester, Or 1047 (17th Century)", + "he_title": "מגילת אסתר Or 1047 (מאה 17)", + "source": "https://www.bl.uk/collection-items/megilat-ester-or-1047", + "description": "", + "he_description": "" + } + } + ] + } } - ] + } + }, + "description": "Successful response" + } }, - "/api/index/": { - "get": { - "tags": [ - "Index" - ], - "responses": { - "200": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/APIIndexResponse" - } - } - }, - "description": "Successful Response" - } - }, - "summary": "Table of Contents", - "description": "This API endpoint returns the titles of all the books in the Sefaria Library arranged by their category along with some additional metadata. This is a large and rarely changing request and should be cached locally if you utilize it." + "summary": "Manuscripts", + "description": "This call retrieves all associated manuscript data and metadata for a given Sefaria `tref`. " + }, + "parameters": [ + { + "examples": { + "Tanakh Example": { + "value": "Numbers.17.2" + }, + "Talmud Example": { + "value": "Berakhot.2a.1" } - }, - "/api/shape/{title}": { - "summary": "Shape", - "description": "The shape API allows one to retrieve information about the shape of an Index on Sefaria. The shape refers some basic statistics about the Index, mostly the number of chapters, and the number of segments per chapter.", - "get": { - "tags": [ - "Index" - ], - "responses": { - "200": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/ShapeJSON" - }, - "examples": { - "Complex Text": { - "value": [ - { - "isComplex": true, - "section": "Haggadah", - "length": 38, - "chapters": [ - { - "section": "Haggadah", - "heTitle": "הגדה של פסח, קדש", - "title": "Pesach Haggadah, Kadesh", - "length": 1, - "chapters": 13, - "book": "Pesach Haggadah", - "heBook": "הגדה של פסח" - }, - { - "section": "Haggadah", - "heTitle": "הגדה של פסח, ורחץ", - "title": "Pesach Haggadah, Urchatz", - "length": 1, - "chapters": 2, - "book": "Pesach Haggadah", - "heBook": "הגדה של פסח" - }, - { - "section": "Haggadah", - "heTitle": "הגדה של פסח, כרפס", - "title": "Pesach Haggadah, Karpas", - "length": 1, - "chapters": 3, - "book": "Pesach Haggadah", - "heBook": "הגדה של פסח" - }, - { - "section": "Haggadah", - "heTitle": "הגדה של פסח, יחץ", - "title": "Pesach Haggadah, Yachatz", - "length": 1, - "chapters": 2, - "book": "Pesach Haggadah", - "heBook": "הגדה של פסח" - }, - { - "section": "Haggadah", - "heTitle": "הגדה של פסח, מגיד, הא לחמא עניא", - "title": "Pesach Haggadah, Magid, Ha Lachma Anya", - "length": 1, - "chapters": 3, - "book": "Pesach Haggadah", - "heBook": "הגדה של פסח" - }, - { - "section": "Haggadah", - "heTitle": "הגדה של פסח, מגיד, מה נשתנה", - "title": "Pesach Haggadah, Magid, Four Questions", - "length": 1, - "chapters": 2, - "book": "Pesach Haggadah", - "heBook": "הגדה של פסח" - }, - { - "section": "Haggadah", - "heTitle": "הגדה של פסח, מגיד, עבדים היינו", - "title": "Pesach Haggadah, Magid, We Were Slaves in Egypt", - "length": 1, - "chapters": 2, - "book": "Pesach Haggadah", - "heBook": "הגדה של פסח" - }, - { - "section": "Haggadah", - "heTitle": "הגדה של פסח, מגיד, מעשה שהיה בבני ברק", - "title": "Pesach Haggadah, Magid, Story of the Five Rabbis", - "length": 1, - "chapters": 2, - "book": "Pesach Haggadah", - "heBook": "הגדה של פסח" - }, - { - "section": "Haggadah", - "heTitle": "הגדה של פסח, מגיד, כנגד ארבעה בנים", - "title": "Pesach Haggadah, Magid, The Four Sons", - "length": 1, - "chapters": 5, - "book": "Pesach Haggadah", - "heBook": "הגדה של פסח" - }, - { - "section": "Haggadah", - "heTitle": "הגדה של פסח, מגיד, יכול מראש חודש", - "title": "Pesach Haggadah, Magid, Yechol Me'rosh Chodesh", - "length": 1, - "chapters": 1, - "book": "Pesach Haggadah", - "heBook": "הגדה של פסח" - }, - { - "section": "Haggadah", - "heTitle": "הגדה של פסח, מגיד, מתחילה עובדי עבודה זרה היו אבותינו", - "title": "Pesach Haggadah, Magid, In the Beginning Our Fathers Were Idol Worshipers", - "length": 1, - "chapters": 5, - "book": "Pesach Haggadah", - "heBook": "הגדה של פסח" - }, - { - "section": "Haggadah", - "heTitle": "הגדה של פסח, מגיד, ארמי אבד אבי", - "title": "Pesach Haggadah, Magid, First Fruits Declaration", - "length": 1, - "chapters": 24, - "book": "Pesach Haggadah", - "heBook": "הגדה של פסח" - }, - { - "section": "Haggadah", - "heTitle": "הגדה של פסח, מגיד, עשר המכות", - "title": "Pesach Haggadah, Magid, The Ten Plagues", - "length": 1, - "chapters": 20, - "book": "Pesach Haggadah", - "heBook": "הגדה של פסח" - }, - { - "section": "Haggadah", - "heTitle": "הגדה של פסח, מגיד, דיינו", - "title": "Pesach Haggadah, Magid, Dayenu", - "length": 1, - "chapters": 16, - "book": "Pesach Haggadah", - "heBook": "הגדה של פסח" - }, - { - "section": "Haggadah", - "heTitle": "הגדה של פסח, מגיד, פסח מצה ומרור", - "title": "Pesach Haggadah, Magid, Rabban Gamliel's Three Things", - "length": 1, - "chapters": 7, - "book": "Pesach Haggadah", - "heBook": "הגדה של פסח" - }, - { - "section": "Haggadah", - "heTitle": "הגדה של פסח, מגיד, חצי הלל", - "title": "Pesach Haggadah, Magid, First Half of Hallel", - "length": 1, - "chapters": 4, - "book": "Pesach Haggadah", - "heBook": "הגדה של פסח" - }, - { - "section": "Haggadah", - "heTitle": "הגדה של פסח, מגיד, כוס שניה", - "title": "Pesach Haggadah, Magid, Second Cup of Wine", - "length": 1, - "chapters": 4, - "book": "Pesach Haggadah", - "heBook": "הגדה של פסח" - }, - { - "section": "Haggadah", - "heTitle": "הגדה של פסח, רחצה", - "title": "Pesach Haggadah, Rachtzah", - "length": 1, - "chapters": 3, - "book": "Pesach Haggadah", - "heBook": "הגדה של פסח" - }, - { - "section": "Haggadah", - "heTitle": "הגדה של פסח, מוציא מצה", - "title": "Pesach Haggadah, Motzi Matzah", - "length": 1, - "chapters": 4, - "book": "Pesach Haggadah", - "heBook": "הגדה של פסח" - }, - { - "section": "Haggadah", - "heTitle": "הגדה של פסח, מרור", - "title": "Pesach Haggadah, Maror", - "length": 1, - "chapters": 3, - "book": "Pesach Haggadah", - "heBook": "הגדה של פסח" - }, - { - "section": "Haggadah", - "heTitle": "הגדה של פסח, כורך", - "title": "Pesach Haggadah, Korech", - "length": 1, - "chapters": 4, - "book": "Pesach Haggadah", - "heBook": "הגדה של פסח" - }, - { - "section": "Haggadah", - "heTitle": "הגדה של פסח, שולחן עורך", - "title": "Pesach Haggadah, Shulchan Orech", - "length": 1, - "chapters": 2, - "book": "Pesach Haggadah", - "heBook": "הגדה של פסח" - }, - { - "section": "Haggadah", - "heTitle": "הגדה של פסח, צפון", - "title": "Pesach Haggadah, Tzafun", - "length": 1, - "chapters": 3, - "book": "Pesach Haggadah", - "heBook": "הגדה של פסח" - }, - { - "section": "Haggadah", - "heTitle": "הגדה של פסח, ברך, ברכת המזון", - "title": "Pesach Haggadah, Barech, Birkat Hamazon", - "length": 1, - "chapters": 23, - "book": "Pesach Haggadah", - "heBook": "הגדה של פסח" - }, - { - "section": "Haggadah", - "heTitle": "הגדה של פסח, ברך, כוס שלישית", - "title": "Pesach Haggadah, Barech, Third Cup of Wine", - "length": 1, - "chapters": 2, - "book": "Pesach Haggadah", - "heBook": "הגדה של פסח" - }, - { - "section": "Haggadah", - "heTitle": "הגדה של פסח, ברך, שפוך חמתך", - "title": "Pesach Haggadah, Barech, Pour Out Thy Wrath", - "length": 1, - "chapters": 2, - "book": "Pesach Haggadah", - "heBook": "הגדה של פסח" - }, - { - "section": "Haggadah", - "heTitle": "הגדה של פסח, הלל, מסיימים את ההלל", - "title": "Pesach Haggadah, Hallel, Second Half of Hallel", - "length": 1, - "chapters": 10, - "book": "Pesach Haggadah", - "heBook": "הגדה של פסח" - }, - { - "section": "Haggadah", - "heTitle": "הגדה של פסח, הלל, מזמורי הודיה", - "title": "Pesach Haggadah, Hallel, Songs of Praise and Thanks", - "length": 1, - "chapters": 6, - "book": "Pesach Haggadah", - "heBook": "הגדה של פסח" - }, - { - "section": "Haggadah", - "heTitle": "הגדה של פסח, הלל, כוס רביעית", - "title": "Pesach Haggadah, Hallel, Fourth Cup of Wine", - "length": 1, - "chapters": 4, - "book": "Pesach Haggadah", - "heBook": "הגדה של פסח" - }, - { - "section": "Haggadah", - "heTitle": "הגדה של פסח, נרצה, חסל סידור פסח", - "title": "Pesach Haggadah, Nirtzah, Chasal Siddur Pesach", - "length": 1, - "chapters": 2, - "book": "Pesach Haggadah", - "heBook": "הגדה של פסח" - }, - { - "section": "Haggadah", - "heTitle": "הגדה של פסח, נרצה, לשנה הבאה", - "title": "Pesach Haggadah, Nirtzah, L'Shana HaBaa", - "length": 1, - "chapters": 1, - "book": "Pesach Haggadah", - "heBook": "הגדה של פסח" - }, - { - "section": "Haggadah", - "heTitle": "הגדה של פסח, נרצה, ויהי בחצי הלילה", - "title": "Pesach Haggadah, Nirtzah, And It Happened at Midnight", - "length": 1, - "chapters": 11, - "book": "Pesach Haggadah", - "heBook": "הגדה של פסח" - }, - { - "section": "Haggadah", - "heTitle": "הגדה של פסח, נרצה, זבח פסח", - "title": "Pesach Haggadah, Nirtzah, Zevach Pesach", - "length": 1, - "chapters": 8, - "book": "Pesach Haggadah", - "heBook": "הגדה של פסח" - }, - { - "section": "Haggadah", - "heTitle": "הגדה של פסח, נרצה, אדיר במלוכה", - "title": "Pesach Haggadah, Nirtzah, Ki Lo Na'e", - "length": 1, - "chapters": 9, - "book": "Pesach Haggadah", - "heBook": "הגדה של פסח" - }, - { - "section": "Haggadah", - "heTitle": "הגדה של פסח, נרצה, אדיר הוא", - "title": "Pesach Haggadah, Nirtzah, Adir Hu", - "length": 1, - "chapters": 8, - "book": "Pesach Haggadah", - "heBook": "הגדה של פסח" - }, - { - "section": "Haggadah", - "heTitle": "הגדה של פסח, נרצה, ספירת העומר", - "title": "Pesach Haggadah, Nirtzah, Sefirat HaOmer", - "length": 1, - "chapters": 2, - "book": "Pesach Haggadah", - "heBook": "הגדה של פסח" - }, - { - "section": "Haggadah", - "heTitle": "הגדה של פסח, נרצה, אחד מי יודע", - "title": "Pesach Haggadah, Nirtzah, Echad Mi Yodea", - "length": 1, - "chapters": 1, - "book": "Pesach Haggadah", - "heBook": "הגדה של פסח" - }, - { - "section": "Haggadah", - "heTitle": "הגדה של פסח, נרצה, חד גדיא", - "title": "Pesach Haggadah, Nirtzah, Chad Gadya", - "length": 1, - "chapters": 10, - "book": "Pesach Haggadah", - "heBook": "הגדה של פסח" - } - ], - "book": "Pesach Haggadah", - "heBook": "הגדה של פסח" - } - ] - }, - "Simple Text": { - "value": [ - { - "section": "Torah", - "heTitle": "שמות", - "title": "Exodus", - "length": 40, - "chapters": [ - 22, - 25, - 22, - 31, - 23, - 30, - 29, - 28, - 35, - 29, - 10, - 51, - 22, - 31, - 27, - 36, - 16, - 27, - 25, - 23, - 37, - 30, - 33, - 18, - 40, - 37, - 21, - 43, - 46, - 38, - 18, - 35, - 23, - 35, - 35, - 38, - 29, - 31, - 43, - 38 - ], - "book": "Exodus", - "heBook": "שמות" - } - ] - } - } - } - }, - "description": "Retrieve basic statistics and information about the \"shape\" of an `Index` on Sefaria. " - } - }, - "summary": "Shape", - "description": "Retrieve basic statistics and information about the \"shape\" of an `Index` on Sefaria. " + }, + "name": "tref", + "description": "A valid Sefaria ref", + "schema": { + "type": "string" + }, + "in": "path", + "required": true + } + ] + }, + "/api/texts/random": { + "get": { + "tags": [ + "Text" + ], + "parameters": [ + { + "name": "titles", + "description": "A string of book titles from the Sefaria library separated with the character `|`. If it exists it will limit the random selection to those titles.", + "schema": { + "type": "string" }, - "parameters": [ - { - "examples": { - "Tanakh": { - "value": "Jonah" - }, - "Talmud": { - "value": "Pesachim" - }, - "Commentary": { - "value": "Rashi on Exodus" - }, - "Category": { - "value": "Tanakh/Modern Commentary on Tanakh/Steinsaltz" - } - }, - "name": "title", - "description": "The title of a valid Sefaria `Index`, or the path of a valid Sefaria category. ", - "schema": { - "type": "string" - }, - "in": "path", - "required": true - }, - { - "name": "depth", - "description": "The `depth` parameter in the query string indicates how many levels in the category tree to descend.\nIf `depth=0` is passed, then the returned JSON descends to end of tree.\nThe default is `depth=2`.", - "schema": { - "type": "integer" - }, - "in": "query" - }, - { - "name": "dependents", - "description": "The dependents parameter, if `true`, includes dependent texts. By default, they are filtered out.", - "schema": { - "type": "boolean" - }, - "in": "query", - "required": false - } - ] - }, - "/api/related/{tref}": { - "summary": "The Related API", - "description": "The Related API returns all related links, sheets, notes, webpages, topics, manuscripts, and other connected media for a given `Ref`. ", - "get": { - "tags": [ - "Related" - ], - "responses": { - "200": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/RelatedJSON" - }, - "examples": { - "Or HaChaim on Deuteronomy 1:1:1": { - "value": { - "links": [ - { - "_id": "54bd48c4fbfba21733367bfa", - "index_title": "Psalms", - "category": "Tanakh", - "type": "", - "ref": "Psalms 51", - "anchorRef": "Or HaChaim on Deuteronomy 1:1:1", - "anchorRefExpanded": [ - "Or HaChaim on Deuteronomy 1:1:1" - ], - "sourceRef": "Psalms 51", - "sourceHeRef": "תהילים נ״א", - "anchorVerse": 1, - "sourceHasEn": true, - "compDate": [ - -1000, - 0 - ], - "commentaryNum": 51, - "collectiveTitle": { - "en": "Psalms", - "he": "תהילים" - }, - "heTitle": "תהילים" - }, - { - "_id": "54bd48c4fbfba21733367bfc", - "index_title": "Pirkei Avot", - "category": "Mishnah", - "type": "", - "ref": "Pirkei Avot 3", - "anchorRef": "Or HaChaim on Deuteronomy 1:1:1", - "anchorRefExpanded": [ - "Or HaChaim on Deuteronomy 1:1:1" - ], - "sourceRef": "Pirkei Avot 3", - "sourceHeRef": "משנה אבות ג׳", - "anchorVerse": 1, - "sourceHasEn": true, - "compDate": [ - 190, - 230 - ], - "commentaryNum": 3, - "collectiveTitle": { - "en": "Pirkei Avot", - "he": "משנה אבות" - }, - "heTitle": "משנה אבות" - }, - { - "_id": "54bd48c4fbfba21733367bfe", - "index_title": "Pirkei Avot", - "category": "Mishnah", - "type": "", - "ref": "Pirkei Avot 4", - "anchorRef": "Or HaChaim on Deuteronomy 1:1:1", - "anchorRefExpanded": [ - "Or HaChaim on Deuteronomy 1:1:1" - ], - "sourceRef": "Pirkei Avot 4", - "sourceHeRef": "משנה אבות ד׳", - "anchorVerse": 1, - "sourceHasEn": true, - "compDate": [ - 190, - 230 - ], - "commentaryNum": 4, - "collectiveTitle": { - "en": "Pirkei Avot", - "he": "משנה אבות" - }, - "heTitle": "משנה אבות" - }, - { - "_id": "54bd48c4fbfba21733367c08", - "index_title": "Proverbs", - "category": "Tanakh", - "type": "", - "ref": "Proverbs 3", - "anchorRef": "Or HaChaim on Deuteronomy 1:1:1", - "anchorRefExpanded": [ - "Or HaChaim on Deuteronomy 1:1:1" - ], - "sourceRef": "Proverbs 3", - "sourceHeRef": "משלי ג׳", - "anchorVerse": 1, - "sourceHasEn": true, - "compDate": [ - -800, - -400 - ], - "commentaryNum": 3, - "collectiveTitle": { - "en": "Proverbs", - "he": "משלי" - }, - "heTitle": "משלי" - }, - { - "_id": "54bd48c4fbfba21733367c0e", - "index_title": "Yoma", - "category": "Talmud", - "type": "", - "ref": "Yoma 19b", - "anchorRef": "Or HaChaim on Deuteronomy 1:1:1", - "anchorRefExpanded": [ - "Or HaChaim on Deuteronomy 1:1:1" - ], - "sourceRef": "Yoma 19b", - "sourceHeRef": "יומא י״ט ב", - "anchorVerse": 1, - "sourceHasEn": true, - "compDate": [ - 450, - 550 - ], - "commentaryNum": 38, - "collectiveTitle": { - "en": "Yoma", - "he": "יומא" - }, - "heTitle": "יומא" - }, - { - "_id": "53f17c73fbfba22336eaba1e", - "index_title": "Deuteronomy", - "category": "Tanakh", - "type": "commentary", - "ref": "Deuteronomy 1:1", - "anchorRef": "Or HaChaim on Deuteronomy 1:1:1", - "anchorRefExpanded": [ - "Or HaChaim on Deuteronomy 1:1:1" - ], - "sourceRef": "Deuteronomy 1:1", - "sourceHeRef": "דברים א׳:א׳", - "anchorVerse": 1, - "sourceHasEn": true, - "compDate": [ - -1400, - -400 - ], - "commentaryNum": 1.0001, - "collectiveTitle": { - "en": "Deuteronomy", - "he": "דברים" - }, - "heTitle": "דברים" - }, - { - "_id": "54bd48c4fbfba21733367bf8", - "index_title": "Exodus", - "category": "Tanakh", - "type": "", - "ref": "Exodus 19:2", - "anchorRef": "Or HaChaim on Deuteronomy 1:1:1", - "anchorRefExpanded": [ - "Or HaChaim on Deuteronomy 1:1:1" - ], - "sourceRef": "Exodus 19:2", - "sourceHeRef": "שמות י״ט:ב׳", - "anchorVerse": 1, - "sourceHasEn": true, - "compDate": [ - -1400, - -400 - ], - "commentaryNum": 19.0002, - "collectiveTitle": { - "en": "Exodus", - "he": "שמות" - }, - "heTitle": "שמות" - }, - { - "_id": "54bd48c4fbfba21733367c00", - "index_title": "Numbers", - "category": "Tanakh", - "type": "", - "ref": "Numbers 20", - "anchorRef": "Or HaChaim on Deuteronomy 1:1:1", - "anchorRefExpanded": [ - "Or HaChaim on Deuteronomy 1:1:1" - ], - "sourceRef": "Numbers 20", - "sourceHeRef": "במדבר כ׳", - "anchorVerse": 1, - "sourceHasEn": true, - "compDate": [ - -1400, - -400 - ], - "commentaryNum": 20, - "collectiveTitle": { - "en": "Numbers", - "he": "במדבר" - }, - "heTitle": "במדבר" - }, - { - "_id": "54bd48c4fbfba21733367c02", - "index_title": "Numbers", - "category": "Tanakh", - "type": "", - "ref": "Numbers 12:8", - "anchorRef": "Or HaChaim on Deuteronomy 1:1:1", - "anchorRefExpanded": [ - "Or HaChaim on Deuteronomy 1:1:1" - ], - "sourceRef": "Numbers 12:8", - "sourceHeRef": "במדבר י״ב:ח׳", - "anchorVerse": 1, - "sourceHasEn": true, - "compDate": [ - -1400, - -400 - ], - "commentaryNum": 12.0008, - "collectiveTitle": { - "en": "Numbers", - "he": "במדבר" - }, - "heTitle": "במדבר" - }, - { - "_id": "54bd48c4fbfba21733367c06", - "index_title": "Kiddushin", - "category": "Talmud", - "type": "", - "ref": "Kiddushin 38a", - "anchorRef": "Or HaChaim on Deuteronomy 1:1:1", - "anchorRefExpanded": [ - "Or HaChaim on Deuteronomy 1:1:1" - ], - "sourceRef": "Kiddushin 38a", - "sourceHeRef": "קידושין ל״ח א", - "anchorVerse": 1, - "sourceHasEn": true, - "compDate": [ - 450, - 550 - ], - "commentaryNum": 75, - "collectiveTitle": { - "en": "Kiddushin", - "he": "קידושין" - }, - "heTitle": "קידושין" - }, - { - "_id": "54bd48c4fbfba21733367c0a", - "index_title": "Berakhot", - "category": "Talmud", - "type": "", - "ref": "Berakhot 7a", - "anchorRef": "Or HaChaim on Deuteronomy 1:1:1", - "anchorRefExpanded": [ - "Or HaChaim on Deuteronomy 1:1:1" - ], - "sourceRef": "Berakhot 7a", - "sourceHeRef": "ברכות ז׳ א", - "anchorVerse": 1, - "sourceHasEn": true, - "compDate": [ - 450, - 550 - ], - "commentaryNum": 13, - "collectiveTitle": { - "en": "Berakhot", - "he": "ברכות" - }, - "heTitle": "ברכות" - }, - { - "_id": "54bd48c4fbfba21733367c0c", - "index_title": "Eruvin", - "category": "Talmud", - "type": "", - "ref": "Eruvin 54a", - "anchorRef": "Or HaChaim on Deuteronomy 1:1:1", - "anchorRefExpanded": [ - "Or HaChaim on Deuteronomy 1:1:1" - ], - "sourceRef": "Eruvin 54a", - "sourceHeRef": "עירובין נ״ד א", - "anchorVerse": 1, - "sourceHasEn": true, - "compDate": [ - 450, - 550 - ], - "commentaryNum": 107, - "collectiveTitle": { - "en": "Eruvin", - "he": "עירובין" - }, - "heTitle": "עירובין" - }, - { - "_id": "54bd48c4fbfba21733367c10", - "index_title": "Genesis", - "category": "Tanakh", - "type": "", - "ref": "Genesis 14:13", - "anchorRef": "Or HaChaim on Deuteronomy 1:1:1", - "anchorRefExpanded": [ - "Or HaChaim on Deuteronomy 1:1:1" - ], - "sourceRef": "Genesis 14:13", - "sourceHeRef": "בראשית י״ד:י״ג", - "anchorVerse": 1, - "sourceHasEn": true, - "compDate": [ - -1400, - -400 - ], - "commentaryNum": 14.0013, - "collectiveTitle": { - "en": "Genesis", - "he": "בראשית" - }, - "heTitle": "בראשית" - }, - { - "_id": "54bd48c4fbfba21733367c12", - "index_title": "Genesis", - "category": "Tanakh", - "type": "", - "ref": "Genesis 25:27", - "anchorRef": "Or HaChaim on Deuteronomy 1:1:1", - "anchorRefExpanded": [ - "Or HaChaim on Deuteronomy 1:1:1" - ], - "sourceRef": "Genesis 25:27", - "sourceHeRef": "בראשית כ״ה:כ״ז", - "anchorVerse": 1, - "sourceHasEn": true, - "compDate": [ - -1400, - -400 - ], - "commentaryNum": 25.0027, - "collectiveTitle": { - "en": "Genesis", - "he": "בראשית" - }, - "heTitle": "בראשית" - }, - { - "_id": "5c17ba58b071e100bf4f3c69", - "index_title": "Megillah", - "category": "Talmud", - "type": "", - "ref": "Megillah 31b:8", - "anchorRef": "Or HaChaim on Deuteronomy 1:1:1", - "anchorRefExpanded": [ - "Or HaChaim on Deuteronomy 1:1:1" - ], - "sourceRef": "Megillah 31b:8", - "sourceHeRef": "מגילה ל״א ב:ח׳", - "anchorVerse": 1, - "sourceHasEn": true, - "compDate": [ - 450, - 550 - ], - "commentaryNum": 62.0008, - "collectiveTitle": { - "en": "Megillah", - "he": "מגילה" - }, - "heTitle": "מגילה" - } - ], - "sheets": [ - { - "owner": 10614, - "_id": "60ee8884d6d0a523b1342111", - "id": "335567", - "public": true, - "title": "Gentle Rebuke", - "sheetUrl": "/sheets/335567", - "anchorRef": "Or HaChaim on Deuteronomy 1:1:1", - "anchorRefExpanded": [ - "Or HaChaim on Deuteronomy 1:1:1" - ], - "options": { - "numbered": 0, - "boxed": 0, - "assignable": 0, - "bsd": 0, - "language": "bilingual", - "layout": "sideBySide", - "langLayout": "heRight", - "divineNames": "noSub", - "highlightMode": 0, - "collaboration": "none" - }, - "ownerName": "Rabbi Yossi Orkin", - "ownerProfileUrl": "/profile/yossi-orkin", - "ownerImageUrl": "https://storage.googleapis.com/sefaria-profile-pictures/yossi-orkin-1626415935-small.png", - "status": "public", - "views": 398, - "topics": [ - { - "slug": "deuteronomy", - "asTyped": "Parshat Devarim", - "en": "Parshat Devarim", - "he": "ספר דברים" - } - ], - "likes": [], - "summary": "Parshat Devarim Questions", - "is_featured": false, - "category": "Sheets", - "type": "sheet" - }, - { - "owner": 92910, - "_id": "60ec76e6340e9458714cc018", - "id": "335153", - "public": true, - "title": "R'Isaac Bernstein -1st of series on \"themes in Devorim\".", - "sheetUrl": "/sheets/335153", - "anchorRef": "Or HaChaim on Deuteronomy 1:1:1", - "anchorRefExpanded": [ - "Or HaChaim on Deuteronomy 1:1:1" - ], - "options": { - "numbered": 0, - "boxed": 0, - "assignable": 0, - "bsd": 0, - "language": "hebrew", - "layout": "stacked", - "langLayout": "heRight", - "divineNames": "h", - "highlightMode": 0, - "collaboration": "none" - }, - "ownerName": "I am Anonymous", - "ownerProfileUrl": "/profile/i-am-anonymous", - "ownerImageUrl": "", - "status": "public", - "views": 278, - "topics": [ - { - "slug": "parshanut1", - "asTyped": "Parshanut", - "en": "Parshanut", - "he": "פרשנות" - }, - { - "slug": "torah-portions", - "asTyped": "Parsha", - "en": "Parsha", - "he": "פרשות השבוע" - } - ], - "likes": [], - "summary": "Parsha shiurim by R'Isaac Bernsein", - "is_featured": false, - "category": "Sheets", - "type": "sheet" - }, - { - "owner": 62800, - "_id": "62ed99e8a85e3ca24ef0064f", - "id": "423213", - "public": true, - "title": "OHR HACHAIM ON DEVARIM", - "sheetUrl": "/sheets/423213", - "anchorRef": "Or HaChaim on Deuteronomy 1:1", - "anchorRefExpanded": [ - "Or HaChaim on Deuteronomy 1:1:1" - ], - "options": { - "numbered": 0, - "boxed": 0, - "assignable": 0, - "bsd": 0, - "language": "hebrew", - "layout": "stacked", - "langLayout": "heRight", - "divineNames": "noSub", - "highlightMode": 0, - "collaboration": "none" - }, - "ownerName": "Yitzi Adlin", - "ownerProfileUrl": "/profile/yitzi-adlin", - "ownerImageUrl": "", - "status": "public", - "views": 186, - "topics": [], - "likes": [], - "summary": "", - "is_featured": false, - "category": "Sheets", - "type": "sheet" - } - ], - "notes": [], - "webpages": [], - "topics": [], - "manuscripts": [], - "media": [] - } - } - } - } - }, - "description": "All content related to the queried `Ref`. " - } - }, - "summary": "Related", - "description": "A single API endpoint to return all of the content (links, sheets, notes, media, manuscripts, webpages and topics) related to the given `Ref` in the query. " + "in": "query" + }, + { + "name": "categories", + "description": "A string of categories from the Sefaria library separated with the character `|`. If it exists it will limit the random selection to those categories.", + "schema": { + "type": "string" }, - "parameters": [ - { - "examples": { - "Tanakh": { - "value": "Deuteronomy 1.1" - } - }, - "name": "tref", - "description": "A valid Sefaria textual `Ref`. ", - "schema": { - "$ref": "#/components/schemas/ref" - }, - "in": "path", - "required": true + "in": "query" + } + ], + "responses": { + "200": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/textAPIReponse" } - ] + } + }, + "description": "Successful response" + } }, - "/api/links/{tref}": { - "get": { - "tags": [ - "Related" - ], - "parameters": [ - { - "name": "with_text", - "description": "`with_text` is an optional parameter that determines whether or not the API response will include the text of any connected links. It's default is `1`", - "schema": { - "type": "boolean" - }, - "in": "query" - }, - { - "name": "with_sheet_links", - "description": "`with_sheet_links` is an optional parameter that determines whether or not the API response will include links to user generated source sheets from Sefaria. It's default is `0`", - "schema": { - "type": "boolean" - }, - "in": "query" - } - ], - "responses": { - "200": { - "content": { - "application/json": { - "schema": { - "type": "array", - "items": { - "$ref": "#/components/schemas/LinkObj" - } - } - } - }, - "description": "Successful response" - } + "summary": "Random Text", + "description": "Returns a random text reference from the Sefaria library. Results can be limited to a specific category or from a selection of titles given the correct query params." + } + }, + "/api/v2/raw/index/{index_title}": { + "summary": "v2 Raw Index API", + "description": "This API endpoint will retrieve the full mongo record of the given `Index` as it appears in the database.", + "get": { + "tags": [ + "Index" + ], + "responses": { + "200": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/RawIndexJSON" }, - "summary": "Links", - "description": "Returns a list of known connections for the submitted text `ref` along with some additional metadata." - }, - "parameters": [ - { - "examples": { - "Tanakh": { - "value": "Obadiah 1.2" + "examples": { + "Pesachim": { + "value": { + "title": "Pesachim", + "categories": [ + "Talmud", + "Bavli", + "Seder Moed" + ], + "schema": { + "nodeType": "JaggedArrayNode", + "depth": 2, + "addressTypes": [ + "Talmud", + "Integer" + ], + "sectionNames": [ + "Daf", + "Line" + ], + "match_templates": [ + { + "term_slugs": [ + "talmud", + "bavli", + "pesachim" + ] + }, + { + "term_slugs": [ + "talmud", + "bavli", + "tractate", + "pesachim" + ] + }, + { + "term_slugs": [ + "talmud", + "pesachim" + ] + }, + { + "term_slugs": [ + "bavli", + "pesachim" + ] + }, + { + "term_slugs": [ + "gemara", + "pesachim" + ] + }, + { + "term_slugs": [ + "bavli", + "tractate", + "pesachim" + ] + }, + { + "term_slugs": [ + "gemara", + "tractate", + "pesachim" + ] + }, + { + "term_slugs": [ + "tractate", + "pesachim" + ] + }, + { + "term_slugs": [ + "pesachim" + ] + } + ], + "lengths": [ + 242, + 3519 + ], + "referenceableSections": [ + true, + false + ], + "titles": [ + { + "text": "Masekhet Pesachim", + "lang": "en" + }, + { + "text": "Talmud Pesachim", + "lang": "en" + }, + { + "text": "Tractate Pesachim", + "lang": "en" + }, + { + "text": "Pesahim", + "lang": "en" + }, + { + "text": "Pes.", + "lang": "en" + }, + { + "text": "P’saḥim", + "lang": "en" + }, + { + "text": "Pessachim", + "lang": "en" + }, + { + "text": "BT Pesachim", + "lang": "en" + }, + { + "text": "Psachim", + "lang": "en" + }, + { + "text": "Pesaḥim ", + "lang": "en" + }, + { + "text": "פסחי'", + "lang": "he" + }, + { + "text": "פסחי׳", + "lang": "he" + }, + { + "text": "פסחים", + "lang": "he", + "primary": true + }, + { + "text": "Pesachim", + "lang": "en", + "primary": true + } + ], + "key": "Pesachim", + "checkFirst": { + "he": "משנה פסחים", + "en": "Mishnah Pesachim" } - }, - "name": "tref", - "description": "A valid Sefaria textual `Ref`.", - "schema": { - "$ref": "#/components/schemas/ref" - }, - "in": "path", - "required": true - } - ] - }, - "/api/ref-topic-links/{tref}": { - "get": { - "tags": [ - "Related" - ], - "responses": { - "200": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/RefTopicLinksJSON" + }, + "alt_structs": { + "Chapters": { + "nodes": [ + { + "nodeType": "ArrayMapNode", + "depth": 0, + "wholeRef": "Pesachim 2a:1-21a:7", + "includeSections": true, + "match_templates": [ + { + "term_slugs": [ + "perek", + "chapter-129" + ], + "scope": "any" + }, + { + "term_slugs": [ + "perek", + "first" + ] + }, + { + "term_slugs": [ + "chapter-129" + ], + "scope": "any" }, - "examples": { - "Link to Bamidbar": { - "value": { - "linkType": "about", - "class": "refTopic", - "dataSource": { - "en": "Aspaklaria", - "he": "אספקלריא", - "slug": "aspaklaria" - }, - "is_sheet": false, - "order": { - "tfidf": 53.476917039392994, - "numDatasource": 2, - "availableLangs": [ - "en", - "he" - ], - "comp_date": -1400, - "order_id": "A00000000300280026", - "pr": 5.15330629652094, - "curatedPrimacy": { - "en": 100, - "he": 0 - } - }, - "descriptions": { - "en": { - "title": "A New Grain Offering", - "prompt": "The central ritual of Shavuot as described in the Torah is a special bread offering that was brought to the Temple. This sacrifice marked the beginning of sacrifices that were brought using grain from that year, as opposed to grains from the previous year, as explained in the Book of Numbers." - } - }, - "topic": "shavuot", - "anchorRef": "Numbers 28:26", - "anchorRefExpanded": [ - "Numbers 28:26" - ] - } - } + { + "term_slugs": [ + "first" + ] } - } - }, - "description": "Successful response" - } - }, - "summary": "Ref-Topic-Links", - "description": "An API endpoint where, given a `Ref`, all of the topics linked to that `Ref` are retrieved along with the respective metadata. " - }, - "parameters": [ - { - "examples": { - "Tanakh": { - "value": "Genesis" - }, - "Tanakh Section": { - "value": "Judges 12" - }, - "Tanakh Segment": { - "value": "Esther 4:14" - }, - "Talmud Segment": { - "value": "Shabbat 2b.2" - } - }, - "name": "tref", - "description": "A valid Sefaria textual `Ref`", - "schema": { - "$ref": "#/components/schemas/ref" - }, - "in": "path", - "required": true - } - ] - }, - "/api/calendars": { - "get": { - "tags": [ - "Calendars" - ], - "parameters": [ - { - "name": "diaspora", - "description": "When this value is set to `diaspora=1`, the text returned is the weekly Torah reading for the diaspora. When this value is set to `diaspora=0`, the text returned is the Torah reading for Israel. ", - "schema": { - "type": "boolean" - }, - "in": "query", - "required": false - }, - { - "name": "custom", - "description": "If available, the weekly _Haftarah_ will be returned for one of the selected custom.", - "schema": { - "enum": [ - "ashkenazi", - "sephardi", - "edot%20hamizrach" - ], - "type": "string" - }, - "in": "query" - }, - { - "name": "year", - "description": "By default the API returns for the current time. You can override it by using a combination of the `year`, `day`, and `month` params - all three of which must be used, or else the API will fallback to the default.", - "schema": { - "type": "number" - }, - "in": "query" - }, - { - "name": "month", - "description": "By default the API returns for the current time. You can override it by using a combination of the `year`, `day`, and `month` params - all three of which must be used, or else the API will fallback to the default.", - "schema": { - "type": "number" - }, - "in": "query" - }, - { - "name": "day", - "description": "By default the API returns for the current time. You can override it by using a combination of the `year`, `day`, and `month` params - all three of which must be used, or else the API will fallback to the default.", - "schema": { - "type": "number" - }, - "in": "query" - }, - { - "name": "timezone", - "description": "By default, the API attempts to return the calendars for the client's timezone. If you want another region you can override it. Timezone names are in accordance with [IANA Standards](https://www.iana.org/time-zones)", - "schema": {}, - "in": "query" - } - ], - "responses": { - "200": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/CalendarAPIResponse" + ], + "numeric_equivalent": 1, + "titles": [ + { + "primary": true, + "text": "Chapter 1", + "lang": "en" + }, + { + "primary": true, + "text": "אור לארבעה עשר", + "lang": "he" } - } - }, - "description": "Successful Response" - } - }, - "summary": "Calendars", - "description": "Returns the daily or weekly learning schedule for a given date." - } - }, - "/api/calendars/next-read/{parasha}": { - "get": { - "tags": [ - "Calendars" - ], - "parameters": [ - { - "name": "parasha", - "description": "One of the 54 weekly Torah Parasha names in English or one of the 7 double parshiyot.", - "schema": { - "enum": [ - "Bereshit", - "Noach", - "Lech-Lecha", - "Vayera", - "Chayei Sara", - "Toldot", - "Vayetzei", - "Vayishlach", - "Vayeshev", - "Miketz", - "Vayigash", - "Vayechi", - "Shemot", - "Vaera", - "Bo", - "Beshalach", - "Yitro", - "Mishpatim", - "Terumah", - "Tetzaveh", - "Ki Tisa", - "Vayakhel", - "Pekudei", - "Vayikra", - "Tzav", - "Shmini", - "Tazria", - "Metzora", - "Achrei Mot", - "Kedoshim", - "Emor", - "Behar", - "Bechukotai", - "Bamidbar", - "Nasso", - "Beha’alotcha", - "Sh’lach", - "Korach", - "Chukat", - "Balak", - "Pinchas", - "Matot", - "Masei", - "Devarim", - "Vaetchanan", - "Eikev", - "Re’eh", - "Shoftim", - "Ki Teitzei", - "Ki Tavo", - "Nitzavim", - "Vayeilech", - "Ha’azinu", - "Vezot Haberakhah", - "Vayakhel-Pekudei", - "Tazria-Metzora", - "Achrei Mot-Kedoshim", - "Behar-Bechukotai", - "Chukat-Balak", - "Matot-Masei", - "Nitzavim-Vayeilech" - ], - "type": "string" - }, - "in": "path", - "required": true - } - ], - "responses": { - "200": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/CalendarNextReadAPI" + ] + }, + { + "nodeType": "ArrayMapNode", + "depth": 0, + "wholeRef": "Pesachim 21a:8-42a:14", + "includeSections": true, + "match_templates": [ + { + "term_slugs": [ + "perek", + "chapter-224" + ], + "scope": "any" + }, + { + "term_slugs": [ + "perek", + "second" + ] + }, + { + "term_slugs": [ + "chapter-224" + ], + "scope": "any" + }, + { + "term_slugs": [ + "second" + ] } - } - }, - "description": "Successful Response" - } - }, - "summary": "Next Read", - "description": "Given a Parasha name in English, this API returns the next Hebrew and English dates that it is read, along with details about the Torah and Haftarah readings for that date." - }, - "parameters": [ - { - "examples": { - "Noach": { - "value": "Noach" - }, - "Devarim": { - "value": "Devarim" - }, - "Ha'Azinu": { - "value": "Ha%27Azinu" - }, - "Lech Lecha": { - "value": "Lech%20Lecha" - } - }, - "name": "parasha", - "description": "The _Parasha_ for which you'd like to generate relevant metadata, most notably the schedule of when it is next read. \n\n*Note*: The _Parasha_ must be in English written with a capitalized first letter, so `Noach` is valid, but `noach` will return an empty array. Any parshiyot with special characters (i.e. apostrophes, or spaces) should have those special characters percent url encoded. ", - "schema": { - "type": "string" - }, - "in": "path", - "required": true - } - ] - }, - "/api/words/{word}": { - "get": { - "tags": [ - "Lexicon" - ], - "parameters": [ - { - "examples": { - "Tanakh": { - "value": "Leviticus 19.3" - } - }, - "name": "lookup_ref", - "description": "This parameters refines the search to fine tune based on the `lookup_ref`.", - "schema": { - "type": "string" - }, - "in": "query" - }, - { - "name": "never_split", - "description": "This parameters refines the search to limit lookup to only the actual input string.", - "schema": { - "type": "string" - }, - "in": "query" - }, - { - "name": "always_split", - "description": "This parameters refines the search to look for substring matches regardless of results for original input. One can pass the values `0` (to indicate false) and `1` (to indicate true). ", - "schema": { - "type": "string" - }, - "in": "query" - }, - { - "name": "always_consonants", - "description": "", - "schema": { - "type": "string" - }, - "in": "query" - } - ], - "responses": { - "200": { - "content": { - "application/json": { - "schema": { - "type": "array", - "items": { - "anyOf": [ - { - "$ref": "#/components/schemas/JastrowDictionaryEntry" - }, - { - "$ref": "#/components/schemas/StrongsDictionaryEntry" - }, - { - "$ref": "#/components/schemas/BDBDictionaryEntry" - }, - { - "$ref": "#/components/schemas/KleinDictionaryEntry" - }, - { - "$ref": "#/components/schemas/HebrewDictionaryEntry" - } - ] - } + ], + "numeric_equivalent": 2, + "titles": [ + { + "primary": true, + "text": "Chapter 2", + "lang": "en" + }, + { + "primary": true, + "text": "כל שעה", + "lang": "he" } - } - }, - "description": "An array of matching words." - } - }, - "summary": "Lexicon", - "description": "Searches Sefaria lexicon entries (i.e. dictionaries) for the query string passed as `word` to the endpoint." - }, - "parameters": [ - { - "name": "word", - "description": "The word or phrase to search for in the lexicons.", - "schema": { - "type": "string" - }, - "in": "path", - "required": true - } - ] - }, - "/api/words/completion/{word}/{lexicon}": { - "description": "Serves primarily as an autocompleter, returning potential lexicon entries for a given input. \n\nReturns an array of arrays, each containing two strings. The first is a completion entry in Hebrew without vowels and the second includes vowels.", - "get": { - "tags": [ - "Lexicon" - ], - "parameters": [ - { - "name": "limit", - "description": "Number of results to return (0 indicates no limit, and is the default)", - "schema": { - "type": "integer" - }, - "in": "query" - }, - { - "examples": { - "Klein Dictionary": { - "value": "Klein Dictionary" + ] + }, + { + "nodeType": "ArrayMapNode", + "depth": 0, + "wholeRef": "Pesachim 42a:15-50a:22", + "includeSections": true, + "match_templates": [ + { + "term_slugs": [ + "perek", + "chapter-324" + ], + "scope": "any" + }, + { + "term_slugs": [ + "perek", + "third" + ] + }, + { + "term_slugs": [ + "chapter-324" + ], + "scope": "any" + }, + { + "term_slugs": [ + "third" + ] + } + ], + "numeric_equivalent": 3, + "titles": [ + { + "primary": true, + "text": "Chapter 3", + "lang": "en" + }, + { + "primary": true, + "text": "אלו עוברין", + "lang": "he" + } + ] }, - "Jastrow Dictionary": { - "value": "Jastrow Dictionary" + { + "nodeType": "ArrayMapNode", + "depth": 0, + "wholeRef": "Pesachim 50a:23-57b:3", + "includeSections": true, + "match_templates": [ + { + "term_slugs": [ + "perek", + "chapter-420" + ], + "scope": "any" + }, + { + "term_slugs": [ + "perek", + "fourth" + ] + }, + { + "term_slugs": [ + "chapter-420" + ], + "scope": "any" + }, + { + "term_slugs": [ + "fourth" + ] + } + ], + "numeric_equivalent": 4, + "titles": [ + { + "primary": true, + "text": "Chapter 4", + "lang": "en" + }, + { + "primary": true, + "text": "מקום שנהגו", + "lang": "he" + } + ] }, - "Sefer HaShorashim": { - "value": "Sefer HaShorashim" + { + "nodeType": "ArrayMapNode", + "depth": 0, + "wholeRef": "Pesachim 58a:1-65b:9", + "includeSections": true, + "match_templates": [ + { + "term_slugs": [ + "perek", + "chapter-518" + ], + "scope": "any" + }, + { + "term_slugs": [ + "perek", + "fifth" + ] + }, + { + "term_slugs": [ + "chapter-518" + ], + "scope": "any" + }, + { + "term_slugs": [ + "fifth" + ] + } + ], + "numeric_equivalent": 5, + "titles": [ + { + "primary": true, + "text": "Chapter 5", + "lang": "en" + }, + { + "primary": true, + "text": "תמיד נשחט", + "lang": "he" + } + ] }, - "Animadversions by Elias Levita on Sefer HaShorashim": { - "value": "Animadversions by Elias Levita on Sefer HaShorashim" + { + "nodeType": "ArrayMapNode", + "depth": 0, + "wholeRef": "Pesachim 65b:10-73b:16", + "includeSections": true, + "match_templates": [ + { + "term_slugs": [ + "perek", + "chapter-616" + ], + "scope": "any" + }, + { + "term_slugs": [ + "perek", + "sixth" + ] + }, + { + "term_slugs": [ + "chapter-616" + ], + "scope": "any" + }, + { + "term_slugs": [ + "sixth" + ] + } + ], + "numeric_equivalent": 6, + "titles": [ + { + "primary": true, + "text": "Chapter 6", + "lang": "en" + }, + { + "primary": true, + "text": "אלו דברים", + "lang": "he" + } + ] }, - "BDB Dictionary": { - "value": "BDB Dictionary" + { + "nodeType": "ArrayMapNode", + "depth": 0, + "wholeRef": "Pesachim 74a:1-86b:13", + "includeSections": true, + "match_templates": [ + { + "term_slugs": [ + "perek", + "chapter-714" + ], + "scope": "any" + }, + { + "term_slugs": [ + "perek", + "seventh" + ] + }, + { + "term_slugs": [ + "chapter-714" + ], + "scope": "any" + }, + { + "term_slugs": [ + "seventh" + ] + } + ], + "numeric_equivalent": 7, + "titles": [ + { + "primary": true, + "text": "Chapter 7", + "lang": "en" + }, + { + "primary": true, + "text": "כיצד צולין", + "lang": "he" + } + ] }, - "BDB Aramaic Dictionary": { - "value": "BDB Aramaic Dictionary" - } - }, - "name": "lexicon", - "description": "An optional text string matching the name of one of Sefaria's lexicons to limit the search.", - "schema": { - "type": "string" - }, - "in": "path", - "required": true - } - ], - "responses": { - "200": { - "content": { - "application/json": { - "schema": { - "type": "array", - "items": { - "$ref": "#/components/schemas/wordCompletionAPIResponse" - } + { + "nodeType": "ArrayMapNode", + "depth": 0, + "wholeRef": "Pesachim 87a:1-92b:3", + "includeSections": true, + "match_templates": [ + { + "term_slugs": [ + "perek", + "chapter-814" + ], + "scope": "any" + }, + { + "term_slugs": [ + "perek", + "eighth" + ] + }, + { + "term_slugs": [ + "chapter-814" + ], + "scope": "any" + }, + { + "term_slugs": [ + "eighth" + ] + } + ], + "numeric_equivalent": 8, + "titles": [ + { + "primary": true, + "text": "Chapter 8", + "lang": "en" + }, + { + "primary": true, + "text": "האשה", + "lang": "he" + } + ] + }, + { + "nodeType": "ArrayMapNode", + "depth": 0, + "wholeRef": "Pesachim 92b:4-99a:5", + "includeSections": true, + "match_templates": [ + { + "term_slugs": [ + "perek", + "chapter-914" + ], + "scope": "any" + }, + { + "term_slugs": [ + "perek", + "ninth" + ] + }, + { + "term_slugs": [ + "chapter-914" + ], + "scope": "any" + }, + { + "term_slugs": [ + "ninth" + ] + } + ], + "numeric_equivalent": 9, + "titles": [ + { + "primary": true, + "text": "Chapter 9", + "lang": "en" + }, + { + "primary": true, + "text": "מי שהיה טמא", + "lang": "he" + } + ] + }, + { + "nodeType": "ArrayMapNode", + "depth": 0, + "wholeRef": "Pesachim 99b:1-121b:3", + "includeSections": true, + "match_templates": [ + { + "term_slugs": [ + "perek", + "chapter-109" + ], + "scope": "any" + }, + { + "term_slugs": [ + "perek", + "tenth" + ] + }, + { + "term_slugs": [ + "chapter-109" + ], + "scope": "any" + }, + { + "term_slugs": [ + "tenth" + ] + }, + { + "term_slugs": [ + "perek", + "last" + ] + }, + { + "term_slugs": [ + "last" + ] + } + ], + "numeric_equivalent": 10, + "titles": [ + { + "primary": true, + "text": "Chapter 10", + "lang": "en" }, - "examples": { - "result": { - "value": [ - [ - "אב", - "אַב" - ], - [ - "אב", - "אֵב" - ], - [ - "אב", - "אָב" - ], - [ - "אבד", - "אֲבַד" - ], - [ - "אבה", - "אבה" - ], - [ - "אבן", - "אֶ֫בֶן" - ], - [ - "אגרה", - "אִגְּרָה" - ], - [ - "אדין", - "אֱדַ֫יִן" - ], - [ - "אדר", - "אִדַּר" - ], - [ - "אדר", - "אֲדָר" - ], - [ - "אדרגזר", - "אֲדַרְגָּזַר" - ], - [ - "אדרזדא", - "אַדְרַזְדָּא" - ], - [ - "אדרע", - "אֶדְרַע" - ] - ] - } + { + "primary": true, + "text": "ערבי פסחים", + "lang": "he" } + ] } - }, - "description": "Successful response" + ] + } + }, + "default_struct": "Chapters", + "exclude_structs": [ + "schema" + ], + "order": [ + 4, + 3 + ], + "authors": [], + "enDesc": "Pesachim (“Passover Festivals”) is the third tractate in Seder Moed (“Festivals”). Its ten chapters discuss laws relating to Passover: the consumption of matzah (unleavened bread) and maror (bitter herbs), the prohibitions against owning or consuming chametz (leavened bread) on the festival, the paschal lamb that used to be offered at the Temple in Jerusalem, and the order of the seder (ritual feast) held on the first evening of the holiday.\n.", + "enShortDesc": "Passover: ridding of chametz, the Paschal lamb offering, matzah, maror, and the Seder.", + "heShortDesc": "דינים הקשורים לחג הפסח: איסור חמץ, קורבן הפסח, מצה, מרור וליל הסדר.", + "pubDate": [ + 1523 + ], + "hasErrorMargin": true, + "compDate": [ + 450, + 550 + ], + "compPlace": "Talmudic Babylon", + "pubPlace": "Venice", + "era": "A", + "is_cited": true, + "corpora": [ + "Bavli" + ] } - }, - "summary": "Word Completion", - "description": "Serves primarily as an autocompleter, returning potential lexicon entries for a given input.\n\nReturns an array of arrays, each containing two strings. The first is a completion entry in Hebrew without vowels and the second includes vowels." + } + } + } }, - "parameters": [ - { - "name": "word", - "description": "An arbitrary text string to match against Sefaria's lexicon collections.", - "schema": { - "type": "string" - }, - "in": "path", - "required": true + "description": "Successful Request" + } + }, + "summary": "Index (v2)", + "description": "This API endpoint will retrieve the full mongo record of the given `Index` as it appears in the database." + }, + "parameters": [ + { + "examples": { + "Tanakh": { + "value": "Genesis" + }, + "Talmud": { + "value": "Pesachim" + } + }, + "name": "index_title", + "description": "A title of a valid Sefaria `Index`. For a complete list of works in the [Sefaria](sefaria.org) library, as well as their index titles, query the [api/index](https://www.sefaria.org/api/index/) endpoint. ", + "schema": { + "type": "string" + }, + "in": "path", + "required": true + } + ] + }, + "/api/index/": { + "get": { + "tags": [ + "Index" + ], + "responses": { + "200": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/APIIndexResponse" } - ] + } + }, + "description": "Successful Response" + } }, - "/api/v2/topics/{topic_slug}": { - "summary": "v2 Specific Topic API", - "description": "The `v2` Topic API is identical to the `v1` Topic API, with one exception. When the API is run with the following query parameter `with_refs=1`, the list of topic links returned is grouped by `type`. ", - "get": { - "tags": [ - "Topic" - ], - "parameters": [ - { - "name": "annotate_links", - "description": "Values can be `1` or `0`. \n\nIf `1`, adds the following fields to each intra-topic link: `title`, `titleIsTransliteration`, `shouldDisplay`, and `order`.", - "schema": { - "type": "integer" - }, - "in": "query" - } - ], - "responses": { - "200": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/TopicJSON" - }, - "examples": { - "Moses": { - "value": { - "slug": "moses", - "titles": [ - { - "text": "Moses", - "lang": "en", - "primary": true - }, - { - "text": "Moshe", - "lang": "en" - }, - { - "text": "Moshe Rabbeinu", - "lang": "en" - }, - { - "text": "moses", - "lang": "en" - }, - { - "text": "MOshe", - "lang": "en" - }, - { - "text": "#Moshe", - "lang": "en" - }, - { - "text": "Moshe Rebbeinu", - "lang": "en" - }, - { - "text": "Moshe Rabeinu", - "lang": "en" - }, - { - "text": "Moses a Leader", - "lang": "en" - }, - { - "text": "Moses our teacher", - "lang": "en" - }, - { - "text": "משה", - "lang": "he", - "primary": true - }, - { - "text": "ירד", - "lang": "he" - }, - { - "text": "מֹשֶׁה", - "lang": "he" - }, - { - "text": "משה רבינו", - "lang": "he" - }, - { - "text": "משה כמנהיג", - "lang": "he" - }, - { - "text": "משה רבנו", - "lang": "he" - } - ], - "subclass": "person", - "alt_ids": { - "_temp_id": "משה", - "wikidata": "Q9077", - "_old_slug": "-75" - }, - "properties": { - "enWikiLink": { - "value": "https://en.wikipedia.org/wiki/Moses", - "dataSource": "wikidata" - }, - "heWikiLink": { - "value": "https://he.wikipedia.org/wiki/משה", - "dataSource": "wikidata" - }, - "deWikiLink": { - "value": "https://de.wikipedia.org/wiki/Mose", - "dataSource": "wikidata" - }, - "esWikiLink": { - "value": "https://es.wikipedia.org/wiki/Moisés", - "dataSource": "wikidata" - }, - "frWikiLink": { - "value": "https://fr.wikipedia.org/wiki/Moïse", - "dataSource": "wikidata" - }, - "ruWikiLink": { - "value": "https://ru.wikipedia.org/wiki/Моисей", - "dataSource": "wikidata" - } - }, - "description": { - "en": "Moses was the greatest prophet in the biblical tradition. Brought up in the Egyptian royal family, he fled Egypt before being sent back by God to lead the Israelites out of slavery and to the Promised Land. He brought the Torah down from Mount Sinai, and, according to Jewish tradition, wrote it all down. He died before reaching Israel.", - "he": "משה היה גדול הנביאים במסורת המקראית. הוא גדל בבית המלוכה המצרי, ברח ממצרים ונשלח לשם בחזרה על ידי אלוהים כדי להוציא את בני ישראל מעבדות ולהביאם לארץ המובטחת. הוא קיבל את התורה בהר סיני, ועל פי המסורת היהודית, כתב אותה מפי האל. הוא נפטר לפני כניסת העם לארץ המובטחת." - }, - "categoryDescription": {}, - "numSources": 1767, - "good_to_promote": true, - "description_published": true, - "data_source": "sefaria", - "primaryTitle": { - "en": "Moses", - "he": "משה" - }, - "primaryTitleIsTransliteration": { - "en": false, - "he": false - } - } - } - } - } - }, - "description": "v2 Specific Topic API" - } + "summary": "Table of Contents", + "description": "This API endpoint returns the titles of all the books in the Sefaria Library arranged by their category along with some additional metadata. This is a large and rarely changing request and should be cached locally if you utilize it." + } + }, + "/api/shape/{title}": { + "summary": "Shape", + "description": "The shape API allows one to retrieve information about the shape of an Index on Sefaria. The shape refers some basic statistics about the Index, mostly the number of chapters, and the number of segments per chapter.", + "get": { + "tags": [ + "Index" + ], + "responses": { + "200": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ShapeJSON" }, - "summary": "Topic (v2)", - "description": "Retrieve a specific topic from the `v2` version of the topics API. " + "examples": { + "Complex Text": { + "value": [ + { + "isComplex": true, + "section": "Haggadah", + "length": 38, + "chapters": [ + { + "section": "Haggadah", + "heTitle": "הגדה של פסח, קדש", + "title": "Pesach Haggadah, Kadesh", + "length": 1, + "chapters": 13, + "book": "Pesach Haggadah", + "heBook": "הגדה של פסח" + }, + { + "section": "Haggadah", + "heTitle": "הגדה של פסח, ורחץ", + "title": "Pesach Haggadah, Urchatz", + "length": 1, + "chapters": 2, + "book": "Pesach Haggadah", + "heBook": "הגדה של פסח" + }, + { + "section": "Haggadah", + "heTitle": "הגדה של פסח, כרפס", + "title": "Pesach Haggadah, Karpas", + "length": 1, + "chapters": 3, + "book": "Pesach Haggadah", + "heBook": "הגדה של פסח" + }, + { + "section": "Haggadah", + "heTitle": "הגדה של פסח, יחץ", + "title": "Pesach Haggadah, Yachatz", + "length": 1, + "chapters": 2, + "book": "Pesach Haggadah", + "heBook": "הגדה של פסח" + }, + { + "section": "Haggadah", + "heTitle": "הגדה של פסח, מגיד, הא לחמא עניא", + "title": "Pesach Haggadah, Magid, Ha Lachma Anya", + "length": 1, + "chapters": 3, + "book": "Pesach Haggadah", + "heBook": "הגדה של פסח" + }, + { + "section": "Haggadah", + "heTitle": "הגדה של פסח, מגיד, מה נשתנה", + "title": "Pesach Haggadah, Magid, Four Questions", + "length": 1, + "chapters": 2, + "book": "Pesach Haggadah", + "heBook": "הגדה של פסח" + }, + { + "section": "Haggadah", + "heTitle": "הגדה של פסח, מגיד, עבדים היינו", + "title": "Pesach Haggadah, Magid, We Were Slaves in Egypt", + "length": 1, + "chapters": 2, + "book": "Pesach Haggadah", + "heBook": "הגדה של פסח" + }, + { + "section": "Haggadah", + "heTitle": "הגדה של פסח, מגיד, מעשה שהיה בבני ברק", + "title": "Pesach Haggadah, Magid, Story of the Five Rabbis", + "length": 1, + "chapters": 2, + "book": "Pesach Haggadah", + "heBook": "הגדה של פסח" + }, + { + "section": "Haggadah", + "heTitle": "הגדה של פסח, מגיד, כנגד ארבעה בנים", + "title": "Pesach Haggadah, Magid, The Four Sons", + "length": 1, + "chapters": 5, + "book": "Pesach Haggadah", + "heBook": "הגדה של פסח" + }, + { + "section": "Haggadah", + "heTitle": "הגדה של פסח, מגיד, יכול מראש חודש", + "title": "Pesach Haggadah, Magid, Yechol Me'rosh Chodesh", + "length": 1, + "chapters": 1, + "book": "Pesach Haggadah", + "heBook": "הגדה של פסח" + }, + { + "section": "Haggadah", + "heTitle": "הגדה של פסח, מגיד, מתחילה עובדי עבודה זרה היו אבותינו", + "title": "Pesach Haggadah, Magid, In the Beginning Our Fathers Were Idol Worshipers", + "length": 1, + "chapters": 5, + "book": "Pesach Haggadah", + "heBook": "הגדה של פסח" + }, + { + "section": "Haggadah", + "heTitle": "הגדה של פסח, מגיד, ארמי אבד אבי", + "title": "Pesach Haggadah, Magid, First Fruits Declaration", + "length": 1, + "chapters": 24, + "book": "Pesach Haggadah", + "heBook": "הגדה של פסח" + }, + { + "section": "Haggadah", + "heTitle": "הגדה של פסח, מגיד, עשר המכות", + "title": "Pesach Haggadah, Magid, The Ten Plagues", + "length": 1, + "chapters": 20, + "book": "Pesach Haggadah", + "heBook": "הגדה של פסח" + }, + { + "section": "Haggadah", + "heTitle": "הגדה של פסח, מגיד, דיינו", + "title": "Pesach Haggadah, Magid, Dayenu", + "length": 1, + "chapters": 16, + "book": "Pesach Haggadah", + "heBook": "הגדה של פסח" + }, + { + "section": "Haggadah", + "heTitle": "הגדה של פסח, מגיד, פסח מצה ומרור", + "title": "Pesach Haggadah, Magid, Rabban Gamliel's Three Things", + "length": 1, + "chapters": 7, + "book": "Pesach Haggadah", + "heBook": "הגדה של פסח" + }, + { + "section": "Haggadah", + "heTitle": "הגדה של פסח, מגיד, חצי הלל", + "title": "Pesach Haggadah, Magid, First Half of Hallel", + "length": 1, + "chapters": 4, + "book": "Pesach Haggadah", + "heBook": "הגדה של פסח" + }, + { + "section": "Haggadah", + "heTitle": "הגדה של פסח, מגיד, כוס שניה", + "title": "Pesach Haggadah, Magid, Second Cup of Wine", + "length": 1, + "chapters": 4, + "book": "Pesach Haggadah", + "heBook": "הגדה של פסח" + }, + { + "section": "Haggadah", + "heTitle": "הגדה של פסח, רחצה", + "title": "Pesach Haggadah, Rachtzah", + "length": 1, + "chapters": 3, + "book": "Pesach Haggadah", + "heBook": "הגדה של פסח" + }, + { + "section": "Haggadah", + "heTitle": "הגדה של פסח, מוציא מצה", + "title": "Pesach Haggadah, Motzi Matzah", + "length": 1, + "chapters": 4, + "book": "Pesach Haggadah", + "heBook": "הגדה של פסח" + }, + { + "section": "Haggadah", + "heTitle": "הגדה של פסח, מרור", + "title": "Pesach Haggadah, Maror", + "length": 1, + "chapters": 3, + "book": "Pesach Haggadah", + "heBook": "הגדה של פסח" + }, + { + "section": "Haggadah", + "heTitle": "הגדה של פסח, כורך", + "title": "Pesach Haggadah, Korech", + "length": 1, + "chapters": 4, + "book": "Pesach Haggadah", + "heBook": "הגדה של פסח" + }, + { + "section": "Haggadah", + "heTitle": "הגדה של פסח, שולחן עורך", + "title": "Pesach Haggadah, Shulchan Orech", + "length": 1, + "chapters": 2, + "book": "Pesach Haggadah", + "heBook": "הגדה של פסח" + }, + { + "section": "Haggadah", + "heTitle": "הגדה של פסח, צפון", + "title": "Pesach Haggadah, Tzafun", + "length": 1, + "chapters": 3, + "book": "Pesach Haggadah", + "heBook": "הגדה של פסח" + }, + { + "section": "Haggadah", + "heTitle": "הגדה של פסח, ברך, ברכת המזון", + "title": "Pesach Haggadah, Barech, Birkat Hamazon", + "length": 1, + "chapters": 23, + "book": "Pesach Haggadah", + "heBook": "הגדה של פסח" + }, + { + "section": "Haggadah", + "heTitle": "הגדה של פסח, ברך, כוס שלישית", + "title": "Pesach Haggadah, Barech, Third Cup of Wine", + "length": 1, + "chapters": 2, + "book": "Pesach Haggadah", + "heBook": "הגדה של פסח" + }, + { + "section": "Haggadah", + "heTitle": "הגדה של פסח, ברך, שפוך חמתך", + "title": "Pesach Haggadah, Barech, Pour Out Thy Wrath", + "length": 1, + "chapters": 2, + "book": "Pesach Haggadah", + "heBook": "הגדה של פסח" + }, + { + "section": "Haggadah", + "heTitle": "הגדה של פסח, הלל, מסיימים את ההלל", + "title": "Pesach Haggadah, Hallel, Second Half of Hallel", + "length": 1, + "chapters": 10, + "book": "Pesach Haggadah", + "heBook": "הגדה של פסח" + }, + { + "section": "Haggadah", + "heTitle": "הגדה של פסח, הלל, מזמורי הודיה", + "title": "Pesach Haggadah, Hallel, Songs of Praise and Thanks", + "length": 1, + "chapters": 6, + "book": "Pesach Haggadah", + "heBook": "הגדה של פסח" + }, + { + "section": "Haggadah", + "heTitle": "הגדה של פסח, הלל, כוס רביעית", + "title": "Pesach Haggadah, Hallel, Fourth Cup of Wine", + "length": 1, + "chapters": 4, + "book": "Pesach Haggadah", + "heBook": "הגדה של פסח" + }, + { + "section": "Haggadah", + "heTitle": "הגדה של פסח, נרצה, חסל סידור פסח", + "title": "Pesach Haggadah, Nirtzah, Chasal Siddur Pesach", + "length": 1, + "chapters": 2, + "book": "Pesach Haggadah", + "heBook": "הגדה של פסח" + }, + { + "section": "Haggadah", + "heTitle": "הגדה של פסח, נרצה, לשנה הבאה", + "title": "Pesach Haggadah, Nirtzah, L'Shana HaBaa", + "length": 1, + "chapters": 1, + "book": "Pesach Haggadah", + "heBook": "הגדה של פסח" + }, + { + "section": "Haggadah", + "heTitle": "הגדה של פסח, נרצה, ויהי בחצי הלילה", + "title": "Pesach Haggadah, Nirtzah, And It Happened at Midnight", + "length": 1, + "chapters": 11, + "book": "Pesach Haggadah", + "heBook": "הגדה של פסח" + }, + { + "section": "Haggadah", + "heTitle": "הגדה של פסח, נרצה, זבח פסח", + "title": "Pesach Haggadah, Nirtzah, Zevach Pesach", + "length": 1, + "chapters": 8, + "book": "Pesach Haggadah", + "heBook": "הגדה של פסח" + }, + { + "section": "Haggadah", + "heTitle": "הגדה של פסח, נרצה, אדיר במלוכה", + "title": "Pesach Haggadah, Nirtzah, Ki Lo Na'e", + "length": 1, + "chapters": 9, + "book": "Pesach Haggadah", + "heBook": "הגדה של פסח" + }, + { + "section": "Haggadah", + "heTitle": "הגדה של פסח, נרצה, אדיר הוא", + "title": "Pesach Haggadah, Nirtzah, Adir Hu", + "length": 1, + "chapters": 8, + "book": "Pesach Haggadah", + "heBook": "הגדה של פסח" + }, + { + "section": "Haggadah", + "heTitle": "הגדה של פסח, נרצה, ספירת העומר", + "title": "Pesach Haggadah, Nirtzah, Sefirat HaOmer", + "length": 1, + "chapters": 2, + "book": "Pesach Haggadah", + "heBook": "הגדה של פסח" + }, + { + "section": "Haggadah", + "heTitle": "הגדה של פסח, נרצה, אחד מי יודע", + "title": "Pesach Haggadah, Nirtzah, Echad Mi Yodea", + "length": 1, + "chapters": 1, + "book": "Pesach Haggadah", + "heBook": "הגדה של פסח" + }, + { + "section": "Haggadah", + "heTitle": "הגדה של פסח, נרצה, חד גדיא", + "title": "Pesach Haggadah, Nirtzah, Chad Gadya", + "length": 1, + "chapters": 10, + "book": "Pesach Haggadah", + "heBook": "הגדה של פסח" + } + ], + "book": "Pesach Haggadah", + "heBook": "הגדה של פסח" + } + ] + }, + "Simple Text": { + "value": [ + { + "section": "Torah", + "heTitle": "שמות", + "title": "Exodus", + "length": 40, + "chapters": [ + 22, + 25, + 22, + 31, + 23, + 30, + 29, + 28, + 35, + 29, + 10, + 51, + 22, + 31, + 27, + 36, + 16, + 27, + 25, + 23, + 37, + 30, + 33, + 18, + 40, + 37, + 21, + 43, + 46, + 38, + 18, + 35, + 23, + 35, + 35, + 38, + 29, + 31, + 43, + 38 + ], + "book": "Exodus", + "heBook": "שמות" + } + ] + } + } + } }, - "parameters": [ - { - "examples": { - "Moses": { - "value": "moses" + "description": "Retrieve basic statistics and information about the \"shape\" of an `Index` on Sefaria. " + } + }, + "summary": "Shape", + "description": "Retrieve basic statistics and information about the \"shape\" of an `Index` on Sefaria. " + }, + "parameters": [ + { + "examples": { + "Tanakh": { + "value": "Jonah" + }, + "Talmud": { + "value": "Pesachim" + }, + "Commentary": { + "value": "Rashi on Exodus" + }, + "Category": { + "value": "Tanakh/Modern Commentary on Tanakh/Steinsaltz" + } + }, + "name": "title", + "description": "The title of a valid Sefaria `Index`, or the path of a valid Sefaria category. ", + "schema": { + "type": "string" + }, + "in": "path", + "required": true + }, + { + "name": "depth", + "description": "The `depth` parameter in the query string indicates how many levels in the category tree to descend.\nIf `depth=0` is passed, then the returned JSON descends to end of tree.\nThe default is `depth=2`.", + "schema": { + "type": "integer" + }, + "in": "query" + }, + { + "name": "dependents", + "description": "The dependents parameter, if `true`, includes dependent texts. By default, they are filtered out.", + "schema": { + "enum": [ + "0", + "1" + ], + "type": "string" + }, + "in": "query", + "required": false + } + ] + }, + "/api/related/{tref}": { + "summary": "The Related API", + "description": "The Related API returns all related links, sheets, notes, webpages, topics, manuscripts, and other connected media for a given `Ref`. ", + "get": { + "tags": [ + "Related" + ], + "responses": { + "200": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/RelatedJSON" + }, + "examples": { + "Or HaChaim on Deuteronomy 1:1:1": { + "value": { + "links": [ + { + "_id": "54bd48c4fbfba21733367bfa", + "index_title": "Psalms", + "category": "Tanakh", + "type": "", + "ref": "Psalms 51", + "anchorRef": "Or HaChaim on Deuteronomy 1:1:1", + "anchorRefExpanded": [ + "Or HaChaim on Deuteronomy 1:1:1" + ], + "sourceRef": "Psalms 51", + "sourceHeRef": "תהילים נ״א", + "anchorVerse": 1, + "sourceHasEn": true, + "compDate": [ + -1000, + 0 + ], + "commentaryNum": 51, + "collectiveTitle": { + "en": "Psalms", + "he": "תהילים" + }, + "heTitle": "תהילים" }, - "Torah": { - "value": "torah" + { + "_id": "54bd48c4fbfba21733367bfc", + "index_title": "Pirkei Avot", + "category": "Mishnah", + "type": "", + "ref": "Pirkei Avot 3", + "anchorRef": "Or HaChaim on Deuteronomy 1:1:1", + "anchorRefExpanded": [ + "Or HaChaim on Deuteronomy 1:1:1" + ], + "sourceRef": "Pirkei Avot 3", + "sourceHeRef": "משנה אבות ג׳", + "anchorVerse": 1, + "sourceHasEn": true, + "compDate": [ + 190, + 230 + ], + "commentaryNum": 3, + "collectiveTitle": { + "en": "Pirkei Avot", + "he": "משנה אבות" + }, + "heTitle": "משנה אבות" }, - "The Four Species": { - "value": "the-four-species" - } - }, - "name": "topic_slug", - "description": "The slug of the desired topic", - "schema": { - "type": "string" - }, - "in": "path", - "required": true - }, - { - "name": "with_links", - "description": "Values can be `1` or `0`. \n\nIf `1`, includes intra-topic links in the `result` field, under `links`.", - "schema": { - "type": "integer" - }, - "in": "query" - }, - { - "name": "annotate_links", - "description": "Values can be `1` or `0`. \n\nIf `1`, adds the following fields to each intra-topic link: `title`, `titleIsTransliteration`, `shouldDisplay`, and `order`.", - "schema": { - "type": "integer" - }, - "in": "query" - }, - { - "name": "annotate_time_period", - "description": "Values can be `1` or `0`. \n\nIf `1`, the response includes time period data under the `timePeriod` key.", - "schema": {}, - "in": "query" - }, - { - "name": "group_related", - "description": "Values can be `1` or `0`. \n\nIf `1`, groups link types with the `groupRelated` key set to true. This will simulate how the sidebar looks on the Sefaria site.", - "schema": { - "type": "integer" - }, - "in": "query" - }, - { - "name": "with_refs", - "description": "Values can be `1` or `0`. \n\nIf `1`, adds a list of `Ref`s tagged with this topic under the `refs` key.", - "schema": { - "type": "integer" - }, - "in": "query" - } - ] - }, - "/api/topics/{topic_slug}": { - "summary": "The Specific Topic API", - "description": "This API will return all of the metadata for the given topic passed in as a path parameter with its `topic_slug`. ", - "get": { - "tags": [ - "Topic" - ], - "responses": { - "200": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/TopicJSON" - }, - "examples": { - "Sukkot Topic": { - "value": { - "slug": "sukkot", - "titles": [ - { - "text": "Tabernacles", - "lang": "en" - }, - { - "text": "Succot", - "lang": "en" - }, - { - "text": "Sukkos", - "lang": "en" - }, - { - "text": "Succos", - "lang": "en" - }, - { - "text": "Booths", - "lang": "en" - }, - { - "text": "sukkot", - "lang": "en" - }, - { - "text": "succot", - "lang": "en" - }, - { - "text": "Succoth", - "lang": "en" - }, - { - "text": "Sukkoth", - "lang": "en" - }, - { - "text": "חג הסוכות", - "lang": "he" - }, - { - "text": "סכות", - "lang": "he" - }, - { - "text": "Sukkot", - "lang": "en", - "primary": true - }, - { - "text": "סוכות", - "lang": "he", - "primary": true - } - ], - "alt_ids": { - "_temp_id": "סוכות" - }, - "properties": { - "heNliLink": { - "value": "https://www.nli.org.il/he/discover/judaism/holidays/sukkot", - "dataSource": "sefaria" - }, - "enNliLink": { - "value": "https://www.nli.org.il/en/discover/judaism/holidays/sukkot", - "dataSource": "sefaria" - } - }, - "description": { - "en": "Sukkot is a weeklong celebration of the harvest in early fall. It is celebrated by the building of temporary booths — that is, sukkot — outside homes in which people eat their meals and sometimes even sleep. The booths are reminders of the transience of life and the sheltering presence of God.", - "he": "חג הסוכות, הוא חג האסיף, נמשך שבעה ימים ומצוין בחודש תשרי על-ידי בניית סוכה מחוץ לבית, בה אוכלים וחלק גם ישנים. הסוכה היא תזכורת לסוכות שבנו בני ישראל ביציאת מצרים, ומסמלת את ארעיות החיים ואת נוכחותו המגוננת של ה'" - }, - "categoryDescription": {}, - "displayOrder": 4, - "numSources": 831, - "description_published": true, - "data_source": "sefaria", - "image": { - "image_uri": "https://storage.googleapis.com/img.sefaria.org/topics/sukkot.jpg", - "image_caption": { - "en": "Detail of a painting of a sukkah. Image taken from f. 316v of Forli Siddur. 1383, Italian rite. The British Library", - "he": "פרט ציור של סוכה עם שולחן פרוש ושלוש דמויות. דימוי מתוך סידור פורלי, 1383 איטליה" - } - }, - "primaryTitle": { - "en": "Sukkot", - "he": "סוכות" - }, - "primaryTitleIsTransliteration": { - "en": false, - "he": false - } - } - } - } - } + { + "_id": "54bd48c4fbfba21733367bfe", + "index_title": "Pirkei Avot", + "category": "Mishnah", + "type": "", + "ref": "Pirkei Avot 4", + "anchorRef": "Or HaChaim on Deuteronomy 1:1:1", + "anchorRefExpanded": [ + "Or HaChaim on Deuteronomy 1:1:1" + ], + "sourceRef": "Pirkei Avot 4", + "sourceHeRef": "משנה אבות ד׳", + "anchorVerse": 1, + "sourceHasEn": true, + "compDate": [ + 190, + 230 + ], + "commentaryNum": 4, + "collectiveTitle": { + "en": "Pirkei Avot", + "he": "משנה אבות" + }, + "heTitle": "משנה אבות" }, - "description": "When one calls this endpoint _with_ a specific `topic_slug`, it returns a JSON object containing the metadata for the topic. \n" - } - }, - "deprecated": true, - "summary": "Topic (v1)", - "description": "When one calls this endpoint _with_ a specific `topic_slug`, it returns a JSON object containing the metadata for the topic. \n" - }, - "parameters": [ - { - "examples": { - "Holiday": { - "value": "rosh-hashanah" + { + "_id": "54bd48c4fbfba21733367c08", + "index_title": "Proverbs", + "category": "Tanakh", + "type": "", + "ref": "Proverbs 3", + "anchorRef": "Or HaChaim on Deuteronomy 1:1:1", + "anchorRefExpanded": [ + "Or HaChaim on Deuteronomy 1:1:1" + ], + "sourceRef": "Proverbs 3", + "sourceHeRef": "משלי ג׳", + "anchorVerse": 1, + "sourceHasEn": true, + "compDate": [ + -800, + -400 + ], + "commentaryNum": 3, + "collectiveTitle": { + "en": "Proverbs", + "he": "משלי" + }, + "heTitle": "משלי" }, - "Ritual objects": { - "value": "the-four-species" + { + "_id": "54bd48c4fbfba21733367c0e", + "index_title": "Yoma", + "category": "Talmud", + "type": "", + "ref": "Yoma 19b", + "anchorRef": "Or HaChaim on Deuteronomy 1:1:1", + "anchorRefExpanded": [ + "Or HaChaim on Deuteronomy 1:1:1" + ], + "sourceRef": "Yoma 19b", + "sourceHeRef": "יומא י״ט ב", + "anchorVerse": 1, + "sourceHasEn": true, + "compDate": [ + 450, + 550 + ], + "commentaryNum": 38, + "collectiveTitle": { + "en": "Yoma", + "he": "יומא" + }, + "heTitle": "יומא" }, - "Conceptual idea": { - "value": "יחיד-וחברה" + { + "_id": "53f17c73fbfba22336eaba1e", + "index_title": "Deuteronomy", + "category": "Tanakh", + "type": "commentary", + "ref": "Deuteronomy 1:1", + "anchorRef": "Or HaChaim on Deuteronomy 1:1:1", + "anchorRefExpanded": [ + "Or HaChaim on Deuteronomy 1:1:1" + ], + "sourceRef": "Deuteronomy 1:1", + "sourceHeRef": "דברים א׳:א׳", + "anchorVerse": 1, + "sourceHasEn": true, + "compDate": [ + -1400, + -400 + ], + "commentaryNum": 1.0001, + "collectiveTitle": { + "en": "Deuteronomy", + "he": "דברים" + }, + "heTitle": "דברים" }, - "Person": { - "value": "nachman-of-breslov" - } - }, - "name": "topic_slug", - "description": "The slug of a topic in the Sefaria system. (To find all of the slugs, you can run `api/topics` without a path parameter to see the data for each topic in our database).", - "schema": { - "type": "string" - }, - "in": "path", - "required": true - }, - { - "name": "with_links", - "description": "`1` or `0`. If `1`, includes intra-topic links in the `result` field, under `links`.", - "schema": { - "type": "integer" - }, - "in": "query", - "required": false - }, - { - "name": "annotate_links", - "description": "`1` or `0`. If `1`, adds the following fields to each intra-topic link: `title`, `titleIsTransliteration`, `shouldDisplay`, and `order`.", - "schema": { - "type": "integer" - }, - "in": "query" - }, - { - "name": "group_related", - "description": "`1` or `0`. If `1`, groups link types with the `groupRelated` key set to true. This will simulate how the sidebar looks on the Sefaria site.", - "schema": { - "type": "integer" - }, - "in": "query" - }, - { - "name": "with_refs", - "description": "`1` or `0`. If `1`, adds a list of `Ref`s tagged with this topic under the `refs` key.", - "schema": { - "type": "integer" - }, - "in": "query" - }, - { - "name": "annotate_time_period", - "description": "`1` or `0`. If `1`, the response includes time period data under the `timePeriod` key.", - "schema": {}, - "in": "query" - } - ] - }, - "/api/topics": { - "summary": "The Topics API", - "description": "The topics API returns a list of JSON objects containing metadata for every topic in the Sefaria database. ", - "get": { - "tags": [ - "Topic" - ], - "responses": { - "200": { - "content": { - "application/json": { - "schema": { - "type": "array", - "items": { - "$ref": "#/components/schemas/TopicJSON" - } - }, - "examples": { - "The first three topics returned: ": { - "value": [ - { - "slug": "prayer", - "titles": [ - { - "primary": true, - "text": "תפילה", - "lang": "he" - }, - { - "primary": true, - "text": "Prayer", - "lang": "en" - }, - { - "text": "Tefillah", - "lang": "en", - "transliteration": true - }, - { - "text": "תפלה", - "lang": "he", - "fromTerm": true - }, - { - "text": "T'filah", - "lang": "en" - }, - { - "text": "Tefilla", - "lang": "en" - }, - { - "text": "Tefilah", - "lang": "en" - }, - { - "text": "התפלל", - "lang": "he" - }, - { - "text": "Liturgy", - "lang": "en" - }, - { - "text": "Siddur", - "lang": "en" - }, - { - "text": "תְּפִלָּה", - "lang": "he" - }, - { - "text": "סידור", - "lang": "he" - }, - { - "text": "סדר התפילה", - "lang": "he" - }, - { - "lang": "en", - "text": "prayer" - }, - { - "lang": "en", - "text": "#Tefillah" - }, - { - "lang": "en", - "text": "Tefila" - }, - { - "lang": "en", - "text": "TEFILA" - }, - { - "lang": "en", - "text": "Tefiilah" - }, - { - "lang": "en", - "text": "Tfillah" - }, - { - "lang": "en", - "text": "T'fillah" - }, - { - "lang": "en", - "text": "T'filla" - }, - { - "lang": "en", - "text": "Tfilla" - }, - { - "lang": "en", - "text": "T'fila" - } - ], - "alt_ids": { - "_temp_id": "תפלה", - "_temp_toc_id": "Prayer", - "_old_slug": "tfilla1" - }, - "description": {}, - "categoryDescription": { - "en": "Liturgy and modes of Jewish prayer.", - "he": "נוסחי תפילה ודרכי תפילה יהודית." - }, - "isTopLevelDisplay": true, - "displayOrder": 30, - "numSources": 2937, - "good_to_promote": true, - "primaryTitle": { - "en": "Prayer", - "he": "תפילה" - } - }, - { - "slug": "torah", - "titles": [ - { - "text": "Torah", - "lang": "en", - "primary": true - }, - { - "text": "תורה", - "lang": "he", - "primary": true - }, - { - "text": "Chumash", - "lang": "en" - }, - { - "lang": "en", - "text": "torah" - } - ], - "alt_ids": { - "_temp_id": "תורה" - }, - "numSources": 2333, - "good_to_promote": true, - "primaryTitle": { - "en": "Torah", - "he": "תורה" - } - }, - { - "slug": "passover", - "titles": [ - { - "text": "Passover", - "lang": "en", - "primary": true - }, - { - "text": "פסח", - "lang": "he", - "primary": true - }, - { - "text": "Pesach", - "lang": "en", - "transliteration": true - }, - { - "text": "Pesah", - "lang": "en" - }, - { - "text": "Chag HaPesach", - "lang": "en", - "fromTerm": true - }, - { - "text": "Pessach", - "lang": "en", - "fromTerm": true - }, - { - "text": "חג הפסח", - "lang": "he", - "fromTerm": true - }, - { - "text": "חג המצות", - "lang": "he", - "fromTerm": true - }, - { - "lang": "he", - "text": "חג פסח" - } - ], - "alt_ids": { - "_temp_id": "פסח", - "_old_slug": "-13" - }, - "properties": { - "heNliLink": { - "value": "https://www.nli.org.il/he/discover/judaism/holidays/passover", - "dataSource": "sefaria" - }, - "enNliLink": { - "value": "https://www.nli.org.il/en/discover/judaism/holidays/passover", - "dataSource": "sefaria" - } - }, - "description": { - "en": "Passover, or Pesach, is a week long springtime festival commemorating the Exodus from Egypt. It also celebrates national redemption, and freedom from slavery. It is observed through avoidance of certain foods (especially grains) and ritual dinners called Seders where attendees retell the story of the Exodus.", - "he": "חג הפסח הוא חג שנמשך שבוע וחל באביב, לזכר יציאת מצרים. הוא גם חוגג את גאולת העם והשחרור מעבדות. הוא נחגג באמצעות הימנעות ממאכלים מסוימים (במיוחד דגנים) וסעודה טקסית הנקראת ליל הסדר אשר בה מספרים המשתתפים את סיפור יציאת מצרים." - }, - "categoryDescription": {}, - "displayOrder": 10, - "numSources": 2040, - "description_published": true, - "primaryTitle": { - "en": "Passover", - "he": "פסח" - } - }, - { - "slug": "teshuvah", - "titles": [ - { - "text": "Teshuvah", - "lang": "en", - "primary": true - }, - { - "text": "Teshuva", - "lang": "en" - }, - { - "text": "Repentance", - "lang": "en" - }, - { - "text": "Tshuva", - "lang": "en" - }, - { - "text": "Repentence", - "lang": "en" - }, - { - "text": "T'shuva", - "lang": "en" - }, - { - "text": "teshuva", - "lang": "en" - }, - { - "text": "teshuvah", - "lang": "en" - }, - { - "text": "Repent", - "lang": "en" - }, - { - "text": "Tshuvah", - "lang": "en" - }, - { - "text": "תשובה", - "lang": "he", - "primary": true - }, - { - "text": "תְּשׁוּבָה", - "lang": "he" - } - ], - "alt_ids": { - "_temp_id": "תשובה" - }, - "description": { - "en": "The word \"teshuvah\" literally means “return” and is best translated as \"repentance.\" Teshuvah is presented in Jewish sources as a gift from God because it allows one to return to the path of righteousness. Although it can be done at any time, Yom Kippur is the Jewish holiday most associated with repentance.", - "he": "המונח תשובה כוונתו שיבה אל דרכי האל. במקורות היהודיים נתפסת התשובה כמתנה מאלוהים, מכיוון שהיא מאפשרת לאדם לשוב ולדבוק בדרכי הטוב והיושר. אף שתשובה היא דבר שאפשר לעשות בכל עת, יום הכיפורים הוא המועד המוכר ביותר למטרה זו." - }, - "categoryDescription": {}, - "numSources": 1967, - "good_to_promote": true, - "description_published": true, - "data_source": "sefaria", - "primaryTitle": { - "en": "Teshuvah", - "he": "תשובה" - } - }, - { - "slug": "יחיד-וחברה", - "titles": [ - { - "lang": "he", - "text": "יחיד וחברה", - "primary": true - } - ], - "alt_ids": { - "_old_slug": "-163" - }, - "numSources": 1826, - "primaryTitle": { - "en": "", - "he": "יחיד וחברה" - } - } - ] - } - } - } + { + "_id": "54bd48c4fbfba21733367bf8", + "index_title": "Exodus", + "category": "Tanakh", + "type": "", + "ref": "Exodus 19:2", + "anchorRef": "Or HaChaim on Deuteronomy 1:1:1", + "anchorRefExpanded": [ + "Or HaChaim on Deuteronomy 1:1:1" + ], + "sourceRef": "Exodus 19:2", + "sourceHeRef": "שמות י״ט:ב׳", + "anchorVerse": 1, + "sourceHasEn": true, + "compDate": [ + -1400, + -400 + ], + "commentaryNum": 19.0002, + "collectiveTitle": { + "en": "Exodus", + "he": "שמות" + }, + "heTitle": "שמות" }, - "description": "A list of JSON objects, each object representing a topic in the Sefaria database. Please note, since this list is over 30,000 topics long, in the example we only presented the first several topics that are returned in the array. " - } - }, - "summary": "All Topics", - "description": "The topics API returns a list of JSON objects, each object containing all of the metadata for each topic in the Sefaria database. " - } - }, - "/api/topics-graph/{topic_slug}": { - "summary": "Topic Graph API", - "description": "And enpoint to retrieve links between various topics. ", - "get": { - "tags": [ - "Topic" - ], - "responses": { - "200": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/TopicGraphJSON" - }, - "examples": { - "Shabbat": { - "value": { - "topics": [ - { - "slug": "shabbat", - "titles": [ - { - "text": "Shabbos", - "lang": "en" - }, - { - "text": "Mishnah Shabbat", - "lang": "en" - }, - { - "text": "שַׁבָּת", - "lang": "he" - }, - { - "text": "השבת", - "lang": "he" - }, - { - "text": "Shabbat", - "lang": "en", - "primary": true - }, - { - "text": "שבת", - "lang": "he", - "primary": true - } - ], - "alt_ids": { - "_temp_id": "שבת", - "_old_slug": "shabbat1" - }, - "properties": { - "heNliLink": { - "value": "https://www.nli.org.il/he/discover/judaism/traditions/shabbat", - "dataSource": "sefaria" - } - }, - "description": { - "en": "Shabbat (or Sabbath) falls every seventh day of the week, from Friday just before sunset until dark on Saturday night. It is a day of rest, marking the time when God stopped creating after after the six days of creation. Shabbat recognizes God as Creator of the Universe and as Redeemer of Israel from Egypt. ", - "he": "היום השביעי בשבוע, החל מיום שישי בשעת השקיעה ועד צאת הכוכבים במוצאי השבת. יום מנוחה לפי המקורות, המציין את הזמן שבו ה' נח לאחר שברא את העולם. " - }, - "categoryDescription": {}, - "displayOrder": 0, - "numSources": 1662, - "good_to_promote": true, - "description_published": true, - "data_source": "sefaria", - "image": { - "image_uri": "https://storage.googleapis.com/img.sefaria.org/topics/shabbat.jpg", - "image_caption": { - "en": "Friday Evening, Isidor Kaufmann, Austria c. 1920. The Jewish Museum, Gift of Mr. and Mrs. M. R. Schweitzer", - "he": "שישי בערב, איזידור קאופמן, וינה 1920. המוזיאון היהודי בניו יורק, מתנת מר וגברת מ.ר. שוויצר" - } - }, - "primaryTitle": { - "en": "Shabbat", - "he": "שבת" - } - }, - { - "slug": "shabbat-shuvah", - "titles": [ - { - "text": "Shabbat Shuvah", - "lang": "en", - "primary": true - }, - { - "text": "שבת שובה", - "lang": "he", - "primary": true - }, - { - "lang": "he", - "text": "שובה" - } - ], - "alt_ids": { - "_temp_id": "שבת שובה", - "_old_slug": "399" - }, - "description": { - "en": "Shabbat of Repentance between Rosh Hashanah and Yom Kippur.", - "he": "" - }, - "numSources": 19, - "primaryTitle": { - "en": "Shabbat Shuvah", - "he": "שבת שובה" - } - }, - { - "slug": "shabbat-hagadol", - "titles": [], - "alt_ids": {}, - "description": {}, - "categoryDescription": {}, - "displayOrder": 230, - "numSources": 57, - "description_published": true, - "data_source": "sefaria", - "primaryTitle": { - "en": "Shabbat Hagadol", - "he": "שבת הגדול" - } - } - ], - "links": [ - { - "toTopic": "shabbat", - "linkType": "is-a", - "class": "intraTopic", - "dataSource": "aspaklaria-edited-by-sefaria", - "fromTopic": "shabbat-shuvah", - "order": { - "linksInCommon": 0, - "toTfidf": 0, - "fromTfidf": 0 - } - }, - { - "toTopic": "shabbat", - "linkType": "is-a", - "class": "intraTopic", - "dataSource": "aspaklaria-edited-by-sefaria", - "fromTopic": "shabbat-hagadol", - "order": { - "linksInCommon": 1, - "toTfidf": 6.1420049159848755, - "fromTfidf": 9.085421387618508 - } - } - ] - } - } - } - } + { + "_id": "54bd48c4fbfba21733367c00", + "index_title": "Numbers", + "category": "Tanakh", + "type": "", + "ref": "Numbers 20", + "anchorRef": "Or HaChaim on Deuteronomy 1:1:1", + "anchorRefExpanded": [ + "Or HaChaim on Deuteronomy 1:1:1" + ], + "sourceRef": "Numbers 20", + "sourceHeRef": "במדבר כ׳", + "anchorVerse": 1, + "sourceHasEn": true, + "compDate": [ + -1400, + -400 + ], + "commentaryNum": 20, + "collectiveTitle": { + "en": "Numbers", + "he": "במדבר" + }, + "heTitle": "במדבר" }, - "description": "A list of topics connected to the `topic_slug` as well as a list of links. " - } - }, - "summary": "Topic Graph", - "description": "Endpoint to retrieve topics and their links between other topics. As opposed to topic links to refs, this endpoint retrieve connections between one topic to another topic. " - }, - "parameters": [ - { - "examples": { - "Moses": { - "value": "moses" + { + "_id": "54bd48c4fbfba21733367c02", + "index_title": "Numbers", + "category": "Tanakh", + "type": "", + "ref": "Numbers 12:8", + "anchorRef": "Or HaChaim on Deuteronomy 1:1:1", + "anchorRefExpanded": [ + "Or HaChaim on Deuteronomy 1:1:1" + ], + "sourceRef": "Numbers 12:8", + "sourceHeRef": "במדבר י״ב:ח׳", + "anchorVerse": 1, + "sourceHasEn": true, + "compDate": [ + -1400, + -400 + ], + "commentaryNum": 12.0008, + "collectiveTitle": { + "en": "Numbers", + "he": "במדבר" + }, + "heTitle": "במדבר" }, - "The Four Species": { - "value": "the-four-species" - } - }, - "name": "topic_slug", - "description": "A valid Sefaria slug for a topic in the database. ", - "schema": { - "type": "string" - }, - "in": "path", - "required": true - }, - { - "name": "link_type", - "description": "Default is `is-a`, but you can pass any link type.", - "schema": { - "type": "string" - }, - "in": "query" - } - ] - }, - "/api/recommend/topics/{ref_list}": { - "get": { - "tags": [ - "Topic" - ], - "parameters": [ - { - "examples": { - "example1": { - "value": "Genesis 50+Mishnah Peah 3" - } + { + "_id": "54bd48c4fbfba21733367c06", + "index_title": "Kiddushin", + "category": "Talmud", + "type": "", + "ref": "Kiddushin 38a", + "anchorRef": "Or HaChaim on Deuteronomy 1:1:1", + "anchorRefExpanded": [ + "Or HaChaim on Deuteronomy 1:1:1" + ], + "sourceRef": "Kiddushin 38a", + "sourceHeRef": "קידושין ל״ח א", + "anchorVerse": 1, + "sourceHasEn": true, + "compDate": [ + 450, + 550 + ], + "commentaryNum": 75, + "collectiveTitle": { + "en": "Kiddushin", + "he": "קידושין" + }, + "heTitle": "קידושין" }, - "name": "ref_list", - "description": "List of strings separated by '+'", - "schema": { - "type": "string" + { + "_id": "54bd48c4fbfba21733367c0a", + "index_title": "Berakhot", + "category": "Talmud", + "type": "", + "ref": "Berakhot 7a", + "anchorRef": "Or HaChaim on Deuteronomy 1:1:1", + "anchorRefExpanded": [ + "Or HaChaim on Deuteronomy 1:1:1" + ], + "sourceRef": "Berakhot 7a", + "sourceHeRef": "ברכות ז׳ א", + "anchorVerse": 1, + "sourceHasEn": true, + "compDate": [ + 450, + 550 + ], + "commentaryNum": 13, + "collectiveTitle": { + "en": "Berakhot", + "he": "ברכות" + }, + "heTitle": "ברכות" }, - "in": "path", - "required": true - } - ], - "responses": { - "200": { - "content": { - "application/json": { - "schema": { - "type": "array", - "items": { - "$ref": "#/components/schemas/recommendedTopicResponse" - } - } - } + { + "_id": "54bd48c4fbfba21733367c0c", + "index_title": "Eruvin", + "category": "Talmud", + "type": "", + "ref": "Eruvin 54a", + "anchorRef": "Or HaChaim on Deuteronomy 1:1:1", + "anchorRefExpanded": [ + "Or HaChaim on Deuteronomy 1:1:1" + ], + "sourceRef": "Eruvin 54a", + "sourceHeRef": "עירובין נ״ד א", + "anchorVerse": 1, + "sourceHasEn": true, + "compDate": [ + 450, + 550 + ], + "commentaryNum": 107, + "collectiveTitle": { + "en": "Eruvin", + "he": "עירובין" + }, + "heTitle": "עירובין" }, - "description": "Successful response" - } - }, - "summary": "Recommended Topics", - "description": "Given a list of `Ref`s this API returns the most used topics associated with them. This is a fast way of identifying potential shared topics amongst disparate `Ref`s." - }, - "post": { - "requestBody": { - "content": { - "application/json": { - "schema": { - "type": "object", - "properties": { - "json": { - "description": "List of strings", - "type": "array", - "items": { - "type": "string" - } - } - } - } + { + "_id": "54bd48c4fbfba21733367c10", + "index_title": "Genesis", + "category": "Tanakh", + "type": "", + "ref": "Genesis 14:13", + "anchorRef": "Or HaChaim on Deuteronomy 1:1:1", + "anchorRefExpanded": [ + "Or HaChaim on Deuteronomy 1:1:1" + ], + "sourceRef": "Genesis 14:13", + "sourceHeRef": "בראשית י״ד:י״ג", + "anchorVerse": 1, + "sourceHasEn": true, + "compDate": [ + -1400, + -400 + ], + "commentaryNum": 14.0013, + "collectiveTitle": { + "en": "Genesis", + "he": "בראשית" + }, + "heTitle": "בראשית" + }, + { + "_id": "54bd48c4fbfba21733367c12", + "index_title": "Genesis", + "category": "Tanakh", + "type": "", + "ref": "Genesis 25:27", + "anchorRef": "Or HaChaim on Deuteronomy 1:1:1", + "anchorRefExpanded": [ + "Or HaChaim on Deuteronomy 1:1:1" + ], + "sourceRef": "Genesis 25:27", + "sourceHeRef": "בראשית כ״ה:כ״ז", + "anchorVerse": 1, + "sourceHasEn": true, + "compDate": [ + -1400, + -400 + ], + "commentaryNum": 25.0027, + "collectiveTitle": { + "en": "Genesis", + "he": "בראשית" + }, + "heTitle": "בראשית" + }, + { + "_id": "5c17ba58b071e100bf4f3c69", + "index_title": "Megillah", + "category": "Talmud", + "type": "", + "ref": "Megillah 31b:8", + "anchorRef": "Or HaChaim on Deuteronomy 1:1:1", + "anchorRefExpanded": [ + "Or HaChaim on Deuteronomy 1:1:1" + ], + "sourceRef": "Megillah 31b:8", + "sourceHeRef": "מגילה ל״א ב:ח׳", + "anchorVerse": 1, + "sourceHasEn": true, + "compDate": [ + 450, + 550 + ], + "commentaryNum": 62.0008, + "collectiveTitle": { + "en": "Megillah", + "he": "מגילה" + }, + "heTitle": "מגילה" } - }, - "required": true - }, - "tags": [ - "Topic" - ], - "responses": { - "200": { - "content": { - "application/json": { - "schema": { - "type": "array", - "items": { - "$ref": "#/components/schemas/recommendedTopicResponse" - } - } + ], + "sheets": [ + { + "owner": 10614, + "_id": "60ee8884d6d0a523b1342111", + "id": "335567", + "public": true, + "title": "Gentle Rebuke", + "sheetUrl": "/sheets/335567", + "anchorRef": "Or HaChaim on Deuteronomy 1:1:1", + "anchorRefExpanded": [ + "Or HaChaim on Deuteronomy 1:1:1" + ], + "options": { + "numbered": 0, + "boxed": 0, + "assignable": 0, + "bsd": 0, + "language": "bilingual", + "layout": "sideBySide", + "langLayout": "heRight", + "divineNames": "noSub", + "highlightMode": 0, + "collaboration": "none" + }, + "ownerName": "Rabbi Yossi Orkin", + "ownerProfileUrl": "/profile/yossi-orkin", + "ownerImageUrl": "https://storage.googleapis.com/sefaria-profile-pictures/yossi-orkin-1626415935-small.png", + "status": "public", + "views": 398, + "topics": [ + { + "slug": "deuteronomy", + "asTyped": "Parshat Devarim", + "en": "Parshat Devarim", + "he": "ספר דברים" + } + ], + "likes": [], + "summary": "Parshat Devarim Questions", + "is_featured": false, + "category": "Sheets", + "type": "sheet" + }, + { + "owner": 92910, + "_id": "60ec76e6340e9458714cc018", + "id": "335153", + "public": true, + "title": "R'Isaac Bernstein -1st of series on \"themes in Devorim\".", + "sheetUrl": "/sheets/335153", + "anchorRef": "Or HaChaim on Deuteronomy 1:1:1", + "anchorRefExpanded": [ + "Or HaChaim on Deuteronomy 1:1:1" + ], + "options": { + "numbered": 0, + "boxed": 0, + "assignable": 0, + "bsd": 0, + "language": "hebrew", + "layout": "stacked", + "langLayout": "heRight", + "divineNames": "h", + "highlightMode": 0, + "collaboration": "none" + }, + "ownerName": "I am Anonymous", + "ownerProfileUrl": "/profile/i-am-anonymous", + "ownerImageUrl": "", + "status": "public", + "views": 278, + "topics": [ + { + "slug": "parshanut1", + "asTyped": "Parshanut", + "en": "Parshanut", + "he": "פרשנות" + }, + { + "slug": "torah-portions", + "asTyped": "Parsha", + "en": "Parsha", + "he": "פרשות השבוע" } + ], + "likes": [], + "summary": "Parsha shiurim by R'Isaac Bernsein", + "is_featured": false, + "category": "Sheets", + "type": "sheet" }, - "description": "Successful response" + { + "owner": 62800, + "_id": "62ed99e8a85e3ca24ef0064f", + "id": "423213", + "public": true, + "title": "OHR HACHAIM ON DEVARIM", + "sheetUrl": "/sheets/423213", + "anchorRef": "Or HaChaim on Deuteronomy 1:1", + "anchorRefExpanded": [ + "Or HaChaim on Deuteronomy 1:1:1" + ], + "options": { + "numbered": 0, + "boxed": 0, + "assignable": 0, + "bsd": 0, + "language": "hebrew", + "layout": "stacked", + "langLayout": "heRight", + "divineNames": "noSub", + "highlightMode": 0, + "collaboration": "none" + }, + "ownerName": "Yitzi Adlin", + "ownerProfileUrl": "/profile/yitzi-adlin", + "ownerImageUrl": "", + "status": "public", + "views": 186, + "topics": [], + "likes": [], + "summary": "", + "is_featured": false, + "category": "Sheets", + "type": "sheet" + } + ], + "notes": [], + "webpages": [], + "topics": [], + "manuscripts": [], + "media": [] } - }, - "summary": "Recommended topics API", - "description": "Given a list of refs this API returns the most used topics associated with them. It's a fast way of identifying potential shared topics amongst disperate references.\n\nn.b. The `ref_list` param is not required for a post request." + } + } + } }, - "parameters": [ - { - "name": "ref_list", - "description": "List of strings separated by '+'", - "schema": { - "type": "string" - }, - "in": "path", - "required": true + "description": "All content related to the queried `Ref`. " + } + }, + "summary": "Related", + "description": "A single API endpoint to return all of the content (links, sheets, notes, media, manuscripts, webpages and topics) related to the given `Ref` in the query. " + }, + "parameters": [ + { + "examples": { + "Tanakh": { + "value": "Deuteronomy 1.1" + } + }, + "name": "tref", + "description": "A valid Sefaria textual `Ref`. ", + "schema": { + "$ref": "#/components/schemas/ref" + }, + "in": "path", + "required": true + } + ] + }, + "/api/links/{tref}": { + "get": { + "tags": [ + "Related" + ], + "parameters": [ + { + "name": "with_text", + "description": "`with_text` is an optional parameter that determines whether or not the API response will include the text of any connected links. It's default is `1`", + "schema": { + "enum": [ + "0", + "1" + ], + "type": "string" + }, + "in": "query" + }, + { + "name": "with_sheet_links", + "description": "`with_sheet_links` is an optional parameter that determines whether or not the API response will include links to user generated source sheets from Sefaria. It's default is `0`", + "schema": { + "enum": [ + "0", + "1" + ], + "type": "string" + }, + "in": "query" + } + ], + "responses": { + "200": { + "content": { + "application/json": { + "schema": { + "type": "array", + "items": { + "$ref": "#/components/schemas/LinkObj" + } } - ] + } + }, + "description": "Successful response" + } }, - "/api/texts/random-by-topic": { - "summary": "Random By Topic API", - "description": "Returns Texts API data for a random text taken from popular topic tags", - "get": { - "tags": [ - "Topic" - ], - "responses": { - "200": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/RandomByTopicJSON" - }, - "examples": { - "Metushelach": { - "value": { - "ref": "Avot D'Rabbi Natan 32:1", - "topic": { - "slug": "metushelach", - "titles": [ - { - "text": "Metushelach", - "lang": "en", - "primary": true, - "transliteration": true - }, - { - "text": "מתושלח", - "lang": "he", - "primary": true - }, - { - "text": "Methuselah", - "lang": "en" - }, - { - "text": "Methushelach", - "lang": "en" - } - ], - "subclass": "person", - "alt_ids": { - "_temp_id": "מתושלח", - "wikidata": "Q156290" - }, - "properties": { - "enWikiLink": { - "value": "https://en.wikipedia.org/wiki/Methuselah", - "dataSource": "wikidata" - }, - "heWikiLink": { - "value": "https://he.wikipedia.org/wiki/מתושלח", - "dataSource": "wikidata" - }, - "deWikiLink": { - "value": "https://de.wikipedia.org/wiki/Methusalem", - "dataSource": "wikidata" - }, - "esWikiLink": { - "value": "https://es.wikipedia.org/wiki/Matusalén", - "dataSource": "wikidata" - }, - "frWikiLink": { - "value": "https://fr.wikipedia.org/wiki/Mathusalem", - "dataSource": "wikidata" - }, - "ruWikiLink": { - "value": "https://ru.wikipedia.org/wiki/Мафусал_(потомок_Сифа)", - "dataSource": "wikidata" - } - }, - "numSources": 7, - "good_to_promote": true, - "primaryTitle": { - "en": "Metushelach", - "he": "מתושלח" - } - }, - "url": "Avot_D'Rabbi_Natan.32.1" - } - } - } - } - }, - "description": "Successful response" - } + "summary": "Links", + "description": "Returns a list of known connections for the submitted text `ref` along with some additional metadata." + }, + "parameters": [ + { + "examples": { + "Tanakh": { + "value": "Obadiah 1.2" + } + }, + "name": "tref", + "description": "A valid Sefaria textual `Ref`.", + "schema": { + "$ref": "#/components/schemas/ref" + }, + "in": "path", + "required": true + } + ] + }, + "/api/ref-topic-links/{tref}": { + "get": { + "tags": [ + "Related" + ], + "responses": { + "200": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/RefTopicLinksJSON" }, - "summary": "Random By Topic", - "description": "Returns Texts API data for a random text taken from popular topic tags." + "examples": { + "Link to Bamidbar": { + "value": { + "linkType": "about", + "class": "refTopic", + "dataSource": { + "en": "Aspaklaria", + "he": "אספקלריא", + "slug": "aspaklaria" + }, + "is_sheet": false, + "order": { + "tfidf": 53.476917039392994, + "numDatasource": 2, + "availableLangs": [ + "en", + "he" + ], + "comp_date": -1400, + "order_id": "A00000000300280026", + "pr": 5.15330629652094, + "curatedPrimacy": { + "en": 100, + "he": 0 + } + }, + "descriptions": { + "en": { + "title": "A New Grain Offering", + "prompt": "The central ritual of Shavuot as described in the Torah is a special bread offering that was brought to the Temple. This sacrifice marked the beginning of sacrifices that were brought using grain from that year, as opposed to grains from the previous year, as explained in the Book of Numbers." + } + }, + "topic": "shavuot", + "anchorRef": "Numbers 28:26", + "anchorRefExpanded": [ + "Numbers 28:26" + ] + } + } + } + } + }, + "description": "Successful response" + } + }, + "summary": "Ref-Topic-Links", + "description": "An API endpoint where, given a `Ref`, all of the topics linked to that `Ref` are retrieved along with the respective metadata. " + }, + "parameters": [ + { + "examples": { + "Tanakh": { + "value": "Genesis" + }, + "Tanakh Section": { + "value": "Judges 12" + }, + "Tanakh Segment": { + "value": "Esther 4:14" + }, + "Talmud Segment": { + "value": "Shabbat 2b.2" } + }, + "name": "tref", + "description": "A valid Sefaria textual `Ref`", + "schema": { + "$ref": "#/components/schemas/ref" + }, + "in": "path", + "required": true + } + ] + }, + "/api/calendars": { + "get": { + "tags": [ + "Calendars" + ], + "parameters": [ + { + "name": "diaspora", + "description": "When this value is set to `diaspora=1`, the text returned is the weekly Torah reading for the diaspora. When this value is set to `diaspora=0`, the text returned is the Torah reading for Israel. ", + "schema": { + "enum": [ + "0", + "1" + ], + "type": "string" + }, + "in": "query", + "required": false + }, + { + "name": "custom", + "description": "If available, the weekly _Haftarah_ will be returned for one of the selected custom.", + "schema": { + "enum": [ + "ashkenazi", + "sephardi", + "edot%20hamizrach" + ], + "type": "string" + }, + "in": "query" + }, + { + "name": "year", + "description": "By default the API returns for the current time. You can override it by using a combination of the `year`, `day`, and `month` params - all three of which must be used, or else the API will fallback to the default.", + "schema": { + "type": "number" + }, + "in": "query" + }, + { + "name": "month", + "description": "By default the API returns for the current time. You can override it by using a combination of the `year`, `day`, and `month` params - all three of which must be used, or else the API will fallback to the default.", + "schema": { + "type": "number" + }, + "in": "query" + }, + { + "name": "day", + "description": "By default the API returns for the current time. You can override it by using a combination of the `year`, `day`, and `month` params - all three of which must be used, or else the API will fallback to the default.", + "schema": { + "type": "number" + }, + "in": "query" + }, + { + "name": "timezone", + "description": "By default, the API attempts to return the calendars for the client's timezone. If you want another region you can override it. Timezone names are in accordance with [IANA Standards](https://www.iana.org/time-zones)", + "schema": {}, + "in": "query" + } + ], + "responses": { + "200": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/CalendarAPIResponse" + } + } + }, + "description": "Successful Response" + } }, - "/api/terms/{name}": { - "summary": "The Terms API", - "description": "A Term is a shared title node. It can be referenced and used by many different `Index` nodes. Terms that use the same `TermScheme` can be ordered within that scheme. So for example, _Parsha_ terms who all share the `TermScheme` of `parsha`, can be ordered within that scheme. \n\nExamples of valid terms: `Noah`, `HaChovel`\n", - "get": { - "tags": [ - "Term" - ], - "responses": { - "200": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/TermsJSON" - }, - "examples": { - "Noah": { - "value": { - "name": "Noach", - "titles": [ - { - "primary": true, - "text": "Noach", - "lang": "en" - }, - { - "primary": true, - "text": "נח", - "lang": "he" - }, - { - "text": "Parashat Noach", - "lang": "en" - }, - { - "text": "פרשת נח", - "lang": "he" - }, - { - "text": "Noah", - "lang": "en" - }, - { - "text": "Parshat Noah", - "lang": "en" - } - ], - "scheme": "Parasha", - "order": 2, - "ref": "Genesis 6:9-11:32", - "category": "Torah Portions" - } - } - } - } - }, - "description": "The response to a query for a specific Term in the Terms API. " - } - }, - "summary": "Terms", - "description": "A Term is a shared title node. It can be referenced and used by many different `Index` nodes. Terms that use the same `TermScheme` can be ordered within that scheme. So for example, _Parsha_ terms who all share the `TermScheme` of `parsha`, can be ordered within that scheme. \n\nExamples of valid terms: `Noah`, `HaChovel`\n" + "summary": "Calendars", + "description": "Returns the daily or weekly learning schedule for a given date." + } + }, + "/api/calendars/next-read/{parasha}": { + "get": { + "tags": [ + "Calendars" + ], + "parameters": [ + { + "name": "parasha", + "description": "One of the 54 weekly Torah Parasha names in English or one of the 7 double parshiyot.", + "schema": { + "enum": [ + "Bereshit", + "Noach", + "Lech-Lecha", + "Vayera", + "Chayei Sara", + "Toldot", + "Vayetzei", + "Vayishlach", + "Vayeshev", + "Miketz", + "Vayigash", + "Vayechi", + "Shemot", + "Vaera", + "Bo", + "Beshalach", + "Yitro", + "Mishpatim", + "Terumah", + "Tetzaveh", + "Ki Tisa", + "Vayakhel", + "Pekudei", + "Vayikra", + "Tzav", + "Shmini", + "Tazria", + "Metzora", + "Achrei Mot", + "Kedoshim", + "Emor", + "Behar", + "Bechukotai", + "Bamidbar", + "Nasso", + "Beha’alotcha", + "Sh’lach", + "Korach", + "Chukat", + "Balak", + "Pinchas", + "Matot", + "Masei", + "Devarim", + "Vaetchanan", + "Eikev", + "Re’eh", + "Shoftim", + "Ki Teitzei", + "Ki Tavo", + "Nitzavim", + "Vayeilech", + "Ha’azinu", + "Vezot Haberakhah", + "Vayakhel-Pekudei", + "Tazria-Metzora", + "Achrei Mot-Kedoshim", + "Behar-Bechukotai", + "Chukat-Balak", + "Matot-Masei", + "Nitzavim-Vayeilech" + ], + "type": "string" }, - "parameters": [ - { - "examples": { - "Parasha": { - "value": "Noah" - }, - "Chapter of Talmud": { - "value": "HaChovel" - } - }, - "name": "name", - "description": "The English name of a valid Sefaria term. ", - "schema": { - "type": "string" - }, - "in": "path", - "required": true + "in": "path", + "required": true + } + ], + "responses": { + "200": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/CalendarNextReadAPI" } - ] + } + }, + "description": "Successful Response" + } }, - "/api/name/{name}": { - "description": "Serves primarily as an autocompleter, returning potential keyword matches for `Ref`s, book titles, authors, topics, and collections available on Sefaria", - "get": { - "tags": [ - "Term" - ], - "parameters": [ - { - "name": "limit", - "description": "Number of results to return (`0` indicates no limit)", - "schema": { - "type": "integer" - }, - "in": "query" - }, - { - "name": "ref_only", - "description": "By default `0` the Name API returns `Ref`s, book titles, authors, topics, and collections. If true, the response will only contain text references.", - "schema": { - "type": "boolean" - }, - "in": "query" - } - ], - "responses": { - "200": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/nameAPIResponse" - } - } - }, - "description": "Successful response" - } - }, - "summary": "Name", - "description": "Serves primarily as an autocompleter, returning potential keyword matches for `Ref`s, book titles, authors, topics, and collections available on Sefaria." + "summary": "Next Read", + "description": "Given a Parasha name in English, this API returns the next Hebrew and English dates that it is read, along with details about the Torah and Haftarah readings for that date." + }, + "parameters": [ + { + "examples": { + "Noach": { + "value": "Noach" }, - "parameters": [ - { - "name": "name", - "description": "An arbitrary text string to match against Sefaria's data collections.", - "schema": { - "type": "string" - }, - "in": "path", - "required": true + "Devarim": { + "value": "Devarim" + }, + "Ha'Azinu": { + "value": "Ha%27Azinu" + }, + "Lech Lecha": { + "value": "Lech%20Lecha" + } + }, + "name": "parasha", + "description": "The _Parasha_ for which you'd like to generate relevant metadata, most notably the schedule of when it is next read. \n\n*Note*: The _Parasha_ must be in English written with a capitalized first letter, so `Noach` is valid, but `noach` will return an empty array. Any parshiyot with special characters (i.e. apostrophes, or spaces) should have those special characters percent url encoded. ", + "schema": { + "type": "string" + }, + "in": "path", + "required": true + } + ] + }, + "/api/words/{word}": { + "get": { + "tags": [ + "Lexicon" + ], + "parameters": [ + { + "examples": { + "Tanakh": { + "value": "Leviticus 19.3" + } + }, + "name": "lookup_ref", + "description": "This parameters refines the search to fine tune based on the `lookup_ref`.", + "schema": { + "type": "string" + }, + "in": "query" + }, + { + "name": "never_split", + "description": "This parameters refines the search to limit lookup to only the actual input string.", + "schema": { + "type": "string" + }, + "in": "query" + }, + { + "name": "always_split", + "description": "This parameters refines the search to look for substring matches regardless of results for original input. One can pass the values `0` (to indicate false) and `1` (to indicate true). ", + "schema": { + "type": "string" + }, + "in": "query" + }, + { + "name": "always_consonants", + "description": "", + "schema": { + "type": "string" + }, + "in": "query" + } + ], + "responses": { + "200": { + "content": { + "application/json": { + "schema": { + "type": "array", + "items": { + "anyOf": [ + { + "$ref": "#/components/schemas/JastrowDictionaryEntry" + }, + { + "$ref": "#/components/schemas/StrongsDictionaryEntry" + }, + { + "$ref": "#/components/schemas/BDBDictionaryEntry" + }, + { + "$ref": "#/components/schemas/KleinDictionaryEntry" + }, + { + "$ref": "#/components/schemas/HebrewDictionaryEntry" + } + ] + } } - ] + } + }, + "description": "An array of matching words." + } }, - "/api/find-refs": { - "post": { - "requestBody": { - "description": "", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/FindRefsPOSTRequest" - }, - "examples": { - "Example": { - "value": { - "text": { - "body": "Genesis 1:1 is a citation and also Mishnah Peah 3-4. So is שמות ב", - "title": "Some thoughts on Sefer Bereishit 1" - }, - "lang": "en" - } - } - } - } - }, - "required": true - }, - "tags": [ - "Misc" - ], - "responses": { - "200": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/FindRefsAPIResponse" - } - } - }, - "description": "Successful Response" - } + "summary": "Lexicon", + "description": "Searches Sefaria lexicon entries (i.e. dictionaries) for the query string passed as `word` to the endpoint." + }, + "parameters": [ + { + "name": "word", + "description": "The word or phrase to search for in the lexicons.", + "schema": { + "type": "string" + }, + "in": "path", + "required": true + } + ] + }, + "/api/words/completion/{word}/{lexicon}": { + "description": "Serves primarily as an autocompleter, returning potential lexicon entries for a given input. \n\nReturns an array of arrays, each containing two strings. The first is a completion entry in Hebrew without vowels and the second includes vowels.", + "get": { + "tags": [ + "Lexicon" + ], + "parameters": [ + { + "name": "limit", + "description": "Number of results to return (0 indicates no limit, and is the default)", + "schema": { + "type": "integer" + }, + "in": "query" + }, + { + "examples": { + "Klein Dictionary": { + "value": "Klein Dictionary" + }, + "Jastrow Dictionary": { + "value": "Jastrow Dictionary" + }, + "Sefer HaShorashim": { + "value": "Sefer HaShorashim" + }, + "Animadversions by Elias Levita on Sefer HaShorashim": { + "value": "Animadversions by Elias Levita on Sefer HaShorashim" + }, + "BDB Dictionary": { + "value": "BDB Dictionary" + }, + "BDB Aramaic Dictionary": { + "value": "BDB Aramaic Dictionary" + } + }, + "name": "lexicon", + "description": "An optional text string matching the name of one of Sefaria's lexicons to limit the search.", + "schema": { + "type": "string" + }, + "in": "path", + "required": true + } + ], + "responses": { + "200": { + "content": { + "application/json": { + "schema": { + "type": "array", + "items": { + "$ref": "#/components/schemas/wordCompletionAPIResponse" + } }, - "summary": "Find Refs", - "description": "Initially designed to find links on websites using [Sefaria's Linker](https://www.sefaria.org/linker), the Find Refs API can identify textual refernces in any arbitrary text that gets sent to it via a structured POST request and returns a response object identifying each located reference including its start and end position within the submitted text." - } + "examples": { + "result": { + "value": [ + [ + "אב", + "אַב" + ], + [ + "אב", + "אֵב" + ], + [ + "אב", + "אָב" + ], + [ + "אבד", + "אֲבַד" + ], + [ + "אבה", + "אבה" + ], + [ + "אבן", + "אֶ֫בֶן" + ], + [ + "אגרה", + "אִגְּרָה" + ], + [ + "אדין", + "אֱדַ֫יִן" + ], + [ + "אדר", + "אִדַּר" + ], + [ + "אדר", + "אֲדָר" + ], + [ + "אדרגזר", + "אֲדַרְגָּזַר" + ], + [ + "אדרזדא", + "אַדְרַזְדָּא" + ], + [ + "אדרע", + "אֶדְרַע" + ] + ] + } + } + } + }, + "description": "Successful response" + } }, - "/api/search-wrapper": { - "post": { - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/SearchPOSTData" - } - } - }, - "required": true + "summary": "Word Completion", + "description": "Serves primarily as an autocompleter, returning potential lexicon entries for a given input.\n\nReturns an array of arrays, each containing two strings. The first is a completion entry in Hebrew without vowels and the second includes vowels." + }, + "parameters": [ + { + "name": "word", + "description": "An arbitrary text string to match against Sefaria's lexicon collections.", + "schema": { + "type": "string" + }, + "in": "path", + "required": true + } + ] + }, + "/api/v2/topics/{topic_slug}": { + "summary": "v2 Specific Topic API", + "description": "The `v2` Topic API is identical to the `v1` Topic API, with one exception. When the API is run with the following query parameter `with_refs=1`, the list of topic links returned is grouped by `type`. ", + "get": { + "tags": [ + "Topic" + ], + "parameters": [ + { + "name": "annotate_links", + "description": "Values can be `1` or `0`. \n\nIf `1`, adds the following fields to each intra-topic link: `title`, `titleIsTransliteration`, `shouldDisplay`, and `order`.", + "schema": { + "type": "integer" + }, + "in": "query" + } + ], + "responses": { + "200": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/TopicJSON" }, - "tags": [ - "Misc" - ], - "responses": { - "200": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/searchResponse" - } - } + "examples": { + "Moses": { + "value": { + "slug": "moses", + "titles": [ + { + "text": "Moses", + "lang": "en", + "primary": true }, - "description": "Successful Response" - } - }, - "summary": "Search", - "description": "An [elastic search](https://www.elastic.co/guide/en/elasticsearch/reference/current/) endpoint for Sefaria's data. Given a properly formated POST request this endpoint will return search results for appropriate Sefaria records." - } - }, - "/api/img-gen/{tref}": { - "get": { - "tags": [ - "Misc" - ], - "parameters": [ - { - "name": "lang", - "description": "The language the social image should return, `en` for English language or `he` for Hebrew. ", - "schema": { - "enum": [ - "he", - "en" - ], - "type": "string" + { + "text": "Moshe", + "lang": "en" }, - "in": "query" - }, - { - "name": "platform", - "description": "This value determines the size of the image, set to the platform's ideal as specified in its own developer documentation.", - "schema": { - "enum": [ - "facebook", - "twitter" - ], - "type": "string" + { + "text": "Moshe Rabbeinu", + "lang": "en" }, - "in": "query" - }, - { - "examples": { - "JSP 1917": { - "value": "The Holy Scriptures: A New Translation (JPS 1917)" - } + { + "text": "moses", + "lang": "en" }, - "name": "ven", - "description": "The title of the version of English text desired for the image. ", - "schema": { - "type": "string" + { + "text": "MOshe", + "lang": "en" }, - "in": "query" - }, - { - "examples": { - "Tanach with Ta'amei Hamikra": { - "value": "Tanach with Ta'amei Hamikra" - } + { + "text": "#Moshe", + "lang": "en" }, - "name": "vhe", - "description": "The title of the version of Hebrew text desired for the image. ", - "schema": { - "type": "string" + { + "text": "Moshe Rebbeinu", + "lang": "en" }, - "in": "query" - } - ], - "responses": { - "200": { - "content": { - "image/png": {} + { + "text": "Moshe Rabeinu", + "lang": "en" }, - "description": "Successful Response" - } - }, - "summary": "Social Media Image", - "description": "Given a Sefaria text `Ref` and some other optional parameters, this endpoint returns a .png image ready to share on social media. At Sefaria.org we use it primarily to auto-generate social media images for any page." - }, - "parameters": [ - { - "examples": { - "Tanakh Ref": { - "value": "Esther 1.1" + { + "text": "Moses a Leader", + "lang": "en" }, - "Talmud Ref": { - "value": "Pesachim 21b.1" - } - }, - "name": "tref", - "description": "A valid Sefaria textual `Ref`.", - "schema": { - "$ref": "#/components/schemas/ref" - }, - "in": "path", - "required": true - } - ] - }, - "/api/category/{category_path}": { - "summary": "Category", - "description": "The category API takes a full category path in the request, e.g. /api/category/Tanakh/Torah/Genesis, and return the full category object found. The above request would return:", - "get": { - "tags": [ - "Misc" - ], - "responses": { - "200": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/CatJSON" - }, - "examples": { - "Genesis": { - "value": { - "path": [ - "Tanakh", - "Torah" - ], - "titles": [ - { - "lang": "en", - "text": "Torah", - "primary": true - }, - { - "lang": "he", - "text": "תורה", - "primary": true - } - ], - "lastPath": "Torah" - } - } - } - } + { + "text": "Moses our teacher", + "lang": "en" }, - "description": "GET requests take a full category path in the request, e.g. `/api/category/Tanakh/Torah/Genesis`, and return the full category object found. \n\nIf the category is not found, the returned object will have an error attribute. If any element of the path is found, the API will return the closest parent in an attribute called `closest_parent`. This is useful for proactively looking up a category before posting an `Index` to it." - } - }, - "summary": "Category", - "description": "GET requests take a full category path in the request, e.g. `/api/category/Tanakh/Torah/Genesis`, and return the full category object found. \n\nIf the category is not found, the returned object will have an error attribute. If any element of the path is found, the API will return the closest parent in an attribute called `closest_parent`. This is useful for proactively looking up a category before posting an `Index` to it." - }, - "parameters": [ - { - "examples": { - "Genesis": { - "value": "Tanakh/Torah/Genesis" + { + "text": "משה", + "lang": "he", + "primary": true }, - "Chiddushei Chatam Sofer": { - "value": "Talmud/Bavli/Acharonim on Talmud/Chidushei Chatam Sofer" + { + "text": "ירד", + "lang": "he" + }, + { + "text": "מֹשֶׁה", + "lang": "he" + }, + { + "text": "משה רבינו", + "lang": "he" + }, + { + "text": "משה כמנהיג", + "lang": "he" + }, + { + "text": "משה רבנו", + "lang": "he" } - }, - "name": "category_path", - "description": "A valid Sefaria Category path", - "schema": { - "type": "string" - }, - "in": "path", - "required": true + ], + "subclass": "person", + "alt_ids": { + "_temp_id": "משה", + "wikidata": "Q9077", + "_old_slug": "-75" + }, + "properties": { + "enWikiLink": { + "value": "https://en.wikipedia.org/wiki/Moses", + "dataSource": "wikidata" + }, + "heWikiLink": { + "value": "https://he.wikipedia.org/wiki/משה", + "dataSource": "wikidata" + }, + "deWikiLink": { + "value": "https://de.wikipedia.org/wiki/Mose", + "dataSource": "wikidata" + }, + "esWikiLink": { + "value": "https://es.wikipedia.org/wiki/Moisés", + "dataSource": "wikidata" + }, + "frWikiLink": { + "value": "https://fr.wikipedia.org/wiki/Moïse", + "dataSource": "wikidata" + }, + "ruWikiLink": { + "value": "https://ru.wikipedia.org/wiki/Моисей", + "dataSource": "wikidata" + } + }, + "description": { + "en": "Moses was the greatest prophet in the biblical tradition. Brought up in the Egyptian royal family, he fled Egypt before being sent back by God to lead the Israelites out of slavery and to the Promised Land. He brought the Torah down from Mount Sinai, and, according to Jewish tradition, wrote it all down. He died before reaching Israel.", + "he": "משה היה גדול הנביאים במסורת המקראית. הוא גדל בבית המלוכה המצרי, ברח ממצרים ונשלח לשם בחזרה על ידי אלוהים כדי להוציא את בני ישראל מעבדות ולהביאם לארץ המובטחת. הוא קיבל את התורה בהר סיני, ועל פי המסורת היהודית, כתב אותה מפי האל. הוא נפטר לפני כניסת העם לארץ המובטחת." + }, + "categoryDescription": {}, + "numSources": 1767, + "good_to_promote": true, + "description_published": true, + "data_source": "sefaria", + "primaryTitle": { + "en": "Moses", + "he": "משה" + }, + "primaryTitleIsTransliteration": { + "en": false, + "he": false + } + } + } } - ] + } + }, + "description": "v2 Specific Topic API" + } + }, + "summary": "Topic (v2)", + "description": "Retrieve a specific topic from the `v2` version of the topics API. " + }, + "parameters": [ + { + "examples": { + "Moses": { + "value": "moses" + }, + "Torah": { + "value": "torah" + }, + "The Four Species": { + "value": "the-four-species" + } + }, + "name": "topic_slug", + "description": "The slug of the desired topic", + "schema": { + "type": "string" + }, + "in": "path", + "required": true + }, + { + "name": "with_links", + "description": "Values can be `1` or `0`. \n\nIf `1`, includes intra-topic links in the `result` field, under `links`.", + "schema": { + "type": "integer" + }, + "in": "query" + }, + { + "name": "annotate_links", + "description": "Values can be `1` or `0`. \n\nIf `1`, adds the following fields to each intra-topic link: `title`, `titleIsTransliteration`, `shouldDisplay`, and `order`.", + "schema": { + "type": "integer" + }, + "in": "query" + }, + { + "name": "annotate_time_period", + "description": "Values can be `1` or `0`. \n\nIf `1`, the response includes time period data under the `timePeriod` key.", + "schema": {}, + "in": "query" + }, + { + "name": "group_related", + "description": "Values can be `1` or `0`. \n\nIf `1`, groups link types with the `groupRelated` key set to true. This will simulate how the sidebar looks on the Sefaria site.", + "schema": { + "type": "integer" + }, + "in": "query" + }, + { + "name": "with_refs", + "description": "Values can be `1` or `0`. \n\nIf `1`, adds a list of `Ref`s tagged with this topic under the `refs` key.", + "schema": { + "type": "integer" + }, + "in": "query" } + ] }, - "components": { - "schemas": { - "ref": { - "description": "A string representing a citation to a Jewish text. \n\nA valid `Ref` consists of a title string followed optionally by a section string or a segment string. \n\nA title string is any one of the known text titles or title variants in the Sefaria Database.", - "type": "string", - "example": "Mishnah Peah 4:2" - }, - "versionData": { - "title": "Root Type for versionData", - "description": "Information about a single text version of a title", - "type": "object", - "properties": { - "title": { - "type": "string" - }, - "versionTitle": { - "type": "string" - }, - "versionSource": { - "type": "string" - }, - "language": { - "type": "string" - }, - "status": { - "type": "string" - }, - "license": { - "type": "string" - }, - "versionNotes": { - "type": "string" - }, - "digitizedBySefaria": { - "type": "string" - }, - "priority": { - "format": "int32", - "type": "integer" - }, - "versionTitleInHebrew": { - "type": "string" - }, - "versionNotesInHebrew": { - "type": "string" - }, - "extendedNotes": { - "type": "string" - }, - "extendedNotesHebrew": { - "type": "string" - }, - "purchaseInformationImage": { - "type": "string" - }, - "purchaseInformationURL": { - "type": "string" - }, - "shortVersionTitle": { - "type": "string" - }, - "shortVersionTitleInHebrew": { - "type": "string" - }, - "isBaseText": { - "type": "boolean" - }, - "firstSectionRef": { - "type": "string" - } + "/api/topics/{topic_slug}": { + "summary": "The Specific Topic API", + "description": "This API will return all of the metadata for the given topic passed in as a path parameter with its `topic_slug`. ", + "get": { + "tags": [ + "Topic" + ], + "responses": { + "200": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/TopicJSON" }, - "example": { - "title": "Genesis", - "versionTitle": "The Contemporary Torah, Jewish Publication Society, 2006", - "versionSource": "https://www.nli.org.il/he/books/NNL_ALEPH002529489/NLI", - "language": "en", - "status": "locked", - "license": "CC-BY-NC", - "versionNotes": "Dedicated by an anonymous donor in honor of all women and girls who study, teach, and transform Torah.\n

\nRead the preface to The Contemporary Torah\n

\n See the Dictionary of Gender in the Torah", - "digitizedBySefaria": "", - "priority": 7, - "versionTitleInHebrew": "", - "versionNotesInHebrew": "תרומה אלמונית לכבוד כל הנשים והבנות שלומדות, מלמדות ונותנות צורה חדשה לתורה", - "extendedNotes": "", - "extendedNotesHebrew": "", - "purchaseInformationImage": "https://jps.org/wp-content/uploads/2014/10/ContemporaryTorah-300x458.png", - "purchaseInformationURL": "https://jps.org/books/contemporary-torah/", - "shortVersionTitle": "The Contemporary Torah, JPS, 2006", - "shortVersionTitleInHebrew": "", - "isBaseText": false, - "firstSectionRef": "Genesis 1" - } - }, - "nameAPIResponse": { - "title": "Root Type for nameAPIResponse", - "description": "Full response of the Name API", - "type": "object", - "properties": { - "lang": { - "description": "The language of the completion results.", - "enum": [ - "en", - "he" - ], - "type": "string" - }, - "is_ref": { - "description": "Returns `true` if the submitted text is a valid Sefaria textual reference", - "type": "boolean" - }, - "completions": { - "description": "A list of autocompletion responses for the submitted text.", - "type": "array", - "items": { - "type": "string" - } - }, - "completion_objects": { - "description": "A list of autocompletion response objects for the submitted text along with some information about them.", - "type": "array", - "items": { - "type": "object", - "properties": { - "title": { - "type": "string" - }, - "key": { - "type": "string" - }, - "type": { - "type": "string" - }, - "is_primary": { - "type": "boolean" - }, - "order": { - "format": "int32", - "type": "integer" - } - } + "examples": { + "Sukkot Topic": { + "value": { + "slug": "sukkot", + "titles": [ + { + "text": "Tabernacles", + "lang": "en" }, - "example": "[{\n \"title\": \"Ruth\",\n \"key\": \"Ruth\",\n \"type\": \"ref\",\n \"is_primary\": true,\n \"order\": 1000000\n }, {\n \"title\": \"Ruth Rabbah\",\n \"key\": \"Ruth Rabbah\",\n \"type\": \"ref\",\n \"is_primary\": true,\n \"order\": 1000000\n }, {\n \"title\": \"Ruth\",\n \"type\": \"PersonTopic\",\n \"key\": \"ruth\",\n \"is_primary\": true,\n \"order\": 4999550\n }, {\n \"title\": \"Ruach Hakodesh\",\n \"type\": \"Topic\",\n \"key\": \"ruach-hakodesh1\",\n \"is_primary\": true,\n \"order\": 4999902\n }, {\n \"title\": \"Ruach\",\n \"type\": \"Topic\",\n \"key\": \"ruach1\",\n \"is_primary\": true,\n \"order\": 4999949\n }, {\n \"title\": \"Rubissa Sharona Hassan\",\n \"type\": \"User\",\n \"key\": \"sharona-hassan\",\n \"pic\": \"https://storage.googleapis.com/sefaria-profile-pictures/sharona-hassan-1622999139-small.png\",\n \"order\": 6999998,\n \"is_primary\": true\n }]" - }, - "is_book": { - "description": "Returns `true` if the submitted text is a book level reference. e.g. (Genesis)", - "type": "boolean" - }, - "is_node": { - "description": "Returns true if the submitted text is a `node` in a complex text. (For example, the query `Abarbanel on Torah, Genesis` is a `node` in the `index` of the complex text `Abarbanel on Torah`). ", - "type": "boolean" - }, - "is_section": { - "description": "Returns `true` if the submitted text is a section `Ref` (e.g. Genesis 4, as opposed to a segment `Ref` such as Genesis 4.1).", - "type": "boolean" - }, - "is_segment": { - "description": "Returns `true` if the submitted text is a segment level `Ref` (e.g. Genesis 43:3, as opposed to a section `Ref` such as Genesis 43)", - "type": "boolean" - }, - "is_range": { - "description": "Returns `true` if the submitted text is a a ranged `Red` (one that spans multiple sections or segments.) e.g. `Genesis 4-5`", - "type": "boolean" - }, - "type": { - "enum": [ - "ref", - "Topic", - "AuthorTopic", - "PersonTopic", - "User" - ], - "type": "string" - }, - "ref": { - "description": "If `is_ref` is `true`, this returns the cannonical ref for the submitted text.", - "type": "string" - }, - "url": { - "description": "If `is_ref` is `true`, this returns the URL path to link to the submitted text on [Sefaria.org](sefaria.org)", - "type": "string" - }, - "index": { - "description": "If `is_ref` is `true`, this returns the cannonical name of the `index` of the submitted text.", - "type": "string" - }, - "book": { - "description": "If the submitted response is a `Ref`, this returns the book it belongs to.", - "type": "string" - }, - "internalSections": { - "type": "array", - "items": { - "format": "int32", - "type": "integer" - } - }, - "internalToSections": { - "type": "array", - "items": { - "format": "int32", - "type": "integer" - } - }, - "sections": { - "type": "array", - "items": { - "type": "string" - } - }, - "toSections": { - "type": "array", - "items": { - "type": "string" - } - }, - "examples": { - "type": "array", - "items": {} - }, - "sectionNames": { - "description": "Given a reference, this returns the names of the sections and segments at each depth of that text.", - "type": "array", - "items": { - "type": "string" - } - }, - "heSectionNames": { - "description": "Given a `Ref`, this returns the names of the sections and segments at each depth of that text in Hebrew.", - "type": "array", - "items": { - "type": "string" - } - }, - "addressExamples": { - "description": "Given a partial `Ref`, this will return an array of strings of possible ways that it might be completed.", - "type": "array", - "items": { - "type": "string" - } - }, - "heAddressExamples": { - "description": "Given a partial `Ref`, this will return an array of Hebrew strings of possible ways that it might be completed.", - "type": "array", - "items": { - "type": "string" - } - } - }, - "example": { - "lang": "en", - "is_ref": true, - "completions": [ - "Job", - "Rashi on Job", - "Rashi on Amos", - "Rashi on Arachin", - "Rashi on Beiah", - "Rashi on Bechorot", - "Rashi on Berachoth", - "Rashi on Chag.", - "Rashi on Hullin", - "Rashi on Dan." - ], - "completion_objects": [ { - "title": "Job", - "key": "Job", - "type": "ref", - "is_primary": true, - "order": 1000000 + "text": "Succot", + "lang": "en" }, { - "title": "Job", - "type": "Topic", - "key": "job-and-his-friends", - "is_primary": false, - "order": 4999978 + "text": "Sukkos", + "lang": "en" }, { - "title": "Rashi on Job", - "key": "Rashi on Job", - "type": "ref", - "is_primary": true, - "order": 1000000 + "text": "Succos", + "lang": "en" }, { - "title": "Rashi on Amos", - "key": "Rashi on Amos", - "type": "ref", - "is_primary": true, - "order": 1000000 + "text": "Booths", + "lang": "en" }, { - "title": "Rashi on Arachin", - "key": "Rashi on Arakhin", - "type": "ref", - "is_primary": false, - "order": 1000000 + "text": "sukkot", + "lang": "en" }, { - "title": "Rashi on Beiah", - "key": "Rashi on Beitzah", - "type": "ref", - "is_primary": false, - "order": 1000000 + "text": "succot", + "lang": "en" }, { - "title": "Rashi on Bechorot", - "key": "Rashi on Bekhorot", - "type": "ref", - "is_primary": false, - "order": 1000000 + "text": "Succoth", + "lang": "en" }, { - "title": "Rashi on Berachoth", - "key": "Rashi on Berakhot", - "type": "ref", - "is_primary": false, - "order": 1000000 + "text": "Sukkoth", + "lang": "en" }, { - "title": "Rashi on Chag.", - "key": "Rashi on Chagigah", - "type": "ref", - "is_primary": false, - "order": 1000000 + "text": "חג הסוכות", + "lang": "he" }, { - "title": "Rashi on Hullin", - "key": "Rashi on Chullin", - "type": "ref", - "is_primary": false, - "order": 1000000 + "text": "סכות", + "lang": "he" }, { - "title": "Rashi on Dan.", - "key": "Rashi on Daniel", - "type": "ref", - "is_primary": false, - "order": 1000000 + "text": "Sukkot", + "lang": "en", + "primary": true + }, + { + "text": "סוכות", + "lang": "he", + "primary": true } - ], - "is_book": false, - "is_node": false, - "is_section": false, - "is_segment": true, - "is_range": false, - "type": "ref", - "ref": "Rashi on Job 1:3:3", - "url": "Rashi_on_Job.1.3.3", - "index": "Rashi on Job", - "book": "Rashi on Job", - "internalSections": [ - 1, - 3, - 3 - ], - "internalToSections": [ - 1, - 3, - 3 - ], - "sections": [ - "1", - "3", - "3" - ], - "toSections": [ - "1", - "3", - "3" - ], - "examples": [], - "sectionNames": [ - "Chapter", - "Verse", - "Comment" - ], - "heSectionNames": [ - "פרק", - "פסוק", - "פירוש" - ], - "addressExamples": [ - "3", - "6", - "9" - ], - "heAddressExamples": [ - "ג׳", - "ו׳", - "ט׳" - ] - } - }, - "dictionaryEntry": { - "title": "Root Type for dictionaryEntry", - "description": "A single dictionary entry on Sefaria.", - "type": "object", - "properties": { - "headword": { - "description": "The main word in the lexicon entry. The one you would look up in the book version.", - "type": "string" - }, - "parent_lexicon": { - "description": "Name of the lexicon from which the entry comes from.", - "type": "string" - }, - "parent_lexicon_details": { - "description": "", - "type": "object" - } - } - }, - "StrongsDictionaryEntry": { - "title": "StrongsDictionaryEntry", - "description": "", - "allOf": [ - { - "$ref": "#/components/schemas/dictionaryEntry" - } - ], - "properties": { - "strong_number": { - "type": "string" - }, - "transliteration": { - "description": "" - }, - "pronunciation": { - "description": "" - }, - "language_code": { - "description": "" - }, - "content": { - "description": "", - "type": "object", - "properties": { - "morphology": { - "type": "string" - }, - "senses": { - "type": "array", - "items": { - "$ref": "#/components/schemas/SenseStrongsDictionaryEntry" - } - } + ], + "alt_ids": { + "_temp_id": "סוכות" + }, + "properties": { + "heNliLink": { + "value": "https://www.nli.org.il/he/discover/judaism/holidays/sukkot", + "dataSource": "sefaria" + }, + "enNliLink": { + "value": "https://www.nli.org.il/en/discover/judaism/holidays/sukkot", + "dataSource": "sefaria" } + }, + "description": { + "en": "Sukkot is a weeklong celebration of the harvest in early fall. It is celebrated by the building of temporary booths — that is, sukkot — outside homes in which people eat their meals and sometimes even sleep. The booths are reminders of the transience of life and the sheltering presence of God.", + "he": "חג הסוכות, הוא חג האסיף, נמשך שבעה ימים ומצוין בחודש תשרי על-ידי בניית סוכה מחוץ לבית, בה אוכלים וחלק גם ישנים. הסוכה היא תזכורת לסוכות שבנו בני ישראל ביציאת מצרים, ומסמלת את ארעיות החיים ואת נוכחותו המגוננת של ה'" + }, + "categoryDescription": {}, + "displayOrder": 4, + "numSources": 831, + "description_published": true, + "data_source": "sefaria", + "image": { + "image_uri": "https://storage.googleapis.com/img.sefaria.org/topics/sukkot.jpg", + "image_caption": { + "en": "Detail of a painting of a sukkah. Image taken from f. 316v of Forli Siddur. 1383, Italian rite. The British Library", + "he": "פרט ציור של סוכה עם שולחן פרוש ושלוש דמויות. דימוי מתוך סידור פורלי, 1383 איטליה" + } + }, + "primaryTitle": { + "en": "Sukkot", + "he": "סוכות" + }, + "primaryTitleIsTransliteration": { + "en": false, + "he": false + } } - }, - "example": { - "headword": "רָאָה", - "parent_lexicon": "BDB Augmented Strong", - "content": { - "morphology": "v", - "senses": [ - { - "definition": "to see, look at, inspect, perceive, consider", - "senses": [ - { - "senses": [ - { - "definition": "to see" - }, - { - "definition": "to see, perceive" - }, - { - "definition": "to see, have vision" - }, - { - "definition": "to look at, see, regard, look after, see after, learn about, observe, watch, look upon, look out, find out" - }, - { - "definition": "to see, observe, consider, look at, give attention to, discern, distinguish" - }, - { - "definition": "to look at, gaze at" - } - ], - "grammar": { - "verbal_stem": "Qal" - } - }, - { - "senses": [ - { - "definition": "to appear, present oneself" - }, - { - "definition": "to be seen" - }, - { - "definition": "to be visible" - } - ], - "grammar": { - "verbal_stem": "Niphal" - } - }, - { - "definition": " to be seen", - "grammar": { - "verbal_stem": "Pual" - } - }, - { - "senses": [ - { - "definition": "to cause to see, show" - }, - { - "definition": "to cause to look intently at, behold, cause to gaze at" - } - ], - "grammar": { - "verbal_stem": "Hiphil" - } - }, - { - "senses": [ - { - "definition": "to be caused to see, be shown" - }, - { - "definition": "to be exhibited to" - } - ], - "grammar": { - "verbal_stem": "Hophal" - } - }, - { - "definition": " to look at each other, face", - "grammar": { - "verbal_stem": "Hithpael" - } - } - ] - } - ] - }, - "strong_number": "7200", - "transliteration": "râʼâh", - "pronunciation": "raw-aw'", - "language_code": "heb", - "parent_lexicon_details": { - "name": "BDB Augmented Strong", - "language": "heb.biblical", - "to_language": "eng", - "text_categories": [ - "Tanakh, Torah", - "Tanakh, Prophets", - "Tanakh, Writings" - ], - "source": "Open Scriptures on GitHub", - "source_url": "https://github.com/openscriptures/strongs", - "attribution": "Based on the work of Larry Pierce at the Online Bible", - "attribution_url": "http://www.blueletterbible.org/contact/contact_gen.cfm" - } + } } + } }, - "BDBDictionaryEntry": { - "title": "BDBDictionaryEntry", - "type": "object", - "allOf": [ - { - "$ref": "#/components/schemas/dictionaryEntry" - } - ], - "properties": { - "rid": { - "description": "Returns a unique id for this reference that establishes an ordering of references across the whole catalog. The `rid` will change as the ordering of the categories changes, and may begin to overlap with other numbers because of those changes. However, at any point in time the `rid`s will be unique across the catalog. The `rid` is used to sort results from ElasticSearch queries.", - "type": "string" - }, - "TWOT": { - "description": "The corresponding Theological Wordbook of the Old Testament number for this word.", - "type": "string" - }, - "strong_numbers": { - "description": "An array of corresponsing Strong Numbers for this word.", - "type": "array", - "items": { - "type": "string" - } - }, - "root": { - "description": "Indicates if the headword is the Biblical root. (Indicated in print, by a larger printed headword).", - "type": "boolean" - }, - "peculiar": { - "description": "A bool indicating the presence of the `‡` symbol in print, demonstrating that the word is peculiar to Biblical Aramaic.", - "type": "boolean" - }, - "ordinal": { - "description": "When the same headword has more than one entry with a differen meaning they are offset by the Roman numerals here.", - "type": "string" - }, - "occurrences": { - "description": "A count of the number of times the headword appears in the Bible", - "type": "number" - }, - "headword_suffix": { - "description": "In some cases the headword has some additional content in print beyond it. That data is included here.", - "type": "string" - }, - "GK": { - "description": "The corresponding Goodrick/Kohlenberger Lexicon number for this headword.", - "type": "string" - }, - "all_cited": { - "description": "A bool indicating the presense of the `†` symbol in print, indicating that all of the occurences of the word are listed as part of this entry", - "type": "boolean" - }, - "brackets": { - "description": "Headword has brackets in print.", - "type": "boolean" - }, - "alt_headwords": { - "description": "An array of alternative headwords for the entry", - "type": "array", - "items": { - "type": "string" - }, - "properties": { - "word": { - "description": "The alternative headword", - "type": "string" - }, - "occurences": { - "description": "The number of times the alternative headword exists in the Bible" - } - } - }, - "prev_hw": { - "description": "The previous entry in print.", - "type": "string" - }, - "next_hw": { - "description": "The next entry in print.", - "type": "string" - }, - "content": { - "description": "", - "type": "object", - "properties": { - "senses": { - "type": "array", - "items": { - "type": "object", - "properties": { - "definition": { - "description": "a definition of this sense of the word", - "type": "string" - }, - "all_cited": { - "description": "A bool indicating the presense of the `†` symbol in print, indicating that all of the occurences of this sense of the word are listed as part of this entry", - "type": "string" - }, - "form": { - "description": "the grammatical verb form (binyan) of the word", - "type": "string" - }, - "note": { - "description": "an additional note for the entry", - "type": "string" - }, - "num": { - "description": "the string of the numbering of this sense in print (it can be a number, English letter, Roman digits, with period, in parentheses, etc.)", - "type": "string" - }, - "occurences": { - "description": "number of occurrences of this sense in bible", - "type": "string" - }, - "pre_num": { - "description": "In some cases the sense has some additional characters before the entry (e.g. the word Especially). That data is included here", - "type": "string" - } - } - } - } - } - } - } + "description": "When one calls this endpoint _with_ a specific `topic_slug`, it returns a JSON object containing the metadata for the topic. \n" + } + }, + "deprecated": true, + "summary": "Topic (v1)", + "description": "When one calls this endpoint _with_ a specific `topic_slug`, it returns a JSON object containing the metadata for the topic. \n" + }, + "parameters": [ + { + "examples": { + "Holiday": { + "value": "rosh-hashanah" }, - "HebrewDictionaryEntry": { - "title": "HebrewDictionaryEntry", - "type": "object", - "allOf": [ - { - "$ref": "#/components/schemas/dictionaryEntry" - } - ], - "properties": { - "rid": { - "description": "Returns a unique id for this reference that establishes an ordering of references across the whole catalog. This id will change as the ordering of the categories changes, and may begin to overlap with other numbers because of those changes. However, at any point in time these ids will be unique across the catalog. Used to sort results from ElasticSearch queries", - "type": "string" - }, - "refs": { - "description": "Cross references to selections in the Sefaria library.", - "type": "array", - "items": { - "$ref": "#/components/schemas/ref" - } - }, - "prev_hw": { - "description": "The previous headword entry from the book.", - "type": "string" - }, - "next_hw": { - "description": "The next headword entry from the book.", - "type": "string" - }, - "content": { - "description": "", - "type": "object", - "properties": { - "senses": { - "type": "array", - "items": { - "type": "object", - "properties": { - "definition": { - "description": "A definition of this sense of the word", - "type": "string" - } - } - } - } - } - } - } + "Ritual objects": { + "value": "the-four-species" }, - "JastrowDictionaryEntry": { - "title": "JastrowDictionaryEntry", - "description": "An entry from Jastrow’s Dictionary,", - "type": "object", - "allOf": [ - { - "$ref": "#/components/schemas/dictionaryEntry" - } - ], - "properties": { - "rid": { - "description": "Returns a unique id for this reference that establishes an ordering of references across the whole catalog. This id will change as the ordering of the categories changes, and may begin to overlap with other numbers because of those changes. However, at any point in time these ids will be unique across the catalog. Used to sort results from ElasticSearch queries" - }, - "quotes": { - "description": "" - }, - "refs": { - "description": "Cross references to selections in the Sefaria library.", - "type": "array", - "items": { - "$ref": "#/components/schemas/ref" + "Conceptual idea": { + "value": "יחיד-וחברה" + }, + "Person": { + "value": "nachman-of-breslov" + } + }, + "name": "topic_slug", + "description": "The slug of a topic in the Sefaria system. (To find all of the slugs, you can run `api/topics` without a path parameter to see the data for each topic in our database).", + "schema": { + "type": "string" + }, + "in": "path", + "required": true + }, + { + "name": "with_links", + "description": "`1` or `0`. If `1`, includes intra-topic links in the `result` field, under `links`.", + "schema": { + "type": "integer" + }, + "in": "query", + "required": false + }, + { + "name": "annotate_links", + "description": "`1` or `0`. If `1`, adds the following fields to each intra-topic link: `title`, `titleIsTransliteration`, `shouldDisplay`, and `order`.", + "schema": { + "type": "integer" + }, + "in": "query" + }, + { + "name": "group_related", + "description": "`1` or `0`. If `1`, groups link types with the `groupRelated` key set to true. This will simulate how the sidebar looks on the Sefaria site.", + "schema": { + "type": "integer" + }, + "in": "query" + }, + { + "name": "with_refs", + "description": "`1` or `0`. If `1`, adds a list of `Ref`s tagged with this topic under the `refs` key.", + "schema": { + "type": "integer" + }, + "in": "query" + }, + { + "name": "annotate_time_period", + "description": "`1` or `0`. If `1`, the response includes time period data under the `timePeriod` key.", + "schema": {}, + "in": "query" + } + ] + }, + "/api/topics": { + "summary": "The Topics API", + "description": "The topics API returns a list of JSON objects containing metadata for every topic in the Sefaria database. ", + "get": { + "tags": [ + "Topic" + ], + "responses": { + "200": { + "content": { + "application/json": { + "schema": { + "type": "array", + "items": { + "$ref": "#/components/schemas/TopicJSON" + } + }, + "examples": { + "The first three topics returned: ": { + "value": [ + { + "slug": "prayer", + "titles": [ + { + "primary": true, + "text": "תפילה", + "lang": "he" + }, + { + "primary": true, + "text": "Prayer", + "lang": "en" + }, + { + "text": "Tefillah", + "lang": "en", + "transliteration": true + }, + { + "text": "תפלה", + "lang": "he", + "fromTerm": true + }, + { + "text": "T'filah", + "lang": "en" + }, + { + "text": "Tefilla", + "lang": "en" + }, + { + "text": "Tefilah", + "lang": "en" + }, + { + "text": "התפלל", + "lang": "he" + }, + { + "text": "Liturgy", + "lang": "en" + }, + { + "text": "Siddur", + "lang": "en" + }, + { + "text": "תְּפִלָּה", + "lang": "he" + }, + { + "text": "סידור", + "lang": "he" + }, + { + "text": "סדר התפילה", + "lang": "he" + }, + { + "lang": "en", + "text": "prayer" + }, + { + "lang": "en", + "text": "#Tefillah" + }, + { + "lang": "en", + "text": "Tefila" + }, + { + "lang": "en", + "text": "TEFILA" + }, + { + "lang": "en", + "text": "Tefiilah" + }, + { + "lang": "en", + "text": "Tfillah" + }, + { + "lang": "en", + "text": "T'fillah" + }, + { + "lang": "en", + "text": "T'filla" + }, + { + "lang": "en", + "text": "Tfilla" + }, + { + "lang": "en", + "text": "T'fila" + } + ], + "alt_ids": { + "_temp_id": "תפלה", + "_temp_toc_id": "Prayer", + "_old_slug": "tfilla1" + }, + "description": {}, + "categoryDescription": { + "en": "Liturgy and modes of Jewish prayer.", + "he": "נוסחי תפילה ודרכי תפילה יהודית." + }, + "isTopLevelDisplay": true, + "displayOrder": 30, + "numSources": 2937, + "good_to_promote": true, + "primaryTitle": { + "en": "Prayer", + "he": "תפילה" } - }, - "prev_hw": { - "description": "The previous headword entry from the book." - }, - "next_hw": { - "description": "The next headword entry from the book." - }, - "plural_form": { - "description": "The plural form of the headword." - }, - "language_reference": { - "description": "" - }, - "language_code": { - "description": "A string containing the following characters `h.` (Hebrew), `b. h.` (Biblical Hebrew) `ch.` or `Ch.` (Chaldean) indicating the source language of the entry." - }, - "alt_headwords": { - "description": "An array of alternate headwords for the entry. Symbolized in print as those headwords separated by commas after the initial entry.", - "type": "array", - "items": { - "type": "string" + }, + { + "slug": "torah", + "titles": [ + { + "text": "Torah", + "lang": "en", + "primary": true + }, + { + "text": "תורה", + "lang": "he", + "primary": true + }, + { + "text": "Chumash", + "lang": "en" + }, + { + "lang": "en", + "text": "torah" + } + ], + "alt_ids": { + "_temp_id": "תורה" + }, + "numSources": 2333, + "good_to_promote": true, + "primaryTitle": { + "en": "Torah", + "he": "תורה" } - }, - "content": { - "description": "", - "type": "object", + }, + { + "slug": "passover", + "titles": [ + { + "text": "Passover", + "lang": "en", + "primary": true + }, + { + "text": "פסח", + "lang": "he", + "primary": true + }, + { + "text": "Pesach", + "lang": "en", + "transliteration": true + }, + { + "text": "Pesah", + "lang": "en" + }, + { + "text": "Chag HaPesach", + "lang": "en", + "fromTerm": true + }, + { + "text": "Pessach", + "lang": "en", + "fromTerm": true + }, + { + "text": "חג הפסח", + "lang": "he", + "fromTerm": true + }, + { + "text": "חג המצות", + "lang": "he", + "fromTerm": true + }, + { + "lang": "he", + "text": "חג פסח" + } + ], + "alt_ids": { + "_temp_id": "פסח", + "_old_slug": "-13" + }, "properties": { - "senses": { - "type": "array", - "items": { - "$ref": "#/components/schemas/SenseJastrowDictionaryEntry" - } - }, - "morphology": { - "description": "A description of the morphological form of the word, one of `m., m. pl., f., f. pl., pr. n., pr. n. pl., pr. n. f., pr. n. m., pron., pers. pron.`", - "type": "string" - } + "heNliLink": { + "value": "https://www.nli.org.il/he/discover/judaism/holidays/passover", + "dataSource": "sefaria" + }, + "enNliLink": { + "value": "https://www.nli.org.il/en/discover/judaism/holidays/passover", + "dataSource": "sefaria" + } + }, + "description": { + "en": "Passover, or Pesach, is a week long springtime festival commemorating the Exodus from Egypt. It also celebrates national redemption, and freedom from slavery. It is observed through avoidance of certain foods (especially grains) and ritual dinners called Seders where attendees retell the story of the Exodus.", + "he": "חג הפסח הוא חג שנמשך שבוע וחל באביב, לזכר יציאת מצרים. הוא גם חוגג את גאולת העם והשחרור מעבדות. הוא נחגג באמצעות הימנעות ממאכלים מסוימים (במיוחד דגנים) וסעודה טקסית הנקראת ליל הסדר אשר בה מספרים המשתתפים את סיפור יציאת מצרים." + }, + "categoryDescription": {}, + "displayOrder": 10, + "numSources": 2040, + "description_published": true, + "primaryTitle": { + "en": "Passover", + "he": "פסח" } - } + }, + { + "slug": "teshuvah", + "titles": [ + { + "text": "Teshuvah", + "lang": "en", + "primary": true + }, + { + "text": "Teshuva", + "lang": "en" + }, + { + "text": "Repentance", + "lang": "en" + }, + { + "text": "Tshuva", + "lang": "en" + }, + { + "text": "Repentence", + "lang": "en" + }, + { + "text": "T'shuva", + "lang": "en" + }, + { + "text": "teshuva", + "lang": "en" + }, + { + "text": "teshuvah", + "lang": "en" + }, + { + "text": "Repent", + "lang": "en" + }, + { + "text": "Tshuvah", + "lang": "en" + }, + { + "text": "תשובה", + "lang": "he", + "primary": true + }, + { + "text": "תְּשׁוּבָה", + "lang": "he" + } + ], + "alt_ids": { + "_temp_id": "תשובה" + }, + "description": { + "en": "The word \"teshuvah\" literally means “return” and is best translated as \"repentance.\" Teshuvah is presented in Jewish sources as a gift from God because it allows one to return to the path of righteousness. Although it can be done at any time, Yom Kippur is the Jewish holiday most associated with repentance.", + "he": "המונח תשובה כוונתו שיבה אל דרכי האל. במקורות היהודיים נתפסת התשובה כמתנה מאלוהים, מכיוון שהיא מאפשרת לאדם לשוב ולדבוק בדרכי הטוב והיושר. אף שתשובה היא דבר שאפשר לעשות בכל עת, יום הכיפורים הוא המועד המוכר ביותר למטרה זו." + }, + "categoryDescription": {}, + "numSources": 1967, + "good_to_promote": true, + "description_published": true, + "data_source": "sefaria", + "primaryTitle": { + "en": "Teshuvah", + "he": "תשובה" + } + }, + { + "slug": "יחיד-וחברה", + "titles": [ + { + "lang": "he", + "text": "יחיד וחברה", + "primary": true + } + ], + "alt_ids": { + "_old_slug": "-163" + }, + "numSources": 1826, + "primaryTitle": { + "en": "", + "he": "יחיד וחברה" + } + } + ] + } } + } }, - "textAPIReponse": { - "title": "Root Type for textAPIReponse", - "description": "Expected reponse data from Sefaria's Text API", - "type": "object", - "properties": { - "ref": { - "$ref": "#/components/schemas/ref" - }, - "heRef": { - "$ref": "#/components/schemas/ref", - "description": "The Hebrew `Ref`." - }, - "isComplex": { - "description": "Whether or not the text is a \"complex\" text or not.\n\nIn Sefaria, a complex text is any text which has a more complicated index structure beyond Chapters/Verses, (e.g. the Talmud). There are a variety of structural differences for a complex text, having to do primarily with its `Index`, and the way the data is stored. For more on complex texts, see the documentation here.", - "type": "boolean" - }, - "text": { - "oneOf": [ + "description": "A list of JSON objects, each object representing a topic in the Sefaria database. Please note, since this list is over 30,000 topics long, in the example we only presented the first several topics that are returned in the array. " + } + }, + "summary": "All Topics", + "description": "The topics API returns a list of JSON objects, each object containing all of the metadata for each topic in the Sefaria database. " + } + }, + "/api/topics-graph/{topic_slug}": { + "summary": "Topic Graph API", + "description": "And enpoint to retrieve links between various topics. ", + "get": { + "tags": [ + "Topic" + ], + "responses": { + "200": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/TopicGraphJSON" + }, + "examples": { + "Shabbat": { + "value": { + "topics": [ + { + "slug": "shabbat", + "titles": [ { - "type": "string" + "text": "Shabbos", + "lang": "en" }, { - "type": "array", - "items": { - "type": "array", - "items": { - "type": "string" - } - } + "text": "Mishnah Shabbat", + "lang": "en" }, { - "type": "array", - "items": { - "type": "string" - } + "text": "שַׁבָּת", + "lang": "he" + }, + { + "text": "השבת", + "lang": "he" + }, + { + "text": "Shabbat", + "lang": "en", + "primary": true + }, + { + "text": "שבת", + "lang": "he", + "primary": true } - ], - "description": "The default, or specified text written in LTR characters for the query (Usually English). It is structured as a `JaggedArray` (nested arrays), with the lowest level being an array of strings with some HTML text." - }, - "he": { - "oneOf": [ + ], + "alt_ids": { + "_temp_id": "שבת", + "_old_slug": "shabbat1" + }, + "properties": { + "heNliLink": { + "value": "https://www.nli.org.il/he/discover/judaism/traditions/shabbat", + "dataSource": "sefaria" + } + }, + "description": { + "en": "Shabbat (or Sabbath) falls every seventh day of the week, from Friday just before sunset until dark on Saturday night. It is a day of rest, marking the time when God stopped creating after after the six days of creation. Shabbat recognizes God as Creator of the Universe and as Redeemer of Israel from Egypt. ", + "he": "היום השביעי בשבוע, החל מיום שישי בשעת השקיעה ועד צאת הכוכבים במוצאי השבת. יום מנוחה לפי המקורות, המציין את הזמן שבו ה' נח לאחר שברא את העולם. " + }, + "categoryDescription": {}, + "displayOrder": 0, + "numSources": 1662, + "good_to_promote": true, + "description_published": true, + "data_source": "sefaria", + "image": { + "image_uri": "https://storage.googleapis.com/img.sefaria.org/topics/shabbat.jpg", + "image_caption": { + "en": "Friday Evening, Isidor Kaufmann, Austria c. 1920. The Jewish Museum, Gift of Mr. and Mrs. M. R. Schweitzer", + "he": "שישי בערב, איזידור קאופמן, וינה 1920. המוזיאון היהודי בניו יורק, מתנת מר וגברת מ.ר. שוויצר" + } + }, + "primaryTitle": { + "en": "Shabbat", + "he": "שבת" + } + }, + { + "slug": "shabbat-shuvah", + "titles": [ { - "type": "array", - "items": { - "type": "string" - } + "text": "Shabbat Shuvah", + "lang": "en", + "primary": true }, { - "type": "string" + "text": "שבת שובה", + "lang": "he", + "primary": true + }, + { + "lang": "he", + "text": "שובה" } - ], - "description": "The default, or specified text written in RTL characters for the query (Usually Hebrew). It is structured as a JaggedArray (nested arrays), with the lowest level being an array of strings with some html text." - }, - "versions": { - "type": "array", - "items": { - "$ref": "#/components/schemas/versionData" - } - }, - "textDepth": { - "format": "int32", - "type": "integer" - }, - "sectionNames": { - "description": "An array containing the type names of the sections of this text. The length of sectionNames gives the depth of the structure of this text. For example, Kohelet `([\"Chapter\", \"Verse\"])` has depth 2, while Mishneh Torah `([\"Book\", \"Topic\", \"Section\", \"Law\"])` has depth 4. Comparing this depth to the depth of sections will show if the request was for the lowest level, or a higher level, of the text.", - "type": "array", - "items": { - "type": "string" - } - }, - "addressTypes": { - "description": "A list which length reflects the depth of the text structure, with string values indicating class names for address types for each level", - "type": "array", - "items": { - "type": "string" - } - }, - "lengths": { - "type": "array", - "items": { - "format": "int32", - "type": "integer" - } - }, - "length": { - "format": "int32", - "type": "integer" - }, - "heTitle": { - "type": "string" - }, - "titleVariants": { - "type": "array", - "items": { - "type": "string" - } - }, - "heTitleVariants": { - "type": "array", - "items": { - "type": "string" - } - }, - "type": { - "type": "string" - }, - "primary_category": { - "type": "string" - }, - "book": { - "description": "The title of the book that the response comes from.", - "type": "string" - }, - "categories": { - "description": "A list of categories that a text belongs to. ", - "type": "array", - "items": { - "type": "string" - } - }, - "order": { - "type": "array", - "items": { - "format": "int32", - "type": "integer" - } - }, - "sections": { - "description": "An array which corresponds to sectionNames and represents the sections of the text requested. When sectionNames is `[\"Chapter\", \"Verse\"]` a request for chapter 4 looks like `[4]` while a request for chapter 4, verse 7 would look like `[4, 7]`. _Note, for Talmud, Dafs are represented by a string like \"42a\" or \"12b\"_", - "type": "array", - "items": { - "format": "int32", - "type": "integer" + ], + "alt_ids": { + "_temp_id": "שבת שובה", + "_old_slug": "399" + }, + "description": { + "en": "Shabbat of Repentance between Rosh Hashanah and Yom Kippur.", + "he": "" + }, + "numSources": 19, + "primaryTitle": { + "en": "Shabbat Shuvah", + "he": "שבת שובה" + } + }, + { + "slug": "shabbat-hagadol", + "titles": [], + "alt_ids": {}, + "description": {}, + "categoryDescription": {}, + "displayOrder": 230, + "numSources": 57, + "description_published": true, + "data_source": "sefaria", + "primaryTitle": { + "en": "Shabbat Hagadol", + "he": "שבת הגדול" + } } - }, - "toSections": { - "type": "array", - "items": { - "format": "int32", - "type": "integer" + ], + "links": [ + { + "toTopic": "shabbat", + "linkType": "is-a", + "class": "intraTopic", + "dataSource": "aspaklaria-edited-by-sefaria", + "fromTopic": "shabbat-shuvah", + "order": { + "linksInCommon": 0, + "toTfidf": 0, + "fromTfidf": 0 + } + }, + { + "toTopic": "shabbat", + "linkType": "is-a", + "class": "intraTopic", + "dataSource": "aspaklaria-edited-by-sefaria", + "fromTopic": "shabbat-hagadol", + "order": { + "linksInCommon": 1, + "toTfidf": 6.1420049159848755, + "fromTfidf": 9.085421387618508 + } } - }, - "isDependant": { - "type": "boolean" - }, - "indexTitle": { - "type": "string" - }, - "heIndexTitle": { - "type": "string" - }, - "sectionRef": { - "$ref": "#/components/schemas/ref" - }, - "firstAvailableSectionRef": { - "type": "string" - }, - "heSectionRef": { - "$ref": "#/components/schemas/ref" - }, - "isSpanning": { - "type": "boolean" - }, - "versionTitle": { - "type": "string" - }, - "versionTitleInHebrew": { - "type": "string" - }, - "shortVersionTitle": { - "type": "string" - }, - "shortVersionTitleInHebrew": { - "type": "string" - }, - "versionSource": { - "type": "string" - }, - "versionStatus": { - "type": "string" - }, - "versionNotes": { - "type": "string" - }, - "extendedNotes": { - "type": "string" - }, - "extendedNotesHebrew": { - "type": "string" - }, - "versionNotesInHebrew": { - "type": "string" - }, - "digitizedBySefaria": { - "description": "Was the `text` response initially digitized by Sefaria `1` or was it initially generated by another digital publisher `0`", - "type": "boolean" - }, - "license": { - "type": "string" - }, - "formatEnAsPoetry": { - "type": "boolean" - }, - "heVersionTitle": { - "type": "string" - }, - "heVersionTitleInHebrew": { - "type": "string" - }, - "heShortVersionTitle": { - "type": "string" - }, - "heShortVersionTitleInHebrew": { - "type": "string" - }, - "heVersionSource": { - "type": "string" - }, - "heVersionStatus": { - "type": "string" - }, - "heVersionNotes": { - "type": "string" - }, - "heExtendedNotes": { - "type": "string" - }, - "heExtendedNotesHebrew": { - "type": "string" - }, - "heVersionNotesInHebrew": { - "type": "string" - }, - "heDigitizedBySefaria": { - "description": "Was the `he` response initially digitized by Sefaria `1` or was it initially generated by another digital publisher `0`", - "type": "boolean" - }, - "heLicense": { - "type": "string" - }, - "formatHeAsPoetry": { - "type": "boolean" - }, - "alts": { - "type": "array", - "items": {} - }, - "index_offsets_by_depth": { - "type": "object" - }, - "next": { - "nullable": true, - "description": "Next segment reference in sequence, if last ref, field will be `null`.", - "type": "string" - }, - "prev": { - "nullable": true, - "description": "Previous segment reference in sequence, if first ref, field will be `null`.", - "type": "string" - }, - "commentary": { - "type": "array", - "items": {} - }, - "sheets": { - "type": "array", - "items": {} - }, - "layer": { - "type": "array", - "items": {} + ] + } + } + } + } + }, + "description": "A list of topics connected to the `topic_slug` as well as a list of links. " + } + }, + "summary": "Topic Graph", + "description": "Endpoint to retrieve topics and their links between other topics. As opposed to topic links to refs, this endpoint retrieve connections between one topic to another topic. " + }, + "parameters": [ + { + "examples": { + "Moses": { + "value": "moses" + }, + "The Four Species": { + "value": "the-four-species" + } + }, + "name": "topic_slug", + "description": "A valid Sefaria slug for a topic in the database. ", + "schema": { + "type": "string" + }, + "in": "path", + "required": true + }, + { + "name": "link_type", + "description": "Default is `is-a`, but you can pass any link type.", + "schema": { + "type": "string" + }, + "in": "query" + } + ] + }, + "/api/recommend/topics/{ref_list}": { + "get": { + "tags": [ + "Topic" + ], + "parameters": [ + { + "examples": { + "example1": { + "value": "Genesis 50+Mishnah Peah 3" + } + }, + "name": "ref_list", + "description": "List of strings separated by '+'", + "schema": { + "type": "string" + }, + "in": "path", + "required": true + } + ], + "responses": { + "200": { + "content": { + "application/json": { + "schema": { + "type": "array", + "items": { + "$ref": "#/components/schemas/recommendedTopicResponse" + } + } + } + }, + "description": "Successful response" + } + }, + "summary": "Recommended Topics", + "description": "Given a list of `Ref`s this API returns the most used topics associated with them. This is a fast way of identifying potential shared topics amongst disparate `Ref`s." + }, + "post": { + "requestBody": { + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "json": { + "description": "List of strings", + "type": "array", + "items": { + "type": "string" } + } + } + } + } + }, + "required": true + }, + "tags": [ + "Topic" + ], + "responses": { + "200": { + "content": { + "application/json": { + "schema": { + "type": "array", + "items": { + "$ref": "#/components/schemas/recommendedTopicResponse" + } + } + } + }, + "description": "Successful response" + } + }, + "summary": "Recommended topics API", + "description": "Given a list of refs this API returns the most used topics associated with them. It's a fast way of identifying potential shared topics amongst disperate references.\n\nn.b. The `ref_list` param is not required for a post request." + }, + "parameters": [ + { + "name": "ref_list", + "description": "List of strings separated by '+'", + "schema": { + "type": "string" + }, + "in": "path", + "required": true + } + ] + }, + "/api/texts/random-by-topic": { + "summary": "Random By Topic API", + "description": "Returns Texts API data for a random text taken from popular topic tags", + "get": { + "tags": [ + "Topic" + ], + "responses": { + "200": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/RandomByTopicJSON" }, - "example": { - "ref": "Mishnah Peah 4:2", - "heRef": "משנה פאה ד׳:ב׳", - "isComplex": false, - "text": [ - "Peah is given from [the crop] while it is still connected with the soil. But in the case of hanging vine-branches and the date-palm, the owner brings down [the fruit] and distributes it among the poor. Rabbi Shimon says: the same applies to smooth nut trees. Even if ninety-nine [of the poor] say [to the owner] to distribute it and one says to leave it in the field, this latter is listened to, since he spoke in accordance with the halakhah.", - "With hanging vine-branches and date-palm trees it is not so; even if ninety-nine [of the poor] say [to the owner] to leave it in the field and one says to distribute it, this latter is listened to, since he spoke in accordance with the halakhah.", - "If [a poor man] took some of the peah [already collected] and threw it onto the remainder [not yet collected], he gets none of it. If he fell down upon it, or spread his cloak over it, they take the peah away from him. The same applies to gleanings and the forgotten sheaf.", - "[The poor] may not harvest peah with scythes or tear it out [of the ground] with spades, so that they might not strike one another [with these implements].", - "There are three times a day [the poor] make a search [in the field for peah]: morning, noon, and sunset. Rabban Gamaliel says: these [times] were only set lest they reduce them. Rabbi Akiva says: these were set lest they add to them. [The men] of Bet Namer used to have the poor harvest [the peah] with the aid of a rope, and they left peah at the end of each furrow.", - "A non-Jew who harvested his field and then converted, he is exempt from [leaving] gleanings, the forgotten sheaf and peah. Rabbi Judah makes him liable to leave the forgotten sheaf, since he becomes liable for the forgotten sheaf at the time of their binding.", - "One who dedicated standing grain [to the Temple] and then redeemed it while it was still standing grain, he is liable [to give the agricultural gifts to the poor]. [If he dedicated] sheaves and redeemed them while they were still sheaves, he is liable. [If he dedicated] standing grain and redeemed it [when it was already in] sheaves, he is exempt, since at the time when it became liable it was exempt.", - "Similarly one who dedicates his produce prior to the stage when they are subject to tithes and then redeemed them, they are liable [to be tithed]. If [he dedicated them] when they had already become subject to tithes and then redeemed them, they are liable [to be tithed]. If he dedicated them before they had ripened, and they became ripe while in the possession of the [Temple] treasurer, and he then redeemed them, they are exempt, since at the time when they would have been liable, they were exempt.", - "One who collected peah and said, “This is for so-and-so a poor man:” Rabbi Eliezer says: he has thus acquired it for him. The sages say: he must give it to the first poor man he finds. Gleanings, the forgotten sheaf and the peah of non-Jews are subject to tithes, unless he [the non-Jew] had declared them ownerless.", - "What are gleanings? That which falls down at the time of harvesting. If while he was harvesting, he harvested a handful, or plucked a fistful, and then a thorn pricked him, and what he had in his hand fell to the ground, it still belongs to the owner. [That which drops from] inside the hand or the sickle [belongs] to the poor, but [that which falls from] the back of the hand or the sickle [belongs] to the owner. [That which falls from] the top of the hand or sickle: Rabbi Ishmael says: to the poor; But Rabbi Akiva says: to the owner.", - "[Grain found in] ant holes where the stalks are still standing, behold it still belongs to the owner. After the harvesters [had passed over them], those found in the top parts [of the ant holes belong] to the poor, but [those found] on the bottom parts [belong] to the owner. Rabbi Meir says: it all belongs to the poor, for gleanings about which there is any doubt are regarded as gleanings." - ], - "he": [ - "הַפֵּאָה נִתֶּנֶת בִּמְחֻבָּר לַקַּרְקָע. בְּדָלִית וּבְדֶקֶל, בַּעַל הַבַּיִת מוֹרִיד וּמְחַלֵּק לָעֲנִיִּים. רַבִּי שִׁמְעוֹן אוֹמֵר, אַף בַּחֲלִיקֵי אֱגוֹזִים. אֲפִלּוּ תִשְׁעִים וְתִשְׁעָה אוֹמְרִים לְחַלֵּק וְאֶחָד אוֹמֵר לָבוֹז, לָזֶה שׁוֹמְעִין, שֶׁאָמַר כַּהֲלָכָה: \n", - "בְּדָלִית וּבְדֶקֶל אֵינוֹ כֵן, אֲפִלּוּ תִשְׁעִים וְתִשְׁעָה אוֹמְרִים לָבוֹז וְאֶחָד אוֹמֵר לְחַלֵּק, לָזֶה שׁוֹמְעִין, שֶׁאָמַר כַּהֲלָכָה: \n", - "נָטַל מִקְצָת פֵּאָה וּזְרָקָהּ עַל הַשְּׁאָר, אֵין לוֹ בָהּ כְּלוּם. נָפַל לוֹ עָלֶיהָ, וּפֵרֵשׂ טַלִּיתוֹ עָלֶיהָ, מַעֲבִירִין אוֹתָהּ הֵימֶנּוּ. וְכֵן בְּלֶקֶט, וְכֵן בְּעֹמֶר הַשִּׁכְחָה: \n", - "פֵּאָה אֵין קוֹצְרִין אוֹתָהּ בְּמַגָּלוֹת, וְאֵין עוֹקְרִין אוֹתָהּ בְּקַרְדֻּמּוֹת, כְּדֵי שֶׁלֹּא יַכּוּ אִישׁ אֶת רֵעֵהוּ: \n", - "שָׁלשׁ אַבְעָיוֹת בַּיּוֹם, בַּשַּׁחַר וּבַחֲצוֹת וּבַמִּנְחָה. רַבָּן גַּמְלִיאֵל אוֹמֵר, לֹא אָמְרוּ אֶלָּא כְּדֵי שֶׁלֹּא יִפְחֲתוּ. רַבִּי עֲקִיבָא אוֹמֵר, לֹא אָמְרוּ אֶלָּא כְּדֵי שֶׁלֹּא יוֹסִיפוּ. שֶׁל בֵּית נָמֵר הָיוּ מְלַקְּטִין עַל הַחֶבֶל, וְנוֹתְנִים פֵּאָה מִכָּל אֻמָּן וְאֻמָּן: \n", - "עוֹבֵד כּוֹכָבִים שֶׁקָּצַר אֶת שָׂדֵהוּ וְאַחַר כָּךְ נִתְגַּיֵּר, פָּטוּר מִן הַלֶּקֶט וּמִן הַשִּׁכְחָה וּמִן הַפֵּאָה. רַבִּי יְהוּדָה מְחַיֵּב בְּשִׁכְחָה, שֶׁאֵין הַשִּׁכְחָה אֶלָּא בִשְׁעַת הָעִמּוּר: \n", - "הִקְדִּישׁ קָמָה וּפָדָה קָמָה, חַיָּב. עֳמָרִין וּפָדָה עֳמָרִין, חַיָּב. קָמָה וּפָדָה עֳמָרִין, פְּטוּרָה, שֶׁבִּשְׁעַת חוֹבָתָהּ הָיְתָה פְטוּרָה: \n", - "כַּיּוֹצֵא בוֹ, הַמַּקְדִּישׁ פֵּרוֹתָיו עַד שֶׁלֹּא בָאוּ לְעוֹנַת הַמַּעַשְׂרוֹת, וּפְדָאָן, חַיָּבִין. מִשֶּׁבָּאוּ לְעוֹנַת הַמַּעַשְׂרוֹת, וּפְדָאָן, חַיָּבִין. הִקְדִּישָׁן עַד שֶׁלֹּא נִגְמְרוּ וּגְמָרָן הַגִּזְבָּר, וְאַחַר כָּךְ פְּדָאָן, פְּטוּרִים, שֶׁבִּשְׁעַת חוֹבָתָן הָיוּ פְטוּרִים: \n", - "מִי שֶׁלָּקַט אֶת הַפֵּאָה וְאָמַר הֲרֵי זוֹ לְאִישׁ פְּלוֹנִי עָנִי, רַבִּי אֱלִיעֶזֶר אוֹמֵר, זָכָה לוֹ. וַחֲכָמִים אוֹמְרִים, יִתְּנֶנָּה לֶעָנִי שֶׁנִּמְצָא רִאשׁוֹן. הַלֶּקֶט וְהַשִּׁכְחָה וְהַפֵּאָה שֶׁל עוֹבֵד כּוֹכָבִים חַיָּב בְּמַעַשְׂרוֹת, אֶלָּא אִם כֵּן הִפְקִיר: \n", - "אֵיזֶהוּ לֶקֶט, הַנּוֹשֵׁר בִּשְׁעַת הַקְּצִירָה. הָיָה קוֹצֵר, קָצַר מְלֹא יָדוֹ, תָּלַשׁ מְלֹא קֻמְצוֹ, הִכָּהוּ קוֹץ וְנָפַל מִיָּדוֹ לָאָרֶץ, הֲרֵי הוּא שֶׁל בַּעַל הַבָּיִת. תּוֹךְ הַיָּד וְתוֹךְ הַמַּגָּל, לָעֲנִיִּים. אַחַר הַיָּד וְאַחַר הַמַּגָּל, לְבַעַל הַבָּיִת. רֹאשׁ הַיָּד וְרֹאשׁ הַמַּגָּל, רַבִּי יִשְׁמָעֵאל אוֹמֵר, לָעֲנִיִּים. רַבִּי עֲקִיבָא אוֹמֵר, לְבַעַל הַבָּיִת: \n", - "חוֹרֵי הַנְּמָלִים שֶׁבְּתוֹךְ הַקָּמָה, הֲרֵי הֵן שֶׁל בַּעַל הַבָּיִת. שֶׁלְּאַחַר הַקּוֹצְרִים, הָעֶלְיוֹנִים לָעֲנִיִּים, וְהַתַּחְתּוֹנִים שֶׁל בַּעַל הַבָּיִת. רַבִּי מֵאִיר אוֹמֵר, הַכֹּל לָעֲנִיִּים, שֶׁסְּפֵק לֶקֶט, לֶקֶט: \n" - ], - "versions": [ - { - "title": "Mishnah Peah", - "versionTitle": "Torat Emet 357", - "versionSource": "http://www.toratemetfreeware.com/index.html?downloads", - "language": "he", - "status": "locked", - "license": "Public Domain", - "versionNotes": "", - "digitizedBySefaria": "", - "priority": 3, - "versionTitleInHebrew": "תורת אמת 357", - "versionNotesInHebrew": "", - "extendedNotes": "", - "extendedNotesHebrew": "", - "purchaseInformationImage": "", - "purchaseInformationURL": "", - "shortVersionTitle": "", - "shortVersionTitleInHebrew": "", - "isBaseText": true + "examples": { + "Metushelach": { + "value": { + "ref": "Avot D'Rabbi Natan 32:1", + "topic": { + "slug": "metushelach", + "titles": [ + { + "text": "Metushelach", + "lang": "en", + "primary": true, + "transliteration": true + }, + { + "text": "מתושלח", + "lang": "he", + "primary": true + }, + { + "text": "Methuselah", + "lang": "en" + }, + { + "text": "Methushelach", + "lang": "en" + } + ], + "subclass": "person", + "alt_ids": { + "_temp_id": "מתושלח", + "wikidata": "Q156290" }, + "properties": { + "enWikiLink": { + "value": "https://en.wikipedia.org/wiki/Methuselah", + "dataSource": "wikidata" + }, + "heWikiLink": { + "value": "https://he.wikipedia.org/wiki/מתושלח", + "dataSource": "wikidata" + }, + "deWikiLink": { + "value": "https://de.wikipedia.org/wiki/Methusalem", + "dataSource": "wikidata" + }, + "esWikiLink": { + "value": "https://es.wikipedia.org/wiki/Matusalén", + "dataSource": "wikidata" + }, + "frWikiLink": { + "value": "https://fr.wikipedia.org/wiki/Mathusalem", + "dataSource": "wikidata" + }, + "ruWikiLink": { + "value": "https://ru.wikipedia.org/wiki/Мафусал_(потомок_Сифа)", + "dataSource": "wikidata" + } + }, + "numSources": 7, + "good_to_promote": true, + "primaryTitle": { + "en": "Metushelach", + "he": "מתושלח" + } + }, + "url": "Avot_D'Rabbi_Natan.32.1" + } + } + } + } + }, + "description": "Successful response" + } + }, + "summary": "Random By Topic", + "description": "Returns Texts API data for a random text taken from popular topic tags." + } + }, + "/api/terms/{name}": { + "summary": "The Terms API", + "description": "A Term is a shared title node. It can be referenced and used by many different `Index` nodes. Terms that use the same `TermScheme` can be ordered within that scheme. So for example, _Parsha_ terms who all share the `TermScheme` of `parsha`, can be ordered within that scheme. \n\nExamples of valid terms: `Noah`, `HaChovel`\n", + "get": { + "tags": [ + "Term" + ], + "responses": { + "200": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/TermsJSON" + }, + "examples": { + "Noah": { + "value": { + "name": "Noach", + "titles": [ { - "title": "Mishnah Peah", - "versionTitle": "Mishnah, ed. Romm, Vilna 1913", - "versionSource": "https://www.nli.org.il/he/books/NNL_ALEPH001741739", - "language": "he", - "status": "locked", - "license": "Public Domain", - "versionNotes": "", - "digitizedBySefaria": true, - "priority": 2, - "versionTitleInHebrew": "משנה, מהדורת בית דפוס ראם, וילנא 1913", - "versionNotesInHebrew": "", - "extendedNotes": "", - "extendedNotesHebrew": "", - "purchaseInformationImage": "", - "purchaseInformationURL": "", - "shortVersionTitle": "", - "shortVersionTitleInHebrew": "", - "isBaseText": true + "primary": true, + "text": "Noach", + "lang": "en" }, { - "title": "Mishnah Peah", - "versionTitle": "Mishnah Yomit by Dr. Joshua Kulp", - "versionSource": "http://learn.conservativeyeshiva.org/mishnah/", - "language": "en", - "status": "locked", - "license": "CC-BY", - "versionNotes": "", - "digitizedBySefaria": "", - "priority": 1, - "versionTitleInHebrew": "", - "versionNotesInHebrew": "", - "extendedNotes": "", - "extendedNotesHebrew": "", - "purchaseInformationImage": "", - "purchaseInformationURL": "", - "shortVersionTitle": "Dr. Joshua Kulp", - "shortVersionTitleInHebrew": "", - "isBaseText": false + "primary": true, + "text": "נח", + "lang": "he" }, { - "title": "Mishnah Peah", - "versionTitle": "Mischnajot mit deutscher Übersetzung und Erklärung. Berlin 1887-1933 [de]", - "versionSource": "https://www.nli.org.il/he/books/NNL_ALEPH002378149/NLI", - "language": "en", - "status": "locked", - "license": "Public Domain", - "versionNotes": "Ordnung Seraïm, übers. und erklärt von Ascher Samter. 1887.
Ordnung Moed, von Eduard Baneth. 1887-1927.
Ordnung Naschim, von Marcus Petuchowski u. Simon Schlesinger. 1896-1933.
Ordnung Nesikin, von David Hoffmann. 1893-1898.
Ordnung Kodaschim, von John Cohn. 1910-1925.
Ordnung Toharot, von David Hoffmann, John Cohn und Moses Auerbach. 1910-1933.", - "digitizedBySefaria": true, - "priority": 0.5, - "versionTitleInHebrew": "", - "versionNotesInHebrew": "", - "extendedNotes": "", - "extendedNotesHebrew": "", - "purchaseInformationImage": "", - "purchaseInformationURL": "", - "shortVersionTitle": "", - "shortVersionTitleInHebrew": "", - "isBaseText": false + "text": "Parashat Noach", + "lang": "en" }, { - "title": "Mishnah Peah", - "versionTitle": "Talmud Bavli. German. Lazarus Goldschmidt. 1929 [de]", - "versionSource": "https://www.nli.org.il/he/books/NNL_ALEPH001042448/NLI", - "language": "en", - "status": "locked", - "license": "Public Domain", - "versionNotes": "", - "digitizedBySefaria": true, - "priority": 0.25, - "versionTitleInHebrew": "", - "versionNotesInHebrew": "", - "extendedNotes": "", - "extendedNotesHebrew": "", - "purchaseInformationImage": "", - "purchaseInformationURL": "", - "shortVersionTitle": "Lazarus Goldschmidt, 1929 ", - "shortVersionTitleInHebrew": "", - "isBaseText": false + "text": "פרשת נח", + "lang": "he" }, { - "title": "Mishnah Peah", - "versionTitle": "Open Mishnah", - "versionSource": "http://en.wikisource.org/wiki/Mishnah", - "language": "en", - "status": "locked", - "license": "CC-BY-SA", - "versionNotes": "", - "digitizedBySefaria": "", - "priority": "", - "versionTitleInHebrew": "משנה פתוחה", - "versionNotesInHebrew": "", - "extendedNotes": "", - "extendedNotesHebrew": "", - "purchaseInformationImage": "", - "purchaseInformationURL": "", - "shortVersionTitle": "", - "shortVersionTitleInHebrew": "", - "isBaseText": false + "text": "Noah", + "lang": "en" }, { - "title": "Mishnah Peah", - "versionTitle": "Le Talmud de Jérusalem, traduit par Moise Schwab, 1878-1890 [fr]", - "versionSource": "https://www.nli.org.il/he/books/NNL_ALEPH002182155/NLI", - "language": "en", - "status": "locked", - "license": "Public Domain", - "versionNotes": "", - "digitizedBySefaria": "", - "priority": "", - "versionTitleInHebrew": "", - "versionNotesInHebrew": "", - "extendedNotes": "", - "extendedNotesHebrew": "", - "purchaseInformationImage": "", - "purchaseInformationURL": "", - "shortVersionTitle": "", - "shortVersionTitleInHebrew": "", - "isBaseText": false + "text": "Parshat Noah", + "lang": "en" + } + ], + "scheme": "Parasha", + "order": 2, + "ref": "Genesis 6:9-11:32", + "category": "Torah Portions" + } + } + } + } + }, + "description": "The response to a query for a specific Term in the Terms API. " + } + }, + "summary": "Terms", + "description": "A Term is a shared title node. It can be referenced and used by many different `Index` nodes. Terms that use the same `TermScheme` can be ordered within that scheme. So for example, _Parsha_ terms who all share the `TermScheme` of `parsha`, can be ordered within that scheme. \n\nExamples of valid terms: `Noah`, `HaChovel`\n" + }, + "parameters": [ + { + "examples": { + "Parasha": { + "value": "Noah" + }, + "Chapter of Talmud": { + "value": "HaChovel" + } + }, + "name": "name", + "description": "The English name of a valid Sefaria term. ", + "schema": { + "type": "string" + }, + "in": "path", + "required": true + } + ] + }, + "/api/name/{name}": { + "description": "Serves primarily as an autocompleter, returning potential keyword matches for `Ref`s, book titles, authors, topics, and collections available on Sefaria", + "get": { + "tags": [ + "Term" + ], + "parameters": [ + { + "name": "limit", + "description": "Number of results to return (`0` indicates no limit)", + "schema": { + "type": "integer" + }, + "in": "query" + }, + { + "name": "ref_only", + "description": "By default `0` the Name API returns `Ref`s, book titles, authors, topics, and collections. If true, the response will only contain text references.", + "schema": { + "enum": [ + "0", + "1" + ], + "type": "string" + }, + "in": "query" + } + ], + "responses": { + "200": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/nameAPIResponse" + } + } + }, + "description": "Successful response" + } + }, + "summary": "Name", + "description": "Serves primarily as an autocompleter, returning potential keyword matches for `Ref`s, book titles, authors, topics, and collections available on Sefaria." + }, + "parameters": [ + { + "name": "name", + "description": "An arbitrary text string to match against Sefaria's data collections.", + "schema": { + "type": "string" + }, + "in": "path", + "required": true + } + ] + }, + "/api/find-refs": { + "post": { + "requestBody": { + "description": "", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/FindRefsPOSTRequest" + }, + "examples": { + "Example": { + "value": { + "text": { + "body": "Genesis 1:1 is a citation and also Mishnah Peah 3-4. So is שמות ב", + "title": "Some thoughts on Sefer Bereishit 1" + }, + "lang": "en" + } + } + } + } + }, + "required": true + }, + "tags": [ + "Misc" + ], + "responses": { + "200": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/FindRefsAPIResponse" + } + } + }, + "description": "Successful Response" + } + }, + "summary": "Find Refs", + "description": "Initially designed to find links on websites using [Sefaria's Linker](https://www.sefaria.org/linker), the Find Refs API can identify textual refernces in any arbitrary text that gets sent to it via a structured POST request and returns a response object identifying each located reference including its start and end position within the submitted text." + } + }, + "/api/search-wrapper": { + "post": { + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/SearchPOSTData" + } + } + }, + "required": true + }, + "tags": [ + "Misc" + ], + "responses": { + "200": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/searchResponse" + } + } + }, + "description": "Successful Response" + } + }, + "summary": "Search", + "description": "An [elastic search](https://www.elastic.co/guide/en/elasticsearch/reference/current/) endpoint for Sefaria's data. Given a properly formated POST request this endpoint will return search results for appropriate Sefaria records." + } + }, + "/api/img-gen/{tref}": { + "get": { + "tags": [ + "Misc" + ], + "parameters": [ + { + "name": "lang", + "description": "The language the social image should return, `en` for English language or `he` for Hebrew. ", + "schema": { + "enum": [ + "he", + "en" + ], + "type": "string" + }, + "in": "query" + }, + { + "name": "platform", + "description": "This value determines the size of the image, set to the platform's ideal as specified in its own developer documentation.", + "schema": { + "enum": [ + "facebook", + "twitter" + ], + "type": "string" + }, + "in": "query" + }, + { + "examples": { + "JSP 1917": { + "value": "The Holy Scriptures: A New Translation (JPS 1917)" + } + }, + "name": "ven", + "description": "The title of the version of English text desired for the image. ", + "schema": { + "type": "string" + }, + "in": "query" + }, + { + "examples": { + "Tanach with Ta'amei Hamikra": { + "value": "Tanach with Ta'amei Hamikra" + } + }, + "name": "vhe", + "description": "The title of the version of Hebrew text desired for the image. ", + "schema": { + "type": "string" + }, + "in": "query" + } + ], + "responses": { + "200": { + "content": { + "image/png": {} + }, + "description": "Successful Response" + } + }, + "summary": "Social Media Image", + "description": "Given a Sefaria text `Ref` and some other optional parameters, this endpoint returns a .png image ready to share on social media. At Sefaria.org we use it primarily to auto-generate social media images for any page." + }, + "parameters": [ + { + "examples": { + "Tanakh Ref": { + "value": "Esther 1.1" + }, + "Talmud Ref": { + "value": "Pesachim 21b.1" + } + }, + "name": "tref", + "description": "A valid Sefaria textual `Ref`.", + "schema": { + "$ref": "#/components/schemas/ref" + }, + "in": "path", + "required": true + } + ] + }, + "/api/category/{category_path}": { + "summary": "Category", + "description": "The category API takes a full category path in the request, e.g. /api/category/Tanakh/Torah/Genesis, and return the full category object found. The above request would return:", + "get": { + "tags": [ + "Misc" + ], + "responses": { + "200": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/CatJSON" + }, + "examples": { + "Genesis": { + "value": { + "path": [ + "Tanakh", + "Torah" + ], + "titles": [ + { + "lang": "en", + "text": "Torah", + "primary": true }, { - "title": "Mishnah Peah", - "versionTitle": "Mishnah based on the Kaufmann manuscript, edited by Dan Be'eri", - "versionSource": "https://archive.org/details/MishnaCorrectedKaufman00WHOLE", - "language": "he", - "status": "locked", - "license": "PD", - "versionNotes": "", - "digitizedBySefaria": true, - "priority": "", - "versionTitleInHebrew": "", - "versionNotesInHebrew": "", - "extendedNotes": "", - "extendedNotesHebrew": "", - "purchaseInformationImage": "", - "purchaseInformationURL": "", - "shortVersionTitle": "", - "shortVersionTitleInHebrew": "", - "isBaseText": "" + "lang": "he", + "text": "תורה", + "primary": true } + ], + "lastPath": "Torah" + } + } + } + } + }, + "description": "GET requests take a full category path in the request, e.g. `/api/category/Tanakh/Torah/Genesis`, and return the full category object found. \n\nIf the category is not found, the returned object will have an error attribute. If any element of the path is found, the API will return the closest parent in an attribute called `closest_parent`. This is useful for proactively looking up a category before posting an `Index` to it." + } + }, + "summary": "Category", + "description": "GET requests take a full category path in the request, e.g. `/api/category/Tanakh/Torah/Genesis`, and return the full category object found. \n\nIf the category is not found, the returned object will have an error attribute. If any element of the path is found, the API will return the closest parent in an attribute called `closest_parent`. This is useful for proactively looking up a category before posting an `Index` to it." + }, + "parameters": [ + { + "examples": { + "Genesis": { + "value": "Tanakh/Torah/Genesis" + }, + "Chiddushei Chatam Sofer": { + "value": "Talmud/Bavli/Acharonim on Talmud/Chidushei Chatam Sofer" + } + }, + "name": "category_path", + "description": "A valid Sefaria Category path", + "schema": { + "type": "string" + }, + "in": "path", + "required": true + } + ] + } + }, + "components": { + "schemas": { + "ref": { + "description": "A string representing a citation to a Jewish text. \n\nA valid `Ref` consists of a title string followed optionally by a section string or a segment string. \n\nA title string is any one of the known text titles or title variants in the Sefaria Database.", + "type": "string", + "example": "Mishnah Peah 4:2" + }, + "versionData": { + "title": "Root Type for versionData", + "description": "Information about a single text version of a title", + "type": "object", + "properties": { + "title": { + "type": "string" + }, + "versionTitle": { + "type": "string" + }, + "versionSource": { + "type": "string" + }, + "language": { + "type": "string" + }, + "status": { + "type": "string" + }, + "license": { + "type": "string" + }, + "versionNotes": { + "type": "string" + }, + "digitizedBySefaria": { + "type": "string" + }, + "priority": { + "format": "int32", + "type": "integer" + }, + "versionTitleInHebrew": { + "type": "string" + }, + "versionNotesInHebrew": { + "type": "string" + }, + "extendedNotes": { + "type": "string" + }, + "extendedNotesHebrew": { + "type": "string" + }, + "purchaseInformationImage": { + "type": "string" + }, + "purchaseInformationURL": { + "type": "string" + }, + "shortVersionTitle": { + "type": "string" + }, + "shortVersionTitleInHebrew": { + "type": "string" + }, + "isBaseText": { + "type": "boolean" + }, + "firstSectionRef": { + "type": "string" + } + }, + "example": { + "title": "Genesis", + "versionTitle": "The Contemporary Torah, Jewish Publication Society, 2006", + "versionSource": "https://www.nli.org.il/he/books/NNL_ALEPH002529489/NLI", + "language": "en", + "status": "locked", + "license": "CC-BY-NC", + "versionNotes": "Dedicated by an anonymous donor in honor of all women and girls who study, teach, and transform Torah.\n

\nRead the preface to The Contemporary Torah\n

\n See the Dictionary of Gender in the Torah", + "digitizedBySefaria": "", + "priority": 7, + "versionTitleInHebrew": "", + "versionNotesInHebrew": "תרומה אלמונית לכבוד כל הנשים והבנות שלומדות, מלמדות ונותנות צורה חדשה לתורה", + "extendedNotes": "", + "extendedNotesHebrew": "", + "purchaseInformationImage": "https://jps.org/wp-content/uploads/2014/10/ContemporaryTorah-300x458.png", + "purchaseInformationURL": "https://jps.org/books/contemporary-torah/", + "shortVersionTitle": "The Contemporary Torah, JPS, 2006", + "shortVersionTitleInHebrew": "", + "isBaseText": false, + "firstSectionRef": "Genesis 1" + } + }, + "nameAPIResponse": { + "title": "Root Type for nameAPIResponse", + "description": "Full response of the Name API", + "type": "object", + "properties": { + "lang": { + "description": "The language of the completion results.", + "enum": [ + "en", + "he" + ], + "type": "string" + }, + "is_ref": { + "description": "Returns `true` if the submitted text is a valid Sefaria textual reference", + "type": "boolean" + }, + "completions": { + "description": "A list of autocompletion responses for the submitted text.", + "type": "array", + "items": { + "type": "string" + } + }, + "completion_objects": { + "description": "A list of autocompletion response objects for the submitted text along with some information about them.", + "type": "array", + "items": { + "type": "object", + "properties": { + "title": { + "type": "string" + }, + "key": { + "type": "string" + }, + "type": { + "type": "string" + }, + "is_primary": { + "type": "boolean" + }, + "order": { + "format": "int32", + "type": "integer" + } + } + }, + "example": "[{\n \"title\": \"Ruth\",\n \"key\": \"Ruth\",\n \"type\": \"ref\",\n \"is_primary\": true,\n \"order\": 1000000\n }, {\n \"title\": \"Ruth Rabbah\",\n \"key\": \"Ruth Rabbah\",\n \"type\": \"ref\",\n \"is_primary\": true,\n \"order\": 1000000\n }, {\n \"title\": \"Ruth\",\n \"type\": \"PersonTopic\",\n \"key\": \"ruth\",\n \"is_primary\": true,\n \"order\": 4999550\n }, {\n \"title\": \"Ruach Hakodesh\",\n \"type\": \"Topic\",\n \"key\": \"ruach-hakodesh1\",\n \"is_primary\": true,\n \"order\": 4999902\n }, {\n \"title\": \"Ruach\",\n \"type\": \"Topic\",\n \"key\": \"ruach1\",\n \"is_primary\": true,\n \"order\": 4999949\n }, {\n \"title\": \"Rubissa Sharona Hassan\",\n \"type\": \"User\",\n \"key\": \"sharona-hassan\",\n \"pic\": \"https://storage.googleapis.com/sefaria-profile-pictures/sharona-hassan-1622999139-small.png\",\n \"order\": 6999998,\n \"is_primary\": true\n }]" + }, + "is_book": { + "description": "Returns `true` if the submitted text is a book level reference. e.g. (Genesis)", + "type": "boolean" + }, + "is_node": { + "description": "Returns true if the submitted text is a `node` in a complex text. (For example, the query `Abarbanel on Torah, Genesis` is a `node` in the `index` of the complex text `Abarbanel on Torah`). ", + "type": "boolean" + }, + "is_section": { + "description": "Returns `true` if the submitted text is a section `Ref` (e.g. Genesis 4, as opposed to a segment `Ref` such as Genesis 4.1).", + "type": "boolean" + }, + "is_segment": { + "description": "Returns `true` if the submitted text is a segment level `Ref` (e.g. Genesis 43:3, as opposed to a section `Ref` such as Genesis 43)", + "type": "boolean" + }, + "is_range": { + "description": "Returns `true` if the submitted text is a a ranged `Ref` (one that spans multiple sections or segments.) e.g. `Genesis 4-5`", + "type": "boolean" + }, + "type": { + "enum": [ + "ref", + "Topic", + "AuthorTopic", + "PersonTopic", + "User" + ], + "type": "string" + }, + "ref": { + "description": "If `is_ref` is `true`, this returns the cannonical ref for the submitted text.", + "type": "string" + }, + "url": { + "description": "If `is_ref` is `true`, this returns the URL path to link to the submitted text on [Sefaria.org](sefaria.org)", + "type": "string" + }, + "index": { + "description": "If `is_ref` is `true`, this returns the cannonical name of the `index` of the submitted text.", + "type": "string" + }, + "book": { + "description": "If the submitted response is a `Ref`, this returns the book it belongs to.", + "type": "string" + }, + "internalSections": { + "type": "array", + "items": { + "format": "int32", + "type": "integer" + } + }, + "internalToSections": { + "type": "array", + "items": { + "format": "int32", + "type": "integer" + } + }, + "sections": { + "type": "array", + "items": { + "type": "string" + } + }, + "toSections": { + "type": "array", + "items": { + "type": "string" + } + }, + "examples": { + "type": "array", + "items": {} + }, + "sectionNames": { + "description": "Given a reference, this returns the names of the sections and segments at each depth of that text.", + "type": "array", + "items": { + "type": "string" + } + }, + "heSectionNames": { + "description": "Given a `Ref`, this returns the names of the sections and segments at each depth of that text in Hebrew.", + "type": "array", + "items": { + "type": "string" + } + }, + "addressExamples": { + "description": "Given a partial `Ref`, this will return an array of strings of possible ways that it might be completed.", + "type": "array", + "items": { + "type": "string" + } + }, + "heAddressExamples": { + "description": "Given a partial `Ref`, this will return an array of Hebrew strings of possible ways that it might be completed.", + "type": "array", + "items": { + "type": "string" + } + } + }, + "example": { + "lang": "en", + "is_ref": true, + "completions": [ + "Job", + "Rashi on Job", + "Rashi on Amos", + "Rashi on Arachin", + "Rashi on Beiah", + "Rashi on Bechorot", + "Rashi on Berachoth", + "Rashi on Chag.", + "Rashi on Hullin", + "Rashi on Dan." + ], + "completion_objects": [ + { + "title": "Job", + "key": "Job", + "type": "ref", + "is_primary": true, + "order": 1000000 + }, + { + "title": "Job", + "type": "Topic", + "key": "job-and-his-friends", + "is_primary": false, + "order": 4999978 + }, + { + "title": "Rashi on Job", + "key": "Rashi on Job", + "type": "ref", + "is_primary": true, + "order": 1000000 + }, + { + "title": "Rashi on Amos", + "key": "Rashi on Amos", + "type": "ref", + "is_primary": true, + "order": 1000000 + }, + { + "title": "Rashi on Arachin", + "key": "Rashi on Arakhin", + "type": "ref", + "is_primary": false, + "order": 1000000 + }, + { + "title": "Rashi on Beiah", + "key": "Rashi on Beitzah", + "type": "ref", + "is_primary": false, + "order": 1000000 + }, + { + "title": "Rashi on Bechorot", + "key": "Rashi on Bekhorot", + "type": "ref", + "is_primary": false, + "order": 1000000 + }, + { + "title": "Rashi on Berachoth", + "key": "Rashi on Berakhot", + "type": "ref", + "is_primary": false, + "order": 1000000 + }, + { + "title": "Rashi on Chag.", + "key": "Rashi on Chagigah", + "type": "ref", + "is_primary": false, + "order": 1000000 + }, + { + "title": "Rashi on Hullin", + "key": "Rashi on Chullin", + "type": "ref", + "is_primary": false, + "order": 1000000 + }, + { + "title": "Rashi on Dan.", + "key": "Rashi on Daniel", + "type": "ref", + "is_primary": false, + "order": 1000000 + } + ], + "is_book": false, + "is_node": false, + "is_section": false, + "is_segment": true, + "is_range": false, + "type": "ref", + "ref": "Rashi on Job 1:3:3", + "url": "Rashi_on_Job.1.3.3", + "index": "Rashi on Job", + "book": "Rashi on Job", + "internalSections": [ + 1, + 3, + 3 + ], + "internalToSections": [ + 1, + 3, + 3 + ], + "sections": [ + "1", + "3", + "3" + ], + "toSections": [ + "1", + "3", + "3" + ], + "examples": [], + "sectionNames": [ + "Chapter", + "Verse", + "Comment" + ], + "heSectionNames": [ + "פרק", + "פסוק", + "פירוש" + ], + "addressExamples": [ + "3", + "6", + "9" + ], + "heAddressExamples": [ + "ג׳", + "ו׳", + "ט׳" + ] + } + }, + "dictionaryEntry": { + "title": "Root Type for dictionaryEntry", + "description": "A single dictionary entry on Sefaria.", + "type": "object", + "properties": { + "headword": { + "description": "The main word in the lexicon entry. The one you would look up in the book version.", + "type": "string" + }, + "parent_lexicon": { + "description": "Name of the lexicon from which the entry comes from.", + "type": "string" + }, + "parent_lexicon_details": { + "description": "", + "type": "object" + } + } + }, + "StrongsDictionaryEntry": { + "title": "StrongsDictionaryEntry", + "description": "", + "allOf": [ + { + "$ref": "#/components/schemas/dictionaryEntry" + } + ], + "properties": { + "strong_number": { + "type": "string" + }, + "transliteration": { + "description": "" + }, + "pronunciation": { + "description": "" + }, + "language_code": { + "description": "" + }, + "content": { + "description": "", + "type": "object", + "properties": { + "morphology": { + "type": "string" + }, + "senses": { + "type": "array", + "items": { + "$ref": "#/components/schemas/SenseStrongsDictionaryEntry" + } + } + } + } + }, + "example": { + "headword": "רָאָה", + "parent_lexicon": "BDB Augmented Strong", + "content": { + "morphology": "v", + "senses": [ + { + "definition": "to see, look at, inspect, perceive, consider", + "senses": [ + { + "senses": [ + { + "definition": "to see" + }, + { + "definition": "to see, perceive" + }, + { + "definition": "to see, have vision" + }, + { + "definition": "to look at, see, regard, look after, see after, learn about, observe, watch, look upon, look out, find out" + }, + { + "definition": "to see, observe, consider, look at, give attention to, discern, distinguish" + }, + { + "definition": "to look at, gaze at" + } ], - "textDepth": 2, - "sectionNames": [ - "Chapter", - "Mishnah" - ], - "addressTypes": [ - "Perek", - "Mishnah" - ], - "lengths": [ - 8, - 69 - ], - "length": 8, - "heTitle": "משנה פאה", - "titleVariants": [ - "M Peah", - "Mishna Peah", - "M. Peah", - "Mishnah Péah", - "Pe’ah", - "Pe'ah", - "Peah", - "Mishnah Peah" - ], - "heTitleVariants": [ - "פאה", - "משנה פיאה", - "משנה פאה" - ], - "type": "Mishnah", - "primary_category": "Mishnah", - "book": "Mishnah Peah", - "categories": [ - "Mishnah", - "Seder Zeraim" - ], - "order": [ - 2, - 2 + "grammar": { + "verbal_stem": "Qal" + } + }, + { + "senses": [ + { + "definition": "to appear, present oneself" + }, + { + "definition": "to be seen" + }, + { + "definition": "to be visible" + } ], - "sections": [ - 4, - 2 + "grammar": { + "verbal_stem": "Niphal" + } + }, + { + "definition": " to be seen", + "grammar": { + "verbal_stem": "Pual" + } + }, + { + "senses": [ + { + "definition": "to cause to see, show" + }, + { + "definition": "to cause to look intently at, behold, cause to gaze at" + } ], - "toSections": [ - 4, - 2 + "grammar": { + "verbal_stem": "Hiphil" + } + }, + { + "senses": [ + { + "definition": "to be caused to see, be shown" + }, + { + "definition": "to be exhibited to" + } ], - "isDependant": false, - "indexTitle": "Mishnah Peah", - "heIndexTitle": "משנה פאה", - "sectionRef": "Mishnah Peah 4", - "firstAvailableSectionRef": "Mishnah Peah 4:2", - "heSectionRef": "משנה פאה ד׳", - "isSpanning": false, - "versionTitle": "Mishnah Yomit by Dr. Joshua Kulp", - "versionTitleInHebrew": "", - "shortVersionTitle": "Dr. Joshua Kulp", - "shortVersionTitleInHebrew": "", - "versionSource": "http://learn.conservativeyeshiva.org/mishnah/", - "versionStatus": "locked", - "versionNotes": "", - "extendedNotes": "", - "extendedNotesHebrew": "", - "versionNotesInHebrew": "", - "digitizedBySefaria": false, - "license": "CC-BY", - "formatEnAsPoetry": false, - "heVersionTitle": "Torat Emet 357", - "heVersionTitleInHebrew": "תורת אמת 357", - "heShortVersionTitle": "", - "heShortVersionTitleInHebrew": "", - "heVersionSource": "http://www.toratemetfreeware.com/index.html?downloads", - "heVersionStatus": "locked", - "heVersionNotes": "", - "heExtendedNotes": "", - "heExtendedNotesHebrew": "", - "heVersionNotesInHebrew": "", - "heDigitizedBySefaria": false, - "heLicense": "Public Domain", - "formatHeAsPoetry": false, - "alts": [], - "index_offsets_by_depth": {}, - "next": "Mishnah Peah 5", - "prev": "Mishnah Peah 3", - "commentary": [], - "sheets": [], - "layer": [] - } - }, - "KleinDictionaryEntry": { - "title": "KleinDictionaryEntry", - "type": "object", - "allOf": [ - { - "$ref": "#/components/schemas/dictionaryEntry" + "grammar": { + "verbal_stem": "Hophal" } - ], - "properties": { - "rid": { - "description": "Returns a unique id for this reference that establishes an ordering of references across the whole catalog. This id will change as the ordering of the categories changes, and may begin to overlap with other numbers because of those changes. However, at any point in time these ids will be unique across the catalog. Used to sort results from ElasticSearch queries" - }, - "quotes": { - "description": "" - }, - "refs": { - "description": "Internal references to the Klein dictionary for other entries.", - "type": "array", - "items": { - "$ref": "#/components/schemas/ref" - } - }, - "prev_hw": { - "description": "The previous headword entry from the book." + }, + { + "definition": " to look at each other, face", + "grammar": { + "verbal_stem": "Hithpael" + } + } + ] + } + ] + }, + "strong_number": "7200", + "transliteration": "râʼâh", + "pronunciation": "raw-aw'", + "language_code": "heb", + "parent_lexicon_details": { + "name": "BDB Augmented Strong", + "language": "heb.biblical", + "to_language": "eng", + "text_categories": [ + "Tanakh, Torah", + "Tanakh, Prophets", + "Tanakh, Writings" + ], + "source": "Open Scriptures on GitHub", + "source_url": "https://github.com/openscriptures/strongs", + "attribution": "Based on the work of Larry Pierce at the Online Bible", + "attribution_url": "http://www.blueletterbible.org/contact/contact_gen.cfm" + } + } + }, + "BDBDictionaryEntry": { + "title": "BDBDictionaryEntry", + "type": "object", + "allOf": [ + { + "$ref": "#/components/schemas/dictionaryEntry" + } + ], + "properties": { + "rid": { + "description": "Returns a unique id for this reference that establishes an ordering of references across the whole catalog. The `rid` will change as the ordering of the categories changes, and may begin to overlap with other numbers because of those changes. However, at any point in time the `rid`s will be unique across the catalog. The `rid` is used to sort results from ElasticSearch queries.", + "type": "string" + }, + "TWOT": { + "description": "The corresponding Theological Wordbook of the Old Testament number for this word.", + "type": "string" + }, + "strong_numbers": { + "description": "An array of corresponsing Strong Numbers for this word.", + "type": "array", + "items": { + "type": "string" + } + }, + "root": { + "description": "Indicates if the headword is the Biblical root. (Indicated in print, by a larger printed headword).", + "type": "boolean" + }, + "peculiar": { + "description": "A bool indicating the presence of the `‡` symbol in print, demonstrating that the word is peculiar to Biblical Aramaic.", + "type": "boolean" + }, + "ordinal": { + "description": "When the same headword has more than one entry with a differen meaning they are offset by the Roman numerals here.", + "type": "string" + }, + "occurrences": { + "description": "A count of the number of times the headword appears in the Bible", + "type": "number" + }, + "headword_suffix": { + "description": "In some cases the headword has some additional content in print beyond it. That data is included here.", + "type": "string" + }, + "GK": { + "description": "The corresponding Goodrick/Kohlenberger Lexicon number for this headword.", + "type": "string" + }, + "all_cited": { + "description": "A bool indicating the presense of the `†` symbol in print, indicating that all of the occurences of the word are listed as part of this entry", + "type": "boolean" + }, + "brackets": { + "description": "Headword has brackets in print.", + "type": "boolean" + }, + "alt_headwords": { + "description": "An array of alternative headwords for the entry", + "type": "array", + "items": { + "type": "string" + }, + "properties": { + "word": { + "description": "The alternative headword", + "type": "string" + }, + "occurences": { + "description": "The number of times the alternative headword exists in the Bible" + } + } + }, + "prev_hw": { + "description": "The previous entry in print.", + "type": "string" + }, + "next_hw": { + "description": "The next entry in print.", + "type": "string" + }, + "content": { + "description": "", + "type": "object", + "properties": { + "senses": { + "type": "array", + "items": { + "type": "object", + "properties": { + "definition": { + "description": "a definition of this sense of the word", + "type": "string" }, - "next_hw": { - "description": "The next headword entry from the book." + "all_cited": { + "description": "A bool indicating the presense of the `†` symbol in print, indicating that all of the occurences of this sense of the word are listed as part of this entry", + "type": "string" }, - "plural_form": { - "description": "The plural form of the headword" + "form": { + "description": "the grammatical verb form (binyan) of the word", + "type": "string" }, - "language_reference": { - "description": "" + "note": { + "description": "an additional note for the entry", + "type": "string" }, - "language_code": { - "description": "If not present, it’s Biblical. Otherwise values could be [PBH, MH, NH, FW] - Post Biblical Hebrew, Middle Hebrew, New Hebrew, Foreign Word." + "num": { + "description": "the string of the numbering of this sense in print (it can be a number, English letter, Roman digits, with period, in parentheses, etc.)", + "type": "string" }, - "morphology": { - "description": "One of [n., adj., adv., m.n., abs., art. , attrib., auxil., comp., copul., c st., def., f., f. n., imper.., Imperf., Indef art., Inf, Interj., Interr., Intr., Neut., Part., Pass., Perf., Possess., p. part., prep., pres part., pres t., p.t.., sing., Subj., Tr.]" + "occurences": { + "description": "number of occurrences of this sense in bible", + "type": "string" }, - "alt_headwords": { - "description": "Alternative spellings of headword" - }, - "notes": { - "description": "The trailing end of the dictionary entry, after the formal definition - may have comparisons to cognates or similar notes" - }, - "derivatives": { - "description": "HTML - list of derivate words - tag wrapped with links to Sefaria entries" - }, - "content": { - "description": "", - "type": "object", - "properties": { - "senses": { - "type": "array", - "items": { - "$ref": "#/components/schemas/SenseKleinDictionaryEntry" - } - }, - "morphology": { - "description": "One of [n., adj., adv., m.n., abs., art. , attrib., auxil., comp., copul., c st., def., f., f. n., imper.., Imperf., Indef art., Inf, Interj., Interr., Intr., Neut., Part., Pass., Perf., Possess., p. part., prep., pres part., pres t., p.t.., sing., Subj., Tr.]", - "type": "string" - } - } + "pre_num": { + "description": "In some cases the sense has some additional characters before the entry (e.g. the word Especially). That data is included here", + "type": "string" } + } } - }, - "SenseStrongsDictionaryEntry": { - "description": "", - "type": "object", - "properties": { + } + } + } + } + }, + "HebrewDictionaryEntry": { + "title": "HebrewDictionaryEntry", + "type": "object", + "allOf": [ + { + "$ref": "#/components/schemas/dictionaryEntry" + } + ], + "properties": { + "rid": { + "description": "Returns a unique id for this reference that establishes an ordering of references across the whole catalog. This id will change as the ordering of the categories changes, and may begin to overlap with other numbers because of those changes. However, at any point in time these ids will be unique across the catalog. Used to sort results from ElasticSearch queries", + "type": "string" + }, + "refs": { + "description": "Cross references to selections in the Sefaria library.", + "type": "array", + "items": { + "$ref": "#/components/schemas/ref" + } + }, + "prev_hw": { + "description": "The previous headword entry from the book.", + "type": "string" + }, + "next_hw": { + "description": "The next headword entry from the book.", + "type": "string" + }, + "content": { + "description": "", + "type": "object", + "properties": { + "senses": { + "type": "array", + "items": { + "type": "object", + "properties": { "definition": { - "description": "A definition of the word" - }, - "grammar": { - "description": "", - "type": "object", - "properties": { - "verbal_stem": { - "type": "string" - } - } + "description": "A definition of this sense of the word", + "type": "string" } + } } - }, - "SenseKleinDictionaryEntry": { - "description": "", - "type": "object", - "properties": { - "definition": { - "description": "A definition of the word", - "type": "string" - }, - "grammar": { - "description": "", - "type": "object", - "properties": { - "verbal_stem": { - "type": "string" - }, - "language_code": { - "type": "string" - }, - "binyan_form": { - "description": "what form the root takes in this binyan", - "type": "array", - "items": { - "type": "string" - } - }, - "morphology": { - "type": "string" - } - } - }, - "number": { - "description": "a number indicating which numbered sense this is", - "type": "string" - }, - "plural_form": { - "description": "the plural form of the sense", - "type": "string" - }, - "notes": { - "description": "The trailing end of the dictionary entry, after the formal definition - may have comparisons to cognates or similar notes", - "type": "string" - }, - "morphology": { - "description": " One of [n., adj., adv., m.n., abs., art. , attrib., auxil., comp., copul., c st., def., f., f. n., imper.., Imperf., Indef art., Inf, Interj., Interr., Intr., Neut., Part., Pass., Perf., Possess., p. part., prep., pres part., pres t., p.t.., sing., Subj., Tr.]", - "type": "string" - }, - "language_code": { - "description": "If not present, it’s Biblical. Otherwise values could be [PBH, MH, NH, FW] - Post Biblical Hebrew, Middle Hebrew, New Hebrew, Foreign Word.", - "type": "string" - }, - "alternative": { - "type": "string" - } + } + } + } + } + }, + "JastrowDictionaryEntry": { + "title": "JastrowDictionaryEntry", + "description": "An entry from Jastrow’s Dictionary,", + "type": "object", + "allOf": [ + { + "$ref": "#/components/schemas/dictionaryEntry" + } + ], + "properties": { + "rid": { + "description": "Returns a unique id for this reference that establishes an ordering of references across the whole catalog. This id will change as the ordering of the categories changes, and may begin to overlap with other numbers because of those changes. However, at any point in time these ids will be unique across the catalog. Used to sort results from ElasticSearch queries" + }, + "quotes": { + "description": "" + }, + "refs": { + "description": "Cross references to selections in the Sefaria library.", + "type": "array", + "items": { + "$ref": "#/components/schemas/ref" + } + }, + "prev_hw": { + "description": "The previous headword entry from the book." + }, + "next_hw": { + "description": "The next headword entry from the book." + }, + "plural_form": { + "description": "The plural form of the headword." + }, + "language_reference": { + "description": "" + }, + "language_code": { + "description": "A string containing the following characters `h.` (Hebrew), `b. h.` (Biblical Hebrew) `ch.` or `Ch.` (Chaldean) indicating the source language of the entry." + }, + "alt_headwords": { + "description": "An array of alternate headwords for the entry. Symbolized in print as those headwords separated by commas after the initial entry.", + "type": "array", + "items": { + "type": "string" + } + }, + "content": { + "description": "", + "type": "object", + "properties": { + "senses": { + "type": "array", + "items": { + "$ref": "#/components/schemas/SenseJastrowDictionaryEntry" } - }, - "SenseJastrowDictionaryEntry": { - "description": "Each meaning of the word is tagged as a `sense` within `senses`\nEach sense may be preceded by a bolded number which will be tagged as a `number`\nEach Binyan will also be broken down into `senses`", - "type": "object", - "properties": { - "definition": { - "description": "A definition of the word", - "type": "string" - }, - "grammar": { - "description": "", - "type": "object", - "properties": { - "verbal_stem": { - "type": "string" - }, - "language_code": { - "type": "string" - }, - "binyan_form": { - "description": "Found in verbs, a binyan is a linguistic alternate use of the word. It will be one of the following: Hiph., Hish., Hith., Hithpalp., Hithpol., Hoph., Hoth., Niph, , Nith., Pa., Pi., Pil., Pilp., Pir., Po., Pol., Polp., Pu., Pul., Pulp., Qal., Shaph., Shiph., Shuph., Tiph., Tuph., Hif., Nif., Hithpa., Af., Ithpa., Ithpe., Nithpa", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "number": { - "type": "string" - } + }, + "morphology": { + "description": "A description of the morphological form of the word, one of `m., m. pl., f., f. pl., pr. n., pr. n. pl., pr. n. f., pr. n. m., pron., pers. pron.`", + "type": "string" + } + } + } + } + }, + "textAPIReponse": { + "title": "Root Type for textAPIReponse", + "description": "Expected reponse data from Sefaria's Text API", + "type": "object", + "properties": { + "ref": { + "$ref": "#/components/schemas/ref" + }, + "heRef": { + "$ref": "#/components/schemas/ref", + "description": "The Hebrew `Ref`." + }, + "isComplex": { + "description": "Whether or not the text is a \"complex\" text or not.\n\nIn Sefaria, a complex text is any text which has a more complicated index structure beyond Chapters/Verses, (e.g. the Talmud). There are a variety of structural differences for a complex text, having to do primarily with its `Index`, and the way the data is stored. For more on complex texts, see the documentation here.", + "type": "boolean" + }, + "text": { + "oneOf": [ + { + "type": "string" + }, + { + "type": "array", + "items": { + "type": "array", + "items": { + "type": "string" + } } - }, - "recommendedTopicResponse": { - "title": "Root Type for recommendedTopicResponse", - "description": "", - "type": "object", - "properties": { - "slug": { - "description": "The url slug for the topic.", - "type": "string" - }, - "titles": { - "description": "Titles for the topic by language (usually Hebrew & English)", - "type": "object", - "properties": { - "en": { - "type": "string" - }, - "he": { - "type": "string" - } - } - }, - "count": { - "format": "int32", - "description": "Number of times the topic appears in the references", - "type": "integer" - } - }, - "example": { - "slug": "jacobs-burial", - "titles": { - "en": "Jacob's Burial", - "he": "קבורת יעקב" - }, - "count": 3 + }, + { + "type": "array", + "items": { + "type": "string" } - }, - "ManuscriptJSON": { - "title": "Root Type for ManuscriptJSON", - "description": "Manuscript data and metadata JSON. ", - "required": [ - "manuscript" - ], - "type": "object", - "properties": { - "manuscript_slug": { - "description": "A unique slug for the given manuscript", - "type": "string", - "example": "leningrad-codex-(1008-ce)" - }, - "page_id": { - "description": "The ID for the specific page within the manuscript being referenced. ", - "type": "string", - "example": "LC_Folio_435r" - }, - "image_url": { - "description": "The URL to the image of the manuscript, hosted by Sefaria. All URLs will be prefaced by `https://manuscripts.sefaria.org/`", - "type": "string", - "example": "https://manuscripts.sefaria.org/leningrad-color/BIB_LENCDX_F434B_thumbnail.jpg" - }, - "thumbnail_url": { - "description": "The url to the thumbnail image of the manuscript. ", - "type": "string", - "example": "https://manuscripts.sefaria.org/leningrad-color/BIB_LENCDX_F434B_thumbnail.jpg" - }, - "anchorRef": { - "description": "A manuscript image will in most cases be associated with a range of `refs` (i.e. an image of a page of Tanakh will display multiple verses). The `anchorRef` is that complete range the manuscript is associated with, and will contain within it the specific textual `Ref` passed in as a parameter. ", - "type": "string", - "example": "\"Esther 3:15-4:17\"" - }, - "anchorRefExpanded": { - "description": "An array of strings, where each string is a segment level `Ref` of the `Ref` passed in as a parameter. If a segment level `Ref` is passed in, this array will have a length of 1, and only contain that segment level `Ref`. If the `Ref` passed in is ranged, this array will contain each of the segment level `Ref`s within that range. \n\nFor example, if someone was searching for manuscript data for `Esther 4.14-15`, the `anchorRefExpanded` would contain `Esther 4.14` and `Esther 4.15`.", - "minItems": 1, - "uniqueItems": true, - "type": "array", - "items": { - "type": "string" - }, - "example": "\"anchorRefExpanded\": [\n \"Esther 4:14\",\n \"Esther 4:15\"\n]" - }, - "manuscript": { - "$ref": "#/components/schemas/ManuscriptVersionMetaData", - "description": "The version metadata for the manuscript, including the title, Hebrew and English descriptions. ", - "properties": { - "slug": { - "type": "string" - }, - "title": { - "type": "string" - }, - "he_title": { - "type": "string" - }, - "source": { - "type": "string" - }, - "description": { - "type": "string" - }, - "he_description": { - "type": "string" - } - }, - "example": "" - } - }, - "example": { - "manuscript_slug": "leningrad-codex-(1008-ce)", - "page_id": "LC_Folio_434v", - "image_url": "https://manuscripts.sefaria.org/leningrad-color/BIB_LENCDX_F434B.jpg", - "thumbnail_url": "https://manuscripts.sefaria.org/leningrad-color/BIB_LENCDX_F434B_thumbnail.jpg", - "anchorRef": "Esther 3:15-4:17", - "anchorRefExpanded": [ - "Esther 4:14" - ], - "manuscript": { - "slug": "leningrad-codex-(1008-ce)", - "title": "Leningrad Codex (1008 CE)", - "he_title": "כתב יד לנינגרד (1008)", - "source": "https://dornsife.usc.edu/wsrp/biblical-manuscripts", - "description": "Bruce Zuckerman, West Semitic Research, in collaboration with the Ancient Biblical Manuscript Center; courtesy Russian National Library, Saltykov-Schedrin", - "he_description": "" - } + } + ], + "description": "The default, or specified text written in LTR characters for the query (Usually English). It is structured as a `JaggedArray` (nested arrays), with the lowest level being an array of strings with some HTML text." + }, + "he": { + "oneOf": [ + { + "type": "array", + "items": { + "type": "string" } + }, + { + "type": "string" + } + ], + "description": "The default, or specified text written in RTL characters for the query (Usually Hebrew). It is structured as a JaggedArray (nested arrays), with the lowest level being an array of strings with some html text." + }, + "versions": { + "type": "array", + "items": { + "$ref": "#/components/schemas/versionData" + } + }, + "textDepth": { + "format": "int32", + "type": "integer" + }, + "sectionNames": { + "description": "An array containing the type names of the sections of this text. The length of sectionNames gives the depth of the structure of this text. For example, Kohelet `([\"Chapter\", \"Verse\"])` has depth 2, while Mishneh Torah `([\"Book\", \"Topic\", \"Section\", \"Law\"])` has depth 4. Comparing this depth to the depth of sections will show if the request was for the lowest level, or a higher level, of the text.", + "type": "array", + "items": { + "type": "string" + } + }, + "addressTypes": { + "description": "A list which length reflects the depth of the text structure, with string values indicating class names for address types for each level", + "type": "array", + "items": { + "type": "string" + } + }, + "lengths": { + "type": "array", + "items": { + "format": "int32", + "type": "integer" + } + }, + "length": { + "format": "int32", + "type": "integer" + }, + "heTitle": { + "type": "string" + }, + "titleVariants": { + "type": "array", + "items": { + "type": "string" + } + }, + "heTitleVariants": { + "type": "array", + "items": { + "type": "string" + } + }, + "type": { + "type": "string" + }, + "primary_category": { + "type": "string" + }, + "book": { + "description": "The title of the book that the response comes from.", + "type": "string" + }, + "categories": { + "description": "A list of categories that a text belongs to. ", + "type": "array", + "items": { + "type": "string" + } + }, + "order": { + "type": "array", + "items": { + "format": "int32", + "type": "integer" + } + }, + "sections": { + "description": "An array which corresponds to sectionNames and represents the sections of the text requested. When sectionNames is `[\"Chapter\", \"Verse\"]` a request for chapter 4 looks like `[4]` while a request for chapter 4, verse 7 would look like `[4, 7]`. _Note, for Talmud, Dafs are represented by a string like \"42a\" or \"12b\"_", + "type": "array", + "items": { + "format": "int32", + "type": "integer" + } + }, + "toSections": { + "type": "array", + "items": { + "format": "int32", + "type": "integer" + } + }, + "isDependant": { + "type": "boolean" + }, + "indexTitle": { + "type": "string" + }, + "heIndexTitle": { + "type": "string" + }, + "sectionRef": { + "$ref": "#/components/schemas/ref" + }, + "firstAvailableSectionRef": { + "type": "string" + }, + "heSectionRef": { + "$ref": "#/components/schemas/ref" + }, + "isSpanning": { + "type": "boolean" + }, + "versionTitle": { + "type": "string" + }, + "versionTitleInHebrew": { + "type": "string" + }, + "shortVersionTitle": { + "type": "string" + }, + "shortVersionTitleInHebrew": { + "type": "string" + }, + "versionSource": { + "type": "string" + }, + "versionStatus": { + "type": "string" + }, + "versionNotes": { + "type": "string" + }, + "extendedNotes": { + "type": "string" + }, + "extendedNotesHebrew": { + "type": "string" + }, + "versionNotesInHebrew": { + "type": "string" + }, + "digitizedBySefaria": { + "description": "Was the `text` response initially digitized by Sefaria `1` or was it initially generated by another digital publisher `0`", + "type": "boolean" + }, + "license": { + "type": "string" + }, + "formatEnAsPoetry": { + "type": "boolean" + }, + "heVersionTitle": { + "type": "string" + }, + "heVersionTitleInHebrew": { + "type": "string" + }, + "heShortVersionTitle": { + "type": "string" + }, + "heShortVersionTitleInHebrew": { + "type": "string" + }, + "heVersionSource": { + "type": "string" + }, + "heVersionStatus": { + "type": "string" + }, + "heVersionNotes": { + "type": "string" + }, + "heExtendedNotes": { + "type": "string" + }, + "heExtendedNotesHebrew": { + "type": "string" + }, + "heVersionNotesInHebrew": { + "type": "string" + }, + "heDigitizedBySefaria": { + "description": "Was the `he` response initially digitized by Sefaria `1` or was it initially generated by another digital publisher `0`", + "type": "boolean" + }, + "heLicense": { + "type": "string" + }, + "formatHeAsPoetry": { + "type": "boolean" + }, + "alts": { + "type": "array", + "items": {} + }, + "index_offsets_by_depth": { + "type": "object" + }, + "next": { + "nullable": true, + "description": "Next segment reference in sequence, if last ref, field will be `null`.", + "type": "string" + }, + "prev": { + "nullable": true, + "description": "Previous segment reference in sequence, if first ref, field will be `null`.", + "type": "string" + }, + "commentary": { + "type": "array", + "items": {} + }, + "sheets": { + "type": "array", + "items": {} + }, + "layer": { + "type": "array", + "items": {} + } + }, + "example": { + "ref": "Mishnah Peah 4:2", + "heRef": "משנה פאה ד׳:ב׳", + "isComplex": false, + "text": [ + "Peah is given from [the crop] while it is still connected with the soil. But in the case of hanging vine-branches and the date-palm, the owner brings down [the fruit] and distributes it among the poor. Rabbi Shimon says: the same applies to smooth nut trees. Even if ninety-nine [of the poor] say [to the owner] to distribute it and one says to leave it in the field, this latter is listened to, since he spoke in accordance with the halakhah.", + "With hanging vine-branches and date-palm trees it is not so; even if ninety-nine [of the poor] say [to the owner] to leave it in the field and one says to distribute it, this latter is listened to, since he spoke in accordance with the halakhah.", + "If [a poor man] took some of the peah [already collected] and threw it onto the remainder [not yet collected], he gets none of it. If he fell down upon it, or spread his cloak over it, they take the peah away from him. The same applies to gleanings and the forgotten sheaf.", + "[The poor] may not harvest peah with scythes or tear it out [of the ground] with spades, so that they might not strike one another [with these implements].", + "There are three times a day [the poor] make a search [in the field for peah]: morning, noon, and sunset. Rabban Gamaliel says: these [times] were only set lest they reduce them. Rabbi Akiva says: these were set lest they add to them. [The men] of Bet Namer used to have the poor harvest [the peah] with the aid of a rope, and they left peah at the end of each furrow.", + "A non-Jew who harvested his field and then converted, he is exempt from [leaving] gleanings, the forgotten sheaf and peah. Rabbi Judah makes him liable to leave the forgotten sheaf, since he becomes liable for the forgotten sheaf at the time of their binding.", + "One who dedicated standing grain [to the Temple] and then redeemed it while it was still standing grain, he is liable [to give the agricultural gifts to the poor]. [If he dedicated] sheaves and redeemed them while they were still sheaves, he is liable. [If he dedicated] standing grain and redeemed it [when it was already in] sheaves, he is exempt, since at the time when it became liable it was exempt.", + "Similarly one who dedicates his produce prior to the stage when they are subject to tithes and then redeemed them, they are liable [to be tithed]. If [he dedicated them] when they had already become subject to tithes and then redeemed them, they are liable [to be tithed]. If he dedicated them before they had ripened, and they became ripe while in the possession of the [Temple] treasurer, and he then redeemed them, they are exempt, since at the time when they would have been liable, they were exempt.", + "One who collected peah and said, “This is for so-and-so a poor man:” Rabbi Eliezer says: he has thus acquired it for him. The sages say: he must give it to the first poor man he finds. Gleanings, the forgotten sheaf and the peah of non-Jews are subject to tithes, unless he [the non-Jew] had declared them ownerless.", + "What are gleanings? That which falls down at the time of harvesting. If while he was harvesting, he harvested a handful, or plucked a fistful, and then a thorn pricked him, and what he had in his hand fell to the ground, it still belongs to the owner. [That which drops from] inside the hand or the sickle [belongs] to the poor, but [that which falls from] the back of the hand or the sickle [belongs] to the owner. [That which falls from] the top of the hand or sickle: Rabbi Ishmael says: to the poor; But Rabbi Akiva says: to the owner.", + "[Grain found in] ant holes where the stalks are still standing, behold it still belongs to the owner. After the harvesters [had passed over them], those found in the top parts [of the ant holes belong] to the poor, but [those found] on the bottom parts [belong] to the owner. Rabbi Meir says: it all belongs to the poor, for gleanings about which there is any doubt are regarded as gleanings." + ], + "he": [ + "הַפֵּאָה נִתֶּנֶת בִּמְחֻבָּר לַקַּרְקָע. בְּדָלִית וּבְדֶקֶל, בַּעַל הַבַּיִת מוֹרִיד וּמְחַלֵּק לָעֲנִיִּים. רַבִּי שִׁמְעוֹן אוֹמֵר, אַף בַּחֲלִיקֵי אֱגוֹזִים. אֲפִלּוּ תִשְׁעִים וְתִשְׁעָה אוֹמְרִים לְחַלֵּק וְאֶחָד אוֹמֵר לָבוֹז, לָזֶה שׁוֹמְעִין, שֶׁאָמַר כַּהֲלָכָה: \n", + "בְּדָלִית וּבְדֶקֶל אֵינוֹ כֵן, אֲפִלּוּ תִשְׁעִים וְתִשְׁעָה אוֹמְרִים לָבוֹז וְאֶחָד אוֹמֵר לְחַלֵּק, לָזֶה שׁוֹמְעִין, שֶׁאָמַר כַּהֲלָכָה: \n", + "נָטַל מִקְצָת פֵּאָה וּזְרָקָהּ עַל הַשְּׁאָר, אֵין לוֹ בָהּ כְּלוּם. נָפַל לוֹ עָלֶיהָ, וּפֵרֵשׂ טַלִּיתוֹ עָלֶיהָ, מַעֲבִירִין אוֹתָהּ הֵימֶנּוּ. וְכֵן בְּלֶקֶט, וְכֵן בְּעֹמֶר הַשִּׁכְחָה: \n", + "פֵּאָה אֵין קוֹצְרִין אוֹתָהּ בְּמַגָּלוֹת, וְאֵין עוֹקְרִין אוֹתָהּ בְּקַרְדֻּמּוֹת, כְּדֵי שֶׁלֹּא יַכּוּ אִישׁ אֶת רֵעֵהוּ: \n", + "שָׁלשׁ אַבְעָיוֹת בַּיּוֹם, בַּשַּׁחַר וּבַחֲצוֹת וּבַמִּנְחָה. רַבָּן גַּמְלִיאֵל אוֹמֵר, לֹא אָמְרוּ אֶלָּא כְּדֵי שֶׁלֹּא יִפְחֲתוּ. רַבִּי עֲקִיבָא אוֹמֵר, לֹא אָמְרוּ אֶלָּא כְּדֵי שֶׁלֹּא יוֹסִיפוּ. שֶׁל בֵּית נָמֵר הָיוּ מְלַקְּטִין עַל הַחֶבֶל, וְנוֹתְנִים פֵּאָה מִכָּל אֻמָּן וְאֻמָּן: \n", + "עוֹבֵד כּוֹכָבִים שֶׁקָּצַר אֶת שָׂדֵהוּ וְאַחַר כָּךְ נִתְגַּיֵּר, פָּטוּר מִן הַלֶּקֶט וּמִן הַשִּׁכְחָה וּמִן הַפֵּאָה. רַבִּי יְהוּדָה מְחַיֵּב בְּשִׁכְחָה, שֶׁאֵין הַשִּׁכְחָה אֶלָּא בִשְׁעַת הָעִמּוּר: \n", + "הִקְדִּישׁ קָמָה וּפָדָה קָמָה, חַיָּב. עֳמָרִין וּפָדָה עֳמָרִין, חַיָּב. קָמָה וּפָדָה עֳמָרִין, פְּטוּרָה, שֶׁבִּשְׁעַת חוֹבָתָהּ הָיְתָה פְטוּרָה: \n", + "כַּיּוֹצֵא בוֹ, הַמַּקְדִּישׁ פֵּרוֹתָיו עַד שֶׁלֹּא בָאוּ לְעוֹנַת הַמַּעַשְׂרוֹת, וּפְדָאָן, חַיָּבִין. מִשֶּׁבָּאוּ לְעוֹנַת הַמַּעַשְׂרוֹת, וּפְדָאָן, חַיָּבִין. הִקְדִּישָׁן עַד שֶׁלֹּא נִגְמְרוּ וּגְמָרָן הַגִּזְבָּר, וְאַחַר כָּךְ פְּדָאָן, פְּטוּרִים, שֶׁבִּשְׁעַת חוֹבָתָן הָיוּ פְטוּרִים: \n", + "מִי שֶׁלָּקַט אֶת הַפֵּאָה וְאָמַר הֲרֵי זוֹ לְאִישׁ פְּלוֹנִי עָנִי, רַבִּי אֱלִיעֶזֶר אוֹמֵר, זָכָה לוֹ. וַחֲכָמִים אוֹמְרִים, יִתְּנֶנָּה לֶעָנִי שֶׁנִּמְצָא רִאשׁוֹן. הַלֶּקֶט וְהַשִּׁכְחָה וְהַפֵּאָה שֶׁל עוֹבֵד כּוֹכָבִים חַיָּב בְּמַעַשְׂרוֹת, אֶלָּא אִם כֵּן הִפְקִיר: \n", + "אֵיזֶהוּ לֶקֶט, הַנּוֹשֵׁר בִּשְׁעַת הַקְּצִירָה. הָיָה קוֹצֵר, קָצַר מְלֹא יָדוֹ, תָּלַשׁ מְלֹא קֻמְצוֹ, הִכָּהוּ קוֹץ וְנָפַל מִיָּדוֹ לָאָרֶץ, הֲרֵי הוּא שֶׁל בַּעַל הַבָּיִת. תּוֹךְ הַיָּד וְתוֹךְ הַמַּגָּל, לָעֲנִיִּים. אַחַר הַיָּד וְאַחַר הַמַּגָּל, לְבַעַל הַבָּיִת. רֹאשׁ הַיָּד וְרֹאשׁ הַמַּגָּל, רַבִּי יִשְׁמָעֵאל אוֹמֵר, לָעֲנִיִּים. רַבִּי עֲקִיבָא אוֹמֵר, לְבַעַל הַבָּיִת: \n", + "חוֹרֵי הַנְּמָלִים שֶׁבְּתוֹךְ הַקָּמָה, הֲרֵי הֵן שֶׁל בַּעַל הַבָּיִת. שֶׁלְּאַחַר הַקּוֹצְרִים, הָעֶלְיוֹנִים לָעֲנִיִּים, וְהַתַּחְתּוֹנִים שֶׁל בַּעַל הַבָּיִת. רַבִּי מֵאִיר אוֹמֵר, הַכֹּל לָעֲנִיִּים, שֶׁסְּפֵק לֶקֶט, לֶקֶט: \n" + ], + "versions": [ + { + "title": "Mishnah Peah", + "versionTitle": "Torat Emet 357", + "versionSource": "http://www.toratemetfreeware.com/index.html?downloads", + "language": "he", + "status": "locked", + "license": "Public Domain", + "versionNotes": "", + "digitizedBySefaria": "", + "priority": 3, + "versionTitleInHebrew": "תורת אמת 357", + "versionNotesInHebrew": "", + "extendedNotes": "", + "extendedNotesHebrew": "", + "purchaseInformationImage": "", + "purchaseInformationURL": "", + "shortVersionTitle": "", + "shortVersionTitleInHebrew": "", + "isBaseText": true }, - "ManuscriptVersionMetaData": { - "title": "Root Type for ManuscriptVersionMetaData", - "description": "The specific metadata for the version of the manuscript. ", - "required": [ - "slug", - "description", - "he_description", - "he_title", - "source", - "title" - ], - "type": "object", - "properties": { - "slug": { - "description": "The unique slug for the manuscript. ", - "type": "string", - "example": "leningrad-codex-(1008-ce)" - }, - "title": { - "description": "The title of the manuscript. ", - "type": "string", - "example": "Leningrad Codex (1008 CE)" - }, - "he_title": { - "description": "The manuscript title in Hebrew. ", - "type": "string", - "example": "כתב יד לנינגרד (1008)" - }, - "source": { - "description": "The url for the source of the manuscript images. ", - "type": "string", - "example": "https://dornsife.usc.edu/wsrp/biblical-manuscripts/" - }, - "description": { - "description": "A description of the manuscript, oftening containing details about the archivists or where the physical manuscript images can be found, as well as other library details. ", - "type": "string", - "example": "Bruce Zuckerman, West Semitic Research, in collaboration with the Ancient Biblical Manuscript Center; courtesy Russian National Library, Saltykov-Schedrin" - }, - "he_description": { - "description": "A Hebrew description of the manuscript, oftening containing details about the archivists or where the physical manuscript images can be found, as well as other library details. ", - "type": "string" - } - }, - "example": { - "slug": "leningrad-codex-(1008-ce)", - "title": "Leningrad Codex (1008 CE)", - "he_title": "כתב יד לנינגרד (1008)", - "source": "https://dornsife.usc.edu/wsrp/biblical-manuscripts", - "description": "Bruce Zuckerman, West Semitic Research, in collaboration with the Ancient Biblical Manuscript Center; courtesy Russian National Library, Saltykov-Schedrin", - "he_description": "" - } + { + "title": "Mishnah Peah", + "versionTitle": "Mishnah, ed. Romm, Vilna 1913", + "versionSource": "https://www.nli.org.il/he/books/NNL_ALEPH001741739", + "language": "he", + "status": "locked", + "license": "Public Domain", + "versionNotes": "", + "digitizedBySefaria": true, + "priority": 2, + "versionTitleInHebrew": "משנה, מהדורת בית דפוס ראם, וילנא 1913", + "versionNotesInHebrew": "", + "extendedNotes": "", + "extendedNotesHebrew": "", + "purchaseInformationImage": "", + "purchaseInformationURL": "", + "shortVersionTitle": "", + "shortVersionTitleInHebrew": "", + "isBaseText": true + }, + { + "title": "Mishnah Peah", + "versionTitle": "Mishnah Yomit by Dr. Joshua Kulp", + "versionSource": "http://learn.conservativeyeshiva.org/mishnah/", + "language": "en", + "status": "locked", + "license": "CC-BY", + "versionNotes": "", + "digitizedBySefaria": "", + "priority": 1, + "versionTitleInHebrew": "", + "versionNotesInHebrew": "", + "extendedNotes": "", + "extendedNotesHebrew": "", + "purchaseInformationImage": "", + "purchaseInformationURL": "", + "shortVersionTitle": "Dr. Joshua Kulp", + "shortVersionTitleInHebrew": "", + "isBaseText": false + }, + { + "title": "Mishnah Peah", + "versionTitle": "Mischnajot mit deutscher Übersetzung und Erklärung. Berlin 1887-1933 [de]", + "versionSource": "https://www.nli.org.il/he/books/NNL_ALEPH002378149/NLI", + "language": "en", + "status": "locked", + "license": "Public Domain", + "versionNotes": "Ordnung Seraïm, übers. und erklärt von Ascher Samter. 1887.
Ordnung Moed, von Eduard Baneth. 1887-1927.
Ordnung Naschim, von Marcus Petuchowski u. Simon Schlesinger. 1896-1933.
Ordnung Nesikin, von David Hoffmann. 1893-1898.
Ordnung Kodaschim, von John Cohn. 1910-1925.
Ordnung Toharot, von David Hoffmann, John Cohn und Moses Auerbach. 1910-1933.", + "digitizedBySefaria": true, + "priority": 0.5, + "versionTitleInHebrew": "", + "versionNotesInHebrew": "", + "extendedNotes": "", + "extendedNotesHebrew": "", + "purchaseInformationImage": "", + "purchaseInformationURL": "", + "shortVersionTitle": "", + "shortVersionTitleInHebrew": "", + "isBaseText": false + }, + { + "title": "Mishnah Peah", + "versionTitle": "Talmud Bavli. German. Lazarus Goldschmidt. 1929 [de]", + "versionSource": "https://www.nli.org.il/he/books/NNL_ALEPH001042448/NLI", + "language": "en", + "status": "locked", + "license": "Public Domain", + "versionNotes": "", + "digitizedBySefaria": true, + "priority": 0.25, + "versionTitleInHebrew": "", + "versionNotesInHebrew": "", + "extendedNotes": "", + "extendedNotesHebrew": "", + "purchaseInformationImage": "", + "purchaseInformationURL": "", + "shortVersionTitle": "Lazarus Goldschmidt, 1929 ", + "shortVersionTitleInHebrew": "", + "isBaseText": false + }, + { + "title": "Mishnah Peah", + "versionTitle": "Open Mishnah", + "versionSource": "http://en.wikisource.org/wiki/Mishnah", + "language": "en", + "status": "locked", + "license": "CC-BY-SA", + "versionNotes": "", + "digitizedBySefaria": "", + "priority": "", + "versionTitleInHebrew": "משנה פתוחה", + "versionNotesInHebrew": "", + "extendedNotes": "", + "extendedNotesHebrew": "", + "purchaseInformationImage": "", + "purchaseInformationURL": "", + "shortVersionTitle": "", + "shortVersionTitleInHebrew": "", + "isBaseText": false + }, + { + "title": "Mishnah Peah", + "versionTitle": "Le Talmud de Jérusalem, traduit par Moise Schwab, 1878-1890 [fr]", + "versionSource": "https://www.nli.org.il/he/books/NNL_ALEPH002182155/NLI", + "language": "en", + "status": "locked", + "license": "Public Domain", + "versionNotes": "", + "digitizedBySefaria": "", + "priority": "", + "versionTitleInHebrew": "", + "versionNotesInHebrew": "", + "extendedNotes": "", + "extendedNotesHebrew": "", + "purchaseInformationImage": "", + "purchaseInformationURL": "", + "shortVersionTitle": "", + "shortVersionTitleInHebrew": "", + "isBaseText": false }, - "wordCompletionAPIResponse": { - "description": "An array of arrays, each containing two strings. The first is a completion entry in Hebrew without vowels and the second includes vowels.", + { + "title": "Mishnah Peah", + "versionTitle": "Mishnah based on the Kaufmann manuscript, edited by Dan Be'eri", + "versionSource": "https://archive.org/details/MishnaCorrectedKaufman00WHOLE", + "language": "he", + "status": "locked", + "license": "PD", + "versionNotes": "", + "digitizedBySefaria": true, + "priority": "", + "versionTitleInHebrew": "", + "versionNotesInHebrew": "", + "extendedNotes": "", + "extendedNotesHebrew": "", + "purchaseInformationImage": "", + "purchaseInformationURL": "", + "shortVersionTitle": "", + "shortVersionTitleInHebrew": "", + "isBaseText": "" + } + ], + "textDepth": 2, + "sectionNames": [ + "Chapter", + "Mishnah" + ], + "addressTypes": [ + "Perek", + "Mishnah" + ], + "lengths": [ + 8, + 69 + ], + "length": 8, + "heTitle": "משנה פאה", + "titleVariants": [ + "M Peah", + "Mishna Peah", + "M. Peah", + "Mishnah Péah", + "Pe’ah", + "Pe'ah", + "Peah", + "Mishnah Peah" + ], + "heTitleVariants": [ + "פאה", + "משנה פיאה", + "משנה פאה" + ], + "type": "Mishnah", + "primary_category": "Mishnah", + "book": "Mishnah Peah", + "categories": [ + "Mishnah", + "Seder Zeraim" + ], + "order": [ + 2, + 2 + ], + "sections": [ + 4, + 2 + ], + "toSections": [ + 4, + 2 + ], + "isDependant": false, + "indexTitle": "Mishnah Peah", + "heIndexTitle": "משנה פאה", + "sectionRef": "Mishnah Peah 4", + "firstAvailableSectionRef": "Mishnah Peah 4:2", + "heSectionRef": "משנה פאה ד׳", + "isSpanning": false, + "versionTitle": "Mishnah Yomit by Dr. Joshua Kulp", + "versionTitleInHebrew": "", + "shortVersionTitle": "Dr. Joshua Kulp", + "shortVersionTitleInHebrew": "", + "versionSource": "http://learn.conservativeyeshiva.org/mishnah/", + "versionStatus": "locked", + "versionNotes": "", + "extendedNotes": "", + "extendedNotesHebrew": "", + "versionNotesInHebrew": "", + "digitizedBySefaria": false, + "license": "CC-BY", + "formatEnAsPoetry": false, + "heVersionTitle": "Torat Emet 357", + "heVersionTitleInHebrew": "תורת אמת 357", + "heShortVersionTitle": "", + "heShortVersionTitleInHebrew": "", + "heVersionSource": "http://www.toratemetfreeware.com/index.html?downloads", + "heVersionStatus": "locked", + "heVersionNotes": "", + "heExtendedNotes": "", + "heExtendedNotesHebrew": "", + "heVersionNotesInHebrew": "", + "heDigitizedBySefaria": false, + "heLicense": "Public Domain", + "formatHeAsPoetry": false, + "alts": [], + "index_offsets_by_depth": {}, + "next": "Mishnah Peah 5", + "prev": "Mishnah Peah 3", + "commentary": [], + "sheets": [], + "layer": [] + } + }, + "KleinDictionaryEntry": { + "title": "KleinDictionaryEntry", + "type": "object", + "allOf": [ + { + "$ref": "#/components/schemas/dictionaryEntry" + } + ], + "properties": { + "rid": { + "description": "Returns a unique id for this reference that establishes an ordering of references across the whole catalog. This id will change as the ordering of the categories changes, and may begin to overlap with other numbers because of those changes. However, at any point in time these ids will be unique across the catalog. Used to sort results from ElasticSearch queries" + }, + "quotes": { + "description": "" + }, + "refs": { + "description": "Internal references to the Klein dictionary for other entries.", + "type": "array", + "items": { + "$ref": "#/components/schemas/ref" + } + }, + "prev_hw": { + "description": "The previous headword entry from the book." + }, + "next_hw": { + "description": "The next headword entry from the book." + }, + "plural_form": { + "description": "The plural form of the headword" + }, + "language_reference": { + "description": "" + }, + "language_code": { + "description": "If not present, it’s Biblical. Otherwise values could be [PBH, MH, NH, FW] - Post Biblical Hebrew, Middle Hebrew, New Hebrew, Foreign Word." + }, + "morphology": { + "description": "One of [n., adj., adv., m.n., abs., art. , attrib., auxil., comp., copul., c st., def., f., f. n., imper.., Imperf., Indef art., Inf, Interj., Interr., Intr., Neut., Part., Pass., Perf., Possess., p. part., prep., pres part., pres t., p.t.., sing., Subj., Tr.]" + }, + "alt_headwords": { + "description": "Alternative spellings of headword" + }, + "notes": { + "description": "The trailing end of the dictionary entry, after the formal definition - may have comparisons to cognates or similar notes" + }, + "derivatives": { + "description": "HTML - list of derivate words - tag wrapped with links to Sefaria entries" + }, + "content": { + "description": "", + "type": "object", + "properties": { + "senses": { "type": "array", "items": { - "type": "string" - }, - "example": [ - [ - "אב", - "אַב" - ] - ] - }, - "VersionJSON": { - "title": "Root Type for VersionJSON", - "description": "The metadata for a given version. ", - "type": "object", - "properties": { - "title": { - "description": "The title of the Index. ", - "type": "string", - "example": "Talmud Berakhot" - }, - "versionTitle": { - "description": "The title of the version", - "type": "string", - "example": "\"William Davidson Edition - Vocalized Aramaic\"" - }, - "versionSource": { - "description": "A URL pointing to the hardcopy of the text as it can be found in libraries, most usually in our case the NLI (National Library of Israel), but not exclusively. ", - "type": "string", - "example": "https://www.nli.org.il/he/books/NNL_ALEPH990025294890205171/NLI" - }, - "language": { - "$ref": "#/components/schemas/LanguageCode", - "description": "The language of the version. The versions on Sefaria are grouped into two language buckets, `en` for languages which read left-to-right (i.e. English, Spanish, German) and `he` for languages which read right-to-left (i.e. Hebrew, Arabic)", - "example": "'en'\n'he'" - }, - "status": { - "description": "The status field contains either the string `\"locked\"` or an empty string. If `\"locked\"` is the value of the field, it indicates that the text is locked from future updatees, edits and translations from community members. ", - "type": "string", - "example": "\"locked\"" - }, - "license": { - "description": "The copyright license for using, and reproducing the text. ", - "type": "string", - "example": "CC-BY" - }, - "versionNotes": { - "description": "English notes relating to the version, often containing details of authorship, place of printing, and sometimes donor dedications. ", - "type": "string", - "example": "\"English from The William Davidson digital edition of the Koren Noé Talmud, with commentary by Rabbi Adin Even-Israel Steinsaltz\"," - }, - "digitizedBySefaria": { - "description": "Whether or not the text was digitized by Sefaria. We have some texts we've been able to add to our database from digital sources, and other texts that we've transfered from print to a digital medium ourselves. This field indicates if Sefaria did the digitization. ", - "type": "boolean", - "example": "True" - }, - "priority": { - "description": "The priority field is a number which indicates the priority of a version relative to all other existing versions of the same text. A value of `1` indicates the lowest priority, while the highest value among all versions of the text indicate the highest priority. \n\nPriority values can also be floating point numbers. The priority field determines how the various available versions of a text will be displayed on the Sefaria website. The texts are displayed to the user in a highest-to-lowest priority order, in many cases offering more complete or higher quality versions of the text before ones of inferior quality. ", - "type": "number", - "example": "7" - }, - "versionTitleInHebrew": { - "description": "The title of the version in Hebrew", - "type": "string", - "example": "מהדורת וויליאם דייוידסון - ארמית המנוקד" - }, - "versionNotesInHebrew": { - "description": "Hebrew notes relating to the version, often containing details of authorship, place of printing, and sometimes donor dedications. ", - "type": "string" - }, - "extendedNotes": { - "description": "English extended notes on a version that go beyond the time and place of printing. ", - "type": "string" - }, - "extendedNotesHebrew": { - "description": "Hebrew extended notes on a version that go beyond the time and place of printing. ", - "type": "string" - }, - "purchaseInformationImage": { - "description": "A URL pointing to an image of the hard copy of the version associated with the digital copy, for those who would like to purchase a hard copy. ", - "type": "string", - "example": "\"https://storage.googleapis.com/sefaria-physical-editions/4fc4b6d5b144eb3915d250d743eaf2e8.png\"" - }, - "purchaseInformationURL": { - "description": "The URL pointing to a website where on can buy a physical copy of the given text version. ", - "type": "string", - "example": "\"https://korenpub.com/collections/the-noe-edition-koren-talmud-bavli-1/products/copy-of-vol-1-berakhot-1\"" - }, - "shortVersionTitle": { - "description": "An English short title for the version", - "type": "string", - "example": "\"Koren - Steinsaltz\"" - }, - "shortVersionTitleInHebrew": { - "description": "A Hebrew short title for the version", - "type": "string" - }, - "isBaseText": { - "description": "Is this a text that has commentary. `true` indicates that there are commentaries on this text, while `false` indicates that the text does not have any commentary. ", - "type": "boolean", - "example": "True" - }, - "firstSectionRef": { - "description": "The first `ref` for this title on a section level (as opposed to the more granular segment level). For example, `Genesis 1` would be the first section level ref of Genesis (as opposed to the segment, `Genesis 1:1`), and `Rashi on Kohelet 1:1` is the first section level ref of `Rashi on Kohelet` (as opposed to the segment level of `Rashi on Kohelet 1:1:1`)", - "type": "string", - "example": "Rashi on Kohelet 1.1" - } - }, - "example": { - "title": "Shulchan Arukh, Orach Chayim", - "versionTitle": "Wikisource Shulchan Aruch", - "versionSource": "https://en.wikisource.org/wiki/Translation:Shulchan_Aruch/Orach_Chaim/338", - "language": "en", - "status": "", - "license": "CC-BY-SA", - "versionNotes": "", - "digitizedBySefaria": "", - "priority": "", - "versionTitleInHebrew": "שולחן ערוך (ויקיטקסט)", - "versionNotesInHebrew": "", - "extendedNotes": "", - "extendedNotesHebrew": "", - "purchaseInformationImage": "", - "purchaseInformationURL": "", - "shortVersionTitle": "", - "shortVersionTitleInHebrew": "", - "isBaseText": false, - "firstSectionRef": "Shulchan Arukh, Orach Chayim 1" + "$ref": "#/components/schemas/SenseKleinDictionaryEntry" } + }, + "morphology": { + "description": "One of [n., adj., adv., m.n., abs., art. , attrib., auxil., comp., copul., c st., def., f., f. n., imper.., Imperf., Indef art., Inf, Interj., Interr., Intr., Neut., Part., Pass., Perf., Possess., p. part., prep., pres part., pres t., p.t.., sing., Subj., Tr.]", + "type": "string" + } + } + } + } + }, + "SenseStrongsDictionaryEntry": { + "description": "", + "type": "object", + "properties": { + "definition": { + "description": "A definition of the word" + }, + "grammar": { + "description": "", + "type": "object", + "properties": { + "verbal_stem": { + "type": "string" + } + } + } + } + }, + "SenseKleinDictionaryEntry": { + "description": "", + "type": "object", + "properties": { + "definition": { + "description": "A definition of the word", + "type": "string" + }, + "grammar": { + "description": "", + "type": "object", + "properties": { + "verbal_stem": { + "type": "string" + }, + "language_code": { + "type": "string" + }, + "binyan_form": { + "description": "what form the root takes in this binyan", + "type": "array", + "items": { + "type": "string" + } + }, + "morphology": { + "type": "string" + } + } + }, + "number": { + "description": "a number indicating which numbered sense this is", + "type": "string" + }, + "plural_form": { + "description": "the plural form of the sense", + "type": "string" + }, + "notes": { + "description": "The trailing end of the dictionary entry, after the formal definition - may have comparisons to cognates or similar notes", + "type": "string" + }, + "morphology": { + "description": " One of [n., adj., adv., m.n., abs., art. , attrib., auxil., comp., copul., c st., def., f., f. n., imper.., Imperf., Indef art., Inf, Interj., Interr., Intr., Neut., Part., Pass., Perf., Possess., p. part., prep., pres part., pres t., p.t.., sing., Subj., Tr.]", + "type": "string" + }, + "language_code": { + "description": "If not present, it’s Biblical. Otherwise values could be [PBH, MH, NH, FW] - Post Biblical Hebrew, Middle Hebrew, New Hebrew, Foreign Word.", + "type": "string" + }, + "alternative": { + "type": "string" + } + } + }, + "SenseJastrowDictionaryEntry": { + "description": "Each meaning of the word is tagged as a `sense` within `senses`\nEach sense may be preceded by a bolded number which will be tagged as a `number`\nEach Binyan will also be broken down into `senses`", + "type": "object", + "properties": { + "definition": { + "description": "A definition of the word", + "type": "string" + }, + "grammar": { + "description": "", + "type": "object", + "properties": { + "verbal_stem": { + "type": "string" + }, + "language_code": { + "type": "string" + }, + "binyan_form": { + "description": "Found in verbs, a binyan is a linguistic alternate use of the word. It will be one of the following: Hiph., Hish., Hith., Hithpalp., Hithpol., Hoph., Hoth., Niph, , Nith., Pa., Pi., Pil., Pilp., Pir., Po., Pol., Polp., Pu., Pul., Pulp., Qal., Shaph., Shiph., Shuph., Tiph., Tuph., Hif., Nif., Hithpa., Af., Ithpa., Ithpe., Nithpa", + "type": "array", + "items": { + "type": "string" + } + } + } + }, + "number": { + "type": "string" + } + } + }, + "recommendedTopicResponse": { + "title": "Root Type for recommendedTopicResponse", + "description": "", + "type": "object", + "properties": { + "slug": { + "description": "The url slug for the topic.", + "type": "string" + }, + "titles": { + "description": "Titles for the topic by language (usually Hebrew & English)", + "type": "object", + "properties": { + "en": { + "type": "string" + }, + "he": { + "type": "string" + } + } + }, + "count": { + "format": "int32", + "description": "Number of times the topic appears in the references", + "type": "integer" + } + }, + "example": { + "slug": "jacobs-burial", + "titles": { + "en": "Jacob's Burial", + "he": "קבורת יעקב" + }, + "count": 3 + } + }, + "ManuscriptJSON": { + "title": "Root Type for ManuscriptJSON", + "description": "Manuscript data and metadata JSON. ", + "required": [ + "manuscript" + ], + "type": "object", + "properties": { + "manuscript_slug": { + "description": "A unique slug for the given manuscript", + "type": "string", + "example": "leningrad-codex-(1008-ce)" + }, + "page_id": { + "description": "The ID for the specific page within the manuscript being referenced. ", + "type": "string", + "example": "LC_Folio_435r" + }, + "image_url": { + "description": "The URL to the image of the manuscript, hosted by Sefaria. All URLs will be prefaced by `https://manuscripts.sefaria.org/`", + "type": "string", + "example": "https://manuscripts.sefaria.org/leningrad-color/BIB_LENCDX_F434B_thumbnail.jpg" + }, + "thumbnail_url": { + "description": "The url to the thumbnail image of the manuscript. ", + "type": "string", + "example": "https://manuscripts.sefaria.org/leningrad-color/BIB_LENCDX_F434B_thumbnail.jpg" + }, + "anchorRef": { + "description": "A manuscript image will in most cases be associated with a range of `refs` (i.e. an image of a page of Tanakh will display multiple verses). The `anchorRef` is that complete range the manuscript is associated with, and will contain within it the specific textual `Ref` passed in as a parameter. ", + "type": "string", + "example": "\"Esther 3:15-4:17\"" + }, + "anchorRefExpanded": { + "description": "An array of strings, where each string is a segment level `Ref` of the `Ref` passed in as a parameter. If a segment level `Ref` is passed in, this array will have a length of 1, and only contain that segment level `Ref`. If the `Ref` passed in is ranged, this array will contain each of the segment level `Ref`s within that range. \n\nFor example, if someone was searching for manuscript data for `Esther 4.14-15`, the `anchorRefExpanded` would contain `Esther 4.14` and `Esther 4.15`.", + "minItems": 1, + "uniqueItems": true, + "type": "array", + "items": { + "type": "string" }, - "LanguageCode": { - "description": "The texts on Sefaria are grouped into two language buckets, `en` for languages which read left-to-right (i.e. English, Spanish, German) and `he` for languages which read right-to-left (i.e. Hebrew, Arabic). This field is only ever populated by a string containing the value of either `en` or `he`. ", - "type": "string", - "example": "'en'\n'he'" + "example": "\"anchorRefExpanded\": [\n \"Esther 4:14\",\n \"Esther 4:15\"\n]" + }, + "manuscript": { + "$ref": "#/components/schemas/ManuscriptVersionMetaData", + "description": "The version metadata for the manuscript, including the title, Hebrew and English descriptions. ", + "properties": { + "slug": { + "type": "string" + }, + "title": { + "type": "string" + }, + "he_title": { + "type": "string" + }, + "source": { + "type": "string" + }, + "description": { + "type": "string" + }, + "he_description": { + "type": "string" + } }, - "FindRefsAPIResponse": { - "title": "Root Type for FindRefsAPIResponse", - "description": "A response to the Find Refs API", - "type": "object", - "properties": { - "title": { - "description": "Information about any references found in the `title` field of the POST request", - "type": "object", - "properties": { - "results": { - "type": "array", - "items": { - "description": "A single matched reference", - "type": "object", - "properties": { - "startChar": { - "format": "int32", - "description": "The index of the starting character of the match", - "type": "integer" - }, - "endChar": { - "format": "int32", - "description": "The index of the ending character of the match", - "type": "integer" - }, - "text": { - "description": "The matched reference", - "type": "string" - }, - "linkFailed": { - "type": "boolean" - }, - "refs": { - "type": "array", - "items": { - "$ref": "#/components/schemas/ref" - } - } - } - } - }, - "refData": { - "type": "object", - "properties": { - "RefTitle": { - "type": "object", - "properties": { - "heRef": { - "description": "The Hebrew equivalent of the cannonical ref", - "type": "string" - }, - "url": { - "description": "The URL this ref can be found at on Sefaria", - "type": "string" - }, - "primaryCategory": { - "description": "The primary category this ref belongs to on Sefaria", - "type": "string" - } - } - } - } - } - } - }, - "body": { - "description": "Information about any references found in the `body` field of the POST request", - "type": "object", - "properties": { - "results": { - "type": "array", - "items": { - "description": "A single matched reference", - "type": "object", - "properties": { - "startChar": { - "format": "int32", - "description": "The index of the starting character of the match", - "type": "integer" - }, - "endChar": { - "format": "int32", - "description": "The index of the ending character of the match", - "type": "integer" - }, - "text": { - "description": "The matched reference", - "type": "string" - }, - "linkFailed": { - "type": "boolean" - }, - "refs": { - "type": "array", - "items": { - "$ref": "#/components/schemas/ref" - } - } - } - } - }, - "refData": { - "type": "object", - "properties": { - "RefTitle": { - "type": "object", - "properties": { - "heRef": { - "description": "The Hebrew equivalent of the cannonical ref", - "type": "string" - }, - "url": { - "description": "The URL this ref can be found at on Sefaria", - "type": "string" - }, - "primaryCategory": { - "description": "The primary category this ref belongs to on Sefaria", - "type": "string" - } - } - } - } - } - } - } - }, - "example": { - "title": { - "results": [ - { - "startChar": 23, - "endChar": 34, - "text": "Bereishit 1", - "linkFailed": false, - "refs": [ - "Genesis 1" - ] - } - ], - "refData": { - "Genesis 1": { - "heRef": "בראשית א׳", - "url": "Genesis.1", - "primaryCategory": "Tanakh" - } - } - }, - "body": { - "results": [ - { - "startChar": 0, - "endChar": 11, - "text": "Genesis 1:1", - "linkFailed": false, - "refs": [ - "Genesis 1:1" - ] - }, - { - "startChar": 35, - "endChar": 51, - "text": "Mishnah Peah 3-4", - "linkFailed": false, - "refs": [ - "Mishnah Peah 3-4" - ] - } - ], - "refData": { - "Genesis 1:1": { - "heRef": "בראשית א׳:א׳", - "url": "Genesis.1.1", - "primaryCategory": "Tanakh" - }, - "Mishnah Peah 3-4": { - "heRef": "משנה פאה ג׳-ד׳", - "url": "Mishnah_Peah.3-4", - "primaryCategory": "Mishnah" - } - } - } - } - }, - "CalendarAPIResponse": { - "title": "Root Type for CalendarAPIResponse", - "description": "A response from the Calendar API", - "type": "object", - "properties": { - "date": { - "format": "date", - "description": "The datestring for the calendars shown. It should match the values submitted in `year` `month` `day` or should be the current date.", - "type": "string" - }, - "timezone": { - "description": "An IANA timezone name", - "type": "string" - }, - "calendar_items": { - "type": "array", - "items": { - "description": "A single learning schedule for the selected date", - "type": "object", - "properties": { - "title": { - "description": "The learning schedule title in `he` and `en`", - "type": "object", - "properties": { - "en": { - "type": "string" - }, - "he": { - "type": "string" - } - }, - "example": "Daf Yomi" - }, - "displayValue": { - "description": "The name of the reading for the selected date in the learning schedule in `en` and `he`", - "type": "object", - "properties": { - "en": { - "type": "string" - }, - "he": { - "type": "string" - } - }, - "example": "Vayishlach" - }, - "url": { - "description": "The url path on Sefaria where this selection can be found", - "type": "string" - }, - "ref": { - "$ref": "#/components/schemas/ref" - }, - "heRef": { - "description": "The Hebrew equivalent of the `ref`", - "type": "string" - }, - "order": { - "format": "int32", - "description": "This is used internally on Sefaria to arrange the learning schedules in the manner we choose.", - "type": "integer" - }, - "category": { - "description": "The primary category that this `ref` belongs to", - "type": "string" - }, - "extraDetails": { - "description": "Additional details about this learning schedule entry", - "type": "object", - "properties": { - "aliyot": { - "description": "The breakdown of aliyot for a parashah", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "description": { - "description": "A description of this learning schedule entry if it exists in `he` and `en`", - "type": "object", - "properties": { - "en": { - "type": "string" - }, - "he": { - "type": "string" - } - } - } - } - } - } - }, - "example": { - "date": "2023-11-28", - "timezone": "America/Halifax", - "calendar_items": [ - { - "title": { - "en": "Parashat Hashavua", - "he": "פרשת השבוע" - }, - "displayValue": { - "en": "Vayishlach", - "he": "וישלח" - }, - "url": "Genesis.32.4-36.43", - "ref": "Genesis 32:4-36:43", - "heRef": "בראשית ל״ב:ד׳-ל״ו:מ״ג", - "order": 1, - "category": "Tanakh", - "extraDetails": { - "aliyot": [ - "Genesis 32:4-32:13", - "Genesis 32:14-32:30", - "Genesis 32:31-33:5", - "Genesis 33:6-33:20", - "Genesis 34:1-35:11", - "Genesis 35:12-36:19", - "Genesis 36:20-36:43", - "Genesis 36:40-36:43" - ] - }, - "description": { - "en": "Vayishlach (“He Sent”) follows Jacob and his family as Jacob wrestles with a man (commonly understood as an angel), is renamed Israel, and reconciles with his brother, Esau. Jacob’s daughter, Dina, is raped by a Hivite prince, and her brothers sack a city in response. Rachel dies as she gives birth to Jacob's youngest child, Benjamin.", - "he": "פרשת וישלח ממשיכה לעקוב אחרי יעקב ומשפחתו. יעקב נאבק עם איש (שלפי הפרשנות המקובלת הוא מלאך אלוהים), ובסיום המאבק האיש מעניק לו את השם ישראל. יעקב מתפייס עם אחיו עשו. דינה, בתו של יעקב, נאנסת ונשבית בידי נסיך חיווי, ואחיה הורגים את כל הזכרים בעיר ומשיבים אליהם את דינה. רחל מתה בשעת לידתו של בנימין, הצעיר בבני יעקב." - } - }, - { - "title": { - "en": "Haftarah", - "he": "הפטרה" - }, - "displayValue": { - "en": "Obadiah 1:1-21", - "he": "עובדיה א׳:א׳-כ״א" - }, - "url": "Obadiah.1.1-21", - "ref": "Obadiah 1:1-21", - "order": 2, - "category": "Tanakh" - }, - { - "title": { - "en": "Daf Yomi", - "he": "דף יומי" - }, - "displayValue": { - "en": "Bava Kamma 26", - "he": "בבא קמא כ״ו" - }, - "url": "Bava_Kamma.26", - "ref": "Bava Kamma 26", - "order": 3, - "category": "Talmud" - }, - { - "title": { - "en": "929", - "he": "929" - }, - "displayValue": { - "en": "Ezekiel 21 (473)", - "he": "יחזקאל כ״א (473)" - }, - "url": "Ezekiel.21", - "ref": "Ezekiel 21", - "order": 4, - "category": "Tanakh" - }, - { - "title": { - "en": "Daily Mishnah", - "he": "משנה יומית" - }, - "displayValue": { - "en": "Mishnah Yevamot 10:4-5", - "he": "משנה יבמות י׳:ד׳-ה׳" - }, - "url": "Mishnah_Yevamot.10.4-5", - "ref": "Mishnah Yevamot 10:4-5", - "order": 5, - "category": "Mishnah" - }, - { - "title": { - "en": "Daily Rambam", - "he": "הרמב\"ם היומי" - }, - "displayValue": { - "en": "Marriage 14", - "he": "הלכות אישות י״ד" - }, - "url": "Mishneh_Torah,_Marriage.14", - "ref": "Mishneh Torah, Marriage 14", - "order": 6, - "category": "Halakhah" - }, - { - "title": { - "en": "Daily Rambam (3 Chapters)", - "he": "הרמב\"ם היומי (3 פרקים)" - }, - "displayValue": { - "en": "Other Sources of Defilement 9-11", - "he": "הלכות שאר אבות הטומאות ט׳-י״א" - }, - "url": "Mishneh_Torah,_Other_Sources_of_Defilement.9-11", - "ref": "Mishneh Torah, Other Sources of Defilement 9-11", - "order": 7, - "category": "Halakhah" - }, - { - "title": { - "en": "Daf a Week", - "he": "דף השבוע" - }, - "displayValue": { - "en": "Ketubot 64", - "he": "כתובות ס״ד" - }, - "url": "Ketubot.64", - "ref": "Ketubot 64", - "order": 8, - "category": "Talmud" - }, - { - "title": { - "en": "Halakhah Yomit", - "he": "הלכה יומית" - }, - "displayValue": { - "en": "Shulchan Arukh, Orach Chayim 535:2-536:1", - "he": "שולחן ערוך, אורח חיים תקל״ה:ב׳-תקל״ו:א׳" - }, - "url": "Shulchan_Arukh,_Orach_Chayim.535.2-536.1", - "ref": "Shulchan Arukh, Orach Chayim 535:2-536:1", - "order": 9, - "category": "Halakhah" - }, - { - "title": { - "en": "Arukh HaShulchan Yomi", - "he": "ערוך השולחן היומי" - }, - "displayValue": { - "en": "Yoreh De'ah 191:7-15", - "he": "יורה דעה קצ״א:ז׳-ט״ו" - }, - "url": "Arukh_HaShulchan,_Yoreh_De'ah.191.7-15", - "ref": "Arukh HaShulchan, Yoreh De'ah 191:7-15", - "order": 10, - "category": "Halakhah" - }, - { - "title": { - "en": "Tanakh Yomi", - "he": "תנ\"ך יומי" - }, - "displayValue": { - "en": "Samuel Seder 17", - "he": "שמואל סדר יז" - }, - "url": "I_Samuel.25.33-26.24", - "ref": "I Samuel 25:33-26:24", - "order": 11, - "category": "Tanakh" - }, - { - "title": { - "en": "Chok LeYisrael", - "he": "חק לישראל" - }, - "displayValue": { - "en": "Vayishlach", - "he": "וישלח" - }, - "url": "collections/חק-לישראל?tag=Vayishlach", - "order": 12, - "category": "Tanakh" - }, - { - "title": { - "en": "Tanya Yomi", - "he": "תניא יומי" - }, - "displayValue": { - "en": "15 Kislev", - "he": "טו כסלו" - }, - "url": "Tanya,_Part_V;_Kuntres_Acharon.6.8", - "ref": "Tanya, Part V; Kuntres Acharon 6:8", - "order": 15, - "category": "Chasidut" - }, - { - "title": { - "en": "Yerushalmi Yomi", - "he": "ירושלמי יומי" - }, - "displayValue": { - "en": "Jerusalem Talmud Orlah 18", - "he": "תלמוד ירושלמי ערלה יח" - }, - "url": "Jerusalem_Talmud_Orlah.3.1.16-3.1", - "ref": "Jerusalem Talmud Orlah 3:1:16-3:1", - "order": 16, - "category": "Talmud" - } - ] - } - }, - "TopicJSON": { - "title": "Root Type for TopicJSON", - "description": "A JSON object containing all of the metadata for a topic object", - "required": [ - "slug", - "titles" - ], - "type": "object", - "properties": { - "slug": { - "description": "The unique slug for a given topic.", - "type": "string", - "example": "nachman-of-breslov" - }, - "titles": { - "description": "An array of JSON objects, each representing an alternative title for the object, in various languages. ", - "type": "array", - "items": { - "$ref": "#/components/schemas/TitlesJSON" - }, - "example": "\"titles\": [\n {\n \"text\": \"Tabernacles\",\n \"lang\": \"en\"\n },\n {\n \"text\": \"Succot\",\n \"lang\": \"en\"\n },\n {\n \"text\": \"Sukkos\",\n \"lang\": \"en\"\n },\n {\n \"text\": \"Succos\",\n \"lang\": \"en\"\n },\n {\n \"text\": \"Booths\",\n \"lang\": \"en\"\n },\n {\n \"text\": \"sukkot\",\n \"lang\": \"en\"\n },\n {\n \"text\": \"succot\",\n \"lang\": \"en\"\n },\n {\n \"text\": \"Succoth\",\n \"lang\": \"en\"\n },\n {\n \"text\": \"Sukkoth\",\n \"lang\": \"en\"\n },\n {\n \"text\": \"חג הסוכות\",\n \"lang\": \"he\"\n },\n {\n \"text\": \"סכות\",\n \"lang\": \"he\"\n },\n {\n \"text\": \"Sukkot\",\n \"lang\": \"en\",\n \"primary\": true\n },\n {\n \"text\": \"סוכות\",\n \"lang\": \"he\",\n \"primary\": true\n }\n]" - }, - "alt_ids": { - "description": "This is a dictionary containing the keys of naming schemes, and ids of this topic represented in that naming scheme. It’s used both for canonical names in other naming schemes and temporary storage of names when renaming slugs. All of the data here is for internal use, with the exception of the values `bfo` and `wikidata`. `bfo` refers to [basic formal ontology](https://developers.sefaria.org/docs/topic-ontology), and `wikidata` to the wikidata ontology of topics. ", - "type": "object", - "properties": { - "_temp_id": { - "type": "string" - } - }, - "example": "\"alt_ids\": {\n \"_temp_id\": \"משה\",\n \"wikidata\": \"Q9077\",\n \"_old_slug\": \"-75\"\n}" - }, - "properties": { - "$ref": "#/components/schemas/TopicPropertyJson", - "description": "The properties stores optional data relating to the topic, including links (if relevant) to where on can learn more about the topic. ", - "properties": { - "heNliLink": { - "type": "object", - "properties": { - "value": { - "type": "string" - }, - "dataSource": { - "type": "string" - } - } - }, - "enNliLink": { - "type": "object", - "properties": { - "value": { - "type": "string" - }, - "dataSource": { - "type": "string" - } - } - } - }, - "example": "\"properties\": {\n \"heNliLink\": {\n \"value\": \"https://www.nli.org.il/he/discover/judaism/holidays/sukkot\",\n \"dataSource\": \"sefaria\"\n },\n \"enNliLink\": {\n \"value\": \"https://www.nli.org.il/en/discover/judaism/holidays/sukkot\",\n \"dataSource\": \"sefaria\"\n }\n}" - }, - "description": { - "$ref": "#/components/schemas/BillingualJSON", - "description": "A description of the topic in English", - "properties": { - "en": { - "type": "string" - }, - "he": { - "type": "string" - } - }, - "example": "\"description\": {\n \"en\": \"Sukkot is a weeklong celebration of the harvest in early fall. It is celebrated by the building of temporary booths — that is, sukkot — outside homes in which people eat their meals and sometimes even sleep. The booths are reminders of the transience of life and the sheltering presence of God.\",\n \"he\": \"חג הסוכות, הוא חג האסיף, נמשך שבעה ימים ומצוין בחודש תשרי על-ידי בניית סוכה מחוץ לבית, בה אוכלים וחלק גם ישנים. הסוכה היא תזכורת לסוכות שבנו בני ישראל ביציאת מצרים, ומסמלת את ארעיות החיים ואת נוכחותו המגוננת של ה'\"\n}" - }, - "categoryDescription": { - "description": "A description of the category of this topic", - "type": "string" - }, - "displayOrder": { - "format": "int32", - "description": "The order in which topics are displayed on the Sefaria website, relative to other topics within their same category. ", - "type": "integer", - "example": "1" - }, - "numSources": { - "format": "int32", - "description": "The number of text sources associated with a topic. ", - "type": "integer", - "example": "831" - }, - "description_published": { - "description": "A boolean representing whether or not the description was published. ", - "type": "boolean", - "example": "true" - }, - "data_source": { - "description": "How the topic was generated, whether by Sefaria, a user on a source sheet, or some other source. ", - "type": "string", - "example": "`sefaria`" - }, - "image": { - "$ref": "#/components/schemas/TopicImgJSON", - "description": "Metadata for images associated with topics. ", - "properties": { - "image_uri": { - "type": "string" - }, - "image_caption": { - "type": "object", - "properties": { - "en": { - "type": "string" - }, - "he": { - "type": "string" - } - } - } - }, - "example": "\"image\": {\n \"image_uri\": \"https://storage.googleapis.com/img.sefaria.org/topics/sukkot.jpg\",\n \"image_caption\": {\n \"en\": \"Detail of a painting of a sukkah. Image taken from f. 316v of Forli Siddur. 1383, Italian rite. The British Library\",\n \"he\": \"פרט ציור של סוכה עם שולחן פרוש ושלוש דמויות. דימוי מתוך סידור פורלי, 1383 איטליה\"\n }\n}" - }, - "primaryTitle": { - "$ref": "#/components/schemas/BillingualJSON", - "description": "The primary title for a topic.", - "properties": { - "en": { - "type": "string" - }, - "he": { - "type": "string" - } - }, - "example": "{\n \"en\": \"Sukkot\",\n \"he\": \"סוכות\"\n}" - }, - "primaryTitleIsTransliteration": { - "$ref": "#/components/schemas/BillingualJSON", - "description": "This field has the possibility of being used to indicate whether or not a title is a transliteration, however the data here is not always consistent or up-to-date. Therefore, it is best to disregard the data in this field, and there are many false negatives. ", - "properties": { - "en": { - "type": "boolean" - }, - "he": { - "type": "boolean" - } - }, - "example": "\"primaryTitleIsTransliteration\": {\n \"en\": false,\n \"he\": false\n}" - } - }, - "example": { - "slug": "sukkot", - "titles": [ - { - "text": "Tabernacles", - "lang": "en" - }, - { - "text": "Succot", - "lang": "en" - }, - { - "text": "Sukkos", - "lang": "en" - }, - { - "text": "Succos", - "lang": "en" - }, - { - "text": "Booths", - "lang": "en" - }, - { - "text": "sukkot", - "lang": "en" - }, - { - "text": "succot", - "lang": "en" - }, - { - "text": "Succoth", - "lang": "en" - }, - { - "text": "Sukkoth", - "lang": "en" - }, - { - "text": "חג הסוכות", - "lang": "he" - }, - { - "text": "סכות", - "lang": "he" - }, - { - "text": "Sukkot", - "lang": "en", - "primary": true - }, - { - "text": "סוכות", - "lang": "he", - "primary": true - } - ], - "alt_ids": { - "_temp_id": "סוכות" - }, - "properties": { - "heNliLink": { - "value": "https://www.nli.org.il/he/discover/judaism/holidays/sukkot", - "dataSource": "sefaria" - }, - "enNliLink": { - "value": "https://www.nli.org.il/en/discover/judaism/holidays/sukkot", - "dataSource": "sefaria" - } - }, - "description": { - "en": "Sukkot is a weeklong celebration of the harvest in early fall. It is celebrated by the building of temporary booths — that is, sukkot — outside homes in which people eat their meals and sometimes even sleep. The booths are reminders of the transience of life and the sheltering presence of God.", - "he": "חג הסוכות, הוא חג האסיף, נמשך שבעה ימים ומצוין בחודש תשרי על-ידי בניית סוכה מחוץ לבית, בה אוכלים וחלק גם ישנים. הסוכה היא תזכורת לסוכות שבנו בני ישראל ביציאת מצרים, ומסמלת את ארעיות החיים ואת נוכחותו המגוננת של ה'" - }, - "categoryDescription": {}, - "displayOrder": 4, - "numSources": 831, - "description_published": true, - "data_source": "sefaria", - "image": { - "image_uri": "https://storage.googleapis.com/img.sefaria.org/topics/sukkot.jpg", - "image_caption": { - "en": "Detail of a painting of a sukkah. Image taken from f. 316v of Forli Siddur. 1383, Italian rite. The British Library", - "he": "פרט ציור של סוכה עם שולחן פרוש ושלוש דמויות. דימוי מתוך סידור פורלי, 1383 איטליה" - } - }, - "primaryTitle": { - "en": "Sukkot", - "he": "סוכות" - }, - "primaryTitleIsTransliteration": { - "en": false, - "he": false - } - } - }, - "TopicImgJSON": { - "title": "Root Type for TopicImgJSON", - "description": "A JSON object containing the image metadata for topics with images. ", - "type": "object", - "properties": { - "image_uri": { - "description": "The URL pointing to the image as hosted by Sefaria. ", - "type": "string", - "example": "https://storage.googleapis.com/img.sefaria.org/topics/sukkot.jpg" - }, - "image_caption": { - "$ref": "#/components/schemas/BillingualJSON", - "description": "A JSON object containing the billingual caption data for an image associated with a topic.", - "properties": { - "en": { - "type": "string" - }, - "he": { - "type": "string" - } - }, - "example": "\"image_caption\": {\n \"en\": \"Detail of a painting of a sukkah. Image taken from f. 316v of Forli Siddur. 1383, Italian rite. The British Library\",\n \"he\": \"פרט ציור של סוכה עם שולחן פרוש ושלוש דמויות. דימוי מתוך סידור פורלי, 1383 איטליה\"\n}" - } - }, - "example": { - "image_uri": "https://storage.googleapis.com/img.sefaria.org/topics/sukkot.jpg", - "image_caption": { - "en": "Detail of a painting of a sukkah. Image taken from f. 316v of Forli Siddur. 1383, Italian rite. The British Library", - "he": "פרט ציור של סוכה עם שולחן פרוש ושלוש דמויות. דימוי מתוך סידור פורלי, 1383 איטליה" - } - } - }, - "BillingualJSON": { - "title": "Root Type for TopicImgCaption", - "description": "A JSON object containing billingual text, both `he` and `en` parallel texts. ", - "type": "object", - "properties": { - "en": { - "description": "The English field for a JSON object representing billingual text. ", - "type": "string", - "example": "Detail of a painting of a sukkah. Image taken from f. 316v of Forli Siddur. 1383, Italian rite. The British Library" - }, - "he": { - "description": "The Hebrew field for a JSON object representing billingual text. ", - "type": "string", - "example": "פרט ציור של סוכה עם שולחן פרוש ושלוש דמויות. דימוי מתוך סידור פורלי, 1383 איטליה" - } - }, - "example": { - "en": "Detail of a painting of a sukkah. Image taken from f. 316v of Forli Siddur. 1383, Italian rite. The British Library", - "he": "פרט ציור של סוכה עם שולחן פרוש ושלוש דמויות. דימוי מתוך סידור פורלי, 1383 איטליה" - } - }, - "TopicPropertyJson": { - "title": "Root Type for TopicPropertyJson", - "description": "The JSON object containing information about a topic's properties", - "type": "object", - "properties": { - "heNliLink": { - "$ref": "#/components/schemas/NLILinkJSON", - "description": "A link to the Hebrew page on the website of the National Library of Israel which corresponds to the given topic, so users can learn more. ", - "properties": { - "value": { - "type": "string" - }, - "dataSource": { - "type": "string" - } - }, - "example": " \"heNliLink\": {\n \"value\": \"https://www.nli.org.il/he/discover/judaism/holidays/sukkot\",\n \"dataSource\": \"sefaria\"\n}" - }, - "enNliLink": { - "$ref": "#/components/schemas/NLILinkJSON", - "description": "A link to the English page on the website of the National Library of Israel which corresponds to the given topic, so users can learn more. ", - "properties": { - "value": { - "type": "string" - }, - "dataSource": { - "type": "string" - } - }, - "example": "\"enNliLink\": {\n \"value\": \"https://www.nli.org.il/en/discover/judaism/holidays/sukkot\",\n \"dataSource\": \"sefaria\"\n}" - } - }, - "example": { - "heNliLink": { - "value": "https://www.nli.org.il/he/discover/judaism/holidays/sukkot", - "dataSource": "sefaria" - }, - "enNliLink": { - "value": "https://www.nli.org.il/en/discover/judaism/holidays/sukkot", - "dataSource": "sefaria" - } - } - }, - "NLILinkJSON": { - "title": "Root Type for NLILinkJSON", - "description": "JSON for storing NLI links related to data in the Sefaria database. ", - "type": "object", - "properties": { - "value": { - "description": "A link to a corresponding NLI page to learn more. ", - "type": "string", - "example": "https://www.nli.org.il/en/discover/judaism/holidays/sukkot" - }, - "dataSource": { - "description": "The source of the topic data, whether user-created or Sefaria-created. ", - "type": "string", - "example": "`sefaria`" - } - }, - "example": { - "value": "https://www.nli.org.il/en/discover/judaism/holidays/sukkot", - "dataSource": "sefaria" - } - }, - "CalendarNextReadAPI": { - "title": "Root Type for CalendarNextReadAPI", - "description": "", - "type": "object", - "properties": { - "parasha": { - "type": "object", - "properties": { - "title": { - "description": "This should always read `Parashat Hashavua`", - "type": "object", - "properties": { - "en": { - "type": "string" - }, - "he": { - "type": "string" - } - }, - "example": "Daf Yomi" - }, - "displayValue": { - "description": "The name of the Parashah", - "type": "object", - "properties": { - "en": { - "type": "string" - }, - "he": { - "type": "string" - } - }, - "example": "Vayishlach" - }, - "url": { - "description": "The url path on Sefaria where this selection can be found", - "type": "string" - }, - "ref": { - "$ref": "#/components/schemas/ref" - }, - "heRef": { - "description": "The Hebrew equivalent of the `ref`", - "type": "string" - }, - "order": { - "format": "int32", - "description": "This is used internally on Sefaria to arrange the learning schedules in the manner we choose.", - "type": "integer" - }, - "category": { - "description": "Should always return `Tanakh`", - "type": "string" - }, - "extraDetails": { - "description": "Additional details about this learning schedule entry", - "type": "object", - "properties": { - "aliyot": { - "description": "The breakdown of aliyot for a parashah", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "description": { - "description": "A description of this learning schedule entry if it exists in `he` and `en`", - "type": "object", - "properties": { - "en": { - "type": "string" - }, - "he": { - "type": "string" - } - } - } - } - }, - "haftarah": { - "type": "array", - "items": { - "type": "object", - "properties": { - "title": { - "description": "This should always read `Haftarah`", - "type": "object", - "properties": { - "en": { - "type": "string" - }, - "he": { - "type": "string" - } - }, - "example": "Daf Yomi" - }, - "displayValue": { - "description": "The name of the Haftarah", - "type": "object", - "properties": { - "en": { - "type": "string" - }, - "he": { - "type": "string" - } - }, - "example": "Vayishlach" - }, - "url": { - "description": "The url path on Sefaria where this selection can be found", - "type": "string" - }, - "ref": { - "$ref": "#/components/schemas/ref" - }, - "order": { - "format": "int32", - "description": "This is used internally on Sefaria to arrange the learning schedules in the manner we choose.", - "type": "integer" - }, - "category": { - "description": "Should return `Tanakh`", - "type": "string" - } - } - } - }, - "date": { - "format": "date-time", - "type": "string" - }, - "he_date": { - "type": "object", - "properties": { - "en": { - "type": "string" - }, - "he": { - "type": "string" - } - } - } - }, - "example": { - "parasha": { - "title": { - "en": "Parashat Hashavua", - "he": "פרשת השבוע" - }, - "displayValue": { - "en": "Vayakhel-Pekudei", - "he": "ויקהל-פקודי" - }, - "url": "Exodus.35.1-40.38", - "ref": "Exodus 35:1-40:38", - "heRef": "שמות ל״ה:א׳-מ׳:ל״ח", - "order": 1, - "category": "Tanakh", - "extraDetails": { - "aliyot": [ - "Exodus 35:1-35:29", - "Exodus 35:30-37:16", - "Exodus 37:17-37:29", - "Exodus 38:1-39:1", - "Exodus 39:2-39:21", - "Exodus 39:22-39:43", - "Exodus 40:1-40:38", - "Exodus 12:1-12:20" - ] - }, - "description": { - "en": "Vayakhel (“He Assembled”) opens as God commands the Israelites to observe the Sabbath. Moses asks for material donations for the building of the Mishkan (Tabernacle), and the people donate. A group of artisans designated by God begin building the Mishkan and its vessels.\n\nPekudei (“Accountings Of”) is the final Torah reading in the Book of Exodus. It describes the making of priestly garments worn in the Mishkan (Tabernacle) and the completion of its construction. At God’s command, Moses erects the Mishkan and puts its vessels in place, and God's presence fills the Mishkan.", - "he": "בפרשת ויקהל בני ישראל מצווים לשמור את השבת. בני ישראל מתבקשים לתרום חומרים לבניית המשכן; הם נענים לבקשה בנדיבות ומתבקשים להפסיק לתרום. בצלאל ואהליאב מתחילים לנהל את בניית מבנה המשכן, כלי המשכן והחצר. כל פרט מבוצע כפי שציווה אלוהים את משה.\n\nפרשת פקודי, האחרונה בספר שמות, מסכמת את תרומות החומרים השונים למשכן, ואת עשיית בגדי הכהונה. בפרשה מתואר אירוע הקמת המשכן והכנסת הכלים לתוכו. משהושלמה בניית המשכן הענן מכסה את אוהל מועד, והשכינה שורה במשכן. ענן שוכן על המשכן ביום, ובלילה נראית בו אש, לעיני בני ישראל." - } - }, - "haftarah": [ - { - "title": { - "en": "Haftarah", - "he": "הפטרה" - }, - "displayValue": { - "en": "Ezekiel 45:16-46:18", - "he": "יחזקאל מ״ה:ט״ז-מ״ו:י״ח" - }, - "url": "Ezekiel.45.16-46.18", - "ref": "Ezekiel 45:16-46:18", - "order": 2, - "category": "Tanakh" - } - ], - "date": "2026-03-14T00:00:00", - "he_date": { - "en": "Adar 25, 5786", - "he": "אדר 25, 5786" - } - } - }, - "APIIndexResponse": { - "title": "Root Type for APIIndexResponse", - "description": "", - "type": "array", - "items": { - "type": "object", - "properties": { - "contents": { - "description": "This level of the object is a category listing.", - "type": "array", - "items": { - "type": "object", - "properties": { - "contents": { - "description": "This level of the object is usually a book level.", - "type": "array", - "items": { - "type": "object", - "properties": { - "categories": { - "description": "A list of categories that this book belongs to.", - "type": "array", - "items": { - "type": "string" - } - }, - "order": { - "format": "int32", - "description": "This is used to order the texts on the Sefaria website.", - "type": "integer" - }, - "primary_category": { - "description": "The main category that this work falls under.", - "type": "string" - }, - "enShortDesc": { - "description": "A short description of this book in English.", - "type": "string" - }, - "heShortDesc": { - "description": "A short description of this book in Hebrew.", - "type": "string" - }, - "corpus": { - "description": "The corpus that this work belongs to e.g. `Tanakh` or `Mishnah` etc.", - "type": "string" - }, - "heTitle": { - "description": "The Hebrew title of this work.", - "type": "string" - }, - "title": { - "description": "The English title of this work.", - "type": "string" - } - } - } - }, - "order": { - "format": "int32", - "description": "This is used to order the texts on the Sefaria website.", - "type": "integer" - }, - "enComplete": { - "description": "Is the entirety of this category available in English", - "type": "boolean" - }, - "heComplete": { - "description": "Is the entirety of this category available in Hebrew", - "type": "boolean" - }, - "enDesc": { - "description": "An English description of the category", - "type": "string" - }, - "heDesc": { - "description": "An Hebrew description of the category", - "type": "string" - }, - "enShortDesc": { - "description": "A short description of this category in English.", - "type": "string" - }, - "heShortDesc": { - "description": "A short description of this category in Hebrew.", - "type": "string" - }, - "heCategory": { - "type": "string" - }, - "category": { - "description": "The current category that these works are nested in.", - "type": "string" - } - } - } - }, - "order": { - "format": "int32", - "description": "This is used to order the categories on the Sefaria website.", - "type": "integer" - }, - "enComplete": { - "description": "Is the entirety of this category available in English", - "type": "boolean" - }, - "heComplete": { - "description": "Is the entirety of this category available in Hebrew", - "type": "boolean" - }, - "enDesc": { - "description": "An English description of the category", - "type": "string" - }, - "heDesc": { - "description": "An Hebrew description of the category", - "type": "string" - }, - "enShortDesc": { - "description": "A short description of this category in English.", - "type": "string" - }, - "heShortDesc": { - "description": "A short description of this category in Hebrew.", - "type": "string" - }, - "heCategory": { - "type": "string" - }, - "category": { - "description": "The current category that these works are nested in.", - "type": "string" - } - } - } - }, - "searchResponse": { - "title": "Root Type for searchResponse", - "description": "", - "type": "object", - "properties": { - "took": { - "format": "int32", - "type": "integer" - }, - "timed_out": { - "type": "boolean" - }, - "_shards": { - "type": "object", - "properties": { - "total": { - "format": "int32", - "type": "integer" - }, - "successful": { - "format": "int32", - "type": "integer" - }, - "skipped": { - "format": "int32", - "type": "integer" - }, - "failed": { - "format": "int32", - "type": "integer" - } - } - }, - "hits": { - "type": "object", - "properties": { - "total": { - "format": "int32", - "type": "integer" - }, - "max_score": { - "format": "double", - "type": "number" - }, - "hits": { - "type": "array", - "items": { - "type": "object", - "properties": { - "_index": { - "type": "string" - }, - "_type": { - "type": "string" - }, - "_id": { - "type": "string" - }, - "_score": { - "format": "double", - "type": "number" - }, - "_source": { - "type": "object", - "properties": { - "ref": { - "type": "string" - }, - "heRef": { - "type": "string" - }, - "version": { - "type": "string" - }, - "lang": { - "type": "string" - }, - "version_priority": { - "format": "int32", - "type": "integer" - }, - "titleVariants": { - "type": "array", - "items": { - "type": "string" - } - }, - "categories": { - "type": "array", - "items": { - "type": "string" - } - }, - "order": { - "type": "string" - }, - "path": { - "type": "string" - }, - "pagesheetrank": { - "format": "double", - "type": "number" - }, - "comp_date": { - "format": "int32", - "type": "integer" - }, - "exact": { - "type": "string" - }, - "naive_lemmatizer": { - "type": "string" - }, - "hebrew_version_title": { - "type": "string" - } - } - }, - "highlight": { - "type": "object", - "properties": { - "naive_lemmatizer": { - "type": "array", - "items": { - "type": "string" - } - } - } - } - } - } - } - } - }, - "aggregations": { - "type": "object", - "properties": { - "path": { - "type": "object", - "properties": { - "doc_count_error_upper_bound": { - "format": "int32", - "type": "integer" - }, - "sum_other_doc_count": { - "format": "int32", - "type": "integer" - }, - "buckets": { - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "type": "string" - }, - "doc_count": { - "format": "int32", - "type": "integer" - } - } - } - } - } - } - } - } - }, - "example": { - "took": 11, - "timed_out": false, - "_shards": { - "total": 5, - "successful": 5, - "skipped": 0, - "failed": 0 - }, - "hits": { - "total": 7, - "max_score": 16692.562, - "hits": [ - { - "_index": "text-b", - "_type": "text", - "_id": "Shabbat 73b:7 (Sefaria Community Translation [en])", - "_score": 16692.562, - "_source": { - "ref": "Shabbat 73b:7", - "heRef": "שבת ע״ג ב:ז׳", - "version": "Sefaria Community Translation", - "lang": "en", - "version_priority": 1, - "titleVariants": [ - "Masekhet Shabbat", - "Shabbos", - "Shabbath", - "Talmud Shabbat", - "Tractate Shabbat", - "Shab.", - "Sabb.", - "Sabbath", - "BT Shabbat", - "Shabbat" - ], - "categories": [ - "Talmud", - "Bavli", - "Seder Moed" - ], - "order": "A00200000100001460007", - "path": "Talmud/Bavli/Seder Moed/Shabbat", - "pagesheetrank": 769.444762983379, - "comp_date": 450, - "exact": "קוצר: harvest Rashi : Is דש = when the kernel falls from natural covering. This means that we can't peel banana... But we can if it's לאלתר - for immediate consumption. Tosphot : Is דש = when your removing something from natural connection ", - "naive_lemmatizer": "קוצר: harvest Rashi : Is דש = when the kernel falls from natural covering. This means that we can't peel banana... But we can if it's לאלתר - for immediate consumption. Tosphot : Is דש = when your removing something from natural connection ", - "hebrew_version_title": "תרגום קהילת ספריא" - }, - "highlight": { - "naive_lemmatizer": [ - "This means that we can't peel banana... But we can if it's לאלתר - for immediate consumption. Tosphot : Is דש = when your removing something from natural connection" - ] - } - }, - { - "_index": "text-b", - "_type": "text", - "_id": "II Samuel 18:12 (Sefaria Community Translation [en])", - "_score": 6415.7573, - "_source": { - "ref": "II Samuel 18:12", - "heRef": "שמואל ב י״ח:י״ב", - "version": "Sefaria Community Translation", - "lang": "en", - "version_priority": 8, - "titleVariants": [ - "2Sam", - "Second Samuel", - "Shmuel Bet", - "Shmuel II", - "Samuel II", - "2 Sam", - "II Shmuel", - "II Sam.", - "II Sam", - "2Sam.", - "2 Samuel", - "II Shemuel", - "2 Sam.", - "II. Samuel", - "II. Sam.", - "Sam. II", - "II Samuel" - ], - "categories": [ - "Tanakh", - "Prophets" - ], - "order": "A00000100300180012", - "path": "Tanakh/Prophets/II Samuel", - "pagesheetrank": 287.86486919568637, - "comp_date": -1000, - "exact": "And the dude said to Yoav: Bro, I just found the evil guy on a banana papaya tree. Let's go murder him ruthlessly, against the king's orders.", - "naive_lemmatizer": "And the dude said to Yoav: Bro, I just found the evil guy on a banana papaya tree. Let's go murder him ruthlessly, against the king's orders." - }, - "highlight": { - "naive_lemmatizer": [ - "And the dude said to Yoav: Bro, I just found the evil guy on a banana papaya tree. Let's go murder him ruthlessly, against the king's orders." - ] - } - }, - { - "_index": "text-b", - "_type": "text", - "_id": "English Explanation of Mishnah Maasrot 1:1:4 (Mishnah Yomit by Dr. Joshua Kulp [en])", - "_score": 36.80613, - "_source": { - "ref": "English Explanation of Mishnah Maasrot 1:1:4", - "heRef": "ביאור אנגלי על משנה מעשרות א׳:א׳:ד׳", - "version": "Mishnah Yomit by Dr. Joshua Kulp", - "lang": "en", - "version_priority": 0, - "titleVariants": [], - "categories": [ - "Mishnah Commentary", - "Modern Commentary on Mishnah", - "English Explanation of Mishnah", - "Seder Zeraim" - ], - "order": "A001008001000006002000100010004", - "path": "Mishnah Commentary/Modern Commentary on Mishnah/English Explanation of Mishnah/Seder Zeraim/English Explanation of Mishnah Maasrot", - "pagesheetrank": 1.44, - "comp_date": 1997, - "exact": " But whatever is not considered food in the earlier stages [of its growth] but only in its later stages, is not liable [to tithe] until it can be considered food. However, if the produce is not considered edible at its earlier stage of growth, if it is nevertheless harvested at this earlier stage, it can be eaten without being tithed. An example might be a banana. A banana harvested at an earlier stage is not considered food and therefore one who does eat such a banana need not tithe it. It would only need to be tithed if harvested when ripe.", - "naive_lemmatizer": " But whatever is not considered food in the earlier stages [of its growth] but only in its later stages, is not liable [to tithe] until it can be considered food. However, if the produce is not considered edible at its earlier stage of growth, if it is nevertheless harvested at this earlier stage, it can be eaten without being tithed. An example might be a banana. A banana harvested at an earlier stage is not considered food and therefore one who does eat such a banana need not tithe it. It would only need to be tithed if harvested when ripe." - }, - "highlight": { - "naive_lemmatizer": [ - "An example might be a banana. A banana harvested at an earlier stage is not considered food and therefore one who does eat such a banana need not tithe it." - ] - } - }, - { - "_index": "text-b", - "_type": "text", - "_id": "Kedushat Levi, Leviticus, Emor 11 (Kedushat Levi translated by Rb. Eliyahu Munk [en])", - "_score": 27.977217, - "_source": { - "ref": "Kedushat Levi, Leviticus, Emor 11", - "heRef": "קדושת לוי, ויקרא, אמור י״א", - "version": "Kedushat Levi translated by Rb. Eliyahu Munk", - "lang": "en", - "version_priority": 1, - "titleVariants": [ - "Emor", - "Parashat Emor", - "Parshat Emor" - ], - "categories": [ - "Chasidut", - "Early Works" - ], - "order": "A0090000010410011", - "path": "Chasidut/Early Works/Kedushat Levi", - "pagesheetrank": 4.840000000000001, - "comp_date": 1772, - "exact": "The sages in Rosh Hashanah 12 alluded to this when ‎they stated that “the Jewish people are in the habit of counting ‎Biblical calendar dates as based on the view of Rabbi Eliezer when ‎speaking of the deluge, , whereas they do so according ‎to the view of Rabbi Joshua when counting the seasons the ‎seasons of the year.” . The Talmud adds that the ‎astronomers of the gentile nations also count the deluge ‎according to the opinion held by Rabbi Joshua. [The whole ‎statement is extremely puzzling, our author contributing a novel ‎interpretation by understanding it as relating to the mystical ‎dimension of life on earth. Ed.] Our author raises the ‎question that seeing that the astronomers of the gentile nations ‎adopt an opinion that is contrary to halachah , how can they ‎be described as “sages of gentile nations?” We have a rule that ‎anyone contradicting what is written in the Torah or recorded as ‎wisdom by King Solomon is an absolute fool.‎ We need to explain above statement allegorically. We have ‎already explained in connection with a statement in the Talmud ‎‎ Pessachim 118 that when Rabbi Yishmael, son of Rabbi ‎Yossi, fell ill Rabbi Yehudah sent to ‎him asking him to tell them one or two Torah insights of his ‎father that he had not previously revealed. He responded by ‎offering an interpretation of a difficult passage in psalms 117,1 ‎where the psalmist appears to invite the nations of the world to ‎praise G’d, saying: ‎הללו את ה' כל גויים שבחוהו כל האומים‎, “praise the ‎Lord all you nations; extol Him all you peoples!” Seeing that the ‎next verse describes the miracles G’d has performed on behalf of ‎the Jewish people, what reason would the gentiles have to praise ‎G’d for this? He answered that if the gentiles are required to ‎praise the Lord for having been witnesses to miracles performed ‎for the Israelites, how much more so must the Israelites be duty ‎bound to praise Him on account of this! How much loving ‎kindness have we experienced at the hands of G’d without having ‎thanked Him adequately! Thereupon Rabbi asked for another ‎pearl of wisdom that Rabbi Yossi had not yet revealed. He told ‎them that at the time when the messiah would come, the gentiles ‎would welcome him with gifts. It seems clear that the words ‎שבחוהו‎, “praise Him,” in the psalm are not meant as ‎acknowledgement of what G’d had done for the gentiles, but for ‎what He had done for His people, the Israelites. It is the ‎overriding duty of all of G’d’s creatures, including the beasts in ‎the field to praise the Creator in accordance with the manner in ‎which they are capable of doing this. This includes even the flora ‎that appear tied to the place in which they grow, and which do ‎not even enjoy the ability to move freely on G’d’s earth. How ‎much more so must the more advanced forms of life on earth ‎praise their Creator, seeing that they are able to enjoy so much ‎more of the world they have been born into?‎ We may take a cue from the words of Rashi on ‎‎ Shabbat 50, “whatever G’d created, He created for the ‎greater glory of His name.” When Jews are killed for the ‎sanctification of the Lord’s name they do so joyfully.‎ It is therefore not difficult to comprehend that the psalmist ‎reminds the gentiles of their duty to praise the Lord as He has ‎given them an opportunity to carry out His will. Miracles which ‎G’d performed for the Israelites frequently were at the expense of ‎the gentiles who had oppressed them. The psalmist warns these ‎gentiles that they are obligated to praise the Lord for having been ‎privileged to experience His greatness even while they perish in ‎the process. The fact that they had been chosen to be G’d’s means ‎of showing His might to the Israelites is something they have to ‎acknowledge, not grudgingly, but joyfully. The fact that they ‎deliberately try to blind themselves to such recognition, stamps ‎them as utter fools. The perennial problem with fools is that they ‎do not wish to be enlightened, believing that they are wise.‎ However, there will come a time, when G’d will open the eyes ‎of the blind and all of them [those who have survived the ‎cataclysmic events occurring first, Ed.] will turn into ‎servants of the Lord. At the time of the Exodus, when G’d performed miracles that ‎enabled the Israelites to be redeemed, He revealed His power to ‎the Egyptians at the same time, of course. However, the latter, ‎almost until their last breath did not acknowledge that it was G’d ‎Who was fighting them when the waves of the sea of reeds came ‎crashing over them. ‎ The Jews have not always been better, so that Isaiah 2,5 tells ‎us that the time will come when –after the gentiles have already ‎acknowledged all this in Isaiah 2,3 – they too will experienced the ‎‎“light” of the Lord. In psalms 118 David foresees all this already ‎hundreds of years before the prophet Isaiah.‎ Let us revert to the passage in the Talmud Rosh ‎Hashanah 12, and the strange statement referring to the ‎astronomers of the gentiles as “sages.” Traditionally, the month ‎of Tishrey symbolizes that G’d’s attribute of Justice, sits in ‎judgment of His creatures on the first day of that month. The ‎month of Nissan, however symbolizes the attribute of Mercy, ‎loving kindness, as it is the month during which the Jewish ‎people, who had a minimum of merits to their credit, were ‎redeemed after hundreds of years of persecution. When looked at ‎from the perspective of the gentiles, the month of Nissan ‎symbolizes the attribute of Justice, as during that month G’d ‎brought retribution on the leading nation of the gentiles, ‎reducing a world power, Egypt, to becoming a “banana republic,” ‎practically overnight. The effect of this was so overwhelming that ‎Rahab from Jericho, who harbored Joshua’s spies, was still in awe ‎of that event. .‎ Rabbi Eliezer correctly realized that for the gentiles what we ‎perceive as unmitigated disaster, actually is the catalyst that ‎brings them to recognize G’d in the end, by seeing in the month ‎of Tishrey also a harbinger of the attribute of Mercy, seeing it is ‎the gentiles’ last opportunity to change their ways and survive as ‎servants of G’d. The Talmud introduces a reference to the period during ‎which the deluge occurred, i.e. in Marcheshvan, although neither ‎Rabbi Joshua nor Rabbi Eliezer had made reference to that event ‎at all. When the “sages” of the gentile nations are described as ‎taking their cue from the deluge as being in accord with Rabbi ‎Joshua, even when referring to the deluge, what the Talmud ‎means is that these “gentile sages” recognized that the disasters ‎that had struck them was also an outpouring of G’d’s love, as this ‎enabled the survivors to recognize G’d as a G’d of love after all. ‎‎ [According to the Talmud there the gentile sages ‎recognized what Yitro recognized later also, i.e. ‎that when G’d brings on retribution He makes the punishment fit ‎the crime. Ed.] ‎", - "naive_lemmatizer": "The sages in Rosh Hashanah 12 alluded to this when ‎they stated that “the Jewish people are in the habit of counting ‎Biblical calendar dates as based on the view of Rabbi Eliezer when ‎speaking of the deluge, , whereas they do so according ‎to the view of Rabbi Joshua when counting the seasons the ‎seasons of the year.” . The Talmud adds that the ‎astronomers of the gentile nations also count the deluge ‎according to the opinion held by Rabbi Joshua. [The whole ‎statement is extremely puzzling, our author contributing a novel ‎interpretation by understanding it as relating to the mystical ‎dimension of life on earth. Ed.] Our author raises the ‎question that seeing that the astronomers of the gentile nations ‎adopt an opinion that is contrary to halachah , how can they ‎be described as “sages of gentile nations?” We have a rule that ‎anyone contradicting what is written in the Torah or recorded as ‎wisdom by King Solomon is an absolute fool.‎ We need to explain above statement allegorically. We have ‎already explained in connection with a statement in the Talmud ‎‎ Pessachim 118 that when Rabbi Yishmael, son of Rabbi ‎Yossi, fell ill Rabbi Yehudah sent to ‎him asking him to tell them one or two Torah insights of his ‎father that he had not previously revealed. He responded by ‎offering an interpretation of a difficult passage in psalms 117,1 ‎where the psalmist appears to invite the nations of the world to ‎praise G’d, saying: ‎הללו את ה' כל גויים שבחוהו כל האומים‎, “praise the ‎Lord all you nations; extol Him all you peoples!” Seeing that the ‎next verse describes the miracles G’d has performed on behalf of ‎the Jewish people, what reason would the gentiles have to praise ‎G’d for this? He answered that if the gentiles are required to ‎praise the Lord for having been witnesses to miracles performed ‎for the Israelites, how much more so must the Israelites be duty ‎bound to praise Him on account of this! How much loving ‎kindness have we experienced at the hands of G’d without having ‎thanked Him adequately! Thereupon Rabbi asked for another ‎pearl of wisdom that Rabbi Yossi had not yet revealed. He told ‎them that at the time when the messiah would come, the gentiles ‎would welcome him with gifts. It seems clear that the words ‎שבחוהו‎, “praise Him,” in the psalm are not meant as ‎acknowledgement of what G’d had done for the gentiles, but for ‎what He had done for His people, the Israelites. It is the ‎overriding duty of all of G’d’s creatures, including the beasts in ‎the field to praise the Creator in accordance with the manner in ‎which they are capable of doing this. This includes even the flora ‎that appear tied to the place in which they grow, and which do ‎not even enjoy the ability to move freely on G’d’s earth. How ‎much more so must the more advanced forms of life on earth ‎praise their Creator, seeing that they are able to enjoy so much ‎more of the world they have been born into?‎ We may take a cue from the words of Rashi on ‎‎ Shabbat 50, “whatever G’d created, He created for the ‎greater glory of His name.” When Jews are killed for the ‎sanctification of the Lord’s name they do so joyfully.‎ It is therefore not difficult to comprehend that the psalmist ‎reminds the gentiles of their duty to praise the Lord as He has ‎given them an opportunity to carry out His will. Miracles which ‎G’d performed for the Israelites frequently were at the expense of ‎the gentiles who had oppressed them. The psalmist warns these ‎gentiles that they are obligated to praise the Lord for having been ‎privileged to experience His greatness even while they perish in ‎the process. The fact that they had been chosen to be G’d’s means ‎of showing His might to the Israelites is something they have to ‎acknowledge, not grudgingly, but joyfully. The fact that they ‎deliberately try to blind themselves to such recognition, stamps ‎them as utter fools. The perennial problem with fools is that they ‎do not wish to be enlightened, believing that they are wise.‎ However, there will come a time, when G’d will open the eyes ‎of the blind and all of them [those who have survived the ‎cataclysmic events occurring first, Ed.] will turn into ‎servants of the Lord. At the time of the Exodus, when G’d performed miracles that ‎enabled the Israelites to be redeemed, He revealed His power to ‎the Egyptians at the same time, of course. However, the latter, ‎almost until their last breath did not acknowledge that it was G’d ‎Who was fighting them when the waves of the sea of reeds came ‎crashing over them. ‎ The Jews have not always been better, so that Isaiah 2,5 tells ‎us that the time will come when –after the gentiles have already ‎acknowledged all this in Isaiah 2,3 – they too will experienced the ‎‎“light” of the Lord. In psalms 118 David foresees all this already ‎hundreds of years before the prophet Isaiah.‎ Let us revert to the passage in the Talmud Rosh ‎Hashanah 12, and the strange statement referring to the ‎astronomers of the gentiles as “sages.” Traditionally, the month ‎of Tishrey symbolizes that G’d’s attribute of Justice, sits in ‎judgment of His creatures on the first day of that month. The ‎month of Nissan, however symbolizes the attribute of Mercy, ‎loving kindness, as it is the month during which the Jewish ‎people, who had a minimum of merits to their credit, were ‎redeemed after hundreds of years of persecution. When looked at ‎from the perspective of the gentiles, the month of Nissan ‎symbolizes the attribute of Justice, as during that month G’d ‎brought retribution on the leading nation of the gentiles, ‎reducing a world power, Egypt, to becoming a “banana republic,” ‎practically overnight. The effect of this was so overwhelming that ‎Rahab from Jericho, who harbored Joshua’s spies, was still in awe ‎of that event. .‎ Rabbi Eliezer correctly realized that for the gentiles what we ‎perceive as unmitigated disaster, actually is the catalyst that ‎brings them to recognize G’d in the end, by seeing in the month ‎of Tishrey also a harbinger of the attribute of Mercy, seeing it is ‎the gentiles’ last opportunity to change their ways and survive as ‎servants of G’d. The Talmud introduces a reference to the period during ‎which the deluge occurred, i.e. in Marcheshvan, although neither ‎Rabbi Joshua nor Rabbi Eliezer had made reference to that event ‎at all. When the “sages” of the gentile nations are described as ‎taking their cue from the deluge as being in accord with Rabbi ‎Joshua, even when referring to the deluge, what the Talmud ‎means is that these “gentile sages” recognized that the disasters ‎that had struck them was also an outpouring of G’d’s love, as this ‎enabled the survivors to recognize G’d as a G’d of love after all. ‎‎ [According to the Talmud there the gentile sages ‎recognized what Yitro recognized later also, i.e. ‎that when G’d brings on retribution He makes the punishment fit ‎the crime. Ed.] ‎", - "hebrew_version_title": "קדושת לוי, מתורגם בידי רבי אליהו מונק" - }, - "highlight": { - "naive_lemmatizer": [ - "gentiles, the month of Nissan ‎symbolizes the attribute of Justice, as during that month G’d ‎brought retribution on the leading nation of the gentiles, ‎reducing a world power, Egypt, to becoming a “banana" - ] - } - }, - { - "_index": "text-b", - "_type": "text", - "_id": "Peninei Halakhah, Shabbat 12:2:3 (Peninei Halakhah, English ed. Yeshivat Har Bracha [en])", - "_score": 19.184504, - "_source": { - "ref": "Peninei Halakhah, Shabbat 12:2:3", - "heRef": "פניני הלכה, שבת י״ב:ב׳:ג׳", - "version": "Peninei Halakhah, English ed. Yeshivat Har Bracha", - "lang": "en", - "version_priority": 0, - "titleVariants": [], - "categories": [ - "Halakhah", - "Modern", - "Peninei Halakhah" - ], - "order": "A004014004010002001200020003", - "path": "Halakhah/Modern/Peninei Halakhah/Peninei Halakhah, Shabbat", - "pagesheetrank": 1.44, - "comp_date": 2007, - "exact": "May one mash foods like bananas and avocados? Some are stringent and forbid doing so with a fork, including for immediate consumption. Even the stringent opinion permits mashing these foods with a spoon, because that is considered a shinui. However, the lenient position allows mashing bananas and avocados even with a fork for immediate consumption, and the halakha follows this position. Thus one may mash a banana or avocado with a fork for immediate consumption. As we have already seen, the prohibition of Toḥen is not relevant to food being prepared for immediate consumption, as long as the mashing is not done with a special utensil designed for this purpose. 3 . There are several reasons for this permission:a) According to most poskim, the prohibition of Toḥen does not apply to fruits or vegetables that are edible .b) Even though SA 321:12 rules in accordance with those who are stringent, nevertheless, when the food is being prepared for immediate consumption, there is no prohibition .c) Even if the prohibition of Toḥen were applicable, according to Igrot Moshe 4:74, Toḥen2, since these foods remain a solid mass even after being mashed, Toḥen does not apply here at all.d) Mashing with a fork already constitutes a shinui, as this is not the normal way to grind . Yeḥaveh Da’at 5:27 and Menuḥat Ahava 2:8:12 permit this in practice. However, Ḥazon Ish OḤ §57 is stringent, and does not allow it even when the food being prepared will be consumed immediately. He also maintains that mashing is considered a type of Toḥen since it breaks down the structure of the fruit. He adds that if the mashing is done to feed the food to a baby, then it is prohibited based on MA 321:14, because it renders the food edible. SSK 6:1 and Hilkhot Shabbat Be-Shabbat 1:12:15 also state that one should be stringent. But they allow mashing with a spoon, as this definitely constitutes a shinui. Similarly, if the foods are very soft, then even those who are normally stringent allow mashing them with a fork. But in practice the primary position is the lenient one, as this is the position of practically all Rishonim.", - "naive_lemmatizer": "May one mash foods like bananas and avocados? Some are stringent and forbid doing so with a fork, including for immediate consumption. Even the stringent opinion permits mashing these foods with a spoon, because that is considered a shinui. However, the lenient position allows mashing bananas and avocados even with a fork for immediate consumption, and the halakha follows this position. Thus one may mash a banana or avocado with a fork for immediate consumption. As we have already seen, the prohibition of Toḥen is not relevant to food being prepared for immediate consumption, as long as the mashing is not done with a special utensil designed for this purpose. 3 . There are several reasons for this permission:a) According to most poskim, the prohibition of Toḥen does not apply to fruits or vegetables that are edible .b) Even though SA 321:12 rules in accordance with those who are stringent, nevertheless, when the food is being prepared for immediate consumption, there is no prohibition .c) Even if the prohibition of Toḥen were applicable, according to Igrot Moshe 4:74, Toḥen2, since these foods remain a solid mass even after being mashed, Toḥen does not apply here at all.d) Mashing with a fork already constitutes a shinui, as this is not the normal way to grind . Yeḥaveh Da’at 5:27 and Menuḥat Ahava 2:8:12 permit this in practice. However, Ḥazon Ish OḤ §57 is stringent, and does not allow it even when the food being prepared will be consumed immediately. He also maintains that mashing is considered a type of Toḥen since it breaks down the structure of the fruit. He adds that if the mashing is done to feed the food to a baby, then it is prohibited based on MA 321:14, because it renders the food edible. SSK 6:1 and Hilkhot Shabbat Be-Shabbat 1:12:15 also state that one should be stringent. But they allow mashing with a spoon, as this definitely constitutes a shinui. Similarly, if the foods are very soft, then even those who are normally stringent allow mashing them with a fork. But in practice the primary position is the lenient one, as this is the position of practically all Rishonim." - }, - "highlight": { - "naive_lemmatizer": [ - "Thus one may mash a banana or avocado with a fork for immediate consumption." - ] - } - }, - { - "_index": "text-b", - "_type": "text", - "_id": "Klein Dictionary, בָּנָנָה (Carta Jerusalem; 1st edition, 1987 [en])", - "_score": 1.032272, - "_source": { - "ref": "Klein Dictionary, בָּנָנָה", - "heRef": "מילון קליין, בָּנָנָה", - "version": "Carta Jerusalem; 1st edition, 1987", - "lang": "en", - "version_priority": 0, - "titleVariants": [ - "בָּנָנָה" - ], - "categories": [ - "Reference", - "Dictionary" - ], - "order": "A013000001B00729", - "path": "Reference/Dictionary/Klein Dictionary", - "pagesheetrank": 0.04000000000000001, - "comp_date": 1973, - "exact": " בָּנָנָה f.n. FW banana. [Sp. and Portuguese banana , from earlier Congolese banam .]", - "naive_lemmatizer": " בָּנָנָה f.n. FW banana. [Sp. and Portuguese banana , from earlier Congolese banam .]", - "hebrew_version_title": "כרטא תשמ״ז" - }, - "highlight": { - "naive_lemmatizer": [ - "FW banana. [Sp. and Portuguese banana , from earlier Congolese banam .]" - ] - } - }, - { - "_index": "text-b", - "_type": "text", - "_id": "Klein Dictionary, מוֹז (Carta Jerusalem; 1st edition, 1987 [en])", - "_score": 0.9270322, - "_source": { - "ref": "Klein Dictionary, מוֹז", - "heRef": "מילון קליין, מוֹז", - "version": "Carta Jerusalem; 1st edition, 1987", - "lang": "en", - "version_priority": 0, - "titleVariants": [ - "מוֹז" - ], - "categories": [ - "Reference", - "Dictionary" - ], - "order": "A013000001M00857", - "path": "Reference/Dictionary/Klein Dictionary", - "pagesheetrank": 0.04000000000000001, - "comp_date": 1973, - "exact": " מוֹז m.n. NH banana . [Introduced by Eliezer ben Yehudah as a loan word from Arab. mauz , which is related to Aram. מוֹזָא .]", - "naive_lemmatizer": " מוֹז m.n. NH banana . [Introduced by Eliezer ben Yehudah as a loan word from Arab. mauz , which is related to Aram. מוֹזָא .]", - "hebrew_version_title": "כרטא תשמ״ז" - }, - "highlight": { - "naive_lemmatizer": [ - "NH banana . [Introduced by Eliezer ben Yehudah as a loan word from Arab. mauz , which is related to Aram. מוֹזָא .]" - ] - } - } - ] - }, - "aggregations": { - "path": { - "doc_count_error_upper_bound": 0, - "sum_other_doc_count": 0, - "buckets": [ - { - "key": "Reference/Dictionary/Klein Dictionary", - "doc_count": 2 - }, - { - "key": "Chasidut/Early Works/Kedushat Levi", - "doc_count": 1 - }, - { - "key": "Halakhah/Modern/Peninei Halakhah/Peninei Halakhah, Shabbat", - "doc_count": 1 - }, - { - "key": "Mishnah Commentary/Modern Commentary on Mishnah/English Explanation of Mishnah/Seder Zeraim/English Explanation of Mishnah Maasrot", - "doc_count": 1 - }, - { - "key": "Talmud/Bavli/Seder Moed/Shabbat", - "doc_count": 1 - }, - { - "key": "Tanakh/Prophets/II Samuel", - "doc_count": 1 - } - ] - } - } - } - }, - "v3TextsJson": { - "title": "Root Type for v3TextsJson", - "description": "The JSON returned from the `v3` `texts/` endpoint. ", - "type": "object", - "properties": { - "versions": { - "description": "The list of requested `version` objects. It includes all the data that is unique to the requested `versions`. \n", - "type": "array", - "items": { - "$ref": "#/components/schemas/v3TextVersionsJSON" - }, - "example": "{\n\"status\": \"locked\",\n\"priority\": 2,\n\"license\": \"CC-BY-SA\",\n\"versionNotes\": \"Miqra According to the Masorah (MAM) is a digital Hebrew edition of the Tanakh based on the Aleppo Codex and related manuscripts. It is designed for readers, and as such it contains added elements to aid vocalization of the text. For instance: When an accent is marked in an unstressed syllable, an extra accent is added in the proper place (pashta, zarqa, segol, telisha). Legarmeih and paseq are visibly distinguished. Qamaz qatan is indicated by its designated Unicode character (alternatives are documented where traditions differ about its application).
The text of MAM is fully documented. The complete introduction to the edition (Hebrew) explains the types of editorial decisions that have been made and the reasons for them (English abstract). In addition, every word in the Bible about which there is some textual concern or ambiguity includes a documentation note; these notes can be viewed conveniently here. If an error is discovered, it may be reported to User:Dovi at Hebrew Wikisource. Please check the documentation notes before reporting an error.\",\n\"formatAsPoetry\": \"\",\n\"digitizedBySefaria\": \"\",\n\"method\": \"\",\n\"heversionSource\": \"\",\n\"versionUrl\": \"\",\n\"versionTitleInHebrew\": \"מקרא על פי המסורה\",\n\"versionNotesInHebrew\": \"\",\n\"shortVersionTitle\": \"\",\n\"shortVersionTitleInHebrew\": \"\",\n\"extendedNotes\": \"\",\n\"extendedNotesHebrew\": \"\",\n\"purchaseInformationImage\": \"\",\n\"purchaseInformationURL\": \"\",\n\"hasManuallyWrappedRefs\": \"\",\n\"actualLanguage\": \"he\",\n\"languageFamilyName\": \"hebrew\",\n\"isBaseText\": true,\n\"isSource\": true,\n\"isPrimary\": true,\n\"direction\": \"rtl\",\n\"language\": \"he\",\n\"versionSource\": \"https://he.wikisource.org/wiki/%D7%9E%D7%A9%D7%AA%D7%9E%D7%A9:Dovi/%D7%9E%D7%A7%D7%A8%D7%90_%D7%A2%D7%9C_%D7%A4%D7%99_%D7%94%D7%9E%D7%A1%D7%95%D7%A8%D7%94\",\n\"versionTitle\": \"Miqra according to the Masorah\",\n\"text\": [\n[\n\"חֲז֖וֹן עֹֽבַדְיָ֑ה כֹּֽה־אָמַר֩ אֲדֹנָ֨י יֱהֹוִ֜ה לֶאֱד֗וֹם שְׁמוּעָ֨ה שָׁמַ֜עְנוּ מֵאֵ֤ת יְהֹוָה֙ וְצִיר֙ בַּגּוֹיִ֣ם שֻׁלָּ֔ח ק֛וּמוּ וְנָק֥וּמָה עָלֶ֖יהָ לַמִּלְחָמָֽה׃\",\n\"הִנֵּ֥ה קָטֹ֛ן נְתַתִּ֖יךָ בַּגּוֹיִ֑ם בָּז֥וּי אַתָּ֖ה מְאֹֽד׃\",\n\"זְד֤וֹן לִבְּךָ֙ הִשִּׁיאֶ֔ךָ שֹׁכְנִ֥י בְחַגְוֵי־סֶ֖לַע מְר֣וֹם שִׁבְתּ֑וֹ אֹמֵ֣ר בְּלִבּ֔וֹ מִ֥י יוֹרִדֵ֖נִי אָֽרֶץ׃\",\n\"אִם־תַּגְבִּ֣יהַּ כַּנֶּ֔שֶׁר וְאִם־בֵּ֥ין כּֽוֹכָבִ֖ים שִׂ֣ים קִנֶּ֑ךָ מִשָּׁ֥ם אוֹרִֽידְךָ֖ נְאֻם־יְהֹוָֽה׃\",\n\"אִם־גַּנָּבִ֤ים בָּאֽוּ־לְךָ֙ אִם־שׁ֣וֹדְדֵי לַ֔יְלָה אֵ֣יךְ נִדְמֵ֔יתָה הֲל֥וֹא יִגְנְב֖וּ דַּיָּ֑ם אִם־בֹּֽצְרִים֙ בָּ֣אוּ לָ֔ךְ הֲל֖וֹא יַשְׁאִ֥ירוּ עֹלֵלֽוֹת׃\",\n\"אֵ֚יךְ נֶחְפְּשׂ֣וּ עֵשָׂ֔ו נִבְע֖וּ מַצְפֻּנָֽיו׃\",\n\"עַֽד־הַגְּב֣וּל שִׁלְּח֗וּךָ כֹּ֚ל אַנְשֵׁ֣י בְרִיתֶ֔ךָ הִשִּׁיא֛וּךָ יָכְל֥וּ לְךָ֖ אַנְשֵׁ֣י שְׁלֹמֶ֑ךָ לַחְמְךָ֗ יָשִׂ֤ימוּ מָזוֹר֙ תַּחְתֶּ֔יךָ אֵ֥ין תְּבוּנָ֖ה בּֽוֹ׃\",\n\"הֲל֛וֹא בַּיּ֥וֹם הַה֖וּא נְאֻם־יְהֹוָ֑ה וְהַאֲבַדְתִּ֤י חֲכָמִים֙ מֵֽאֱד֔וֹם וּתְבוּנָ֖ה מֵהַ֥ר עֵשָֽׂו׃\",\n\"וְחַתּ֥וּ גִבּוֹרֶ֖יךָ תֵּימָ֑ן לְמַ֧עַן יִכָּֽרֶת־אִ֛ישׁ מֵהַ֥ר עֵשָׂ֖ו מִקָּֽטֶל׃\",\n\"מֵחֲמַ֛ס אָחִ֥יךָ יַעֲקֹ֖ב תְּכַסְּךָ֣ בוּשָׁ֑ה וְנִכְרַ֖תָּ לְעוֹלָֽם׃\",\n\"בְּיוֹם֙ עֲמׇֽדְךָ֣ מִנֶּ֔גֶד בְּי֛וֹם שְׁב֥וֹת זָרִ֖ים חֵיל֑וֹ וְנׇכְרִ֞ים בָּ֣אוּ שְׁעָרָ֗ו וְעַל־יְרוּשָׁלַ֙͏ִם֙ יַדּ֣וּ גוֹרָ֔ל גַּם־אַתָּ֖ה כְּאַחַ֥ד מֵהֶֽם׃\",\n\"וְאַל־תֵּ֤רֶא בְיוֹם־אָחִ֙יךָ֙ בְּי֣וֹם נׇכְר֔וֹ וְאַל־תִּשְׂמַ֥ח לִבְנֵֽי־יְהוּדָ֖ה בְּי֣וֹם אׇבְדָ֑ם וְאַל־תַּגְדֵּ֥ל פִּ֖יךָ בְּי֥וֹם צָרָֽה׃\",\n\"אַל־תָּב֤וֹא בְשַֽׁעַר־עַמִּי֙ בְּי֣וֹם אֵידָ֔ם אַל־תֵּ֧רֶא גַם־אַתָּ֛ה בְּרָעָת֖וֹ בְּי֣וֹם אֵיד֑וֹ וְאַל־תִּשְׁלַ֥חְנָה בְחֵיל֖וֹ בְּי֥וֹם אֵידֽוֹ׃\",\n\"וְאַֽל־תַּעֲמֹד֙ עַל־הַפֶּ֔רֶק לְהַכְרִ֖ית אֶת־פְּלִיטָ֑יו וְאַל־תַּסְגֵּ֥ר שְׂרִידָ֖יו בְּי֥וֹם צָרָֽה׃\",\n\"כִּֽי־קָר֥וֹב יוֹם־יְהֹוָ֖ה עַל־כׇּל־הַגּוֹיִ֑ם כַּאֲשֶׁ֤ר עָשִׂ֙יתָ֙ יֵעָ֣שֶׂה לָּ֔ךְ גְּמֻלְךָ֖ יָשׁ֥וּב בְּרֹאשֶֽׁךָ׃\",\n\"כִּ֗י כַּֽאֲשֶׁ֤ר שְׁתִיתֶם֙ עַל־הַ֣ר קׇדְשִׁ֔י יִשְׁתּ֥וּ כׇֽל־הַגּוֹיִ֖ם תָּמִ֑יד וְשָׁת֣וּ וְלָע֔וּ וְהָי֖וּ כְּל֥וֹא הָיֽוּ׃\",\n\"וּבְהַ֥ר צִיּ֛וֹן תִּהְיֶ֥ה פְלֵיטָ֖ה וְהָ֣יָה קֹ֑דֶשׁ וְיָֽרְשׁוּ֙ בֵּ֣ית יַֽעֲקֹ֔ב אֵ֖ת מוֹרָֽשֵׁיהֶֽם׃\",\n\"וְהָיָה֩ בֵית־יַעֲקֹ֨ב אֵ֜שׁ וּבֵ֧ית יוֹסֵ֣ף לֶהָבָ֗ה וּבֵ֤ית עֵשָׂו֙ לְקַ֔שׁ וְדָלְק֥וּ בָהֶ֖ם וַאֲכָל֑וּם וְלֹֽא־יִֽהְיֶ֤ה שָׂרִיד֙ לְבֵ֣ית עֵשָׂ֔ו כִּ֥י יְהֹוָ֖ה דִּבֵּֽר׃\",\n\"וְיָרְשׁ֨וּ הַנֶּ֜גֶב אֶת־הַ֣ר עֵשָׂ֗ו וְהַשְּׁפֵלָה֙ אֶת־פְּלִשְׁתִּ֔ים וְיָרְשׁוּ֙ אֶת־שְׂדֵ֣ה אֶפְרַ֔יִם וְאֵ֖ת שְׂדֵ֣ה שֹׁמְר֑וֹן וּבִנְיָמִ֖ן אֶת־הַגִּלְעָֽד׃\",\n\"וְגָלֻ֣ת הַֽחֵל־הַ֠זֶּ֠ה לִבְנֵ֨י יִשְׂרָאֵ֤ל אֲשֶֽׁר־כְּנַעֲנִים֙ עַד־צָ֣רְפַ֔ת וְגָלֻ֥ת יְרוּשָׁלַ֖͏ִם אֲשֶׁ֣ר בִּסְפָרַ֑ד יִֽרְשׁ֕וּ אֵ֖ת עָרֵ֥י הַנֶּֽגֶב׃\",\n\"וְעָל֤וּ מֽוֹשִׁעִים֙ בְּהַ֣ר צִיּ֔וֹן לִשְׁפֹּ֖ט אֶת־הַ֣ר עֵשָׂ֑ו וְהָיְתָ֥ה לַֽיהֹוָ֖ה הַמְּלוּכָֽה׃\"\n]\n],\n\"firstSectionRef\": \"Obadiah 1\"}\n" - }, - "available_versions": { - "type": "array", - "items": { - "$ref": "#/components/schemas/v3AvailableVersionsTextJson" - } - }, - "ref": { - "$ref": "#/components/schemas/ref" - }, - "heRef": { - "description": "Hebrew `Ref` for the segment. ", - "type": "string" - }, - "sections": { - "description": "An array which corresponds to sectionNames and represents the sections of the text requested. When sectionNames is `[\"Chapter\", \"Verse\"]` a request for chapter 4 looks like `[4]` while a request for chapter 4, verse 7 would look like `[4, 7]`. _Note, for Talmud, Dafs are represented by a string like \"42a\" or \"12b\"_", - "type": "array", - "items": {} - }, - "toSections": { - "type": "array", - "items": {} - }, - "sectionRef": { - "$ref": "#/components/schemas/ref" - }, - "heSectionRef": { - "type": "string" - }, - "firstAvailableSectionRef": { - "type": "string" - }, - "isSpanning": { - "type": "boolean" - }, - "spanningRefs": { - "type": "array", - "items": {} - }, - "next": { - "description": "Next segment reference in sequence, if last ref, field will be `null`.", - "type": "string" - }, - "prev": { - "description": "Previous segment reference in sequence, if first ref, field will be `null`.", - "type": "string" - }, - "title": { - "description": "The title of the book these versions correspond to. ", - "type": "string" - }, - "book": { - "description": "The title of the book that the response comes from.", - "type": "string", - "example": "Esther" - }, - "heTitle": { - "type": "string" - }, - "primary_category": { - "type": "string" - }, - "type": { - "type": "string" - }, - "indexTitle": { - "description": "The book title", - "type": "string" - }, - "categories": { - "description": "A list of categories that a text belongs to. ", - "type": "array", - "items": { - "type": "string" - }, - "example": "[\n\"Tanakh\",\n\"Writings\"\n]" - }, - "heIndexTitle": { - "type": "string" - }, - "isComplex": { - "description": "Whether or not the text is a \"complex\" text or not.\n\nIn Sefaria, a complex text is any text which has a more complicated index structure beyond Chapters/Verses, (e.g. the Talmud). There are a variety of structural differences for a complex text, having to do primarily with its Index, and the way the data is stored. For more on complex texts, see the documentation here.", - "type": "boolean" - }, - "isDependant": { - "type": "boolean" - }, - "order": { - "type": "array", - "items": { - "format": "int32", - "type": "integer" - } - }, - "collectiveTitle": { - "description": "A shortened name of the Index for display in the connection panel (i.e. `Rashi on Genesis` will have a collective title of `Rashi`)", - "type": "string" - }, - "heCollectiveTitle": { - "description": "A Hebrew shortened name of the Index for display in the connection panel (i.e. `רש״י על בראשית` will have a collective title of `רש״י`)", - "type": "string" - }, - "alts": { - "type": "array", - "items": {} - }, - "lengths": { - "type": "array", - "items": { - "format": "int32", - "type": "integer" - } - }, - "length": { - "format": "int32", - "type": "integer" - }, - "textDepth": { - "format": "int32", - "description": "The depth of the text. For example, Genesis will have depth of `2`, since it is comprised of two layers, chapters and verses. Whereas a commentary on Genesis will have a depth of `3`, since it is organized by chapter, verse, and then specific comment on a verse. ", - "type": "integer" - }, - "sectionNames": { - "description": "An array containing the type names of the sections of this text. The length of sectionNames gives the depth of the structure of this text. For example, Kohelet `([\"Chapter\", \"Verse\"])` has depth 2, while Mishneh Torah `([\"Book\", \"Topic\", \"Section\", \"Law\"])` has depth 4. Comparing this depth to the depth of sections will show if the request was for the lowest level, or a higher level, of the text.", - "type": "array", - "items": { - "type": "string" - } - }, - "addressTypes": { - "description": "A list which length reflects the depth of the text structure, with string values indicating class names for address types for each level", - "type": "array", - "items": { - "type": "string" - }, - "example": "[\n\"Perek\",\n\"Pasuk\"\n]" - }, - "titleVariants": { - "description": "Various alternative titles used for the text. ", - "type": "array", - "items": { - "type": "string" - }, - "example": "[\n\"Est.\",\n\"Est\",\n\"Ester\",\n\"Esth.\",\n\"Esth\",\n\"Esther\"\n]" - }, - "heTitleVariants": { - "type": "array", - "items": { - "type": "string" - } - }, - "index_offsets_by_depth": { - "type": "object" - }, - "warnings": { - "description": "A list of objects - for any version parameter that has no result there is a readable message and warning code. \n\nCodes:\n`APINoVersion = 101`\n`APINoLanguageVersion = 102`\n`APINoSourceText = 103`\n`APINoTranslationText = 104`\n", - "type": "array", - "items": {}, - "example": "[\n{\n\"\\\"finnish\\\"\": {\n\"warning_code\": 102,\n\"message\": \"We do not have the language you asked for Esther 1:1. Available languages are ['english', 'esperanto', 'french', 'german', 'hebrew', 'italian', 'persian', 'polish', 'spanish', 'yiddish']\"\n}\n},\n{\n\"\\\"dutch\\\"\": {\n\"warning_code\": 102,\n\"message\": \"We do not have the language you asked for Esther 1:1. Available languages are ['english', 'esperanto', 'french', 'german', 'hebrew', 'italian', 'persian', 'polish', 'spanish', 'yiddish']\"\n}\n}\n]" - } - }, - "example": { - "versions": [ - { - "status": "locked", - "priority": 2, - "license": "CC-BY-SA", - "versionNotes": "Miqra According to the Masorah (MAM) is a digital Hebrew edition of the Tanakh based on the Aleppo Codex and related manuscripts. It is designed for readers, and as such it contains added elements to aid vocalization of the text. For instance: When an accent is marked in an unstressed syllable, an extra accent is added in the proper place (pashta, zarqa, segol, telisha). Legarmeih and paseq are visibly distinguished. Qamaz qatan is indicated by its designated Unicode character (alternatives are documented where traditions differ about its application).
The text of MAM is fully documented. The complete introduction to the edition (Hebrew) explains the types of editorial decisions that have been made and the reasons for them (English abstract). In addition, every word in the Bible about which there is some textual concern or ambiguity includes a documentation note; these notes can be viewed conveniently here. If an error is discovered, it may be reported to User:Dovi at Hebrew Wikisource. Please check the documentation notes before reporting an error.", - "formatAsPoetry": "", - "digitizedBySefaria": "", - "method": "", - "heversionSource": "", - "versionUrl": "", - "versionTitleInHebrew": "מקרא על פי המסורה", - "versionNotesInHebrew": "", - "shortVersionTitle": "", - "shortVersionTitleInHebrew": "", - "extendedNotes": "", - "extendedNotesHebrew": "", - "purchaseInformationImage": "", - "purchaseInformationURL": "", - "hasManuallyWrappedRefs": "", - "actualLanguage": "he", - "languageFamilyName": "hebrew", - "isBaseText": true, - "isSource": true, - "isPrimary": true, - "direction": "rtl", - "language": "he", - "versionSource": "https://he.wikisource.org/wiki/%D7%9E%D7%A9%D7%AA%D7%9E%D7%A9:Dovi/%D7%9E%D7%A7%D7%A8%D7%90_%D7%A2%D7%9C_%D7%A4%D7%99_%D7%94%D7%9E%D7%A1%D7%95%D7%A8%D7%94", - "versionTitle": "Miqra according to the Masorah", - "text": [], - "firstSectionRef": "Obadiah 1" - } - ], - "available_versions": [], - "ref": "Obadiah", - "heRef": "עובדיה", - "sections": [], - "toSections": [], - "sectionRef": "Obadiah", - "heSectionRef": "עובדיה", - "firstAvailableSectionRef": "Obadiah 1", - "isSpanning": false, - "spanningRefs": [], - "next": "Obadiah 1", - "prev": "Obadiah 1", - "title": "Obadiah", - "book": "Obadiah", - "heTitle": "עובדיה", - "primary_category": "Tanakh", - "type": "Tanakh", - "indexTitle": "Obadiah", - "categories": [ - "Tanakh", - "Prophets" - ], - "heIndexTitle": "עובדיה", - "isComplex": false, - "isDependant": false, - "order": [ - 18, - 13 - ], - "collectiveTitle": "", - "heCollectiveTitle": "", - "alts": [], - "lengths": [ - 1, - 21 - ], - "length": 1, - "textDepth": 2, - "sectionNames": [ - "Chapter", - "Verse" - ], - "addressTypes": [ - "Perek", - "Pasuk" - ], - "titleVariants": [ - "Ovadiah", - "Ob.", - "Oba.", - "Ovadyah", - "Ovadia", - "Ovadya", - "Abdias", - "Obad", - "Obadiah" - ], - "heTitleVariants": [ - "עובדיה" - ], - "index_offsets_by_depth": {}, - "warnings": [] - } - }, - "v3AvailableVersionsTextJson": { - "title": "Root Type for v3AvailableVersionsTextJson", - "description": "Data returned in the `available_versions` field of the `v3` `texts` API. This contains all of the available versions for a given text, not just the required versions. ", - "type": "object", - "allOf": [ - { - "type": "object", - "properties": { - "status": { - "type": "string" - }, - "priority": { - "format": "int32", - "type": "integer" - }, - "license": { - "type": "string" - }, - "versionNotes": { - "type": "string" - }, - "formatAsPoetry": { - "type": "string" - }, - "digitizedBySefaria": { - "type": "string" - }, - "method": { - "type": "string" - }, - "heversionSource": { - "type": "string" - }, - "versionUrl": { - "type": "string" - }, - "versionTitleInHebrew": { - "type": "string" - }, - "versionNotesInHebrew": { - "type": "string" - }, - "shortVersionTitle": { - "type": "string" - }, - "shortVersionTitleInHebrew": { - "type": "string" - }, - "extendedNotes": { - "type": "string" - }, - "extendedNotesHebrew": { - "type": "string" - }, - "purchaseInformationImage": { - "type": "string" - }, - "purchaseInformationURL": { - "type": "string" - }, - "hasManuallyWrappedRefs": { - "type": "string" - }, - "actualLanguage": { - "type": "string" - }, - "languageFamilyName": { - "description": "The overarching family for the specific language detailed in `actualLanguage`. For example, `Arabic` would be the overarching `languageFamily` for `judeo-arabic`.", - "type": "string" - }, - "isBaseText": { - "type": "string" - }, - "isSource": { - "type": "boolean" - }, - "isPrimary": { - "type": "string" - }, - "direction": { - "type": "string" - }, - "language": { - "type": "string" - }, - "title": { - "description": "The title of the book.", - "type": "string", - "example": "Esther" - }, - "versionSource": { - "type": "string" - }, - "versionTitle": { - "type": "string" - } - } - }, - { - "$ref": "#/components/schemas/v3TextVersionsJSON" - } - ], - "example": { - "status": "locked", - "priority": 3, - "license": "CC-BY-NC", - "versionNotes": "Read the Preface to the Revised JPS Edition\n

\nRead the Notes on Gender in Translation for the Revised JPS Edition\n

\nRead a Commentary on the Hebrew word ’ish in the Revised JPS Edition", - "formatAsPoetry": "", - "digitizedBySefaria": "", - "method": "", - "heversionSource": "", - "versionUrl": "", - "versionTitleInHebrew": "", - "versionNotesInHebrew": "", - "shortVersionTitle": "Revised JPS, 2023", - "shortVersionTitleInHebrew": "", - "extendedNotes": "", - "extendedNotesHebrew": "", - "purchaseInformationImage": "https://storage.googleapis.com/sefaria-physical-editions/JPS-Tanakh-Gender-Sensitive-Edition-Cover-300x450.jpg", - "purchaseInformationURL": "https://jps.org/books/the-jps-tanakh-gender-sensitive-edition/", - "hasManuallyWrappedRefs": "", - "actualLanguage": "en", - "languageFamilyName": "english", - "isBaseText": "", - "isSource": false, - "isPrimary": "", - "direction": "ltr", - "language": "en", - "title": "Obadiah", - "versionSource": "https://jps.org/books/the-jps-tanakh-gender-sensitive-edition/", - "versionTitle": "THE JPS TANAKH: Gender-Sensitive Edition" - } - }, - "v3TextVersionsJSON": { - "title": "Root Type for v3TextVersionsJSON", - "description": "", - "type": "object", - "properties": { - "status": { - "description": "Whether or not the text is `\"locked\"` for further edits from the community. ", - "type": "string" - }, - "priority": { - "format": "float", - "description": "The priority assigned to a version of the text. A higher number will have the text appear higher within the listing of available versions for a specific text on the Sefaria website. (i.e. `Esther A` with a priority of `2`, will appear before `Esther B`, with a priority of `1`)", - "type": "number" - }, - "license": { - "description": "The license for the text, in terms of copyright, and distribution. ", - "type": "string", - "example": "Public Domain" - }, - "versionNotes": { - "description": "Notes on the version", - "type": "string", - "example": "© Kehot Publication Society" - }, - "formatAsPoetry": { - "description": "A boolean indicating whether or not the text (or portions of it) are formatted as poetry.", - "type": "boolean" - }, - "digitizedBySefaria": { - "description": "An indicator of whether or not Sefaria digitized the text, versus acquiring an already digital copy of a text. ", - "type": "boolean" - }, - "method": { - "type": "string" - }, - "heversionSource": { - "type": "string" - }, - "versionUrl": { - "description": "URl for the version", - "type": "string" - }, - "versionTitleInHebrew": { - "type": "string" - }, - "versionNotesInHebrew": { - "type": "string" - }, - "shortVersionTitle": { - "type": "string" - }, - "shortVersionTitleInHebrew": { - "type": "string" - }, - "extendedNotes": { - "type": "string" - }, - "extendedNotesHebrew": { - "type": "string" - }, - "purchaseInformationImage": { - "description": "A URL pointing to an image of the hardcopy text available for purchase.", - "type": "string", - "example": "https://storage.googleapis.com/sefaria-physical-editions/touger-mishneh-torah-hilkhot-teshuvah-purchase-img.png" - }, - "purchaseInformationURL": { - "description": "A URL pointing to where one can purchase a hardcopy of this text. ", - "type": "string", - "example": "https://moznaim.com/products/mishneh-torah-rambam" - }, - "hasManuallyWrappedRefs": { - "type": "string" - }, - "actualLanguage": { - "description": "The [ISO 639-1](https://en.wikipedia.org/wiki/List_of_ISO_639_language_codes) language code for the language of the text. We default to 2 letter codes when available, and 3 letter codes when they are not.", - "type": "string", - "example": "de" - }, - "languageFamilyName": { - "description": "The overarching family for the specific language detailed in `actualLanguage`. For example, `Arabic` would be the overarching family for `judeo-arabic`. ", - "type": "string" - }, - "isBaseText": { - "description": "Indicates whether or not this text is the base for a commentary (i.e. `Genesis` is a base text for `Ramban on Genesis`)", - "type": "boolean" - }, - "isSource": { - "type": "boolean" - }, - "isPrimary": { - "description": "Indicates whether or not this version of the text is determined as the primary version in the Sefaria database.", - "type": "boolean" - }, - "direction": { - "description": "The direction of the text, either `ltr` (left-to-right) or `rtl` (right-to-left). Examples of `ltr` languages include English, French and German. Examples of `rtl` languages are Hebrew and Arabic. ", - "type": "string", - "example": "ltr" - }, - "language": { - "description": "A holdover from the `v2` API which will eventually be deprecated. This used to indicate the direction of the text, with `en` indicating texts written from left-to-right, and `he` indicating texting written from right-to-left. ", - "type": "string", - "example": "`he`\n`en`" - }, - "versionSource": { - "description": "The original source of the digital text. ", - "type": "string", - "example": "http://kehot.com/" - }, - "versionTitle": { - "description": "The English title of the Version of text. ", - "type": "string", - "example": "Mischnajot mit deutscher Übersetzung und Erklärung. Berlin 1887-1933 [de]" - }, - "text": { - "description": "An array of strings containing the text of the specific version. \n\nIf a segment `Ref` was passed, the array returned will be one-dimensional and contain a string with the specific segment level text. \n\nIf a bottom level section `Ref` was passed, the array returned will be a two-dimensional array, a list of lists of strings. The outer layer of the array represents the section, and the inner arrays represent the segments. ", - "type": "array", - "items": { - "type": "string" - }, - "example": "[\n[\n\"Von welcher Zeit ab liest man das Schema. Zu Schema wird Deuter. 6, 4—9 שמע , 2. Deuter. 11, 13—21 והיה אם שמוע und 3. Numeri 15, 37—41 ויאמר gerechnet.\",\n\"da die Priester eintreten. Nämlich unreine Priester, welche nicht gebadet und gereinigt hatten und erst mit dem Erscheinen der Sterne ihre Hebe essen durften (Lev. 22, 7).\",\n\"bis zu Ende der ersten Nachtwache. Man teilte die Nacht in drei Wachen.\",\n\"Die Weisen. So oft hier der Ausdruck die Weisen vorkommt, verstehe man darunter die große Mehrzahl der Weisen, sofern sie nach allgemein geltender Ansicht entscheidet.\",\n\"Bis die Morgenröte. Säule der Morgenröte im Hebr. und Arab.\",\n\"aufsteigt. Der Grund der Meinungsverschiedenheit liegt in der Deutung des ובשכבך . R. Elieser erklärt: Wenn du dich niederlegst; dies geschieht bei den meisten Menschen bis Ende der ersten Nachtwache. Nach den Weisen und so auch nach R. Gamliel heißt ובשכבך , wenn du liegst; demnach wäre es die ganze Nacht erlaubt das Schema zu lesen, jedoch die Weisen erlauben es nur bis Mitternacht, um der Gesetzesübertretung vorzubeugen, was R. Gamliel nicht für nötig hält.\",\n\"Das Aufdampfen des Fettes und der Glieder. Stücke der Opfertiere, (Lev. 6, 2; 7, 2.)\",\n\"nur an demselben Tage gegessen werden darf. D. h. am Tage der Darbringung (Lev. 7, 15).\",\n\"Um die Menschen von der Übertretung fern zu halten. Nämlich, sie setzten eine kürzere Frist, damit man sich auf keinen Fall verspäte.\"\n],\n[\n\"Sobald man zwischen himmelblau und weiß unterscheiden kann; R. Elieser sagt: Zwischen himmelblau und lauchgrün; (und beendet das Lesen. וגומרה , wenn die Lesart richtig ist, bezieht es sich auf פרשת שמע .\",\n\"erst um drei Stunden aufzustehen. Das Gesetz ובקומך meint er, bedeute »bis Jedermann aufgestanden ist.« — Die Stunden sind hier je nach der Jahreszeit von verschiedener Länge; denn man teilte den Tag und die Nacht in je 12 Teile. Wenn also z. B. der Tag 8 und die Nacht 16 Stunden hat, so wird die Tagesstunde zu 8/12 gewöhnliche Stunden = 40 Minuten, die Nachtstunde aber zu 16/12 gewöhnliche Stunden = 80 Minuten gerechnet. Solche Stunden werden שעות זמניות = Zeitstunden genannt\",\n\"büsst nichts ein. D. h. er möge immerhin die dazu gehörigen Vor- und Nachgebete sprechen (nach Einigen jedoch nur bis Ende der. 4. Stunde) obgleich deren Zeit vorüber ist.\"\n],\n[\n\"brachte mich aber in Lebensgefahr durch Räuber. Wäre beinahe von Räubern getötet worden.\"\n],\n[\n\"Am Morgen spricht man zwei Segenssprüche voran. לפניה bezieht sich auf פרשת שמע .\",\n\"und zwei nachher. Nämlich des Morgens אהבה רבה ,יוצר אור und גאולה Des Abends מעריב גאולה ,אהבת עולם ,ערבים und השכיבנו .\",\n\"eine Schlussformel anzubringen. Die ganze Stelle von מקום שאמרו an wird hier als ein allgemeines, auf alle anderen ברכות sich auch beziehendes Gesetz mit eingeschaltet. — Unter Schlussformel versteht man einen mit ברוך anfangenden Satz, der das Ganze schliesst. Z. B. ברוך אתה ה׳ גאל ישראל .\"\n],\n[\n\"Man gedenke des Auszuges aus Ägypten auch in der Nachtzeit. D. h. es ist Pflicht auch in der Nacht פרשת ציצית zu sprechen, weil darin des Auszuges Erwähnung geschieht.\",\n\"Ich bin jetzt beinah. So nach einer Baraita im Jeruschalmi. Der babylonische Talmud jedoch sagt: R. Elasar ben Asarja sei damals nur 18 Jahre alt, aber bereits grau gewesen, wie ein Greis von siebzig Jahren. Nach Maimonides ist er durch vieles Studieren grau geworden.\"\n]\n]" - }, - "firstSectionRef": { - "description": "The first available `Ref` to the section of text passed in the API. ", - "type": "string" - } - }, - "example": { - "status": "locked", - "priority": 2, - "license": "CC-BY-SA", - "versionNotes": "Miqra According to the Masorah (MAM) is a digital Hebrew edition of the Tanakh based on the Aleppo Codex and related manuscripts. It is designed for readers, and as such it contains added elements to aid vocalization of the text. For instance: When an accent is marked in an unstressed syllable, an extra accent is added in the proper place (pashta, zarqa, segol, telisha). Legarmeih and paseq are visibly distinguished. Qamaz qatan is indicated by its designated Unicode character (alternatives are documented where traditions differ about its application).
The text of MAM is fully documented. The complete introduction to the edition (Hebrew) explains the types of editorial decisions that have been made and the reasons for them (English abstract). In addition, every word in the Bible about which there is some textual concern or ambiguity includes a documentation note; these notes can be viewed conveniently here. If an error is discovered, it may be reported to User:Dovi at Hebrew Wikisource. Please check the documentation notes before reporting an error.", - "formatAsPoetry": "", - "digitizedBySefaria": "", - "method": "", - "heversionSource": "", - "versionUrl": "", - "versionTitleInHebrew": "מקרא על פי המסורה", - "versionNotesInHebrew": "", - "shortVersionTitle": "", - "shortVersionTitleInHebrew": "", - "extendedNotes": "", - "extendedNotesHebrew": "", - "purchaseInformationImage": "", - "purchaseInformationURL": "", - "hasManuallyWrappedRefs": "", - "actualLanguage": "he", - "languageFamilyName": "hebrew", - "isBaseText": true, - "isSource": true, - "isPrimary": true, - "direction": "rtl", - "language": "he", - "versionSource": "https://he.wikisource.org/wiki/%D7%9E%D7%A9%D7%AA%D7%9E%D7%A9:Dovi/%D7%9E%D7%A7%D7%A8%D7%90_%D7%A2%D7%9C_%D7%A4%D7%99_%D7%94%D7%9E%D7%A1%D7%95%D7%A8%D7%94", - "versionTitle": "Miqra according to the Masorah", - "text": [], - "firstSectionRef": "Obadiah 1" - } - }, - "LinkObj": { - "title": "Root Type for LinkObj", - "description": "A single link returned by the link (and related[?]) APIs", - "type": "object", - "properties": { - "_id": { - "type": "string" - }, - "index_title": { - "description": "The cannonical title of the text in the Sefaria library.", - "type": "string" - }, - "category": { - "description": "The primary category this ref belongs to on Sefaria.", - "type": "string" - }, - "type": { - "description": "An arbitrary string assigned to the connection to identify it. Most commonly `commentary`, `reference`, or an empty string. ", - "type": "string" - }, - "ref": { - "$ref": "#/components/schemas/ref" - }, - "anchorRef": { - "description": "The submitted `ref` in the GET request at times may fall within a more encompassing ranged ref that includes multiple text segments. The `anchorRef` is that complete range the that the link is associated with, and will contain within it the specific `ref` that was passed. ", - "type": "string", - "example": "\"Esther 3:15-4:17\"" - }, - "anchorRefExpanded": { - "description": "An array of strings, where each string is a segment level `ref` of the `ref` passed in as a parameter. If a segment level `ref` is passed in, this array will have a length of 1, and only contain that segment level `ref`. If the `ref` passed in is ranged, this array will contain each of the segment level `ref`s within that range. \n\nFor example, if someone was searching for links for `Esther 4.14-15`, the `anchorRefExpanded` would contain `Esther 4.14` and `Esther 4.15`.", - "minItems": 1, - "uniqueItems": true, - "type": "array", - "items": { - "type": "string" - }, - "example": "\"anchorRefExpanded\": [\n \"Esther 4:14\",\n \"Esther 4:15\"\n]" - }, - "sourceRef": { - "$ref": "#/components/schemas/ref", - "description": "The connecting link for the submitted `ref`" - }, - "sourceHeRef": { - "$ref": "#/components/schemas/ref" - }, - "anchorVerse": { - "format": "int32", - "type": "integer" - }, - "sourceHasEn": { - "type": "boolean" - }, - "compDate": { - "description": "The estimated year of completion of the work according to the Gregorian calendar. If its length is zero the completion date is unknown. If its length is one, then the completion date is that single year. If its length is 2 then the date is a potential range with the first int in the array is the lower end of the range and the latter the higher. ", - "type": "array", - "items": { - "format": "int32", - "type": "integer" - } - }, - "commentaryNum": { - "format": "double", - "type": "number" - }, - "collectiveTitle": { - "type": "object", - "properties": { - "en": { - "type": "string" - }, - "he": { - "type": "string" - } - } - }, - "he": { - "description": "The default text written in RTL characters for the query (Usually Hebrew). It is structured as a JaggedArray (nested arrays), with the lowest level being an array of strings with some html text.\n", - "type": "string" - }, - "heVersionTitle": { - "description": "The title of the work in English for where the default `he` text came from.", - "type": "string" - }, - "heLicense": { - "description": "A string of text documenting the license for the text in Hebrew.", - "type": "string" - }, - "heVersionTitleInHebrew": { - "description": "The title of the work in Hebrew for where the default `he` text came from.", - "type": "string" - }, - "text": { - "description": "The default text written in LTR characters for the query (Usually English). It is structured as a JaggedArray (nested arrays), with the lowest level being an array of strings with some html text.", - "type": "array", - "items": {} - }, - "versionTitle": { - "description": "A descriptive string which describes what version of a text this is. Is it from a particular printing or edition of a book? An online resource? This string should describe it in English", - "type": "string" - }, - "license": { - "description": "A string of text documenting the license for the text in English.", - "type": "string" - }, - "versionTitleInHebrew": { - "description": "A descriptive string which describes what version of a text this is. Is it from a particular printing or edition of a book? An online resource? This string should describe it in Hebrew.", - "type": "string" - } - }, - "example": { - "_id": "578b4ad1d6e4a90d260c2d9a", - "index_title": "Tosafot Yom Tov on Mishnah Peah", - "category": "Commentary", - "type": "commentary", - "ref": "Tosafot Yom Tov on Mishnah Peah 4:2:1", - "anchorRef": "Mishnah Peah 4:2", - "anchorRefExpanded": [ - "Mishnah Peah 4:2" - ], - "sourceRef": "Tosafot Yom Tov on Mishnah Peah 4:2:1", - "sourceHeRef": "תוספות יום טוב על משנה פאה ד׳:ב׳:א׳", - "anchorVerse": 2, - "sourceHasEn": false, - "compDate": [ - 1613, - 1617 - ], - "commentaryNum": 2.0001, - "collectiveTitle": { - "en": "Tosafot Yom Tov", - "he": "תוספות יום טוב" - }, - "he": "[*ואחד אומר לחלק לזה שומעין וכו'. שאפילו הוא זקן ותש כח או חולה שהרי מה שאמר לחלק מפני חלישותו הוא אפילו הכי שומעין לו כך מצאתי בפירוש הנ\"ל]: \n", - "heVersionTitle": "Mishnah, ed. Romm, Vilna 1913", - "heLicense": "Public Domain", - "heVersionTitleInHebrew": "משנה, מהדורת בית דפוס ראם, וילנא 1913", - "text": [] - } - }, - "TopicGraphJSON": { - "title": "Root Type for TopicGraphJSON", - "description": "", - "type": "object", - "properties": { - "topics": { - "description": "Array of topics", - "type": "array", - "items": { - "$ref": "#/components/schemas/TopicJSON" - }, - "example": "{\n\"slug\": \"shabbat-shuvah\",\n\"titles\": [\n{\n\"text\": \"Shabbat Shuvah\",\n\"lang\": \"en\",\n\"primary\": true\n},\n{\n\"text\": \"שבת שובה\",\n\"lang\": \"he\",\n\"primary\": true\n},\n{\n\"lang\": \"he\",\n\"text\": \"שובה\"\n}\n],\n\"alt_ids\": {\n\"_temp_id\": \"שבת שובה\",\n\"_old_slug\": \"399\"\n},\n\"description\": {\n\"en\": \"Shabbat of Repentance between Rosh Hashanah and Yom Kippur.\",\n\"he\": \"\"\n},\n\"numSources\": 19,\n\"primaryTitle\": {\n\"en\": \"Shabbat Shuvah\",\n\"he\": \"שבת שובה\"\n}\n}" - }, - "links": { - "type": "array", - "items": { - "$ref": "#/components/schemas/TopicGraphLinkJSON" - } - } - }, - "example": { - "topics": [ - { - "slug": "shabbat", - "titles": [], - "alt_ids": { - "_temp_id": "שבת", - "_old_slug": "shabbat1" - }, - "properties": { - "heNliLink": { - "value": "https://www.nli.org.il/he/discover/judaism/traditions/shabbat", - "dataSource": "sefaria" - } - }, - "description": { - "en": "Shabbat (or Sabbath) falls every seventh day of the week, from Friday just before sunset until dark on Saturday night. It is a day of rest, marking the time when God stopped creating after after the six days of creation. Shabbat recognizes God as Creator of the Universe and as Redeemer of Israel from Egypt. ", - "he": "היום השביעי בשבוע, החל מיום שישי בשעת השקיעה ועד צאת הכוכבים במוצאי השבת. יום מנוחה לפי המקורות, המציין את הזמן שבו ה' נח לאחר שברא את העולם. " - }, - "categoryDescription": {}, - "displayOrder": 0, - "numSources": 1662, - "good_to_promote": true, - "description_published": true, - "data_source": "sefaria", - "image": { - "image_uri": "https://storage.googleapis.com/img.sefaria.org/topics/shabbat.jpg", - "image_caption": { - "en": "Friday Evening, Isidor Kaufmann, Austria c. 1920. The Jewish Museum, Gift of Mr. and Mrs. M. R. Schweitzer", - "he": "שישי בערב, איזידור קאופמן, וינה 1920. המוזיאון היהודי בניו יורק, מתנת מר וגברת מ.ר. שוויצר" - } - }, - "primaryTitle": { - "en": "Shabbat", - "he": "שבת" - } - }, - { - "slug": "shabbat-shuvah", - "titles": [ - { - "text": "Shabbat Shuvah", - "lang": "en", - "primary": true - }, - { - "text": "שבת שובה", - "lang": "he", - "primary": true - }, - { - "lang": "he", - "text": "שובה" - } - ], - "alt_ids": { - "_temp_id": "שבת שובה", - "_old_slug": "399" - }, - "description": { - "en": "Shabbat of Repentance between Rosh Hashanah and Yom Kippur.", - "he": "" - }, - "numSources": 19, - "primaryTitle": { - "en": "Shabbat Shuvah", - "he": "שבת שובה" - } - }, - { - "slug": "shabbat-hagadol", - "titles": [ - { - "text": "Shabbat HaGadol", - "lang": "en" - }, - { - "text": "Shabbat Hagadol", - "lang": "en", - "primary": true - }, - { - "text": "שבת הגדול", - "lang": "he", - "primary": true - } - ], - "alt_ids": { - "_temp_id": "שבת הגדול" - }, - "description": { - "en": "Shabbat HaGadol (“The Great Shabbat”) is the Shabbat that immediately precedes the holiday of Passover. Jewish texts offer many explanations as to why this Shabbat is called “great,” like those that point to a great miracle performed on this Shabbat during the exodus, or those that point to the word “great” at the end of the haftarah prophetic reading traditionally read on this Shabbat. In many communities, the rabbi delivers a lengthy sermon on a Passover-related topic. ", - "he": "״שבת הגדול״ היא השבת האחרונה לפני חג הפסח. שבת זו נודעה כשבת מיוחדת החל מהמאה ה-12 בבתי המדרש של רש״י וחכמי התוספות. מנהגי שבת זו כוללים דרשה של הרב בקהילתו בהלכות הפסח, וקריאת קטעים מההגדה של פסח. מספר טעמים ניתנו לשמה של שבת זו כגון שבשבת זו בני ישראל הפסיקו לעבוד עבודה זרה, או שהיה נס גדול בלקיחת השה לקרבן פסח, ועוד. " - }, - "categoryDescription": {}, - "displayOrder": 230, - "numSources": 57, - "description_published": true, - "data_source": "sefaria", - "primaryTitle": { - "en": "Shabbat Hagadol", - "he": "שבת הגדול" - } - } - ], - "links": [ - { - "toTopic": "shabbat", - "linkType": "is-a", - "class": "intraTopic", - "dataSource": "aspaklaria-edited-by-sefaria", - "fromTopic": "shabbat-shuvah", - "order": { - "linksInCommon": 0, - "toTfidf": 0, - "fromTfidf": 0 - } - }, - { - "toTopic": "shabbat", - "linkType": "is-a", - "class": "intraTopic", - "dataSource": "aspaklaria-edited-by-sefaria", - "fromTopic": "shabbat-hagadol", - "order": { - "linksInCommon": 1, - "toTfidf": 6.1420049159848755, - "fromTfidf": 9.085421387618508 - } - } - ] + "example": "" + } + }, + "example": { + "manuscript_slug": "leningrad-codex-(1008-ce)", + "page_id": "LC_Folio_434v", + "image_url": "https://manuscripts.sefaria.org/leningrad-color/BIB_LENCDX_F434B.jpg", + "thumbnail_url": "https://manuscripts.sefaria.org/leningrad-color/BIB_LENCDX_F434B_thumbnail.jpg", + "anchorRef": "Esther 3:15-4:17", + "anchorRefExpanded": [ + "Esther 4:14" + ], + "manuscript": { + "slug": "leningrad-codex-(1008-ce)", + "title": "Leningrad Codex (1008 CE)", + "he_title": "כתב יד לנינגרד (1008)", + "source": "https://dornsife.usc.edu/wsrp/biblical-manuscripts", + "description": "Bruce Zuckerman, West Semitic Research, in collaboration with the Ancient Biblical Manuscript Center; courtesy Russian National Library, Saltykov-Schedrin", + "he_description": "" + } + } + }, + "ManuscriptVersionMetaData": { + "title": "Root Type for ManuscriptVersionMetaData", + "description": "The specific metadata for the version of the manuscript. ", + "required": [ + "slug", + "description", + "he_description", + "he_title", + "source", + "title" + ], + "type": "object", + "properties": { + "slug": { + "description": "The unique slug for the manuscript. ", + "type": "string", + "example": "leningrad-codex-(1008-ce)" + }, + "title": { + "description": "The title of the manuscript. ", + "type": "string", + "example": "Leningrad Codex (1008 CE)" + }, + "he_title": { + "description": "The manuscript title in Hebrew. ", + "type": "string", + "example": "כתב יד לנינגרד (1008)" + }, + "source": { + "description": "The url for the source of the manuscript images. ", + "type": "string", + "example": "https://dornsife.usc.edu/wsrp/biblical-manuscripts/" + }, + "description": { + "description": "A description of the manuscript, oftening containing details about the archivists or where the physical manuscript images can be found, as well as other library details. ", + "type": "string", + "example": "Bruce Zuckerman, West Semitic Research, in collaboration with the Ancient Biblical Manuscript Center; courtesy Russian National Library, Saltykov-Schedrin" + }, + "he_description": { + "description": "A Hebrew description of the manuscript, oftening containing details about the archivists or where the physical manuscript images can be found, as well as other library details. ", + "type": "string" + } + }, + "example": { + "slug": "leningrad-codex-(1008-ce)", + "title": "Leningrad Codex (1008 CE)", + "he_title": "כתב יד לנינגרד (1008)", + "source": "https://dornsife.usc.edu/wsrp/biblical-manuscripts", + "description": "Bruce Zuckerman, West Semitic Research, in collaboration with the Ancient Biblical Manuscript Center; courtesy Russian National Library, Saltykov-Schedrin", + "he_description": "" + } + }, + "wordCompletionAPIResponse": { + "description": "An array of arrays, each containing two strings. The first is a completion entry in Hebrew without vowels and the second includes vowels.", + "type": "array", + "items": { + "type": "string" + }, + "example": [ + [ + "אב", + "אַב" + ] + ] + }, + "VersionJSON": { + "title": "Root Type for VersionJSON", + "description": "The metadata for a given version. ", + "type": "object", + "properties": { + "title": { + "description": "The title of the Index. ", + "type": "string", + "example": "Talmud Berakhot" + }, + "versionTitle": { + "description": "The title of the version", + "type": "string", + "example": "\"William Davidson Edition - Vocalized Aramaic\"" + }, + "versionSource": { + "description": "A URL pointing to the hardcopy of the text as it can be found in libraries, most usually in our case the NLI (National Library of Israel), but not exclusively. ", + "type": "string", + "example": "https://www.nli.org.il/he/books/NNL_ALEPH990025294890205171/NLI" + }, + "language": { + "$ref": "#/components/schemas/LanguageCode", + "description": "The language of the version. The versions on Sefaria are grouped into two language buckets, `en` for languages which read left-to-right (i.e. English, Spanish, German) and `he` for languages which read right-to-left (i.e. Hebrew, Arabic)", + "example": "'en'\n'he'" + }, + "status": { + "description": "The status field contains either the string `\"locked\"` or an empty string. If `\"locked\"` is the value of the field, it indicates that the text is locked from future updatees, edits and translations from community members. ", + "type": "string", + "example": "\"locked\"" + }, + "license": { + "description": "The copyright license for using, and reproducing the text. ", + "type": "string", + "example": "CC-BY" + }, + "versionNotes": { + "description": "English notes relating to the version, often containing details of authorship, place of printing, and sometimes donor dedications. ", + "type": "string", + "example": "\"English from The William Davidson digital edition of the Koren Noé Talmud, with commentary by Rabbi Adin Even-Israel Steinsaltz\"," + }, + "digitizedBySefaria": { + "description": "Whether or not the text was digitized by Sefaria. We have some texts we've been able to add to our database from digital sources, and other texts that we've transfered from print to a digital medium ourselves. This field indicates if Sefaria did the digitization. ", + "type": "boolean", + "example": "True" + }, + "priority": { + "description": "The priority field is a number which indicates the priority of a version relative to all other existing versions of the same text. A value of `1` indicates the lowest priority, while the highest value among all versions of the text indicate the highest priority. \n\nPriority values can also be floating point numbers. The priority field determines how the various available versions of a text will be displayed on the Sefaria website. The texts are displayed to the user in a highest-to-lowest priority order, in many cases offering more complete or higher quality versions of the text before ones of inferior quality. ", + "type": "number", + "example": "7" + }, + "versionTitleInHebrew": { + "description": "The title of the version in Hebrew", + "type": "string", + "example": "מהדורת וויליאם דייוידסון - ארמית המנוקד" + }, + "versionNotesInHebrew": { + "description": "Hebrew notes relating to the version, often containing details of authorship, place of printing, and sometimes donor dedications. ", + "type": "string" + }, + "extendedNotes": { + "description": "English extended notes on a version that go beyond the time and place of printing. ", + "type": "string" + }, + "extendedNotesHebrew": { + "description": "Hebrew extended notes on a version that go beyond the time and place of printing. ", + "type": "string" + }, + "purchaseInformationImage": { + "description": "A URL pointing to an image of the hard copy of the version associated with the digital copy, for those who would like to purchase a hard copy. ", + "type": "string", + "example": "\"https://storage.googleapis.com/sefaria-physical-editions/4fc4b6d5b144eb3915d250d743eaf2e8.png\"" + }, + "purchaseInformationURL": { + "description": "The URL pointing to a website where on can buy a physical copy of the given text version. ", + "type": "string", + "example": "\"https://korenpub.com/collections/the-noe-edition-koren-talmud-bavli-1/products/copy-of-vol-1-berakhot-1\"" + }, + "shortVersionTitle": { + "description": "An English short title for the version", + "type": "string", + "example": "\"Koren - Steinsaltz\"" + }, + "shortVersionTitleInHebrew": { + "description": "A Hebrew short title for the version", + "type": "string" + }, + "isBaseText": { + "description": "Is this a text that has commentary. `true` indicates that there are commentaries on this text, while `false` indicates that the text does not have any commentary. ", + "type": "boolean", + "example": "True" + }, + "firstSectionRef": { + "description": "The first `ref` for this title on a section level (as opposed to the more granular segment level). For example, `Genesis 1` would be the first section level ref of Genesis (as opposed to the segment, `Genesis 1:1`), and `Rashi on Kohelet 1:1` is the first section level ref of `Rashi on Kohelet` (as opposed to the segment level of `Rashi on Kohelet 1:1:1`)", + "type": "string", + "example": "Rashi on Kohelet 1.1" + } + }, + "example": { + "title": "Shulchan Arukh, Orach Chayim", + "versionTitle": "Wikisource Shulchan Aruch", + "versionSource": "https://en.wikisource.org/wiki/Translation:Shulchan_Aruch/Orach_Chaim/338", + "language": "en", + "status": "", + "license": "CC-BY-SA", + "versionNotes": "", + "digitizedBySefaria": "", + "priority": "", + "versionTitleInHebrew": "שולחן ערוך (ויקיטקסט)", + "versionNotesInHebrew": "", + "extendedNotes": "", + "extendedNotesHebrew": "", + "purchaseInformationImage": "", + "purchaseInformationURL": "", + "shortVersionTitle": "", + "shortVersionTitleInHebrew": "", + "isBaseText": false, + "firstSectionRef": "Shulchan Arukh, Orach Chayim 1" + } + }, + "LanguageCode": { + "description": "The texts on Sefaria are grouped into two language buckets, `en` for languages which read left-to-right (i.e. English, Spanish, German) and `he` for languages which read right-to-left (i.e. Hebrew, Arabic). This field is only ever populated by a string containing the value of either `en` or `he`. ", + "type": "string", + "example": "'en'\n'he'" + }, + "FindRefsAPIResponse": { + "title": "Root Type for FindRefsAPIResponse", + "description": "A response to the Find Refs API", + "type": "object", + "properties": { + "title": { + "description": "Information about any references found in the `title` field of the POST request", + "type": "object", + "properties": { + "results": { + "type": "array", + "items": { + "description": "A single matched reference", + "type": "object", + "properties": { + "startChar": { + "format": "int32", + "description": "The index of the starting character of the match", + "type": "integer" + }, + "endChar": { + "format": "int32", + "description": "The index of the ending character of the match", + "type": "integer" + }, + "text": { + "description": "The matched reference", + "type": "string" + }, + "linkFailed": { + "type": "boolean" + }, + "refs": { + "type": "array", + "items": { + "$ref": "#/components/schemas/ref" + } + } + } } - }, - "TopicGraphLinkJSON": { - "title": "Root Type for TopicGraphLinkJSON", - "description": "", + }, + "refData": { "type": "object", "properties": { - "toTopic": { - "description": "Slug of the `toTopic` (i.e. the topic to which the link connects to, usually the slug passed as `topic_slug` to the `api/topic-graph` endpoint).", + "RefTitle": { + "type": "object", + "properties": { + "heRef": { + "description": "The Hebrew equivalent of the cannonical ref", "type": "string" - }, - "linkType": { - "description": "The type of the link, based on the relationship within our ontology. Many links has an `is-a` relationship (such as `Genesis` `is-a` `Book`), but other topic-to-topic links have a variety of other types documented [here](https://developers.sefaria.org/docs/topic-ontology#overview-of-sefaria-link-types). \n\nSome examples include `child-of`, `parent-of`, `sibling-of` etc. ", + }, + "url": { + "description": "The URL this ref can be found at on Sefaria", "type": "string" - }, - "class": { - "description": "Class of the link `intraTopic` (a link from topic-to-topic) or `refTopic` (a link from a topic-to-ref). ", - "enum": [ - "refTopic", - "intraTopic" - ], + }, + "primaryCategory": { + "description": "The primary category this ref belongs to on Sefaria", "type": "string" + } + } + } + } + } + } + }, + "body": { + "description": "Information about any references found in the `body` field of the POST request", + "type": "object", + "properties": { + "results": { + "type": "array", + "items": { + "description": "A single matched reference", + "type": "object", + "properties": { + "startChar": { + "format": "int32", + "description": "The index of the starting character of the match", + "type": "integer" + }, + "endChar": { + "format": "int32", + "description": "The index of the ending character of the match", + "type": "integer" }, - "dataSource": { - "description": "Source where the topic link originated from. ", - "type": "string" + "text": { + "description": "The matched reference", + "type": "string" }, - "fromTopic": { - "description": "Slug of the `fromTopic` (i.e. the topic from which the link originates). ", - "type": "string" + "linkFailed": { + "type": "boolean" }, - "order": { - "$ref": "#/components/schemas/OrderJSON", - "description": "A dictionary containing information regarding the links in common, as well as the to and from `tfIdf` scores. To learn more about the [tfIdf](https://en.wikipedia.org/wiki/Tf%E2%80%93idf) algorithm. ", - "properties": { - "linksInCommon": { - "format": "int32", - "type": "integer" - }, - "toTfidf": { - "format": "int32", - "type": "integer" - }, - "fromTfidf": { - "format": "int32", - "type": "integer" - } - }, - "example": "{\n \"linksInCommon\": 0,\n \"toTfidf\": 0,\n \"fromTfidf\": 0\n }" - } - }, - "example": { - "toTopic": "shabbat", - "linkType": "is-a", - "class": "intraTopic", - "dataSource": "aspaklaria-edited-by-sefaria", - "fromTopic": "shabbat-shuvah", - "order": { - "linksInCommon": 0, - "toTfidf": 0, - "fromTfidf": 0 + "refs": { + "type": "array", + "items": { + "$ref": "#/components/schemas/ref" + } } + } } - }, - "OrderJSON": { - "title": "Root Type for OrderJSON", - "description": "", + }, + "refData": { "type": "object", "properties": { - "linksInCommon": { - "format": "int32", - "type": "integer" + "RefTitle": { + "type": "object", + "properties": { + "heRef": { + "description": "The Hebrew equivalent of the cannonical ref", + "type": "string" + }, + "url": { + "description": "The URL this ref can be found at on Sefaria", + "type": "string" + }, + "primaryCategory": { + "description": "The primary category this ref belongs to on Sefaria", + "type": "string" + } + } + } + } + } + } + } + }, + "example": { + "title": { + "results": [ + { + "startChar": 23, + "endChar": 34, + "text": "Bereishit 1", + "linkFailed": false, + "refs": [ + "Genesis 1" + ] + } + ], + "refData": { + "Genesis 1": { + "heRef": "בראשית א׳", + "url": "Genesis.1", + "primaryCategory": "Tanakh" + } + } + }, + "body": { + "results": [ + { + "startChar": 0, + "endChar": 11, + "text": "Genesis 1:1", + "linkFailed": false, + "refs": [ + "Genesis 1:1" + ] + }, + { + "startChar": 35, + "endChar": 51, + "text": "Mishnah Peah 3-4", + "linkFailed": false, + "refs": [ + "Mishnah Peah 3-4" + ] + } + ], + "refData": { + "Genesis 1:1": { + "heRef": "בראשית א׳:א׳", + "url": "Genesis.1.1", + "primaryCategory": "Tanakh" + }, + "Mishnah Peah 3-4": { + "heRef": "משנה פאה ג׳-ד׳", + "url": "Mishnah_Peah.3-4", + "primaryCategory": "Mishnah" + } + } + } + } + }, + "CalendarAPIResponse": { + "title": "Root Type for CalendarAPIResponse", + "description": "A response from the Calendar API", + "type": "object", + "properties": { + "date": { + "format": "date", + "description": "The datestring for the calendars shown. It should match the values submitted in `year` `month` `day` or should be the current date.", + "type": "string" + }, + "timezone": { + "description": "An IANA timezone name", + "type": "string" + }, + "calendar_items": { + "type": "array", + "items": { + "description": "A single learning schedule for the selected date", + "type": "object", + "properties": { + "title": { + "description": "The learning schedule title in `he` and `en`", + "type": "object", + "properties": { + "en": { + "type": "string" }, - "toTfidf": { - "format": "int32", - "type": "integer" + "he": { + "type": "string" + } + }, + "example": "Daf Yomi" + }, + "displayValue": { + "description": "The name of the reading for the selected date in the learning schedule in `en` and `he`", + "type": "object", + "properties": { + "en": { + "type": "string" }, - "fromTfidf": { - "format": "int32", - "type": "integer" + "he": { + "type": "string" } + }, + "example": "Vayishlach" }, - "example": { - "linksInCommon": 0, - "toTfidf": 0, - "fromTfidf": 0 + "url": { + "description": "The url path on Sefaria where this selection can be found", + "type": "string" + }, + "ref": { + "$ref": "#/components/schemas/ref" + }, + "heRef": { + "description": "The Hebrew equivalent of the `ref`", + "type": "string" + }, + "order": { + "format": "int32", + "description": "This is used internally on Sefaria to arrange the learning schedules in the manner we choose.", + "type": "integer" + }, + "category": { + "description": "The primary category that this `ref` belongs to", + "type": "string" + }, + "extraDetails": { + "description": "Additional details about this learning schedule entry", + "type": "object", + "properties": { + "aliyot": { + "description": "The breakdown of aliyot for a parashah", + "type": "array", + "items": { + "type": "string" + } + } + } + }, + "description": { + "description": "A description of this learning schedule entry if it exists in `he` and `en`", + "type": "object", + "properties": { + "en": { + "type": "string" + }, + "he": { + "type": "string" + } + } } + } + } + } + }, + "example": { + "date": "2023-11-28", + "timezone": "America/Halifax", + "calendar_items": [ + { + "title": { + "en": "Parashat Hashavua", + "he": "פרשת השבוע" + }, + "displayValue": { + "en": "Vayishlach", + "he": "וישלח" + }, + "url": "Genesis.32.4-36.43", + "ref": "Genesis 32:4-36:43", + "heRef": "בראשית ל״ב:ד׳-ל״ו:מ״ג", + "order": 1, + "category": "Tanakh", + "extraDetails": { + "aliyot": [ + "Genesis 32:4-32:13", + "Genesis 32:14-32:30", + "Genesis 32:31-33:5", + "Genesis 33:6-33:20", + "Genesis 34:1-35:11", + "Genesis 35:12-36:19", + "Genesis 36:20-36:43", + "Genesis 36:40-36:43" + ] + }, + "description": { + "en": "Vayishlach (“He Sent”) follows Jacob and his family as Jacob wrestles with a man (commonly understood as an angel), is renamed Israel, and reconciles with his brother, Esau. Jacob’s daughter, Dina, is raped by a Hivite prince, and her brothers sack a city in response. Rachel dies as she gives birth to Jacob's youngest child, Benjamin.", + "he": "פרשת וישלח ממשיכה לעקוב אחרי יעקב ומשפחתו. יעקב נאבק עם איש (שלפי הפרשנות המקובלת הוא מלאך אלוהים), ובסיום המאבק האיש מעניק לו את השם ישראל. יעקב מתפייס עם אחיו עשו. דינה, בתו של יעקב, נאנסת ונשבית בידי נסיך חיווי, ואחיה הורגים את כל הזכרים בעיר ומשיבים אליהם את דינה. רחל מתה בשעת לידתו של בנימין, הצעיר בבני יעקב." + } + }, + { + "title": { + "en": "Haftarah", + "he": "הפטרה" + }, + "displayValue": { + "en": "Obadiah 1:1-21", + "he": "עובדיה א׳:א׳-כ״א" + }, + "url": "Obadiah.1.1-21", + "ref": "Obadiah 1:1-21", + "order": 2, + "category": "Tanakh" + }, + { + "title": { + "en": "Daf Yomi", + "he": "דף יומי" + }, + "displayValue": { + "en": "Bava Kamma 26", + "he": "בבא קמא כ״ו" + }, + "url": "Bava_Kamma.26", + "ref": "Bava Kamma 26", + "order": 3, + "category": "Talmud" + }, + { + "title": { + "en": "929", + "he": "929" + }, + "displayValue": { + "en": "Ezekiel 21 (473)", + "he": "יחזקאל כ״א (473)" + }, + "url": "Ezekiel.21", + "ref": "Ezekiel 21", + "order": 4, + "category": "Tanakh" + }, + { + "title": { + "en": "Daily Mishnah", + "he": "משנה יומית" + }, + "displayValue": { + "en": "Mishnah Yevamot 10:4-5", + "he": "משנה יבמות י׳:ד׳-ה׳" + }, + "url": "Mishnah_Yevamot.10.4-5", + "ref": "Mishnah Yevamot 10:4-5", + "order": 5, + "category": "Mishnah" + }, + { + "title": { + "en": "Daily Rambam", + "he": "הרמב\"ם היומי" + }, + "displayValue": { + "en": "Marriage 14", + "he": "הלכות אישות י״ד" + }, + "url": "Mishneh_Torah,_Marriage.14", + "ref": "Mishneh Torah, Marriage 14", + "order": 6, + "category": "Halakhah" + }, + { + "title": { + "en": "Daily Rambam (3 Chapters)", + "he": "הרמב\"ם היומי (3 פרקים)" + }, + "displayValue": { + "en": "Other Sources of Defilement 9-11", + "he": "הלכות שאר אבות הטומאות ט׳-י״א" + }, + "url": "Mishneh_Torah,_Other_Sources_of_Defilement.9-11", + "ref": "Mishneh Torah, Other Sources of Defilement 9-11", + "order": 7, + "category": "Halakhah" + }, + { + "title": { + "en": "Daf a Week", + "he": "דף השבוע" + }, + "displayValue": { + "en": "Ketubot 64", + "he": "כתובות ס״ד" + }, + "url": "Ketubot.64", + "ref": "Ketubot 64", + "order": 8, + "category": "Talmud" + }, + { + "title": { + "en": "Halakhah Yomit", + "he": "הלכה יומית" + }, + "displayValue": { + "en": "Shulchan Arukh, Orach Chayim 535:2-536:1", + "he": "שולחן ערוך, אורח חיים תקל״ה:ב׳-תקל״ו:א׳" + }, + "url": "Shulchan_Arukh,_Orach_Chayim.535.2-536.1", + "ref": "Shulchan Arukh, Orach Chayim 535:2-536:1", + "order": 9, + "category": "Halakhah" + }, + { + "title": { + "en": "Arukh HaShulchan Yomi", + "he": "ערוך השולחן היומי" + }, + "displayValue": { + "en": "Yoreh De'ah 191:7-15", + "he": "יורה דעה קצ״א:ז׳-ט״ו" + }, + "url": "Arukh_HaShulchan,_Yoreh_De'ah.191.7-15", + "ref": "Arukh HaShulchan, Yoreh De'ah 191:7-15", + "order": 10, + "category": "Halakhah" + }, + { + "title": { + "en": "Tanakh Yomi", + "he": "תנ\"ך יומי" + }, + "displayValue": { + "en": "Samuel Seder 17", + "he": "שמואל סדר יז" + }, + "url": "I_Samuel.25.33-26.24", + "ref": "I Samuel 25:33-26:24", + "order": 11, + "category": "Tanakh" }, - "RandomByTopicJSON": { - "title": "Root Type for RandomByTopicJSON", - "description": "Response to the random-by-topic API endpoint. ", + { + "title": { + "en": "Chok LeYisrael", + "he": "חק לישראל" + }, + "displayValue": { + "en": "Vayishlach", + "he": "וישלח" + }, + "url": "collections/חק-לישראל?tag=Vayishlach", + "order": 12, + "category": "Tanakh" + }, + { + "title": { + "en": "Tanya Yomi", + "he": "תניא יומי" + }, + "displayValue": { + "en": "15 Kislev", + "he": "טו כסלו" + }, + "url": "Tanya,_Part_V;_Kuntres_Acharon.6.8", + "ref": "Tanya, Part V; Kuntres Acharon 6:8", + "order": 15, + "category": "Chasidut" + }, + { + "title": { + "en": "Yerushalmi Yomi", + "he": "ירושלמי יומי" + }, + "displayValue": { + "en": "Jerusalem Talmud Orlah 18", + "he": "תלמוד ירושלמי ערלה יח" + }, + "url": "Jerusalem_Talmud_Orlah.3.1.16-3.1", + "ref": "Jerusalem Talmud Orlah 3:1:16-3:1", + "order": 16, + "category": "Talmud" + } + ] + } + }, + "TopicJSON": { + "title": "Root Type for TopicJSON", + "description": "A JSON object containing all of the metadata for a topic object", + "required": [ + "slug", + "titles" + ], + "type": "object", + "properties": { + "slug": { + "description": "The unique slug for a given topic.", + "type": "string", + "example": "nachman-of-breslov" + }, + "titles": { + "description": "An array of JSON objects, each representing an alternative title for the object, in various languages. ", + "type": "array", + "items": { + "$ref": "#/components/schemas/TitlesJSON" + }, + "example": "\"titles\": [\n {\n \"text\": \"Tabernacles\",\n \"lang\": \"en\"\n },\n {\n \"text\": \"Succot\",\n \"lang\": \"en\"\n },\n {\n \"text\": \"Sukkos\",\n \"lang\": \"en\"\n },\n {\n \"text\": \"Succos\",\n \"lang\": \"en\"\n },\n {\n \"text\": \"Booths\",\n \"lang\": \"en\"\n },\n {\n \"text\": \"sukkot\",\n \"lang\": \"en\"\n },\n {\n \"text\": \"succot\",\n \"lang\": \"en\"\n },\n {\n \"text\": \"Succoth\",\n \"lang\": \"en\"\n },\n {\n \"text\": \"Sukkoth\",\n \"lang\": \"en\"\n },\n {\n \"text\": \"חג הסוכות\",\n \"lang\": \"he\"\n },\n {\n \"text\": \"סכות\",\n \"lang\": \"he\"\n },\n {\n \"text\": \"Sukkot\",\n \"lang\": \"en\",\n \"primary\": true\n },\n {\n \"text\": \"סוכות\",\n \"lang\": \"he\",\n \"primary\": true\n }\n]" + }, + "alt_ids": { + "description": "This is a dictionary containing the keys of naming schemes, and ids of this topic represented in that naming scheme. It’s used both for canonical names in other naming schemes and temporary storage of names when renaming slugs. All of the data here is for internal use, with the exception of the values `bfo` and `wikidata`. `bfo` refers to [basic formal ontology](https://developers.sefaria.org/docs/topic-ontology), and `wikidata` to the wikidata ontology of topics. ", + "type": "object", + "properties": { + "_temp_id": { + "type": "string" + } + }, + "example": "\"alt_ids\": {\n \"_temp_id\": \"משה\",\n \"wikidata\": \"Q9077\",\n \"_old_slug\": \"-75\"\n}" + }, + "properties": { + "$ref": "#/components/schemas/TopicPropertyJson", + "description": "The properties stores optional data relating to the topic, including links (if relevant) to where on can learn more about the topic. ", + "properties": { + "heNliLink": { "type": "object", "properties": { - "ref": { - "description": "The `Ref` of the text randomly selected, which is connected to one of the recently popular topics. ", - "type": "string", - "example": "Deuteronomy 16:21" - }, - "topic": { - "$ref": "#/components/schemas/RandomByTopicTopicJSON", - "description": "The topic attached to the `Ref` returned. ", - "properties": { - "slug": { - "type": "string" - }, - "titles": { - "type": "array", - "items": {} - }, - "subclass": { - "type": "string" - }, - "alt_ids": { - "type": "object", - "properties": { - "_temp_id": { - "type": "string" - }, - "old-person-key": { - "type": "string" - } - } - }, - "properties": { - "type": "object", - "properties": { - "enWikiLink": { - "type": "object", - "properties": { - "value": { - "type": "string" - }, - "dataSource": { - "type": "string" - } - } - }, - "jeLink": { - "type": "object", - "properties": { - "value": { - "type": "string" - }, - "dataSource": { - "type": "string" - } - } - }, - "generation": { - "type": "object", - "properties": { - "value": { - "type": "string" - }, - "dataSource": { - "type": "string" - } - } - }, - "sex": { - "type": "object", - "properties": { - "value": { - "type": "string" - }, - "dataSource": { - "type": "string" - } - } - }, - "heWikiLink": { - "type": "object", - "properties": { - "data_source": { - "type": "string" - }, - "value": { - "type": "string" - } - } - } - } - }, - "description": { - "type": "object", - "properties": { - "en": { - "type": "string" - }, - "he": { - "type": "string" - } - } - }, - "categoryDescription": { - "type": "object" - }, - "numSources": { - "format": "int32", - "type": "integer" - }, - "good_to_promote": { - "type": "boolean" - }, - "description_published": { - "type": "boolean" - }, - "primaryTitle": { - "type": "object", - "properties": { - "en": { - "type": "string" - }, - "he": { - "type": "string" - } - } - } - }, - "example": "{\n\"slug\": \"metushelach\",\n\"titles\": [\n{\n\"text\": \"Metushelach\",\n\"lang\": \"en\",\n\"primary\": true,\n\"transliteration\": true\n},\n{\n\"text\": \"מתושלח\",\n\"lang\": \"he\",\n\"primary\": true\n},\n{\n\"text\": \"Methuselah\",\n\"lang\": \"en\"\n},\n{\n\"text\": \"Methushelach\",\n\"lang\": \"en\"\n}\n],\n\"subclass\": \"person\",\n\"alt_ids\": {\n\"_temp_id\": \"מתושלח\",\n\"wikidata\": \"Q156290\"\n},\n\"properties\": {\n\"enWikiLink\": {\n\"value\": \"https://en.wikipedia.org/wiki/Methuselah\",\n\"dataSource\": \"wikidata\"\n},\n\"heWikiLink\": {\n\"value\": \"https://he.wikipedia.org/wiki/מתושלח\",\n\"dataSource\": \"wikidata\"\n},\n\"deWikiLink\": {\n\"value\": \"https://de.wikipedia.org/wiki/Methusalem\",\n\"dataSource\": \"wikidata\"\n},\n\"esWikiLink\": {\n\"value\": \"https://es.wikipedia.org/wiki/Matusalén\",\n\"dataSource\": \"wikidata\"\n},\n\"frWikiLink\": {\n\"value\": \"https://fr.wikipedia.org/wiki/Mathusalem\",\n\"dataSource\": \"wikidata\"\n},\n\"ruWikiLink\": {\n\"value\": \"https://ru.wikipedia.org/wiki/Мафусал_(потомок_Сифа)\",\n\"dataSource\": \"wikidata\"\n}\n},\n\"numSources\": 7,\n\"good_to_promote\": true,\n\"primaryTitle\": {\n\"en\": \"Metushelach\",\n\"he\": \"מתושלח\"\n}\n}" - }, - "url": { - "description": "The `Ref` in a format appropriate for a URL, with spaces replaced with `.` etc. ", - "type": "string", - "example": "Deuteronomy.16.21" - } - }, - "example": { - "ref": "Pesachim 66a:3-6", - "topic": { - "slug": "hillel", - "titles": [], - "subclass": "person", - "alt_ids": { - "_temp_id": "הלל", - "old-person-key": "Hillel the Elder" - }, - "properties": { - "enWikiLink": { - "value": "http://en.wikipedia.org/wiki/Hillel_the_Elder", - "dataSource": "person-collection" - }, - "jeLink": { - "value": "http://www.jewishencyclopedia.com/view.jsp?artid=730&letter=H", - "dataSource": "person-collection" - }, - "generation": { - "value": "Z5", - "dataSource": "person-collection" - }, - "sex": { - "value": "M", - "dataSource": "person-collection" - }, - "heWikiLink": { - "data_source": "wikidata", - "value": "https://he.wikipedia.org/wiki/%D7%94%D7%9C%D7%9C_%D7%94%D7%96%D7%A7%D7%9F" - } - }, - "description": { - "en": "Hillel was one of the most influential and prolific of the early teachers. Coming from Babylon to learn with Avtalyon and Shemaya, he soon became famous for his scholarship and his patient and tolerant manner. Bolstered by his Davidic lineage, he served as Nasi during part of Herod’s reign.", - "he": "הלל היה אחד החכמים הראשונים, ומהפורים והמשפיעים ביניהם. הוא הגיע מבבל כדי ללמוד עם שמעיה ואבטליון, ונודע מהר מאוד בשל חוכמתו בתורה ואופיו הסבלני והסובלני. היותו צאצא של בית דוד הייתה בסיס לכהונתו כנשיא בתקופת שלטונו של הורדוס." - }, - "categoryDescription": {}, - "numSources": 217, - "good_to_promote": true, - "description_published": true, - "primaryTitle": { - "en": "Hillel", - "he": "הִלֵּל" - } - }, - "url": "Pesachim.66a.3-6" + "value": { + "type": "string" + }, + "dataSource": { + "type": "string" + } + } + }, + "enNliLink": { + "type": "object", + "properties": { + "value": { + "type": "string" + }, + "dataSource": { + "type": "string" + } } + } }, - "RandomByTopicTopicJSON": { - "title": "Root Type for RandomByTopicTopicJSON", - "description": "Topic JSON for the `random-by-topic/` endpoint. ", - "required": [ - "slug" - ], + "example": "\"properties\": {\n \"heNliLink\": {\n \"value\": \"https://www.nli.org.il/he/discover/judaism/holidays/sukkot\",\n \"dataSource\": \"sefaria\"\n },\n \"enNliLink\": {\n \"value\": \"https://www.nli.org.il/en/discover/judaism/holidays/sukkot\",\n \"dataSource\": \"sefaria\"\n }\n}" + }, + "description": { + "$ref": "#/components/schemas/BillingualJSON", + "description": "A description of the topic in English", + "properties": { + "en": { + "type": "string" + }, + "he": { + "type": "string" + } + }, + "example": "\"description\": {\n \"en\": \"Sukkot is a weeklong celebration of the harvest in early fall. It is celebrated by the building of temporary booths — that is, sukkot — outside homes in which people eat their meals and sometimes even sleep. The booths are reminders of the transience of life and the sheltering presence of God.\",\n \"he\": \"חג הסוכות, הוא חג האסיף, נמשך שבעה ימים ומצוין בחודש תשרי על-ידי בניית סוכה מחוץ לבית, בה אוכלים וחלק גם ישנים. הסוכה היא תזכורת לסוכות שבנו בני ישראל ביציאת מצרים, ומסמלת את ארעיות החיים ואת נוכחותו המגוננת של ה'\"\n}" + }, + "categoryDescription": { + "description": "A description of the category of this topic", + "type": "string" + }, + "displayOrder": { + "format": "int32", + "description": "The order in which topics are displayed on the Sefaria website, relative to other topics within their same category. ", + "type": "integer", + "example": "1" + }, + "numSources": { + "format": "int32", + "description": "The number of text sources associated with a topic. ", + "type": "integer", + "example": "831" + }, + "description_published": { + "description": "A boolean representing whether or not the description was published. ", + "type": "boolean", + "example": "true" + }, + "data_source": { + "description": "How the topic was generated, whether by Sefaria, a user on a source sheet, or some other source. ", + "type": "string", + "example": "`sefaria`" + }, + "image": { + "$ref": "#/components/schemas/TopicImgJSON", + "description": "Metadata for images associated with topics. ", + "properties": { + "image_uri": { + "type": "string" + }, + "image_caption": { "type": "object", "properties": { - "slug": { - "description": "The unique slug for a given topic.", - "type": "string", - "example": "mezuzah" - }, - "titles": { - "$ref": "#/components/schemas/TitlesJSON", - "description": "An array of JSON objects, each representing an alternative title for the object, in various languages. " - }, - "alt_ids": { - "description": "This is a dictionary containing the keys of naming schemes, and ids of this topic represented in that naming scheme. It’s used both for canonical names in other naming schemes and temporary storage of names when renaming slugs. All of the data here is for internal use, with the exception of the values `bfo` and `wikidata`. `bfo` refers to [basic formal ontology](https://github.com/BFO-ontology/BFO#implementations), and `wikidata` to the wikidata ontology of topics. ", - "example": "\"alt_ids\": {\n \"_temp_id\": \"משה\",\n \"wikidata\": \"Q9077\",\n \"_old_slug\": \"-75\"\n}" - }, - "categoryDescription": { - "description": "A description of the category of this topic", - "type": "string" - }, - "good_to_promote": { - "description": "A topic which will be included in our results from the `random-by-topic` endpoint. ", - "type": "boolean" - }, - "numSources": { - "description": "The number of text sources associated with a topic. ", - "type": "integer", - "example": "613" - }, - "description_published": { - "description": "A boolean representing whether or not the description was published. ", - "type": "boolean", - "example": "false" - }, - "data_source": { - "description": "How the topic was generated, whether by Sefaria, a user on a source sheet, or some other source. ", - "type": "string", - "example": "sefaria" - }, - "primary_title": { - "$ref": "#/components/schemas/BillingualJSON", - "description": "The primary title for a topic.", - "example": "{\n \"en\": \"Sukkot\",\n \"he\": \"סוכות\"\n}" - }, - "description": { - "$ref": "#/components/schemas/BillingualJSON", - "description": "A description of the topic in English" - } - }, - "example": { - "slug": "mezuzah", - "titles": [ - { - "text": "Mezuzah", - "lang": "en", - "primary": true - }, - { - "text": "מזוזה", - "lang": "he", - "primary": true - } - ], - "alt_ids": { - "_temp_id": "מזוזה" - }, - "description": { - "en": "A mezuzah is the small parchment placed inside a case and attached to the right side of entryway doorframes where Jews reside. Written on the scroll are various sections from the Torah, such as the Shema, that feature some of Judaism's central principles.", - "he": "המזוזה היא נייר קלף קטן הנמצא בתוך נרתיק (בית המזוזה) המחובר לצד הימני של משקוף הדלת בבתי יהודים. על מגילת הקלף כתובים מגוון קטעים מן התורה, דוגמת פרשת שמע הכוללת כמה מהעקרונות העיקריים של היהדות." - }, - "categoryDescription": {}, - "numSources": 120, - "good_to_promote": true, - "description_published": true, - "data_source": "sefaria", - "primaryTitle": { - "en": "Mezuzah", - "he": "מזוזה" - } + "en": { + "type": "string" + }, + "he": { + "type": "string" + } } + } + }, + "example": "\"image\": {\n \"image_uri\": \"https://storage.googleapis.com/img.sefaria.org/topics/sukkot.jpg\",\n \"image_caption\": {\n \"en\": \"Detail of a painting of a sukkah. Image taken from f. 316v of Forli Siddur. 1383, Italian rite. The British Library\",\n \"he\": \"פרט ציור של סוכה עם שולחן פרוש ושלוש דמויות. דימוי מתוך סידור פורלי, 1383 איטליה\"\n }\n}" + }, + "primaryTitle": { + "$ref": "#/components/schemas/BillingualJSON", + "description": "The primary title for a topic.", + "properties": { + "en": { + "type": "string" + }, + "he": { + "type": "string" + } + }, + "example": "{\n \"en\": \"Sukkot\",\n \"he\": \"סוכות\"\n}" + }, + "primaryTitleIsTransliteration": { + "$ref": "#/components/schemas/BillingualJSON", + "description": "This field has the possibility of being used to indicate whether or not a title is a transliteration, however the data here is not always consistent or up-to-date. Therefore, it is best to disregard the data in this field, and there are many false negatives. ", + "properties": { + "en": { + "type": "boolean" + }, + "he": { + "type": "boolean" + } + }, + "example": "\"primaryTitleIsTransliteration\": {\n \"en\": false,\n \"he\": false\n}" + } + }, + "example": { + "slug": "sukkot", + "titles": [ + { + "text": "Tabernacles", + "lang": "en" + }, + { + "text": "Succot", + "lang": "en" + }, + { + "text": "Sukkos", + "lang": "en" + }, + { + "text": "Succos", + "lang": "en" + }, + { + "text": "Booths", + "lang": "en" + }, + { + "text": "sukkot", + "lang": "en" + }, + { + "text": "succot", + "lang": "en" + }, + { + "text": "Succoth", + "lang": "en" + }, + { + "text": "Sukkoth", + "lang": "en" + }, + { + "text": "חג הסוכות", + "lang": "he" + }, + { + "text": "סכות", + "lang": "he" + }, + { + "text": "Sukkot", + "lang": "en", + "primary": true + }, + { + "text": "סוכות", + "lang": "he", + "primary": true + } + ], + "alt_ids": { + "_temp_id": "סוכות" + }, + "properties": { + "heNliLink": { + "value": "https://www.nli.org.il/he/discover/judaism/holidays/sukkot", + "dataSource": "sefaria" + }, + "enNliLink": { + "value": "https://www.nli.org.il/en/discover/judaism/holidays/sukkot", + "dataSource": "sefaria" + } + }, + "description": { + "en": "Sukkot is a weeklong celebration of the harvest in early fall. It is celebrated by the building of temporary booths — that is, sukkot — outside homes in which people eat their meals and sometimes even sleep. The booths are reminders of the transience of life and the sheltering presence of God.", + "he": "חג הסוכות, הוא חג האסיף, נמשך שבעה ימים ומצוין בחודש תשרי על-ידי בניית סוכה מחוץ לבית, בה אוכלים וחלק גם ישנים. הסוכה היא תזכורת לסוכות שבנו בני ישראל ביציאת מצרים, ומסמלת את ארעיות החיים ואת נוכחותו המגוננת של ה'" + }, + "categoryDescription": {}, + "displayOrder": 4, + "numSources": 831, + "description_published": true, + "data_source": "sefaria", + "image": { + "image_uri": "https://storage.googleapis.com/img.sefaria.org/topics/sukkot.jpg", + "image_caption": { + "en": "Detail of a painting of a sukkah. Image taken from f. 316v of Forli Siddur. 1383, Italian rite. The British Library", + "he": "פרט ציור של סוכה עם שולחן פרוש ושלוש דמויות. דימוי מתוך סידור פורלי, 1383 איטליה" + } + }, + "primaryTitle": { + "en": "Sukkot", + "he": "סוכות" + }, + "primaryTitleIsTransliteration": { + "en": false, + "he": false + } + } + }, + "TopicImgJSON": { + "title": "Root Type for TopicImgJSON", + "description": "A JSON object containing the image metadata for topics with images. ", + "type": "object", + "properties": { + "image_uri": { + "description": "The URL pointing to the image as hosted by Sefaria. ", + "type": "string", + "example": "https://storage.googleapis.com/img.sefaria.org/topics/sukkot.jpg" + }, + "image_caption": { + "$ref": "#/components/schemas/BillingualJSON", + "description": "A JSON object containing the billingual caption data for an image associated with a topic.", + "properties": { + "en": { + "type": "string" + }, + "he": { + "type": "string" + } + }, + "example": "\"image_caption\": {\n \"en\": \"Detail of a painting of a sukkah. Image taken from f. 316v of Forli Siddur. 1383, Italian rite. The British Library\",\n \"he\": \"פרט ציור של סוכה עם שולחן פרוש ושלוש דמויות. דימוי מתוך סידור פורלי, 1383 איטליה\"\n}" + } + }, + "example": { + "image_uri": "https://storage.googleapis.com/img.sefaria.org/topics/sukkot.jpg", + "image_caption": { + "en": "Detail of a painting of a sukkah. Image taken from f. 316v of Forli Siddur. 1383, Italian rite. The British Library", + "he": "פרט ציור של סוכה עם שולחן פרוש ושלוש דמויות. דימוי מתוך סידור פורלי, 1383 איטליה" + } + } + }, + "BillingualJSON": { + "title": "Root Type for TopicImgCaption", + "description": "A JSON object containing billingual text, both `he` and `en` parallel texts. ", + "type": "object", + "properties": { + "en": { + "description": "The English field for a JSON object representing billingual text. ", + "type": "string", + "example": "Detail of a painting of a sukkah. Image taken from f. 316v of Forli Siddur. 1383, Italian rite. The British Library" + }, + "he": { + "description": "The Hebrew field for a JSON object representing billingual text. ", + "type": "string", + "example": "פרט ציור של סוכה עם שולחן פרוש ושלוש דמויות. דימוי מתוך סידור פורלי, 1383 איטליה" + } + }, + "example": { + "en": "Detail of a painting of a sukkah. Image taken from f. 316v of Forli Siddur. 1383, Italian rite. The British Library", + "he": "פרט ציור של סוכה עם שולחן פרוש ושלוש דמויות. דימוי מתוך סידור פורלי, 1383 איטליה" + } + }, + "TopicPropertyJson": { + "title": "Root Type for TopicPropertyJson", + "description": "The JSON object containing information about a topic's properties", + "type": "object", + "properties": { + "heNliLink": { + "$ref": "#/components/schemas/NLILinkJSON", + "description": "A link to the Hebrew page on the website of the National Library of Israel which corresponds to the given topic, so users can learn more. ", + "properties": { + "value": { + "type": "string" + }, + "dataSource": { + "type": "string" + } + }, + "example": " \"heNliLink\": {\n \"value\": \"https://www.nli.org.il/he/discover/judaism/holidays/sukkot\",\n \"dataSource\": \"sefaria\"\n}" + }, + "enNliLink": { + "$ref": "#/components/schemas/NLILinkJSON", + "description": "A link to the English page on the website of the National Library of Israel which corresponds to the given topic, so users can learn more. ", + "properties": { + "value": { + "type": "string" + }, + "dataSource": { + "type": "string" + } }, - "RefTopicLinksJSON": { - "title": "Root Type for RefTopicLinksJSON", - "description": "Response from the ref-topic-links endpoint", + "example": "\"enNliLink\": {\n \"value\": \"https://www.nli.org.il/en/discover/judaism/holidays/sukkot\",\n \"dataSource\": \"sefaria\"\n}" + } + }, + "example": { + "heNliLink": { + "value": "https://www.nli.org.il/he/discover/judaism/holidays/sukkot", + "dataSource": "sefaria" + }, + "enNliLink": { + "value": "https://www.nli.org.il/en/discover/judaism/holidays/sukkot", + "dataSource": "sefaria" + } + } + }, + "NLILinkJSON": { + "title": "Root Type for NLILinkJSON", + "description": "JSON for storing NLI links related to data in the Sefaria database. ", + "type": "object", + "properties": { + "value": { + "description": "A link to a corresponding NLI page to learn more. ", + "type": "string", + "example": "https://www.nli.org.il/en/discover/judaism/holidays/sukkot" + }, + "dataSource": { + "description": "The source of the topic data, whether user-created or Sefaria-created. ", + "type": "string", + "example": "`sefaria`" + } + }, + "example": { + "value": "https://www.nli.org.il/en/discover/judaism/holidays/sukkot", + "dataSource": "sefaria" + } + }, + "CalendarNextReadAPI": { + "title": "Root Type for CalendarNextReadAPI", + "description": "", + "type": "object", + "properties": { + "parasha": { + "type": "object", + "properties": { + "title": { + "description": "This should always read `Parashat Hashavua`", "type": "object", "properties": { - "linkType": { - "description": "The type of the link, based on the relationship within our ontology. Many links has an `is-a` relationship (such as `Genesis` `is-a` `Book`), but other topic-to-topic links have a variety of other types documented [here](https://developers.sefaria.org/docs/topic-ontology#overview-of-sefaria-link-types). \n\nSome examples include `child-of`, `parent-of`, `sibling-of` etc. ", - "type": "string", - "example": "about" - }, - "class": { - "description": "A classification of the link as either `refTopic` (i.e. a ref to a topic) or `intraTopic` (topic-to-topic). In this case, it would be expected that all returned topic links would be of type `refTopic`. ", - "enum": [ - "refTopic", - "intraTopic" - ], - "type": "string", - "example": "refTopic" - }, - "dataSource": { - "$ref": "#/components/schemas/DataSourceJSON", - "description": "Where the topic link originated from (i.e. was it added to a sheet and generated by Sefaria users, or was it created by the Sefaria learning team?)", - "properties": { - "en": { - "type": "string" - }, - "he": { - "type": "string" - }, - "slug": { - "type": "string" - } - }, - "example": "{\n\"en\": \"Sheets by Sefaria users\",\n\"he\": \"דפי מקורות ממשתמשי ספריא\",\n\"slug\": \"sefaria-users\"\n}" - }, - "is_sheet": { - "description": "Is this ref-to-topic link one that was generated by a user-created source sheet?", - "type": "boolean", - "example": "false" - }, - "order": { - "$ref": "#/components/schemas/OrderTopicLinkJSON", - "description": "This JSON includes the various metrics that are relevant for ordering the link on a topics page. We use these metrics at [Sefaria.org](sefaria.org) to change the order on the topics page.", - "properties": { - "tfidf": { - "format": "double", - "type": "number" - }, - "numDatasource": { - "format": "int32", - "type": "integer" - }, - "availableLangs": { - "type": "array", - "items": { - "type": "string" - } - }, - "comp_date": { - "format": "int32", - "type": "integer" - }, - "order_id": { - "type": "string" - }, - "pr": { - "format": "double", - "type": "number" - }, - "curatedPrimacy": { - "type": "object", - "properties": { - "en": { - "format": "int32", - "type": "integer" - }, - "he": { - "format": "int32", - "type": "integer" - } - } - } - }, - "example": "\"order\": {\n\"tfidf\": 53.476917039392994,\n\"numDatasource\": 2,\n\"availableLangs\": [\n\"en\",\n\"he\"\n],\n\"comp_date\": -1400,\n\"order_id\": \"A00000000300280026\",\n\"pr\": 5.15330629652094,\n\"curatedPrimacy\": {\n\"en\": 100,\n\"he\": 0\n}\n}" - }, - "descriptions": { - "description": "JSON containing descriptions for a given topic in various languages. Each language contains a `title` for the topic description, as well as a `prompt` which previews the source and asks questions to help the user engage with the text. ", - "type": "object", - "properties": { - "en": { - "type": "object", - "properties": { - "title": { - "type": "string" - }, - "prompt": { - "type": "string" - } - } - } - }, - "example": "\"en\": {\n\"title\": \"A New Grain Offering\",\n\"prompt\": \"The central ritual of Shavuot as described in the Torah is a special bread offering that was brought to the Temple. This sacrifice marked the beginning of sacrifices that were brought using grain from that year, as opposed to grains from the previous year, as explained in the Book of Numbers.\"\n}" - }, - "topic": { - "description": "The title of the topic. ", - "type": "string", - "example": "passover" - }, - "anchorRef": { - "description": "The `Ref` the topic is connected to, which should overlap with the requested `Ref` passed through the endpoint. For example, if someone queries for `Bamidbar 28:21`, one of the topics returned is `passover` which has an `anchorRef` of `Numbers 28:16-24` - a range overlapping with our desired `Ref`. ", - "type": "string", - "example": "Numbers 28:16-24" - }, - "anchorRefExpanded": { - "description": "If the `anchorRef` is a ranged `Ref` (i.e. containing more than a single segment), then this is a list of strings, with each string being one of single segment level `Ref`s that together comprise the range. So for example, the `anchorRefExpanded` of `Exodus 1:1-2` would be `[\"Exodus 1:1\", \"Exodus 1:2\"]`. ", - "type": "array", - "items": { - "type": "string" - }, - "example": "\"Numbers 28:16\",\n\"Numbers 28:17\",\n\"Numbers 28:18\",\n\"Numbers 28:19\",\n\"Numbers 28:20\",\n\"Numbers 28:21\",\n\"Numbers 28:22\",\n\"Numbers 28:23\",\n\"Numbers 28:24\"" - } - }, - "example": { - "linkType": "about", - "class": "refTopic", - "dataSource": { - "en": "Aspaklaria", - "he": "אספקלריא", - "slug": "aspaklaria" - }, - "is_sheet": false, - "order": { - "tfidf": 53.476917039392994, - "numDatasource": 2, - "availableLangs": [ - "en", - "he" - ], - "comp_date": -1400, - "order_id": "A00000000300280026", - "pr": 5.15330629652094, - "curatedPrimacy": { - "en": 100, - "he": 0 - } - }, - "descriptions": { - "en": { - "title": "A New Grain Offering", - "prompt": "The central ritual of Shavuot as described in the Torah is a special bread offering that was brought to the Temple. This sacrifice marked the beginning of sacrifices that were brought using grain from that year, as opposed to grains from the previous year, as explained in the Book of Numbers." - } - }, - "topic": "shavuot", - "anchorRef": "Numbers 28:26", - "anchorRefExpanded": [ - "Numbers 28:26" - ] + "en": { + "type": "string" + }, + "he": { + "type": "string" + } + }, + "example": "Daf Yomi" + }, + "displayValue": { + "description": "The name of the Parashah", + "type": "object", + "properties": { + "en": { + "type": "string" + }, + "he": { + "type": "string" + } + }, + "example": "Vayishlach" + }, + "url": { + "description": "The url path on Sefaria where this selection can be found", + "type": "string" + }, + "ref": { + "$ref": "#/components/schemas/ref" + }, + "heRef": { + "description": "The Hebrew equivalent of the `ref`", + "type": "string" + }, + "order": { + "format": "int32", + "description": "This is used internally on Sefaria to arrange the learning schedules in the manner we choose.", + "type": "integer" + }, + "category": { + "description": "Should always return `Tanakh`", + "type": "string" + }, + "extraDetails": { + "description": "Additional details about this learning schedule entry", + "type": "object", + "properties": { + "aliyot": { + "description": "The breakdown of aliyot for a parashah", + "type": "array", + "items": { + "type": "string" + } + } } - }, - "DataSourceJSON": { - "title": "Root Type for DataSourceJSON", - "description": "JSON containing the information as to the source of the data for a given ref-to-topic link. ", + }, + "description": { + "description": "A description of this learning schedule entry if it exists in `he` and `en`", "type": "object", "properties": { + "en": { + "type": "string" + }, + "he": { + "type": "string" + } + } + } + } + }, + "haftarah": { + "type": "array", + "items": { + "type": "object", + "properties": { + "title": { + "description": "This should always read `Haftarah`", + "type": "object", + "properties": { "en": { - "description": "English title of the data source.", - "type": "string", - "example": "Aspaklaria" + "type": "string" }, "he": { - "description": "Hebrew title of the data source.", - "type": "string", - "example": "אספקלריא" - }, - "slug": { - "description": "Unique slug describing the data source. ", - "type": "string", - "example": "aspaklaria" + "type": "string" } + }, + "example": "Daf Yomi" }, - "example": { - "en": "Sheets by Sefaria users", - "he": "דפי מקורות ממשתמשי ספריא", - "slug": "sefaria-users" - } - }, - "OrderTopicLinkJSON": { - "title": "Root Type for OrderTopicLinkJSON", - "description": "This JSON includes the various metrics that are relevant for ordering the link on a topics page. We use these metrics at [Sefaria.org](sefaria.org) to change the order on the topics page.", - "type": "object", - "properties": { - "tfidf": { - "format": "double", - "description": "Results of the [tfidf algorithm](https://en.wikipedia.org/wiki/Tf%E2%80%93idf) run on the `Ref`s within a given topic, as another metric for evaluating the relevance of a given source on a topic page. ", - "type": "number", - "example": "53.476917039392994" - }, - "numDatasource": { - "format": "int32", - "description": "The number of datasources which connect this `Ref` to the topic. A value of `2` will occur when two sources (i.e. `aspaklaria` and `sefaria sheets` both have connections between this `Ref` and this topic.)", - "type": "integer", - "example": "3" - }, - "availableLangs": { - "description": "This topic is available in a list of languages represented as strings with their language code.", - "type": "array", - "items": { - "type": "string" - }, - "example": "[\n\"en\",\n\"he\"\n]" - }, - "comp_date": { - "format": "int32", - "description": "The date when the book referenced in the `Ref` was composed. Negative numbers indicate the work was composed BCE, whereas positive numbers indicate the book was composed CE. ", - "type": "integer", - "example": "-1400" - }, - "order_id": { - "description": "Unique ID for the `order` JSON.", - "type": "string", - "example": "A00000000300280026" - }, - "pr": { - "format": "double", - "description": "`PageRank`. Sefaria calculates `PageRank` for the sources on a given topic page using the internal Sefaria links to create a link graph and then running the [PageRank algorithm](https://en.wikipedia.org/wiki/PageRank) on that. Sources with higher `PageRank` are considered to be more centrally linked and more relevant.", - "type": "number", - "example": "5.15330629652094" + "displayValue": { + "description": "The name of the Haftarah", + "type": "object", + "properties": { + "en": { + "type": "string" }, - "curatedPrimacy": { - "description": "This field is used for manually ordering a source on a topics page. It has a separate order value for each language.", - "type": "object", - "properties": { - "en": { - "format": "int32", - "type": "integer" - }, - "he": { - "format": "int32", - "type": "integer" - } - }, - "example": "\"curatedPrimacy\": {\n\"en\": 100,\n\"he\": 0\n}" + "he": { + "type": "string" } + }, + "example": "Vayishlach" }, - "example": { - "tfidf": 53.476917039392994, - "numDatasource": 2, - "availableLangs": [ - "en", - "he" - ], - "comp_date": -1400, - "order_id": "A00000000300280026", - "pr": 5.15330629652094, - "curatedPrimacy": { - "en": 100, - "he": 0 - } + "url": { + "description": "The url path on Sefaria where this selection can be found", + "type": "string" + }, + "ref": { + "$ref": "#/components/schemas/ref" + }, + "order": { + "format": "int32", + "description": "This is used internally on Sefaria to arrange the learning schedules in the manner we choose.", + "type": "integer" + }, + "category": { + "description": "Should return `Tanakh`", + "type": "string" } + } + } + }, + "date": { + "format": "date-time", + "type": "string" + }, + "he_date": { + "type": "object", + "properties": { + "en": { + "type": "string" + }, + "he": { + "type": "string" + } + } + } + }, + "example": { + "parasha": { + "title": { + "en": "Parashat Hashavua", + "he": "פרשת השבוע" }, - "TermsJSON": { - "title": "Root Type for TermsJSON", - "description": "Term JSON returned to a query for a Term. ", - "required": [ - "name" - ], + "displayValue": { + "en": "Vayakhel-Pekudei", + "he": "ויקהל-פקודי" + }, + "url": "Exodus.35.1-40.38", + "ref": "Exodus 35:1-40:38", + "heRef": "שמות ל״ה:א׳-מ׳:ל״ח", + "order": 1, + "category": "Tanakh", + "extraDetails": { + "aliyot": [ + "Exodus 35:1-35:29", + "Exodus 35:30-37:16", + "Exodus 37:17-37:29", + "Exodus 38:1-39:1", + "Exodus 39:2-39:21", + "Exodus 39:22-39:43", + "Exodus 40:1-40:38", + "Exodus 12:1-12:20" + ] + }, + "description": { + "en": "Vayakhel (“He Assembled”) opens as God commands the Israelites to observe the Sabbath. Moses asks for material donations for the building of the Mishkan (Tabernacle), and the people donate. A group of artisans designated by God begin building the Mishkan and its vessels.\n\nPekudei (“Accountings Of”) is the final Torah reading in the Book of Exodus. It describes the making of priestly garments worn in the Mishkan (Tabernacle) and the completion of its construction. At God’s command, Moses erects the Mishkan and puts its vessels in place, and God's presence fills the Mishkan.", + "he": "בפרשת ויקהל בני ישראל מצווים לשמור את השבת. בני ישראל מתבקשים לתרום חומרים לבניית המשכן; הם נענים לבקשה בנדיבות ומתבקשים להפסיק לתרום. בצלאל ואהליאב מתחילים לנהל את בניית מבנה המשכן, כלי המשכן והחצר. כל פרט מבוצע כפי שציווה אלוהים את משה.\n\nפרשת פקודי, האחרונה בספר שמות, מסכמת את תרומות החומרים השונים למשכן, ואת עשיית בגדי הכהונה. בפרשה מתואר אירוע הקמת המשכן והכנסת הכלים לתוכו. משהושלמה בניית המשכן הענן מכסה את אוהל מועד, והשכינה שורה במשכן. ענן שוכן על המשכן ביום, ובלילה נראית בו אש, לעיני בני ישראל." + } + }, + "haftarah": [ + { + "title": { + "en": "Haftarah", + "he": "הפטרה" + }, + "displayValue": { + "en": "Ezekiel 45:16-46:18", + "he": "יחזקאל מ״ה:ט״ז-מ״ו:י״ח" + }, + "url": "Ezekiel.45.16-46.18", + "ref": "Ezekiel 45:16-46:18", + "order": 2, + "category": "Tanakh" + } + ], + "date": "2026-03-14T00:00:00", + "he_date": { + "en": "Adar 25, 5786", + "he": "אדר 25, 5786" + } + } + }, + "APIIndexResponse": { + "title": "Root Type for APIIndexResponse", + "description": "", + "type": "array", + "items": { + "type": "object", + "properties": { + "contents": { + "description": "This level of the object is a category listing.", + "type": "array", + "items": { "type": "object", "properties": { - "name": { - "description": "The name of the `Term`. Since a `Term` is a shared title node that can be referenced and used by many different `Index` nodes, the `name` field is critical as it contains the shared title. ", - "type": "string", - "example": "Noah" - }, - "titles": { - "description": "Alternative titles for the term in Hebrew and English.", - "type": "array", - "items": { - "$ref": "#/components/schemas/TitlesJSON" + "contents": { + "description": "This level of the object is usually a book level.", + "type": "array", + "items": { + "type": "object", + "properties": { + "categories": { + "description": "A list of categories that this book belongs to.", + "type": "array", + "items": { + "type": "string" + } }, - "example": "\n{\n\"primary\": true,\n\"text\": \"Noach\",\n\"lang\": \"en\"\n},\n{\n\"primary\": true,\n\"text\": \"נח\",\n\"lang\": \"he\"\n},\n{\n\"text\": \"Parashat Noach\",\n\"lang\": \"en\"\n},\n{\n\"text\": \"פרשת נח\",\n\"lang\": \"he\"\n},\n{\n\"text\": \"Noah\",\n\"lang\": \"en\"\n},\n{\n\"text\": \"Parshat Noah\",\n\"lang\": \"en\"\n}\n]" - }, - "scheme": { - "description": "A shared `scheme` for a group of terms. ", - "type": "string", - "example": "Parasha" - }, - "order": { - "format": "int32", - "description": "Terms that share a `scheme` can be ordered within that `scheme`. So for example, _Parshiyot_ within the `Parasha` scheme can be ordered as per the order of the _Parshiyot_. ", - "type": "integer", - "example": "4" - }, - "ref": { - "$ref": "#/components/schemas/ref", - "description": "For a _Parasha_, this is the Sefaria `Ref` which correlates to this _Parasha_ in the text. For example, _Parshat Noah_ corresponds to the ranged `Ref` of `\"Genesis 6:9-11:32\"`. ", - "example": "\"Genesis 6:9-11:32\"" - }, - "category": { - "description": "The category of a specific term. ", - "type": "string", - "example": "`texts`, `Torah Portions`" - } - }, - "example": { - "name": "Noach", - "titles": [ - { - "primary": true, - "text": "Noach", - "lang": "en" + "order": { + "format": "int32", + "description": "This is used to order the texts on the Sefaria website.", + "type": "integer" }, - { - "primary": true, - "text": "נח", - "lang": "he" + "primary_category": { + "description": "The main category that this work falls under.", + "type": "string" }, - { - "text": "Parashat Noach", - "lang": "en" + "enShortDesc": { + "description": "A short description of this book in English.", + "type": "string" }, - { - "text": "פרשת נח", - "lang": "he" + "heShortDesc": { + "description": "A short description of this book in Hebrew.", + "type": "string" }, - { - "text": "Noah", - "lang": "en" + "corpus": { + "description": "The corpus that this work belongs to e.g. `Tanakh` or `Mishnah` etc.", + "type": "string" }, - { - "text": "Parshat Noah", - "lang": "en" + "heTitle": { + "description": "The Hebrew title of this work.", + "type": "string" + }, + "title": { + "description": "The English title of this work.", + "type": "string" } - ], - "scheme": "Parasha", - "order": 2, - "ref": "Genesis 6:9-11:32", - "category": "Torah Portions" - } - }, - "TitlesJSON": { - "title": "Root Type for TopicTitlesJSON", - "description": "Alternative title for a topic, along with the language code representing the language of the given title. ", - "type": "object", - "properties": { - "text": { - "description": "The text of the title", - "type": "string", - "example": "Sukkoth" - }, - "lang": { - "description": "The language of the title, either `en` or `he`. ", - "type": "string", - "example": "he" - }, - "Primary": { - "description": "A field depicting whether or not the title is the primary title. Note: For any given topics, one should expect two titles with this field present and set to `true`, an English and a Hebrew primary title. The English value with `primary` set to `true` will match the string value of the `primaryTitle` field on topic. ", - "type": "boolean", - "example": "false" + } } - }, - "example": { - "text": "Tabernacles", - "lang": "en", - "primary": false + }, + "order": { + "format": "int32", + "description": "This is used to order the texts on the Sefaria website.", + "type": "integer" + }, + "enComplete": { + "description": "Is the entirety of this category available in English", + "type": "boolean" + }, + "heComplete": { + "description": "Is the entirety of this category available in Hebrew", + "type": "boolean" + }, + "enDesc": { + "description": "An English description of the category", + "type": "string" + }, + "heDesc": { + "description": "An Hebrew description of the category", + "type": "string" + }, + "enShortDesc": { + "description": "A short description of this category in English.", + "type": "string" + }, + "heShortDesc": { + "description": "A short description of this category in Hebrew.", + "type": "string" + }, + "heCategory": { + "type": "string" + }, + "category": { + "description": "The current category that these works are nested in.", + "type": "string" + } } + } }, - "RelatedJSON": { - "title": "Root Type for RelatedJSON", - "description": "", - "type": "object", - "properties": { - "links": { - "description": "An array of JSON containing the metadata for links to the reference.", - "type": "array", - "items": { - "$ref": "#/components/schemas/RelatedLinkJSON" - }, - "example": "[\n{\n\"_id\": \"54bd48c4fbfba21733367bfa\",\n\"index_title\": \"Psalms\",\n\"category\": \"Tanakh\",\n\"type\": \"\",\n\"ref\": \"Psalms 51\",\n\"anchorRef\": \"Or HaChaim on Deuteronomy 1:1:1\",\n\"anchorRefExpanded\": [\n\"Or HaChaim on Deuteronomy 1:1:1\"\n],\n\"sourceRef\": \"Psalms 51\",\n\"sourceHeRef\": \"תהילים נ״א\",\n\"anchorVerse\": 1,\n\"sourceHasEn\": true,\n\"compDate\": [\n-1000,\n0\n],\n\"commentaryNum\": 51,\n\"collectiveTitle\": {\n\"en\": \"Psalms\",\n\"he\": \"תהילים\"\n},\n\"heTitle\": \"תהילים\"\n},\n{\n\"_id\": \"54bd48c4fbfba21733367bfc\",\n\"index_title\": \"Pirkei Avot\",\n\"category\": \"Mishnah\",\n\"type\": \"\",\n\"ref\": \"Pirkei Avot 3\",\n\"anchorRef\": \"Or HaChaim on Deuteronomy 1:1:1\",\n\"anchorRefExpanded\": [\n\"Or HaChaim on Deuteronomy 1:1:1\"\n],\n\"sourceRef\": \"Pirkei Avot 3\",\n\"sourceHeRef\": \"משנה אבות ג׳\",\n\"anchorVerse\": 1,\n\"sourceHasEn\": true,\n\"compDate\": [\n190,\n230\n],\n\"commentaryNum\": 3,\n\"collectiveTitle\": {\n\"en\": \"Pirkei Avot\",\n\"he\": \"משנה אבות\"\n},\n\"heTitle\": \"משנה אבות\"\n},\n{\n\"_id\": \"54bd48c4fbfba21733367bfe\",\n\"index_title\": \"Pirkei Avot\",\n\"category\": \"Mishnah\",\n\"type\": \"\",\n\"ref\": \"Pirkei Avot 4\",\n\"anchorRef\": \"Or HaChaim on Deuteronomy 1:1:1\",\n\"anchorRefExpanded\": [\n\"Or HaChaim on Deuteronomy 1:1:1\"\n],\n\"sourceRef\": \"Pirkei Avot 4\",\n\"sourceHeRef\": \"משנה אבות ד׳\",\n\"anchorVerse\": 1,\n\"sourceHasEn\": true,\n\"compDate\": [\n190,\n230\n],\n\"commentaryNum\": 4,\n\"collectiveTitle\": {\n\"en\": \"Pirkei Avot\",\n\"he\": \"משנה אבות\"\n},\n\"heTitle\": \"משנה אבות\"\n},\n{\n\"_id\": \"54bd48c4fbfba21733367c08\",\n\"index_title\": \"Proverbs\",\n\"category\": \"Tanakh\",\n\"type\": \"\",\n\"ref\": \"Proverbs 3\",\n\"anchorRef\": \"Or HaChaim on Deuteronomy 1:1:1\",\n\"anchorRefExpanded\": [\n\"Or HaChaim on Deuteronomy 1:1:1\"\n],\n\"sourceRef\": \"Proverbs 3\",\n\"sourceHeRef\": \"משלי ג׳\",\n\"anchorVerse\": 1,\n\"sourceHasEn\": true,\n\"compDate\": [\n-800,\n-400\n],\n\"commentaryNum\": 3,\n\"collectiveTitle\": {\n\"en\": \"Proverbs\",\n\"he\": \"משלי\"\n},\n\"heTitle\": \"משלי\"\n},\n{\n\"_id\": \"54bd48c4fbfba21733367c0e\",\n\"index_title\": \"Yoma\",\n\"category\": \"Talmud\",\n\"type\": \"\",\n\"ref\": \"Yoma 19b\",\n\"anchorRef\": \"Or HaChaim on Deuteronomy 1:1:1\",\n\"anchorRefExpanded\": [\n\"Or HaChaim on Deuteronomy 1:1:1\"\n],\n\"sourceRef\": \"Yoma 19b\",\n\"sourceHeRef\": \"יומא י״ט ב\",\n\"anchorVerse\": 1,\n\"sourceHasEn\": true,\n\"compDate\": [\n450,\n550\n],\n\"commentaryNum\": 38,\n\"collectiveTitle\": {\n\"en\": \"Yoma\",\n\"he\": \"יומא\"\n},\n\"heTitle\": \"יומא\"\n},\n{\n\"_id\": \"53f17c73fbfba22336eaba1e\",\n\"index_title\": \"Deuteronomy\",\n\"category\": \"Tanakh\",\n\"type\": \"commentary\",\n\"ref\": \"Deuteronomy 1:1\",\n\"anchorRef\": \"Or HaChaim on Deuteronomy 1:1:1\",\n\"anchorRefExpanded\": [\n\"Or HaChaim on Deuteronomy 1:1:1\"\n],\n\"sourceRef\": \"Deuteronomy 1:1\",\n\"sourceHeRef\": \"דברים א׳:א׳\",\n\"anchorVerse\": 1,\n\"sourceHasEn\": true,\n\"compDate\": [\n-1400,\n-400\n],\n\"commentaryNum\": 1.0001,\n\"collectiveTitle\": {\n\"en\": \"Deuteronomy\",\n\"he\": \"דברים\"\n},\n\"heTitle\": \"דברים\"\n},\n{\n\"_id\": \"54bd48c4fbfba21733367bf8\",\n\"index_title\": \"Exodus\",\n\"category\": \"Tanakh\",\n\"type\": \"\",\n\"ref\": \"Exodus 19:2\",\n\"anchorRef\": \"Or HaChaim on Deuteronomy 1:1:1\",\n\"anchorRefExpanded\": [\n\"Or HaChaim on Deuteronomy 1:1:1\"\n],\n\"sourceRef\": \"Exodus 19:2\",\n\"sourceHeRef\": \"שמות י״ט:ב׳\",\n\"anchorVerse\": 1,\n\"sourceHasEn\": true,\n\"compDate\": [\n-1400,\n-400\n],\n\"commentaryNum\": 19.0002,\n\"collectiveTitle\": {\n\"en\": \"Exodus\",\n\"he\": \"שמות\"\n},\n\"heTitle\": \"שמות\"\n},\n{\n\"_id\": \"54bd48c4fbfba21733367c00\",\n\"index_title\": \"Numbers\",\n\"category\": \"Tanakh\",\n\"type\": \"\",\n\"ref\": \"Numbers 20\",\n\"anchorRef\": \"Or HaChaim on Deuteronomy 1:1:1\",\n\"anchorRefExpanded\": [\n\"Or HaChaim on Deuteronomy 1:1:1\"\n],\n\"sourceRef\": \"Numbers 20\",\n\"sourceHeRef\": \"במדבר כ׳\",\n\"anchorVerse\": 1,\n\"sourceHasEn\": true,\n\"compDate\": [\n-1400,\n-400\n],\n\"commentaryNum\": 20,\n\"collectiveTitle\": {\n\"en\": \"Numbers\",\n\"he\": \"במדבר\"\n},\n\"heTitle\": \"במדבר\"\n},\n{\n\"_id\": \"54bd48c4fbfba21733367c02\",\n\"index_title\": \"Numbers\",\n\"category\": \"Tanakh\",\n\"type\": \"\",\n\"ref\": \"Numbers 12:8\",\n\"anchorRef\": \"Or HaChaim on Deuteronomy 1:1:1\",\n\"anchorRefExpanded\": [\n\"Or HaChaim on Deuteronomy 1:1:1\"\n],\n\"sourceRef\": \"Numbers 12:8\",\n\"sourceHeRef\": \"במדבר י״ב:ח׳\",\n\"anchorVerse\": 1,\n\"sourceHasEn\": true,\n\"compDate\": [\n-1400,\n-400\n],\n\"commentaryNum\": 12.0008,\n\"collectiveTitle\": {\n\"en\": \"Numbers\",\n\"he\": \"במדבר\"\n},\n\"heTitle\": \"במדבר\"\n},\n{\n\"_id\": \"54bd48c4fbfba21733367c06\",\n\"index_title\": \"Kiddushin\",\n\"category\": \"Talmud\",\n\"type\": \"\",\n\"ref\": \"Kiddushin 38a\",\n\"anchorRef\": \"Or HaChaim on Deuteronomy 1:1:1\",\n\"anchorRefExpanded\": [\n\"Or HaChaim on Deuteronomy 1:1:1\"\n],\n\"sourceRef\": \"Kiddushin 38a\",\n\"sourceHeRef\": \"קידושין ל״ח א\",\n\"anchorVerse\": 1,\n\"sourceHasEn\": true,\n\"compDate\": [\n450,\n550\n],\n\"commentaryNum\": 75,\n\"collectiveTitle\": {\n\"en\": \"Kiddushin\",\n\"he\": \"קידושין\"\n},\n\"heTitle\": \"קידושין\"\n},\n{\n\"_id\": \"54bd48c4fbfba21733367c0a\",\n\"index_title\": \"Berakhot\",\n\"category\": \"Talmud\",\n\"type\": \"\",\n\"ref\": \"Berakhot 7a\",\n\"anchorRef\": \"Or HaChaim on Deuteronomy 1:1:1\",\n\"anchorRefExpanded\": [\n\"Or HaChaim on Deuteronomy 1:1:1\"\n],\n\"sourceRef\": \"Berakhot 7a\",\n\"sourceHeRef\": \"ברכות ז׳ א\",\n\"anchorVerse\": 1,\n\"sourceHasEn\": true,\n\"compDate\": [\n450,\n550\n],\n\"commentaryNum\": 13,\n\"collectiveTitle\": {\n\"en\": \"Berakhot\",\n\"he\": \"ברכות\"\n},\n\"heTitle\": \"ברכות\"\n},\n{\n\"_id\": \"54bd48c4fbfba21733367c0c\",\n\"index_title\": \"Eruvin\",\n\"category\": \"Talmud\",\n\"type\": \"\",\n\"ref\": \"Eruvin 54a\",\n\"anchorRef\": \"Or HaChaim on Deuteronomy 1:1:1\",\n\"anchorRefExpanded\": [\n\"Or HaChaim on Deuteronomy 1:1:1\"\n],\n\"sourceRef\": \"Eruvin 54a\",\n\"sourceHeRef\": \"עירובין נ״ד א\",\n\"anchorVerse\": 1,\n\"sourceHasEn\": true,\n\"compDate\": [\n450,\n550\n],\n\"commentaryNum\": 107,\n\"collectiveTitle\": {\n\"en\": \"Eruvin\",\n\"he\": \"עירובין\"\n},\n\"heTitle\": \"עירובין\"\n},\n{\n\"_id\": \"54bd48c4fbfba21733367c10\",\n\"index_title\": \"Genesis\",\n\"category\": \"Tanakh\",\n\"type\": \"\",\n\"ref\": \"Genesis 14:13\",\n\"anchorRef\": \"Or HaChaim on Deuteronomy 1:1:1\",\n\"anchorRefExpanded\": [\n\"Or HaChaim on Deuteronomy 1:1:1\"\n],\n\"sourceRef\": \"Genesis 14:13\",\n\"sourceHeRef\": \"בראשית י״ד:י״ג\",\n\"anchorVerse\": 1,\n\"sourceHasEn\": true,\n\"compDate\": [\n-1400,\n-400\n],\n\"commentaryNum\": 14.0013,\n\"collectiveTitle\": {\n\"en\": \"Genesis\",\n\"he\": \"בראשית\"\n},\n\"heTitle\": \"בראשית\"\n},\n{\n\"_id\": \"54bd48c4fbfba21733367c12\",\n\"index_title\": \"Genesis\",\n\"category\": \"Tanakh\",\n\"type\": \"\",\n\"ref\": \"Genesis 25:27\",\n\"anchorRef\": \"Or HaChaim on Deuteronomy 1:1:1\",\n\"anchorRefExpanded\": [\n\"Or HaChaim on Deuteronomy 1:1:1\"\n],\n\"sourceRef\": \"Genesis 25:27\",\n\"sourceHeRef\": \"בראשית כ״ה:כ״ז\",\n\"anchorVerse\": 1,\n\"sourceHasEn\": true,\n\"compDate\": [\n-1400,\n-400\n],\n\"commentaryNum\": 25.0027,\n\"collectiveTitle\": {\n\"en\": \"Genesis\",\n\"he\": \"בראשית\"\n},\n\"heTitle\": \"בראשית\"\n},\n{\n\"_id\": \"5c17ba58b071e100bf4f3c69\",\n\"index_title\": \"Megillah\",\n\"category\": \"Talmud\",\n\"type\": \"\",\n\"ref\": \"Megillah 31b:8\",\n\"anchorRef\": \"Or HaChaim on Deuteronomy 1:1:1\",\n\"anchorRefExpanded\": [\n\"Or HaChaim on Deuteronomy 1:1:1\"\n],\n\"sourceRef\": \"Megillah 31b:8\",\n\"sourceHeRef\": \"מגילה ל״א ב:ח׳\",\n\"anchorVerse\": 1,\n\"sourceHasEn\": true,\n\"compDate\": [\n450,\n550\n],\n\"commentaryNum\": 62.0008,\n\"collectiveTitle\": {\n\"en\": \"Megillah\",\n\"he\": \"מגילה\"\n},\n\"heTitle\": \"מגילה\"\n}\n]" - }, - "sheets": { - "description": "All public source sheets linked to a given `Ref` or containing that `Ref` on the sheet. ", - "type": "array", - "items": { - "$ref": "#/components/schemas/SheetsJSON" - }, - "example": "{\n\"owner\": 65000,\n\"_id\": \"5ec3a6f7c73d4d278311782e\",\n\"id\": \"238181\",\n\"public\": true,\n\"title\": \"סדר תיקון ליל שבועות\",\n\"sheetUrl\": \"/sheets/238181\",\n\"anchorRef\": \"Deuteronomy 1\",\n\"anchorRefExpanded\": [\n\"Deuteronomy 1:2\"\n],\n\"options\": {\n\"numbered\": 0,\n\"boxed\": 0,\n\"assignable\": 0,\n\"bsd\": 1,\n\"language\": \"hebrew\",\n\"layout\": \"stacked\",\n\"langLayout\": \"heRight\",\n\"divineNames\": \"ykvk\",\n\"highlightMode\": 0,\n\"collaboration\": \"none\"\n},\n\"collectionTOC\": null,\n\"ownerName\": \"יותם גונן\",\n\"via\": null,\n\"viaOwnerName\": null,\n\"assignerName\": null,\n\"viaOwnerProfileUrl\": null,\n\"assignerProfileUrl\": null,\n\"ownerProfileUrl\": \"/profile/-2977\",\n\"ownerImageUrl\": \"https://storage.googleapis.com/sefaria-profile-pictures/-2977-1626800304-small.png\",\n\"status\": \"public\",\n\"views\": 8509,\n\"topics\": [],\n\"likes\": [],\n\"summary\": \"\",\n\"attribution\": null,\n\"is_featured\": false,\n\"category\": \"Sheets\",\n\"type\": \"sheet\"\n}" - }, - "notes": { - "description": "Any notes a user has on a given `Ref`. **Note:** This data is only available for logged-in users to view their own notes on a text. This field will always present as an empty array for third party developers. ", - "type": "array", - "items": {} + "order": { + "format": "int32", + "description": "This is used to order the categories on the Sefaria website.", + "type": "integer" + }, + "enComplete": { + "description": "Is the entirety of this category available in English", + "type": "boolean" + }, + "heComplete": { + "description": "Is the entirety of this category available in Hebrew", + "type": "boolean" + }, + "enDesc": { + "description": "An English description of the category", + "type": "string" + }, + "heDesc": { + "description": "An Hebrew description of the category", + "type": "string" + }, + "enShortDesc": { + "description": "A short description of this category in English.", + "type": "string" + }, + "heShortDesc": { + "description": "A short description of this category in Hebrew.", + "type": "string" + }, + "heCategory": { + "type": "string" + }, + "category": { + "description": "The current category that these works are nested in.", + "type": "string" + } + } + } + }, + "searchResponse": { + "title": "Root Type for searchResponse", + "description": "", + "type": "object", + "properties": { + "took": { + "format": "int32", + "type": "integer" + }, + "timed_out": { + "type": "boolean" + }, + "_shards": { + "type": "object", + "properties": { + "total": { + "format": "int32", + "type": "integer" + }, + "successful": { + "format": "int32", + "type": "integer" + }, + "skipped": { + "format": "int32", + "type": "integer" + }, + "failed": { + "format": "int32", + "type": "integer" + } + } + }, + "hits": { + "type": "object", + "properties": { + "total": { + "format": "int32", + "type": "integer" + }, + "max_score": { + "format": "double", + "type": "number" + }, + "hits": { + "type": "array", + "items": { + "type": "object", + "properties": { + "_index": { + "type": "string" }, - "webpages": { - "description": "Webpages related to the `Ref`. ", - "type": "array", - "items": { - "$ref": "#/components/schemas/WebPagesJSON" - }, - "example": "{\n\"url\": \"https://etzion.org.il/en/mission-spies\",\n\"title\": \"The Mission of the Spies | vbm haretzion\",\n\"refs\": [\n\"Joshua 2:2-3\",\n\"I Samuel 26:9\",\n\"Deuteronomy 32:51\",\n\"Numbers 34:16-29\",\n\"Numbers 26:52-56\",\n\"Joshua 14\",\n\"Numbers 13\",\n\"Numbers 20:12\",\n\"Numbers 32:9\",\n\"Deuteronomy 9:1-2\",\n\"Numbers 13:20\",\n\"Genesis 13:17\",\n\"Numbers 13:21\",\n\"Numbers 13:22\",\n\"Deuteronomy 1:37\",\n\"Joshua 2:1\",\n\"Deuteronomy 1:22\",\n\"Deuteronomy 1\",\n\"Numbers 34\",\n\"Deuteronomy 1:21\",\n\"Numbers 32\",\n\"Deuteronomy 1:24\",\n\"Joshua 18:3-9\"\n],\n\"description\": \"Parshat HaShavua Yeshivat Har Etzion PARASHAT SHELACH The Mission of the Spies by Rav Yaakov Medan A The Problem\",\n\"linkerHits\": 283,\n\"domain\": \"etzion.org.il\",\n\"siteName\": \"Torat Har Etzion\",\n\"favicon\": \"https://www.google.com/s2/favicons?domain=etzion.org.il\",\n\"authors\": null,\n\"articleSource\": null,\n\"anchorRef\": \"Deuteronomy 1\",\n\"anchorRefExpanded\": [\n\"Deuteronomy 1:2\"\n]\n}" + "_type": { + "type": "string" }, - "topics": { - "description": "Topics related to a given `Ref`. ", - "type": "array", - "items": { - "$ref": "#/components/schemas/RelatedTopicJSON" - }, - "example": "{\n\"linkType\": \"about\",\n\"class\": \"refTopic\",\n\"dataSource\": {\n\"en\": \"Sheets by Sefaria users\",\n\"he\": \"דפי מקורות ממשתמשי ספריא\",\n\"slug\": \"sefaria-users\"\n},\n\"is_sheet\": false,\n\"generatedBy\": \"sheet-topic-aggregator\",\n\"order\": {\n\"user_votes\": 14,\n\"tfidf\": 10.783834565585545,\n\"numDatasource\": 1,\n\"availableLangs\": [\n\"en\",\n\"he\"\n],\n\"comp_date\": -1400,\n\"order_id\": \"A00000000400010001-00010011\",\n\"pr\": 8.083013483888324,\n\"numSources\": 143\n},\n\"topic\": \"parashat-devarim\",\n\"title\": {\n\"en\": \"Parashat Devarim\",\n\"he\": \"פרשת דברים\"\n},\n\"titleIsTransliteration\": {\n\"en\": false,\n\"he\": false\n},\n\"description\": {\n\"en\": \"Devarim (“Words”) is the first Torah portion in the Book of Deuteronomy, the final book of the Torah. In it, Moses recounts events from the Israelites’ travels in the desert, like the appointment of judges, the sin of the spies, and the wars with the Emorite kings Sihon and Og.\",\n\"he\": \"דברים היא הפרשה הראשונה בספר דברים, החומש החמישי והאחרון בתורה. בספר מובאים נאומי משה, שבהם הוא מזכיר אירועים מהעבר, סוקר מצוות שכבר ניתנו ומצווה מצוות חדשות. בפרשה משה מספר על הצורך במינוי שופטים להנהגת העם. הוא גם מזכיר את חטא המרגלים, שבו התלונן העם על הכניסה העתידית לארץ כנען, את העונש שהוטל על העם לנדוד במדבר ארבעים שנה ואת מלחמות ישראל במדבר.\"\n},\n\"anchorRef\": \"Deuteronomy 1:1-11\",\n\"anchorRefExpanded\": [\n\"Deuteronomy 1:1\",\n\"Deuteronomy 1:2\",\n\"Deuteronomy 1:3\",\n\"Deuteronomy 1:4\",\n\"Deuteronomy 1:5\",\n\"Deuteronomy 1:6\",\n\"Deuteronomy 1:7\",\n\"Deuteronomy 1:8\",\n\"Deuteronomy 1:9\",\n\"Deuteronomy 1:10\",\n\"Deuteronomy 1:11\"\n]\n}" + "_id": { + "type": "string" }, - "manuscripts": { - "description": "An array of manuscript objects containing data of related manuscripts. ", - "type": "array", - "items": { - "$ref": "#/components/schemas/ManuscriptJSON" - }, - "example": "[\n{\n\"manuscript_slug\": \"leningrad-codex-(1008-ce)\",\n\"page_id\": \"LC_Folio_98v\",\n\"image_url\": \"https://manuscripts.sefaria.org/leningrad-color/BIB_LENCDX_F098B.jpg\",\n\"thumbnail_url\": \"https://manuscripts.sefaria.org/leningrad-color/BIB_LENCDX_F098B_thumbnail.jpg\",\n\"anchorRef\": \"Deuteronomy 1:1-21\",\n\"anchorRefExpanded\": [\n\"Deuteronomy 1:2\"\n],\n\"manuscript\": {\n\"slug\": \"leningrad-codex-(1008-ce)\",\n\"title\": \"Leningrad Codex (1008 CE)\",\n\"he_title\": \"כתב יד לנינגרד (1008)\",\n\"source\": \"https://dornsife.usc.edu/wsrp/biblical-manuscripts\",\n\"description\": \"Bruce Zuckerman, West Semitic Research, in collaboration with the Ancient Biblical Manuscript Center; courtesy Russian National Library, Saltykov-Schedrin\",\n\"he_description\": \"\"\n}\n}\n]" + "_score": { + "format": "double", + "type": "number" }, - "media": { - "description": "An array of JSON containing any media related to the `Ref`. ", - "type": "array", - "items": { - "$ref": "#/components/schemas/MediaJSON" - }, - "example": "[\n{\n\"media_url\": \"https://raw.githubusercontent.com/rneiss/PocketTorah/master/data/audio/Devarim-1.mp3\",\n\"source\": \"PocketTorah\",\n\"source_he\": \"\\\"פוקט\\\"-תורה\",\n\"start_time\": \"36.045250\",\n\"end_time\": \"49.118184\",\n\"anchorRef\": \"Deuteronomy 1:2\",\n\"license\": \"CC-BY-SA\",\n\"source_site\": \"http://www.pockettorah.com\",\n\"description\": \"Audio recordings of the weekly Torah portions used in PocketTorah. Avery-Binder style.\",\n\"description_he\": \"הקלטות שמע של פרשות השבוע באמצעות \\\"פוקט-תורה\\\" בסגנון הקריאה של א. בינדר ול.אוורי.\"\n}\n]" - } - }, - "example": { - "links": [ - { - "_id": "54bd48c4fbfba21733367bfa", - "index_title": "Psalms", - "category": "Tanakh", - "type": "", - "ref": "Psalms 51", - "anchorRef": "Or HaChaim on Deuteronomy 1:1:1", - "anchorRefExpanded": [ - "Or HaChaim on Deuteronomy 1:1:1" - ], - "sourceRef": "Psalms 51", - "sourceHeRef": "תהילים נ״א", - "anchorVerse": 1, - "sourceHasEn": true, - "compDate": [ - -1000, - 0 - ], - "commentaryNum": 51, - "collectiveTitle": { - "en": "Psalms", - "he": "תהילים" - }, - "heTitle": "תהילים" - }, - { - "_id": "54bd48c4fbfba21733367bfc", - "index_title": "Pirkei Avot", - "category": "Mishnah", - "type": "", - "ref": "Pirkei Avot 3", - "anchorRef": "Or HaChaim on Deuteronomy 1:1:1", - "anchorRefExpanded": [ - "Or HaChaim on Deuteronomy 1:1:1" - ], - "sourceRef": "Pirkei Avot 3", - "sourceHeRef": "משנה אבות ג׳", - "anchorVerse": 1, - "sourceHasEn": true, - "compDate": [ - 190, - 230 - ], - "commentaryNum": 3, - "collectiveTitle": { - "en": "Pirkei Avot", - "he": "משנה אבות" - }, - "heTitle": "משנה אבות" + "_source": { + "type": "object", + "properties": { + "ref": { + "type": "string" }, - { - "_id": "54bd48c4fbfba21733367bfe", - "index_title": "Pirkei Avot", - "category": "Mishnah", - "type": "", - "ref": "Pirkei Avot 4", - "anchorRef": "Or HaChaim on Deuteronomy 1:1:1", - "anchorRefExpanded": [ - "Or HaChaim on Deuteronomy 1:1:1" - ], - "sourceRef": "Pirkei Avot 4", - "sourceHeRef": "משנה אבות ד׳", - "anchorVerse": 1, - "sourceHasEn": true, - "compDate": [ - 190, - 230 - ], - "commentaryNum": 4, - "collectiveTitle": { - "en": "Pirkei Avot", - "he": "משנה אבות" - }, - "heTitle": "משנה אבות" + "heRef": { + "type": "string" }, - { - "_id": "54bd48c4fbfba21733367c08", - "index_title": "Proverbs", - "category": "Tanakh", - "type": "", - "ref": "Proverbs 3", - "anchorRef": "Or HaChaim on Deuteronomy 1:1:1", - "anchorRefExpanded": [ - "Or HaChaim on Deuteronomy 1:1:1" - ], - "sourceRef": "Proverbs 3", - "sourceHeRef": "משלי ג׳", - "anchorVerse": 1, - "sourceHasEn": true, - "compDate": [ - -800, - -400 - ], - "commentaryNum": 3, - "collectiveTitle": { - "en": "Proverbs", - "he": "משלי" - }, - "heTitle": "משלי" + "version": { + "type": "string" }, - { - "_id": "54bd48c4fbfba21733367c0e", - "index_title": "Yoma", - "category": "Talmud", - "type": "", - "ref": "Yoma 19b", - "anchorRef": "Or HaChaim on Deuteronomy 1:1:1", - "anchorRefExpanded": [ - "Or HaChaim on Deuteronomy 1:1:1" - ], - "sourceRef": "Yoma 19b", - "sourceHeRef": "יומא י״ט ב", - "anchorVerse": 1, - "sourceHasEn": true, - "compDate": [ - 450, - 550 - ], - "commentaryNum": 38, - "collectiveTitle": { - "en": "Yoma", - "he": "יומא" - }, - "heTitle": "יומא" + "lang": { + "type": "string" }, - { - "_id": "53f17c73fbfba22336eaba1e", - "index_title": "Deuteronomy", - "category": "Tanakh", - "type": "commentary", - "ref": "Deuteronomy 1:1", - "anchorRef": "Or HaChaim on Deuteronomy 1:1:1", - "anchorRefExpanded": [ - "Or HaChaim on Deuteronomy 1:1:1" - ], - "sourceRef": "Deuteronomy 1:1", - "sourceHeRef": "דברים א׳:א׳", - "anchorVerse": 1, - "sourceHasEn": true, - "compDate": [ - -1400, - -400 - ], - "commentaryNum": 1.0001, - "collectiveTitle": { - "en": "Deuteronomy", - "he": "דברים" - }, - "heTitle": "דברים" + "version_priority": { + "format": "int32", + "type": "integer" }, - { - "_id": "54bd48c4fbfba21733367bf8", - "index_title": "Exodus", - "category": "Tanakh", - "type": "", - "ref": "Exodus 19:2", - "anchorRef": "Or HaChaim on Deuteronomy 1:1:1", - "anchorRefExpanded": [ - "Or HaChaim on Deuteronomy 1:1:1" - ], - "sourceRef": "Exodus 19:2", - "sourceHeRef": "שמות י״ט:ב׳", - "anchorVerse": 1, - "sourceHasEn": true, - "compDate": [ - -1400, - -400 - ], - "commentaryNum": 19.0002, - "collectiveTitle": { - "en": "Exodus", - "he": "שמות" - }, - "heTitle": "שמות" + "titleVariants": { + "type": "array", + "items": { + "type": "string" + } }, - { - "_id": "54bd48c4fbfba21733367c00", - "index_title": "Numbers", - "category": "Tanakh", - "type": "", - "ref": "Numbers 20", - "anchorRef": "Or HaChaim on Deuteronomy 1:1:1", - "anchorRefExpanded": [ - "Or HaChaim on Deuteronomy 1:1:1" - ], - "sourceRef": "Numbers 20", - "sourceHeRef": "במדבר כ׳", - "anchorVerse": 1, - "sourceHasEn": true, - "compDate": [ - -1400, - -400 - ], - "commentaryNum": 20, - "collectiveTitle": { - "en": "Numbers", - "he": "במדבר" - }, - "heTitle": "במדבר" + "categories": { + "type": "array", + "items": { + "type": "string" + } }, - { - "_id": "54bd48c4fbfba21733367c02", - "index_title": "Numbers", - "category": "Tanakh", - "type": "", - "ref": "Numbers 12:8", - "anchorRef": "Or HaChaim on Deuteronomy 1:1:1", - "anchorRefExpanded": [ - "Or HaChaim on Deuteronomy 1:1:1" - ], - "sourceRef": "Numbers 12:8", - "sourceHeRef": "במדבר י״ב:ח׳", - "anchorVerse": 1, - "sourceHasEn": true, - "compDate": [ - -1400, - -400 - ], - "commentaryNum": 12.0008, - "collectiveTitle": { - "en": "Numbers", - "he": "במדבר" - }, - "heTitle": "במדבר" + "order": { + "type": "string" }, - { - "_id": "54bd48c4fbfba21733367c06", - "index_title": "Kiddushin", - "category": "Talmud", - "type": "", - "ref": "Kiddushin 38a", - "anchorRef": "Or HaChaim on Deuteronomy 1:1:1", - "anchorRefExpanded": [ - "Or HaChaim on Deuteronomy 1:1:1" - ], - "sourceRef": "Kiddushin 38a", - "sourceHeRef": "קידושין ל״ח א", - "anchorVerse": 1, - "sourceHasEn": true, - "compDate": [ - 450, - 550 - ], - "commentaryNum": 75, - "collectiveTitle": { - "en": "Kiddushin", - "he": "קידושין" - }, - "heTitle": "קידושין" + "path": { + "type": "string" }, - { - "_id": "54bd48c4fbfba21733367c0a", - "index_title": "Berakhot", - "category": "Talmud", - "type": "", - "ref": "Berakhot 7a", - "anchorRef": "Or HaChaim on Deuteronomy 1:1:1", - "anchorRefExpanded": [ - "Or HaChaim on Deuteronomy 1:1:1" - ], - "sourceRef": "Berakhot 7a", - "sourceHeRef": "ברכות ז׳ א", - "anchorVerse": 1, - "sourceHasEn": true, - "compDate": [ - 450, - 550 - ], - "commentaryNum": 13, - "collectiveTitle": { - "en": "Berakhot", - "he": "ברכות" - }, - "heTitle": "ברכות" + "pagesheetrank": { + "format": "double", + "type": "number" }, - { - "_id": "54bd48c4fbfba21733367c0c", - "index_title": "Eruvin", - "category": "Talmud", - "type": "", - "ref": "Eruvin 54a", - "anchorRef": "Or HaChaim on Deuteronomy 1:1:1", - "anchorRefExpanded": [ - "Or HaChaim on Deuteronomy 1:1:1" - ], - "sourceRef": "Eruvin 54a", - "sourceHeRef": "עירובין נ״ד א", - "anchorVerse": 1, - "sourceHasEn": true, - "compDate": [ - 450, - 550 - ], - "commentaryNum": 107, - "collectiveTitle": { - "en": "Eruvin", - "he": "עירובין" - }, - "heTitle": "עירובין" + "comp_date": { + "format": "int32", + "type": "integer" }, - { - "_id": "54bd48c4fbfba21733367c10", - "index_title": "Genesis", - "category": "Tanakh", - "type": "", - "ref": "Genesis 14:13", - "anchorRef": "Or HaChaim on Deuteronomy 1:1:1", - "anchorRefExpanded": [ - "Or HaChaim on Deuteronomy 1:1:1" - ], - "sourceRef": "Genesis 14:13", - "sourceHeRef": "בראשית י״ד:י״ג", - "anchorVerse": 1, - "sourceHasEn": true, - "compDate": [ - -1400, - -400 - ], - "commentaryNum": 14.0013, - "collectiveTitle": { - "en": "Genesis", - "he": "בראשית" - }, - "heTitle": "בראשית" + "exact": { + "type": "string" }, - { - "_id": "54bd48c4fbfba21733367c12", - "index_title": "Genesis", - "category": "Tanakh", - "type": "", - "ref": "Genesis 25:27", - "anchorRef": "Or HaChaim on Deuteronomy 1:1:1", - "anchorRefExpanded": [ - "Or HaChaim on Deuteronomy 1:1:1" - ], - "sourceRef": "Genesis 25:27", - "sourceHeRef": "בראשית כ״ה:כ״ז", - "anchorVerse": 1, - "sourceHasEn": true, - "compDate": [ - -1400, - -400 - ], - "commentaryNum": 25.0027, - "collectiveTitle": { - "en": "Genesis", - "he": "בראשית" - }, - "heTitle": "בראשית" + "naive_lemmatizer": { + "type": "string" }, - { - "_id": "5c17ba58b071e100bf4f3c69", - "index_title": "Megillah", - "category": "Talmud", - "type": "", - "ref": "Megillah 31b:8", - "anchorRef": "Or HaChaim on Deuteronomy 1:1:1", - "anchorRefExpanded": [ - "Or HaChaim on Deuteronomy 1:1:1" - ], - "sourceRef": "Megillah 31b:8", - "sourceHeRef": "מגילה ל״א ב:ח׳", - "anchorVerse": 1, - "sourceHasEn": true, - "compDate": [ - 450, - 550 - ], - "commentaryNum": 62.0008, - "collectiveTitle": { - "en": "Megillah", - "he": "מגילה" - }, - "heTitle": "מגילה" + "hebrew_version_title": { + "type": "string" } - ], - "sheets": [ - { - "owner": 10614, - "_id": "60ee8884d6d0a523b1342111", - "id": "335567", - "public": true, - "title": "Gentle Rebuke", - "sheetUrl": "/sheets/335567", - "anchorRef": "Or HaChaim on Deuteronomy 1:1:1", - "anchorRefExpanded": [ - "Or HaChaim on Deuteronomy 1:1:1" - ], - "options": { - "numbered": 0, - "boxed": 0, - "assignable": 0, - "bsd": 0, - "language": "bilingual", - "layout": "sideBySide", - "langLayout": "heRight", - "divineNames": "noSub", - "highlightMode": 0, - "collaboration": "none" - }, - "ownerName": "Rabbi Yossi Orkin", - "ownerProfileUrl": "/profile/yossi-orkin", - "ownerImageUrl": "https://storage.googleapis.com/sefaria-profile-pictures/yossi-orkin-1626415935-small.png", - "status": "public", - "views": 398, - "topics": [ - { - "slug": "deuteronomy", - "asTyped": "Parshat Devarim", - "en": "Parshat Devarim", - "he": "ספר דברים" - } - ], - "likes": [], - "summary": "Parshat Devarim Questions", - "is_featured": false, - "category": "Sheets", - "type": "sheet" - }, - { - "owner": 92910, - "_id": "60ec76e6340e9458714cc018", - "id": "335153", - "public": true, - "title": "R'Isaac Bernstein -1st of series on \"themes in Devorim\".", - "sheetUrl": "/sheets/335153", - "anchorRef": "Or HaChaim on Deuteronomy 1:1:1", - "anchorRefExpanded": [ - "Or HaChaim on Deuteronomy 1:1:1" - ], - "options": { - "numbered": 0, - "boxed": 0, - "assignable": 0, - "bsd": 0, - "language": "hebrew", - "layout": "stacked", - "langLayout": "heRight", - "divineNames": "h", - "highlightMode": 0, - "collaboration": "none" - }, - "ownerName": "I am Anonymous", - "ownerProfileUrl": "/profile/i-am-anonymous", - "ownerImageUrl": "", - "status": "public", - "views": 278, - "topics": [ - { - "slug": "parshanut1", - "asTyped": "Parshanut", - "en": "Parshanut", - "he": "פרשנות" - }, - { - "slug": "torah-portions", - "asTyped": "Parsha", - "en": "Parsha", - "he": "פרשות השבוע" - } - ], - "likes": [], - "summary": "Parsha shiurim by R'Isaac Bernsein", - "is_featured": false, - "category": "Sheets", - "type": "sheet" - }, - { - "owner": 62800, - "_id": "62ed99e8a85e3ca24ef0064f", - "id": "423213", - "public": true, - "title": "OHR HACHAIM ON DEVARIM", - "sheetUrl": "/sheets/423213", - "anchorRef": "Or HaChaim on Deuteronomy 1:1", - "anchorRefExpanded": [ - "Or HaChaim on Deuteronomy 1:1:1" - ], - "options": { - "numbered": 0, - "boxed": 0, - "assignable": 0, - "bsd": 0, - "language": "hebrew", - "layout": "stacked", - "langLayout": "heRight", - "divineNames": "noSub", - "highlightMode": 0, - "collaboration": "none" - }, - "ownerName": "Yitzi Adlin", - "ownerProfileUrl": "/profile/yitzi-adlin", - "ownerImageUrl": "", - "status": "public", - "views": 186, - "topics": [], - "likes": [], - "summary": "", - "is_featured": false, - "category": "Sheets", - "type": "sheet" + } + }, + "highlight": { + "type": "object", + "properties": { + "naive_lemmatizer": { + "type": "array", + "items": { + "type": "string" + } } - ], - "notes": [], - "webpages": [], - "topics": [], - "manuscripts": [], - "media": [] + } + } + } } - }, - "MediaJSON": { - "title": "Root Type for MediaJSON", - "description": "JSON containing metadata for media linked to `Ref`s on [Sefaria](sefaria.org)", + } + } + }, + "aggregations": { + "type": "object", + "properties": { + "path": { "type": "object", "properties": { - "media_url": { - "description": "The URL for the media. ", - "type": "string", - "example": "https://raw.githubusercontent.com/rneiss/PocketTorah/master/data/audio/Devarim-2.mp3" - }, - "source": { - "description": "Source of the media. ", - "type": "string", - "example": "PocketTorah" - }, - "source_he": { - "description": "Hebrew title of the media source. ", - "type": "string", - "example": "פוקט\\\"-תורה" - }, - "start_time": { - "description": "Start time of the media associated with this `Ref`.", - "type": "string", - "example": "0" - }, - "end_time": { - "description": "End time of the portion of the associated media which correlates to this `Ref`. ", - "type": "string", - "example": "27.26476" - }, - "anchorRef": { - "$ref": "#/components/schemas/ref", - "description": "The `Ref` in the query.", - "example": "Deuteronomy 1:2" - }, - "license": { - "description": "The license on the media. ", - "type": "string", - "example": "CC-BY-SA" - }, - "source_site": { - "description": "Website of the source.", - "type": "string", - "example": "http://www.pockettorah.com" - }, - "description": { - "description": "A description of the associated media in English. ", - "type": "string", - "example": "Audio recordings of the weekly Torah portions used in PocketTorah. Avery-Binder style." - }, - "description_he": { - "description": "A description of the associated media in Hebrew. ", - "type": "string", - "example": "הקלטות שמע של פרשות השבוע באמצעות \\\"פוקט-תורה\\\" בסגנון הקריאה של א. בינדר ול.אוורי." + "doc_count_error_upper_bound": { + "format": "int32", + "type": "integer" + }, + "sum_other_doc_count": { + "format": "int32", + "type": "integer" + }, + "buckets": { + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "type": "string" + }, + "doc_count": { + "format": "int32", + "type": "integer" + } + } } + } + } + } + } + } + }, + "example": { + "took": 11, + "timed_out": false, + "_shards": { + "total": 5, + "successful": 5, + "skipped": 0, + "failed": 0 + }, + "hits": { + "total": 7, + "max_score": 16692.562, + "hits": [ + { + "_index": "text-b", + "_type": "text", + "_id": "Shabbat 73b:7 (Sefaria Community Translation [en])", + "_score": 16692.562, + "_source": { + "ref": "Shabbat 73b:7", + "heRef": "שבת ע״ג ב:ז׳", + "version": "Sefaria Community Translation", + "lang": "en", + "version_priority": 1, + "titleVariants": [ + "Masekhet Shabbat", + "Shabbos", + "Shabbath", + "Talmud Shabbat", + "Tractate Shabbat", + "Shab.", + "Sabb.", + "Sabbath", + "BT Shabbat", + "Shabbat" + ], + "categories": [ + "Talmud", + "Bavli", + "Seder Moed" + ], + "order": "A00200000100001460007", + "path": "Talmud/Bavli/Seder Moed/Shabbat", + "pagesheetrank": 769.444762983379, + "comp_date": 450, + "exact": "קוצר: harvest Rashi : Is דש = when the kernel falls from natural covering. This means that we can't peel banana... But we can if it's לאלתר - for immediate consumption. Tosphot : Is דש = when your removing something from natural connection ", + "naive_lemmatizer": "קוצר: harvest Rashi : Is דש = when the kernel falls from natural covering. This means that we can't peel banana... But we can if it's לאלתר - for immediate consumption. Tosphot : Is דש = when your removing something from natural connection ", + "hebrew_version_title": "תרגום קהילת ספריא" + }, + "highlight": { + "naive_lemmatizer": [ + "This means that we can't peel banana... But we can if it's לאלתר - for immediate consumption. Tosphot : Is דש = when your removing something from natural connection" + ] + } + }, + { + "_index": "text-b", + "_type": "text", + "_id": "II Samuel 18:12 (Sefaria Community Translation [en])", + "_score": 6415.7573, + "_source": { + "ref": "II Samuel 18:12", + "heRef": "שמואל ב י״ח:י״ב", + "version": "Sefaria Community Translation", + "lang": "en", + "version_priority": 8, + "titleVariants": [ + "2Sam", + "Second Samuel", + "Shmuel Bet", + "Shmuel II", + "Samuel II", + "2 Sam", + "II Shmuel", + "II Sam.", + "II Sam", + "2Sam.", + "2 Samuel", + "II Shemuel", + "2 Sam.", + "II. Samuel", + "II. Sam.", + "Sam. II", + "II Samuel" + ], + "categories": [ + "Tanakh", + "Prophets" + ], + "order": "A00000100300180012", + "path": "Tanakh/Prophets/II Samuel", + "pagesheetrank": 287.86486919568637, + "comp_date": -1000, + "exact": "And the dude said to Yoav: Bro, I just found the evil guy on a banana papaya tree. Let's go murder him ruthlessly, against the king's orders.", + "naive_lemmatizer": "And the dude said to Yoav: Bro, I just found the evil guy on a banana papaya tree. Let's go murder him ruthlessly, against the king's orders." + }, + "highlight": { + "naive_lemmatizer": [ + "And the dude said to Yoav: Bro, I just found the evil guy on a banana papaya tree. Let's go murder him ruthlessly, against the king's orders." + ] + } + }, + { + "_index": "text-b", + "_type": "text", + "_id": "English Explanation of Mishnah Maasrot 1:1:4 (Mishnah Yomit by Dr. Joshua Kulp [en])", + "_score": 36.80613, + "_source": { + "ref": "English Explanation of Mishnah Maasrot 1:1:4", + "heRef": "ביאור אנגלי על משנה מעשרות א׳:א׳:ד׳", + "version": "Mishnah Yomit by Dr. Joshua Kulp", + "lang": "en", + "version_priority": 0, + "titleVariants": [], + "categories": [ + "Mishnah Commentary", + "Modern Commentary on Mishnah", + "English Explanation of Mishnah", + "Seder Zeraim" + ], + "order": "A001008001000006002000100010004", + "path": "Mishnah Commentary/Modern Commentary on Mishnah/English Explanation of Mishnah/Seder Zeraim/English Explanation of Mishnah Maasrot", + "pagesheetrank": 1.44, + "comp_date": 1997, + "exact": " But whatever is not considered food in the earlier stages [of its growth] but only in its later stages, is not liable [to tithe] until it can be considered food. However, if the produce is not considered edible at its earlier stage of growth, if it is nevertheless harvested at this earlier stage, it can be eaten without being tithed. An example might be a banana. A banana harvested at an earlier stage is not considered food and therefore one who does eat such a banana need not tithe it. It would only need to be tithed if harvested when ripe.", + "naive_lemmatizer": " But whatever is not considered food in the earlier stages [of its growth] but only in its later stages, is not liable [to tithe] until it can be considered food. However, if the produce is not considered edible at its earlier stage of growth, if it is nevertheless harvested at this earlier stage, it can be eaten without being tithed. An example might be a banana. A banana harvested at an earlier stage is not considered food and therefore one who does eat such a banana need not tithe it. It would only need to be tithed if harvested when ripe." + }, + "highlight": { + "naive_lemmatizer": [ + "An example might be a banana. A banana harvested at an earlier stage is not considered food and therefore one who does eat such a banana need not tithe it." + ] + } + }, + { + "_index": "text-b", + "_type": "text", + "_id": "Kedushat Levi, Leviticus, Emor 11 (Kedushat Levi translated by Rb. Eliyahu Munk [en])", + "_score": 27.977217, + "_source": { + "ref": "Kedushat Levi, Leviticus, Emor 11", + "heRef": "קדושת לוי, ויקרא, אמור י״א", + "version": "Kedushat Levi translated by Rb. Eliyahu Munk", + "lang": "en", + "version_priority": 1, + "titleVariants": [ + "Emor", + "Parashat Emor", + "Parshat Emor" + ], + "categories": [ + "Chasidut", + "Early Works" + ], + "order": "A0090000010410011", + "path": "Chasidut/Early Works/Kedushat Levi", + "pagesheetrank": 4.840000000000001, + "comp_date": 1772, + "exact": "The sages in Rosh Hashanah 12 alluded to this when ‎they stated that “the Jewish people are in the habit of counting ‎Biblical calendar dates as based on the view of Rabbi Eliezer when ‎speaking of the deluge, , whereas they do so according ‎to the view of Rabbi Joshua when counting the seasons the ‎seasons of the year.” . The Talmud adds that the ‎astronomers of the gentile nations also count the deluge ‎according to the opinion held by Rabbi Joshua. [The whole ‎statement is extremely puzzling, our author contributing a novel ‎interpretation by understanding it as relating to the mystical ‎dimension of life on earth. Ed.] Our author raises the ‎question that seeing that the astronomers of the gentile nations ‎adopt an opinion that is contrary to halachah , how can they ‎be described as “sages of gentile nations?” We have a rule that ‎anyone contradicting what is written in the Torah or recorded as ‎wisdom by King Solomon is an absolute fool.‎ We need to explain above statement allegorically. We have ‎already explained in connection with a statement in the Talmud ‎‎ Pessachim 118 that when Rabbi Yishmael, son of Rabbi ‎Yossi, fell ill Rabbi Yehudah sent to ‎him asking him to tell them one or two Torah insights of his ‎father that he had not previously revealed. He responded by ‎offering an interpretation of a difficult passage in psalms 117,1 ‎where the psalmist appears to invite the nations of the world to ‎praise G’d, saying: ‎הללו את ה' כל גויים שבחוהו כל האומים‎, “praise the ‎Lord all you nations; extol Him all you peoples!” Seeing that the ‎next verse describes the miracles G’d has performed on behalf of ‎the Jewish people, what reason would the gentiles have to praise ‎G’d for this? He answered that if the gentiles are required to ‎praise the Lord for having been witnesses to miracles performed ‎for the Israelites, how much more so must the Israelites be duty ‎bound to praise Him on account of this! How much loving ‎kindness have we experienced at the hands of G’d without having ‎thanked Him adequately! Thereupon Rabbi asked for another ‎pearl of wisdom that Rabbi Yossi had not yet revealed. He told ‎them that at the time when the messiah would come, the gentiles ‎would welcome him with gifts. It seems clear that the words ‎שבחוהו‎, “praise Him,” in the psalm are not meant as ‎acknowledgement of what G’d had done for the gentiles, but for ‎what He had done for His people, the Israelites. It is the ‎overriding duty of all of G’d’s creatures, including the beasts in ‎the field to praise the Creator in accordance with the manner in ‎which they are capable of doing this. This includes even the flora ‎that appear tied to the place in which they grow, and which do ‎not even enjoy the ability to move freely on G’d’s earth. How ‎much more so must the more advanced forms of life on earth ‎praise their Creator, seeing that they are able to enjoy so much ‎more of the world they have been born into?‎ We may take a cue from the words of Rashi on ‎‎ Shabbat 50, “whatever G’d created, He created for the ‎greater glory of His name.” When Jews are killed for the ‎sanctification of the Lord’s name they do so joyfully.‎ It is therefore not difficult to comprehend that the psalmist ‎reminds the gentiles of their duty to praise the Lord as He has ‎given them an opportunity to carry out His will. Miracles which ‎G’d performed for the Israelites frequently were at the expense of ‎the gentiles who had oppressed them. The psalmist warns these ‎gentiles that they are obligated to praise the Lord for having been ‎privileged to experience His greatness even while they perish in ‎the process. The fact that they had been chosen to be G’d’s means ‎of showing His might to the Israelites is something they have to ‎acknowledge, not grudgingly, but joyfully. The fact that they ‎deliberately try to blind themselves to such recognition, stamps ‎them as utter fools. The perennial problem with fools is that they ‎do not wish to be enlightened, believing that they are wise.‎ However, there will come a time, when G’d will open the eyes ‎of the blind and all of them [those who have survived the ‎cataclysmic events occurring first, Ed.] will turn into ‎servants of the Lord. At the time of the Exodus, when G’d performed miracles that ‎enabled the Israelites to be redeemed, He revealed His power to ‎the Egyptians at the same time, of course. However, the latter, ‎almost until their last breath did not acknowledge that it was G’d ‎Who was fighting them when the waves of the sea of reeds came ‎crashing over them. ‎ The Jews have not always been better, so that Isaiah 2,5 tells ‎us that the time will come when –after the gentiles have already ‎acknowledged all this in Isaiah 2,3 – they too will experienced the ‎‎“light” of the Lord. In psalms 118 David foresees all this already ‎hundreds of years before the prophet Isaiah.‎ Let us revert to the passage in the Talmud Rosh ‎Hashanah 12, and the strange statement referring to the ‎astronomers of the gentiles as “sages.” Traditionally, the month ‎of Tishrey symbolizes that G’d’s attribute of Justice, sits in ‎judgment of His creatures on the first day of that month. The ‎month of Nissan, however symbolizes the attribute of Mercy, ‎loving kindness, as it is the month during which the Jewish ‎people, who had a minimum of merits to their credit, were ‎redeemed after hundreds of years of persecution. When looked at ‎from the perspective of the gentiles, the month of Nissan ‎symbolizes the attribute of Justice, as during that month G’d ‎brought retribution on the leading nation of the gentiles, ‎reducing a world power, Egypt, to becoming a “banana republic,” ‎practically overnight. The effect of this was so overwhelming that ‎Rahab from Jericho, who harbored Joshua’s spies, was still in awe ‎of that event. .‎ Rabbi Eliezer correctly realized that for the gentiles what we ‎perceive as unmitigated disaster, actually is the catalyst that ‎brings them to recognize G’d in the end, by seeing in the month ‎of Tishrey also a harbinger of the attribute of Mercy, seeing it is ‎the gentiles’ last opportunity to change their ways and survive as ‎servants of G’d. The Talmud introduces a reference to the period during ‎which the deluge occurred, i.e. in Marcheshvan, although neither ‎Rabbi Joshua nor Rabbi Eliezer had made reference to that event ‎at all. When the “sages” of the gentile nations are described as ‎taking their cue from the deluge as being in accord with Rabbi ‎Joshua, even when referring to the deluge, what the Talmud ‎means is that these “gentile sages” recognized that the disasters ‎that had struck them was also an outpouring of G’d’s love, as this ‎enabled the survivors to recognize G’d as a G’d of love after all. ‎‎ [According to the Talmud there the gentile sages ‎recognized what Yitro recognized later also, i.e. ‎that when G’d brings on retribution He makes the punishment fit ‎the crime. Ed.] ‎", + "naive_lemmatizer": "The sages in Rosh Hashanah 12 alluded to this when ‎they stated that “the Jewish people are in the habit of counting ‎Biblical calendar dates as based on the view of Rabbi Eliezer when ‎speaking of the deluge, , whereas they do so according ‎to the view of Rabbi Joshua when counting the seasons the ‎seasons of the year.” . The Talmud adds that the ‎astronomers of the gentile nations also count the deluge ‎according to the opinion held by Rabbi Joshua. [The whole ‎statement is extremely puzzling, our author contributing a novel ‎interpretation by understanding it as relating to the mystical ‎dimension of life on earth. Ed.] Our author raises the ‎question that seeing that the astronomers of the gentile nations ‎adopt an opinion that is contrary to halachah , how can they ‎be described as “sages of gentile nations?” We have a rule that ‎anyone contradicting what is written in the Torah or recorded as ‎wisdom by King Solomon is an absolute fool.‎ We need to explain above statement allegorically. We have ‎already explained in connection with a statement in the Talmud ‎‎ Pessachim 118 that when Rabbi Yishmael, son of Rabbi ‎Yossi, fell ill Rabbi Yehudah sent to ‎him asking him to tell them one or two Torah insights of his ‎father that he had not previously revealed. He responded by ‎offering an interpretation of a difficult passage in psalms 117,1 ‎where the psalmist appears to invite the nations of the world to ‎praise G’d, saying: ‎הללו את ה' כל גויים שבחוהו כל האומים‎, “praise the ‎Lord all you nations; extol Him all you peoples!” Seeing that the ‎next verse describes the miracles G’d has performed on behalf of ‎the Jewish people, what reason would the gentiles have to praise ‎G’d for this? He answered that if the gentiles are required to ‎praise the Lord for having been witnesses to miracles performed ‎for the Israelites, how much more so must the Israelites be duty ‎bound to praise Him on account of this! How much loving ‎kindness have we experienced at the hands of G’d without having ‎thanked Him adequately! Thereupon Rabbi asked for another ‎pearl of wisdom that Rabbi Yossi had not yet revealed. He told ‎them that at the time when the messiah would come, the gentiles ‎would welcome him with gifts. It seems clear that the words ‎שבחוהו‎, “praise Him,” in the psalm are not meant as ‎acknowledgement of what G’d had done for the gentiles, but for ‎what He had done for His people, the Israelites. It is the ‎overriding duty of all of G’d’s creatures, including the beasts in ‎the field to praise the Creator in accordance with the manner in ‎which they are capable of doing this. This includes even the flora ‎that appear tied to the place in which they grow, and which do ‎not even enjoy the ability to move freely on G’d’s earth. How ‎much more so must the more advanced forms of life on earth ‎praise their Creator, seeing that they are able to enjoy so much ‎more of the world they have been born into?‎ We may take a cue from the words of Rashi on ‎‎ Shabbat 50, “whatever G’d created, He created for the ‎greater glory of His name.” When Jews are killed for the ‎sanctification of the Lord’s name they do so joyfully.‎ It is therefore not difficult to comprehend that the psalmist ‎reminds the gentiles of their duty to praise the Lord as He has ‎given them an opportunity to carry out His will. Miracles which ‎G’d performed for the Israelites frequently were at the expense of ‎the gentiles who had oppressed them. The psalmist warns these ‎gentiles that they are obligated to praise the Lord for having been ‎privileged to experience His greatness even while they perish in ‎the process. The fact that they had been chosen to be G’d’s means ‎of showing His might to the Israelites is something they have to ‎acknowledge, not grudgingly, but joyfully. The fact that they ‎deliberately try to blind themselves to such recognition, stamps ‎them as utter fools. The perennial problem with fools is that they ‎do not wish to be enlightened, believing that they are wise.‎ However, there will come a time, when G’d will open the eyes ‎of the blind and all of them [those who have survived the ‎cataclysmic events occurring first, Ed.] will turn into ‎servants of the Lord. At the time of the Exodus, when G’d performed miracles that ‎enabled the Israelites to be redeemed, He revealed His power to ‎the Egyptians at the same time, of course. However, the latter, ‎almost until their last breath did not acknowledge that it was G’d ‎Who was fighting them when the waves of the sea of reeds came ‎crashing over them. ‎ The Jews have not always been better, so that Isaiah 2,5 tells ‎us that the time will come when –after the gentiles have already ‎acknowledged all this in Isaiah 2,3 – they too will experienced the ‎‎“light” of the Lord. In psalms 118 David foresees all this already ‎hundreds of years before the prophet Isaiah.‎ Let us revert to the passage in the Talmud Rosh ‎Hashanah 12, and the strange statement referring to the ‎astronomers of the gentiles as “sages.” Traditionally, the month ‎of Tishrey symbolizes that G’d’s attribute of Justice, sits in ‎judgment of His creatures on the first day of that month. The ‎month of Nissan, however symbolizes the attribute of Mercy, ‎loving kindness, as it is the month during which the Jewish ‎people, who had a minimum of merits to their credit, were ‎redeemed after hundreds of years of persecution. When looked at ‎from the perspective of the gentiles, the month of Nissan ‎symbolizes the attribute of Justice, as during that month G’d ‎brought retribution on the leading nation of the gentiles, ‎reducing a world power, Egypt, to becoming a “banana republic,” ‎practically overnight. The effect of this was so overwhelming that ‎Rahab from Jericho, who harbored Joshua’s spies, was still in awe ‎of that event. .‎ Rabbi Eliezer correctly realized that for the gentiles what we ‎perceive as unmitigated disaster, actually is the catalyst that ‎brings them to recognize G’d in the end, by seeing in the month ‎of Tishrey also a harbinger of the attribute of Mercy, seeing it is ‎the gentiles’ last opportunity to change their ways and survive as ‎servants of G’d. The Talmud introduces a reference to the period during ‎which the deluge occurred, i.e. in Marcheshvan, although neither ‎Rabbi Joshua nor Rabbi Eliezer had made reference to that event ‎at all. When the “sages” of the gentile nations are described as ‎taking their cue from the deluge as being in accord with Rabbi ‎Joshua, even when referring to the deluge, what the Talmud ‎means is that these “gentile sages” recognized that the disasters ‎that had struck them was also an outpouring of G’d’s love, as this ‎enabled the survivors to recognize G’d as a G’d of love after all. ‎‎ [According to the Talmud there the gentile sages ‎recognized what Yitro recognized later also, i.e. ‎that when G’d brings on retribution He makes the punishment fit ‎the crime. Ed.] ‎", + "hebrew_version_title": "קדושת לוי, מתורגם בידי רבי אליהו מונק" + }, + "highlight": { + "naive_lemmatizer": [ + "gentiles, the month of Nissan ‎symbolizes the attribute of Justice, as during that month G’d ‎brought retribution on the leading nation of the gentiles, ‎reducing a world power, Egypt, to becoming a “banana" + ] + } + }, + { + "_index": "text-b", + "_type": "text", + "_id": "Peninei Halakhah, Shabbat 12:2:3 (Peninei Halakhah, English ed. Yeshivat Har Bracha [en])", + "_score": 19.184504, + "_source": { + "ref": "Peninei Halakhah, Shabbat 12:2:3", + "heRef": "פניני הלכה, שבת י״ב:ב׳:ג׳", + "version": "Peninei Halakhah, English ed. Yeshivat Har Bracha", + "lang": "en", + "version_priority": 0, + "titleVariants": [], + "categories": [ + "Halakhah", + "Modern", + "Peninei Halakhah" + ], + "order": "A004014004010002001200020003", + "path": "Halakhah/Modern/Peninei Halakhah/Peninei Halakhah, Shabbat", + "pagesheetrank": 1.44, + "comp_date": 2007, + "exact": "May one mash foods like bananas and avocados? Some are stringent and forbid doing so with a fork, including for immediate consumption. Even the stringent opinion permits mashing these foods with a spoon, because that is considered a shinui. However, the lenient position allows mashing bananas and avocados even with a fork for immediate consumption, and the halakha follows this position. Thus one may mash a banana or avocado with a fork for immediate consumption. As we have already seen, the prohibition of Toḥen is not relevant to food being prepared for immediate consumption, as long as the mashing is not done with a special utensil designed for this purpose. 3 . There are several reasons for this permission:a) According to most poskim, the prohibition of Toḥen does not apply to fruits or vegetables that are edible .b) Even though SA 321:12 rules in accordance with those who are stringent, nevertheless, when the food is being prepared for immediate consumption, there is no prohibition .c) Even if the prohibition of Toḥen were applicable, according to Igrot Moshe 4:74, Toḥen2, since these foods remain a solid mass even after being mashed, Toḥen does not apply here at all.d) Mashing with a fork already constitutes a shinui, as this is not the normal way to grind . Yeḥaveh Da’at 5:27 and Menuḥat Ahava 2:8:12 permit this in practice. However, Ḥazon Ish OḤ §57 is stringent, and does not allow it even when the food being prepared will be consumed immediately. He also maintains that mashing is considered a type of Toḥen since it breaks down the structure of the fruit. He adds that if the mashing is done to feed the food to a baby, then it is prohibited based on MA 321:14, because it renders the food edible. SSK 6:1 and Hilkhot Shabbat Be-Shabbat 1:12:15 also state that one should be stringent. But they allow mashing with a spoon, as this definitely constitutes a shinui. Similarly, if the foods are very soft, then even those who are normally stringent allow mashing them with a fork. But in practice the primary position is the lenient one, as this is the position of practically all Rishonim.", + "naive_lemmatizer": "May one mash foods like bananas and avocados? Some are stringent and forbid doing so with a fork, including for immediate consumption. Even the stringent opinion permits mashing these foods with a spoon, because that is considered a shinui. However, the lenient position allows mashing bananas and avocados even with a fork for immediate consumption, and the halakha follows this position. Thus one may mash a banana or avocado with a fork for immediate consumption. As we have already seen, the prohibition of Toḥen is not relevant to food being prepared for immediate consumption, as long as the mashing is not done with a special utensil designed for this purpose. 3 . There are several reasons for this permission:a) According to most poskim, the prohibition of Toḥen does not apply to fruits or vegetables that are edible .b) Even though SA 321:12 rules in accordance with those who are stringent, nevertheless, when the food is being prepared for immediate consumption, there is no prohibition .c) Even if the prohibition of Toḥen were applicable, according to Igrot Moshe 4:74, Toḥen2, since these foods remain a solid mass even after being mashed, Toḥen does not apply here at all.d) Mashing with a fork already constitutes a shinui, as this is not the normal way to grind . Yeḥaveh Da’at 5:27 and Menuḥat Ahava 2:8:12 permit this in practice. However, Ḥazon Ish OḤ §57 is stringent, and does not allow it even when the food being prepared will be consumed immediately. He also maintains that mashing is considered a type of Toḥen since it breaks down the structure of the fruit. He adds that if the mashing is done to feed the food to a baby, then it is prohibited based on MA 321:14, because it renders the food edible. SSK 6:1 and Hilkhot Shabbat Be-Shabbat 1:12:15 also state that one should be stringent. But they allow mashing with a spoon, as this definitely constitutes a shinui. Similarly, if the foods are very soft, then even those who are normally stringent allow mashing them with a fork. But in practice the primary position is the lenient one, as this is the position of practically all Rishonim." + }, + "highlight": { + "naive_lemmatizer": [ + "Thus one may mash a banana or avocado with a fork for immediate consumption." + ] + } + }, + { + "_index": "text-b", + "_type": "text", + "_id": "Klein Dictionary, בָּנָנָה (Carta Jerusalem; 1st edition, 1987 [en])", + "_score": 1.032272, + "_source": { + "ref": "Klein Dictionary, בָּנָנָה", + "heRef": "מילון קליין, בָּנָנָה", + "version": "Carta Jerusalem; 1st edition, 1987", + "lang": "en", + "version_priority": 0, + "titleVariants": [ + "בָּנָנָה" + ], + "categories": [ + "Reference", + "Dictionary" + ], + "order": "A013000001B00729", + "path": "Reference/Dictionary/Klein Dictionary", + "pagesheetrank": 0.04000000000000001, + "comp_date": 1973, + "exact": " בָּנָנָה f.n. FW banana. [Sp. and Portuguese banana , from earlier Congolese banam .]", + "naive_lemmatizer": " בָּנָנָה f.n. FW banana. [Sp. and Portuguese banana , from earlier Congolese banam .]", + "hebrew_version_title": "כרטא תשמ״ז" + }, + "highlight": { + "naive_lemmatizer": [ + "FW banana. [Sp. and Portuguese banana , from earlier Congolese banam .]" + ] + } + }, + { + "_index": "text-b", + "_type": "text", + "_id": "Klein Dictionary, מוֹז (Carta Jerusalem; 1st edition, 1987 [en])", + "_score": 0.9270322, + "_source": { + "ref": "Klein Dictionary, מוֹז", + "heRef": "מילון קליין, מוֹז", + "version": "Carta Jerusalem; 1st edition, 1987", + "lang": "en", + "version_priority": 0, + "titleVariants": [ + "מוֹז" + ], + "categories": [ + "Reference", + "Dictionary" + ], + "order": "A013000001M00857", + "path": "Reference/Dictionary/Klein Dictionary", + "pagesheetrank": 0.04000000000000001, + "comp_date": 1973, + "exact": " מוֹז m.n. NH banana . [Introduced by Eliezer ben Yehudah as a loan word from Arab. mauz , which is related to Aram. מוֹזָא .]", + "naive_lemmatizer": " מוֹז m.n. NH banana . [Introduced by Eliezer ben Yehudah as a loan word from Arab. mauz , which is related to Aram. מוֹזָא .]", + "hebrew_version_title": "כרטא תשמ״ז" + }, + "highlight": { + "naive_lemmatizer": [ + "NH banana . [Introduced by Eliezer ben Yehudah as a loan word from Arab. mauz , which is related to Aram. מוֹזָא .]" + ] + } + } + ] + }, + "aggregations": { + "path": { + "doc_count_error_upper_bound": 0, + "sum_other_doc_count": 0, + "buckets": [ + { + "key": "Reference/Dictionary/Klein Dictionary", + "doc_count": 2 + }, + { + "key": "Chasidut/Early Works/Kedushat Levi", + "doc_count": 1 + }, + { + "key": "Halakhah/Modern/Peninei Halakhah/Peninei Halakhah, Shabbat", + "doc_count": 1 + }, + { + "key": "Mishnah Commentary/Modern Commentary on Mishnah/English Explanation of Mishnah/Seder Zeraim/English Explanation of Mishnah Maasrot", + "doc_count": 1 + }, + { + "key": "Talmud/Bavli/Seder Moed/Shabbat", + "doc_count": 1 + }, + { + "key": "Tanakh/Prophets/II Samuel", + "doc_count": 1 + } + ] + } + } + } + }, + "v3TextsJson": { + "title": "Root Type for v3TextsJson", + "description": "The JSON returned from the `v3` `texts/` endpoint. ", + "type": "object", + "properties": { + "versions": { + "description": "The list of requested `version` objects. It includes all the data that is unique to the requested `versions`. \n", + "type": "array", + "items": { + "$ref": "#/components/schemas/v3TextVersionsJSON" + }, + "example": "{\n\"status\": \"locked\",\n\"priority\": 2,\n\"license\": \"CC-BY-SA\",\n\"versionNotes\": \"Miqra According to the Masorah (MAM) is a digital Hebrew edition of the Tanakh based on the Aleppo Codex and related manuscripts. It is designed for readers, and as such it contains added elements to aid vocalization of the text. For instance: When an accent is marked in an unstressed syllable, an extra accent is added in the proper place (pashta, zarqa, segol, telisha). Legarmeih and paseq are visibly distinguished. Qamaz qatan is indicated by its designated Unicode character (alternatives are documented where traditions differ about its application).
The text of MAM is fully documented. The complete introduction to the edition (Hebrew) explains the types of editorial decisions that have been made and the reasons for them (English abstract). In addition, every word in the Bible about which there is some textual concern or ambiguity includes a documentation note; these notes can be viewed conveniently here. If an error is discovered, it may be reported to User:Dovi at Hebrew Wikisource. Please check the documentation notes before reporting an error.\",\n\"formatAsPoetry\": \"\",\n\"digitizedBySefaria\": \"\",\n\"method\": \"\",\n\"heversionSource\": \"\",\n\"versionUrl\": \"\",\n\"versionTitleInHebrew\": \"מקרא על פי המסורה\",\n\"versionNotesInHebrew\": \"\",\n\"shortVersionTitle\": \"\",\n\"shortVersionTitleInHebrew\": \"\",\n\"extendedNotes\": \"\",\n\"extendedNotesHebrew\": \"\",\n\"purchaseInformationImage\": \"\",\n\"purchaseInformationURL\": \"\",\n\"hasManuallyWrappedRefs\": \"\",\n\"actualLanguage\": \"he\",\n\"languageFamilyName\": \"hebrew\",\n\"isBaseText\": true,\n\"isSource\": true,\n\"isPrimary\": true,\n\"direction\": \"rtl\",\n\"language\": \"he\",\n\"versionSource\": \"https://he.wikisource.org/wiki/%D7%9E%D7%A9%D7%AA%D7%9E%D7%A9:Dovi/%D7%9E%D7%A7%D7%A8%D7%90_%D7%A2%D7%9C_%D7%A4%D7%99_%D7%94%D7%9E%D7%A1%D7%95%D7%A8%D7%94\",\n\"versionTitle\": \"Miqra according to the Masorah\",\n\"text\": [\n[\n\"חֲז֖וֹן עֹֽבַדְיָ֑ה כֹּֽה־אָמַר֩ אֲדֹנָ֨י יֱהֹוִ֜ה לֶאֱד֗וֹם שְׁמוּעָ֨ה שָׁמַ֜עְנוּ מֵאֵ֤ת יְהֹוָה֙ וְצִיר֙ בַּגּוֹיִ֣ם שֻׁלָּ֔ח ק֛וּמוּ וְנָק֥וּמָה עָלֶ֖יהָ לַמִּלְחָמָֽה׃\",\n\"הִנֵּ֥ה קָטֹ֛ן נְתַתִּ֖יךָ בַּגּוֹיִ֑ם בָּז֥וּי אַתָּ֖ה מְאֹֽד׃\",\n\"זְד֤וֹן לִבְּךָ֙ הִשִּׁיאֶ֔ךָ שֹׁכְנִ֥י בְחַגְוֵי־סֶ֖לַע מְר֣וֹם שִׁבְתּ֑וֹ אֹמֵ֣ר בְּלִבּ֔וֹ מִ֥י יוֹרִדֵ֖נִי אָֽרֶץ׃\",\n\"אִם־תַּגְבִּ֣יהַּ כַּנֶּ֔שֶׁר וְאִם־בֵּ֥ין כּֽוֹכָבִ֖ים שִׂ֣ים קִנֶּ֑ךָ מִשָּׁ֥ם אוֹרִֽידְךָ֖ נְאֻם־יְהֹוָֽה׃\",\n\"אִם־גַּנָּבִ֤ים בָּאֽוּ־לְךָ֙ אִם־שׁ֣וֹדְדֵי לַ֔יְלָה אֵ֣יךְ נִדְמֵ֔יתָה הֲל֥וֹא יִגְנְב֖וּ דַּיָּ֑ם אִם־בֹּֽצְרִים֙ בָּ֣אוּ לָ֔ךְ הֲל֖וֹא יַשְׁאִ֥ירוּ עֹלֵלֽוֹת׃\",\n\"אֵ֚יךְ נֶחְפְּשׂ֣וּ עֵשָׂ֔ו נִבְע֖וּ מַצְפֻּנָֽיו׃\",\n\"עַֽד־הַגְּב֣וּל שִׁלְּח֗וּךָ כֹּ֚ל אַנְשֵׁ֣י בְרִיתֶ֔ךָ הִשִּׁיא֛וּךָ יָכְל֥וּ לְךָ֖ אַנְשֵׁ֣י שְׁלֹמֶ֑ךָ לַחְמְךָ֗ יָשִׂ֤ימוּ מָזוֹר֙ תַּחְתֶּ֔יךָ אֵ֥ין תְּבוּנָ֖ה בּֽוֹ׃\",\n\"הֲל֛וֹא בַּיּ֥וֹם הַה֖וּא נְאֻם־יְהֹוָ֑ה וְהַאֲבַדְתִּ֤י חֲכָמִים֙ מֵֽאֱד֔וֹם וּתְבוּנָ֖ה מֵהַ֥ר עֵשָֽׂו׃\",\n\"וְחַתּ֥וּ גִבּוֹרֶ֖יךָ תֵּימָ֑ן לְמַ֧עַן יִכָּֽרֶת־אִ֛ישׁ מֵהַ֥ר עֵשָׂ֖ו מִקָּֽטֶל׃\",\n\"מֵחֲמַ֛ס אָחִ֥יךָ יַעֲקֹ֖ב תְּכַסְּךָ֣ בוּשָׁ֑ה וְנִכְרַ֖תָּ לְעוֹלָֽם׃\",\n\"בְּיוֹם֙ עֲמׇֽדְךָ֣ מִנֶּ֔גֶד בְּי֛וֹם שְׁב֥וֹת זָרִ֖ים חֵיל֑וֹ וְנׇכְרִ֞ים בָּ֣אוּ שְׁעָרָ֗ו וְעַל־יְרוּשָׁלַ֙͏ִם֙ יַדּ֣וּ גוֹרָ֔ל גַּם־אַתָּ֖ה כְּאַחַ֥ד מֵהֶֽם׃\",\n\"וְאַל־תֵּ֤רֶא בְיוֹם־אָחִ֙יךָ֙ בְּי֣וֹם נׇכְר֔וֹ וְאַל־תִּשְׂמַ֥ח לִבְנֵֽי־יְהוּדָ֖ה בְּי֣וֹם אׇבְדָ֑ם וְאַל־תַּגְדֵּ֥ל פִּ֖יךָ בְּי֥וֹם צָרָֽה׃\",\n\"אַל־תָּב֤וֹא בְשַֽׁעַר־עַמִּי֙ בְּי֣וֹם אֵידָ֔ם אַל־תֵּ֧רֶא גַם־אַתָּ֛ה בְּרָעָת֖וֹ בְּי֣וֹם אֵיד֑וֹ וְאַל־תִּשְׁלַ֥חְנָה בְחֵיל֖וֹ בְּי֥וֹם אֵידֽוֹ׃\",\n\"וְאַֽל־תַּעֲמֹד֙ עַל־הַפֶּ֔רֶק לְהַכְרִ֖ית אֶת־פְּלִיטָ֑יו וְאַל־תַּסְגֵּ֥ר שְׂרִידָ֖יו בְּי֥וֹם צָרָֽה׃\",\n\"כִּֽי־קָר֥וֹב יוֹם־יְהֹוָ֖ה עַל־כׇּל־הַגּוֹיִ֑ם כַּאֲשֶׁ֤ר עָשִׂ֙יתָ֙ יֵעָ֣שֶׂה לָּ֔ךְ גְּמֻלְךָ֖ יָשׁ֥וּב בְּרֹאשֶֽׁךָ׃\",\n\"כִּ֗י כַּֽאֲשֶׁ֤ר שְׁתִיתֶם֙ עַל־הַ֣ר קׇדְשִׁ֔י יִשְׁתּ֥וּ כׇֽל־הַגּוֹיִ֖ם תָּמִ֑יד וְשָׁת֣וּ וְלָע֔וּ וְהָי֖וּ כְּל֥וֹא הָיֽוּ׃\",\n\"וּבְהַ֥ר צִיּ֛וֹן תִּהְיֶ֥ה פְלֵיטָ֖ה וְהָ֣יָה קֹ֑דֶשׁ וְיָֽרְשׁוּ֙ בֵּ֣ית יַֽעֲקֹ֔ב אֵ֖ת מוֹרָֽשֵׁיהֶֽם׃\",\n\"וְהָיָה֩ בֵית־יַעֲקֹ֨ב אֵ֜שׁ וּבֵ֧ית יוֹסֵ֣ף לֶהָבָ֗ה וּבֵ֤ית עֵשָׂו֙ לְקַ֔שׁ וְדָלְק֥וּ בָהֶ֖ם וַאֲכָל֑וּם וְלֹֽא־יִֽהְיֶ֤ה שָׂרִיד֙ לְבֵ֣ית עֵשָׂ֔ו כִּ֥י יְהֹוָ֖ה דִּבֵּֽר׃\",\n\"וְיָרְשׁ֨וּ הַנֶּ֜גֶב אֶת־הַ֣ר עֵשָׂ֗ו וְהַשְּׁפֵלָה֙ אֶת־פְּלִשְׁתִּ֔ים וְיָרְשׁוּ֙ אֶת־שְׂדֵ֣ה אֶפְרַ֔יִם וְאֵ֖ת שְׂדֵ֣ה שֹׁמְר֑וֹן וּבִנְיָמִ֖ן אֶת־הַגִּלְעָֽד׃\",\n\"וְגָלֻ֣ת הַֽחֵל־הַ֠זֶּ֠ה לִבְנֵ֨י יִשְׂרָאֵ֤ל אֲשֶֽׁר־כְּנַעֲנִים֙ עַד־צָ֣רְפַ֔ת וְגָלֻ֥ת יְרוּשָׁלַ֖͏ִם אֲשֶׁ֣ר בִּסְפָרַ֑ד יִֽרְשׁ֕וּ אֵ֖ת עָרֵ֥י הַנֶּֽגֶב׃\",\n\"וְעָל֤וּ מֽוֹשִׁעִים֙ בְּהַ֣ר צִיּ֔וֹן לִשְׁפֹּ֖ט אֶת־הַ֣ר עֵשָׂ֑ו וְהָיְתָ֥ה לַֽיהֹוָ֖ה הַמְּלוּכָֽה׃\"\n]\n],\n\"firstSectionRef\": \"Obadiah 1\"}\n" + }, + "available_versions": { + "type": "array", + "items": { + "$ref": "#/components/schemas/v3AvailableVersionsTextJson" + } + }, + "ref": { + "$ref": "#/components/schemas/ref" + }, + "heRef": { + "description": "Hebrew `Ref` for the segment. ", + "type": "string" + }, + "sections": { + "description": "An array which corresponds to sectionNames and represents the sections of the text requested. When sectionNames is `[\"Chapter\", \"Verse\"]` a request for chapter 4 looks like `[4]` while a request for chapter 4, verse 7 would look like `[4, 7]`. _Note, for Talmud, Dafs are represented by a string like \"42a\" or \"12b\"_", + "type": "array", + "items": {} + }, + "toSections": { + "type": "array", + "items": {} + }, + "sectionRef": { + "$ref": "#/components/schemas/ref" + }, + "heSectionRef": { + "type": "string" + }, + "firstAvailableSectionRef": { + "type": "string" + }, + "isSpanning": { + "type": "boolean" + }, + "spanningRefs": { + "type": "array", + "items": {} + }, + "next": { + "description": "Next segment reference in sequence, if last ref, field will be `null`.", + "type": "string" + }, + "prev": { + "description": "Previous segment reference in sequence, if first ref, field will be `null`.", + "type": "string" + }, + "title": { + "description": "The title of the book these versions correspond to. ", + "type": "string" + }, + "book": { + "description": "The title of the book that the response comes from.", + "type": "string", + "example": "Esther" + }, + "heTitle": { + "type": "string" + }, + "primary_category": { + "type": "string" + }, + "type": { + "type": "string" + }, + "indexTitle": { + "description": "The book title", + "type": "string" + }, + "categories": { + "description": "A list of categories that a text belongs to. ", + "type": "array", + "items": { + "type": "string" + }, + "example": "[\n\"Tanakh\",\n\"Writings\"\n]" + }, + "heIndexTitle": { + "type": "string" + }, + "isComplex": { + "description": "Whether or not the text is a \"complex\" text or not.\n\nIn Sefaria, a complex text is any text which has a more complicated index structure beyond Chapters/Verses, (e.g. the Talmud). There are a variety of structural differences for a complex text, having to do primarily with its Index, and the way the data is stored. For more on complex texts, see the documentation here.", + "type": "boolean" + }, + "isDependant": { + "type": "boolean" + }, + "order": { + "type": "array", + "items": { + "format": "int32", + "type": "integer" + } + }, + "collectiveTitle": { + "description": "A shortened name of the Index for display in the connection panel (i.e. `Rashi on Genesis` will have a collective title of `Rashi`)", + "type": "string" + }, + "heCollectiveTitle": { + "description": "A Hebrew shortened name of the Index for display in the connection panel (i.e. `רש״י על בראשית` will have a collective title of `רש״י`)", + "type": "string" + }, + "alts": { + "type": "array", + "items": {} + }, + "lengths": { + "type": "array", + "items": { + "format": "int32", + "type": "integer" + } + }, + "length": { + "format": "int32", + "type": "integer" + }, + "textDepth": { + "format": "int32", + "description": "The depth of the text. For example, Genesis will have depth of `2`, since it is comprised of two layers, chapters and verses. Whereas a commentary on Genesis will have a depth of `3`, since it is organized by chapter, verse, and then specific comment on a verse. ", + "type": "integer" + }, + "sectionNames": { + "description": "An array containing the type names of the sections of this text. The length of sectionNames gives the depth of the structure of this text. For example, Kohelet `([\"Chapter\", \"Verse\"])` has depth 2, while Mishneh Torah `([\"Book\", \"Topic\", \"Section\", \"Law\"])` has depth 4. Comparing this depth to the depth of sections will show if the request was for the lowest level, or a higher level, of the text.", + "type": "array", + "items": { + "type": "string" + } + }, + "addressTypes": { + "description": "A list which length reflects the depth of the text structure, with string values indicating class names for address types for each level", + "type": "array", + "items": { + "type": "string" + }, + "example": "[\n\"Perek\",\n\"Pasuk\"\n]" + }, + "titleVariants": { + "description": "Various alternative titles used for the text. ", + "type": "array", + "items": { + "type": "string" + }, + "example": "[\n\"Est.\",\n\"Est\",\n\"Ester\",\n\"Esth.\",\n\"Esth\",\n\"Esther\"\n]" + }, + "heTitleVariants": { + "type": "array", + "items": { + "type": "string" + } + }, + "index_offsets_by_depth": { + "type": "object" + }, + "warnings": { + "description": "A list of objects - for any version parameter that has no result there is a readable message and warning code. \n\nCodes:\n`APINoVersion = 101`\n`APINoLanguageVersion = 102`\n`APINoSourceText = 103`\n`APINoTranslationText = 104`\n", + "type": "array", + "items": {}, + "example": "[\n{\n\"\\\"finnish\\\"\": {\n\"warning_code\": 102,\n\"message\": \"We do not have the language you asked for Esther 1:1. Available languages are ['english', 'esperanto', 'french', 'german', 'hebrew', 'italian', 'persian', 'polish', 'spanish', 'yiddish']\"\n}\n},\n{\n\"\\\"dutch\\\"\": {\n\"warning_code\": 102,\n\"message\": \"We do not have the language you asked for Esther 1:1. Available languages are ['english', 'esperanto', 'french', 'german', 'hebrew', 'italian', 'persian', 'polish', 'spanish', 'yiddish']\"\n}\n}\n]" + } + }, + "example": { + "versions": [ + { + "status": "locked", + "priority": 2, + "license": "CC-BY-SA", + "versionNotes": "Miqra According to the Masorah (MAM) is a digital Hebrew edition of the Tanakh based on the Aleppo Codex and related manuscripts. It is designed for readers, and as such it contains added elements to aid vocalization of the text. For instance: When an accent is marked in an unstressed syllable, an extra accent is added in the proper place (pashta, zarqa, segol, telisha). Legarmeih and paseq are visibly distinguished. Qamaz qatan is indicated by its designated Unicode character (alternatives are documented where traditions differ about its application).
The text of MAM is fully documented. The complete introduction to the edition (Hebrew) explains the types of editorial decisions that have been made and the reasons for them (English abstract). In addition, every word in the Bible about which there is some textual concern or ambiguity includes a documentation note; these notes can be viewed conveniently here. If an error is discovered, it may be reported to User:Dovi at Hebrew Wikisource. Please check the documentation notes before reporting an error.", + "formatAsPoetry": "", + "digitizedBySefaria": "", + "method": "", + "heversionSource": "", + "versionUrl": "", + "versionTitleInHebrew": "מקרא על פי המסורה", + "versionNotesInHebrew": "", + "shortVersionTitle": "", + "shortVersionTitleInHebrew": "", + "extendedNotes": "", + "extendedNotesHebrew": "", + "purchaseInformationImage": "", + "purchaseInformationURL": "", + "hasManuallyWrappedRefs": "", + "actualLanguage": "he", + "languageFamilyName": "hebrew", + "isBaseText": true, + "isSource": true, + "isPrimary": true, + "direction": "rtl", + "language": "he", + "versionSource": "https://he.wikisource.org/wiki/%D7%9E%D7%A9%D7%AA%D7%9E%D7%A9:Dovi/%D7%9E%D7%A7%D7%A8%D7%90_%D7%A2%D7%9C_%D7%A4%D7%99_%D7%94%D7%9E%D7%A1%D7%95%D7%A8%D7%94", + "versionTitle": "Miqra according to the Masorah", + "text": [], + "firstSectionRef": "Obadiah 1" + } + ], + "available_versions": [], + "ref": "Obadiah", + "heRef": "עובדיה", + "sections": [], + "toSections": [], + "sectionRef": "Obadiah", + "heSectionRef": "עובדיה", + "firstAvailableSectionRef": "Obadiah 1", + "isSpanning": false, + "spanningRefs": [], + "next": "Obadiah 1", + "prev": "Obadiah 1", + "title": "Obadiah", + "book": "Obadiah", + "heTitle": "עובדיה", + "primary_category": "Tanakh", + "type": "Tanakh", + "indexTitle": "Obadiah", + "categories": [ + "Tanakh", + "Prophets" + ], + "heIndexTitle": "עובדיה", + "isComplex": false, + "isDependant": false, + "order": [ + 18, + 13 + ], + "collectiveTitle": "", + "heCollectiveTitle": "", + "alts": [], + "lengths": [ + 1, + 21 + ], + "length": 1, + "textDepth": 2, + "sectionNames": [ + "Chapter", + "Verse" + ], + "addressTypes": [ + "Perek", + "Pasuk" + ], + "titleVariants": [ + "Ovadiah", + "Ob.", + "Oba.", + "Ovadyah", + "Ovadia", + "Ovadya", + "Abdias", + "Obad", + "Obadiah" + ], + "heTitleVariants": [ + "עובדיה" + ], + "index_offsets_by_depth": {}, + "warnings": [] + } + }, + "v3AvailableVersionsTextJson": { + "title": "Root Type for v3AvailableVersionsTextJson", + "description": "Data returned in the `available_versions` field of the `v3` `texts` API. This contains all of the available versions for a given text, not just the required versions. ", + "type": "object", + "allOf": [ + { + "type": "object", + "properties": { + "status": { + "type": "string" + }, + "priority": { + "format": "int32", + "type": "integer" + }, + "license": { + "type": "string" + }, + "versionNotes": { + "type": "string" + }, + "formatAsPoetry": { + "type": "string" + }, + "digitizedBySefaria": { + "type": "string" + }, + "method": { + "type": "string" + }, + "heversionSource": { + "type": "string" + }, + "versionUrl": { + "type": "string" + }, + "versionTitleInHebrew": { + "type": "string" + }, + "versionNotesInHebrew": { + "type": "string" + }, + "shortVersionTitle": { + "type": "string" + }, + "shortVersionTitleInHebrew": { + "type": "string" + }, + "extendedNotes": { + "type": "string" + }, + "extendedNotesHebrew": { + "type": "string" + }, + "purchaseInformationImage": { + "type": "string" + }, + "purchaseInformationURL": { + "type": "string" + }, + "hasManuallyWrappedRefs": { + "type": "string" + }, + "actualLanguage": { + "type": "string" + }, + "languageFamilyName": { + "description": "The overarching family for the specific language detailed in `actualLanguage`. For example, `Arabic` would be the overarching `languageFamily` for `judeo-arabic`.", + "type": "string" + }, + "isBaseText": { + "type": "string" + }, + "isSource": { + "type": "boolean" + }, + "isPrimary": { + "type": "string" + }, + "direction": { + "type": "string" + }, + "language": { + "type": "string" + }, + "title": { + "description": "The title of the book.", + "type": "string", + "example": "Esther" + }, + "versionSource": { + "type": "string" + }, + "versionTitle": { + "type": "string" + } + } + }, + { + "$ref": "#/components/schemas/v3TextVersionsJSON" + } + ], + "example": { + "status": "locked", + "priority": 3, + "license": "CC-BY-NC", + "versionNotes": "Read the Preface to the Revised JPS Edition\n

\nRead the Notes on Gender in Translation for the Revised JPS Edition\n

\nRead a Commentary on the Hebrew word ’ish in the Revised JPS Edition", + "formatAsPoetry": "", + "digitizedBySefaria": "", + "method": "", + "heversionSource": "", + "versionUrl": "", + "versionTitleInHebrew": "", + "versionNotesInHebrew": "", + "shortVersionTitle": "Revised JPS, 2023", + "shortVersionTitleInHebrew": "", + "extendedNotes": "", + "extendedNotesHebrew": "", + "purchaseInformationImage": "https://storage.googleapis.com/sefaria-physical-editions/JPS-Tanakh-Gender-Sensitive-Edition-Cover-300x450.jpg", + "purchaseInformationURL": "https://jps.org/books/the-jps-tanakh-gender-sensitive-edition/", + "hasManuallyWrappedRefs": "", + "actualLanguage": "en", + "languageFamilyName": "english", + "isBaseText": "", + "isSource": false, + "isPrimary": "", + "direction": "ltr", + "language": "en", + "title": "Obadiah", + "versionSource": "https://jps.org/books/the-jps-tanakh-gender-sensitive-edition/", + "versionTitle": "THE JPS TANAKH: Gender-Sensitive Edition" + } + }, + "v3TextVersionsJSON": { + "title": "Root Type for v3TextVersionsJSON", + "description": "", + "type": "object", + "properties": { + "status": { + "description": "Whether or not the text is `\"locked\"` for further edits from the community. ", + "type": "string" + }, + "priority": { + "format": "float", + "description": "The priority assigned to a version of the text. A higher number will have the text appear higher within the listing of available versions for a specific text on the Sefaria website. (i.e. `Esther A` with a priority of `2`, will appear before `Esther B`, with a priority of `1`)", + "type": "number" + }, + "license": { + "description": "The license for the text, in terms of copyright, and distribution. ", + "type": "string", + "example": "Public Domain" + }, + "versionNotes": { + "description": "Notes on the version", + "type": "string", + "example": "© Kehot Publication Society" + }, + "formatAsPoetry": { + "description": "A boolean indicating whether or not the text (or portions of it) are formatted as poetry.", + "type": "boolean" + }, + "digitizedBySefaria": { + "description": "An indicator of whether or not Sefaria digitized the text, versus acquiring an already digital copy of a text. ", + "type": "boolean" + }, + "method": { + "type": "string" + }, + "heversionSource": { + "type": "string" + }, + "versionUrl": { + "description": "URl for the version", + "type": "string" + }, + "versionTitleInHebrew": { + "type": "string" + }, + "versionNotesInHebrew": { + "type": "string" + }, + "shortVersionTitle": { + "type": "string" + }, + "shortVersionTitleInHebrew": { + "type": "string" + }, + "extendedNotes": { + "type": "string" + }, + "extendedNotesHebrew": { + "type": "string" + }, + "purchaseInformationImage": { + "description": "A URL pointing to an image of the hardcopy text available for purchase.", + "type": "string", + "example": "https://storage.googleapis.com/sefaria-physical-editions/touger-mishneh-torah-hilkhot-teshuvah-purchase-img.png" + }, + "purchaseInformationURL": { + "description": "A URL pointing to where one can purchase a hardcopy of this text. ", + "type": "string", + "example": "https://moznaim.com/products/mishneh-torah-rambam" + }, + "hasManuallyWrappedRefs": { + "type": "string" + }, + "actualLanguage": { + "description": "The [ISO 639-1](https://en.wikipedia.org/wiki/List_of_ISO_639_language_codes) language code for the language of the text. We default to 2 letter codes when available, and 3 letter codes when they are not.", + "type": "string", + "example": "de" + }, + "languageFamilyName": { + "description": "The overarching family for the specific language detailed in `actualLanguage`. For example, `Arabic` would be the overarching family for `judeo-arabic`. ", + "type": "string" + }, + "isBaseText": { + "description": "Indicates whether or not this text is the base for a commentary (i.e. `Genesis` is a base text for `Ramban on Genesis`)", + "type": "boolean" + }, + "isSource": { + "type": "boolean" + }, + "isPrimary": { + "description": "Indicates whether or not this version of the text is determined as the primary version in the Sefaria database.", + "type": "boolean" + }, + "direction": { + "description": "The direction of the text, either `ltr` (left-to-right) or `rtl` (right-to-left). Examples of `ltr` languages include English, French and German. Examples of `rtl` languages are Hebrew and Arabic. ", + "type": "string", + "example": "ltr" + }, + "language": { + "description": "A holdover from the `v2` API which will eventually be deprecated. This used to indicate the direction of the text, with `en` indicating texts written from left-to-right, and `he` indicating texting written from right-to-left. ", + "type": "string", + "example": "`he`\n`en`" + }, + "versionSource": { + "description": "The original source of the digital text. ", + "type": "string", + "example": "http://kehot.com/" + }, + "versionTitle": { + "description": "The English title of the Version of text. ", + "type": "string", + "example": "Mischnajot mit deutscher Übersetzung und Erklärung. Berlin 1887-1933 [de]" + }, + "text": { + "description": "An array of strings containing the text of the specific version. \n\nIf a segment `Ref` was passed, the array returned will be one-dimensional and contain a string with the specific segment level text. \n\nIf a bottom level section `Ref` was passed, the array returned will be a two-dimensional array, a list of lists of strings. The outer layer of the array represents the section, and the inner arrays represent the segments. ", + "type": "array", + "items": { + "type": "string" + }, + "example": "[\n[\n\"Von welcher Zeit ab liest man das Schema. Zu Schema wird Deuter. 6, 4—9 שמע , 2. Deuter. 11, 13—21 והיה אם שמוע und 3. Numeri 15, 37—41 ויאמר gerechnet.\",\n\"da die Priester eintreten. Nämlich unreine Priester, welche nicht gebadet und gereinigt hatten und erst mit dem Erscheinen der Sterne ihre Hebe essen durften (Lev. 22, 7).\",\n\"bis zu Ende der ersten Nachtwache. Man teilte die Nacht in drei Wachen.\",\n\"Die Weisen. So oft hier der Ausdruck die Weisen vorkommt, verstehe man darunter die große Mehrzahl der Weisen, sofern sie nach allgemein geltender Ansicht entscheidet.\",\n\"Bis die Morgenröte. Säule der Morgenröte im Hebr. und Arab.\",\n\"aufsteigt. Der Grund der Meinungsverschiedenheit liegt in der Deutung des ובשכבך . R. Elieser erklärt: Wenn du dich niederlegst; dies geschieht bei den meisten Menschen bis Ende der ersten Nachtwache. Nach den Weisen und so auch nach R. Gamliel heißt ובשכבך , wenn du liegst; demnach wäre es die ganze Nacht erlaubt das Schema zu lesen, jedoch die Weisen erlauben es nur bis Mitternacht, um der Gesetzesübertretung vorzubeugen, was R. Gamliel nicht für nötig hält.\",\n\"Das Aufdampfen des Fettes und der Glieder. Stücke der Opfertiere, (Lev. 6, 2; 7, 2.)\",\n\"nur an demselben Tage gegessen werden darf. D. h. am Tage der Darbringung (Lev. 7, 15).\",\n\"Um die Menschen von der Übertretung fern zu halten. Nämlich, sie setzten eine kürzere Frist, damit man sich auf keinen Fall verspäte.\"\n],\n[\n\"Sobald man zwischen himmelblau und weiß unterscheiden kann; R. Elieser sagt: Zwischen himmelblau und lauchgrün; (und beendet das Lesen. וגומרה , wenn die Lesart richtig ist, bezieht es sich auf פרשת שמע .\",\n\"erst um drei Stunden aufzustehen. Das Gesetz ובקומך meint er, bedeute »bis Jedermann aufgestanden ist.« — Die Stunden sind hier je nach der Jahreszeit von verschiedener Länge; denn man teilte den Tag und die Nacht in je 12 Teile. Wenn also z. B. der Tag 8 und die Nacht 16 Stunden hat, so wird die Tagesstunde zu 8/12 gewöhnliche Stunden = 40 Minuten, die Nachtstunde aber zu 16/12 gewöhnliche Stunden = 80 Minuten gerechnet. Solche Stunden werden שעות זמניות = Zeitstunden genannt\",\n\"büsst nichts ein. D. h. er möge immerhin die dazu gehörigen Vor- und Nachgebete sprechen (nach Einigen jedoch nur bis Ende der. 4. Stunde) obgleich deren Zeit vorüber ist.\"\n],\n[\n\"brachte mich aber in Lebensgefahr durch Räuber. Wäre beinahe von Räubern getötet worden.\"\n],\n[\n\"Am Morgen spricht man zwei Segenssprüche voran. לפניה bezieht sich auf פרשת שמע .\",\n\"und zwei nachher. Nämlich des Morgens אהבה רבה ,יוצר אור und גאולה Des Abends מעריב גאולה ,אהבת עולם ,ערבים und השכיבנו .\",\n\"eine Schlussformel anzubringen. Die ganze Stelle von מקום שאמרו an wird hier als ein allgemeines, auf alle anderen ברכות sich auch beziehendes Gesetz mit eingeschaltet. — Unter Schlussformel versteht man einen mit ברוך anfangenden Satz, der das Ganze schliesst. Z. B. ברוך אתה ה׳ גאל ישראל .\"\n],\n[\n\"Man gedenke des Auszuges aus Ägypten auch in der Nachtzeit. D. h. es ist Pflicht auch in der Nacht פרשת ציצית zu sprechen, weil darin des Auszuges Erwähnung geschieht.\",\n\"Ich bin jetzt beinah. So nach einer Baraita im Jeruschalmi. Der babylonische Talmud jedoch sagt: R. Elasar ben Asarja sei damals nur 18 Jahre alt, aber bereits grau gewesen, wie ein Greis von siebzig Jahren. Nach Maimonides ist er durch vieles Studieren grau geworden.\"\n]\n]" + }, + "firstSectionRef": { + "description": "The first available `Ref` to the section of text passed in the API. ", + "type": "string" + } + }, + "example": { + "status": "locked", + "priority": 2, + "license": "CC-BY-SA", + "versionNotes": "Miqra According to the Masorah (MAM) is a digital Hebrew edition of the Tanakh based on the Aleppo Codex and related manuscripts. It is designed for readers, and as such it contains added elements to aid vocalization of the text. For instance: When an accent is marked in an unstressed syllable, an extra accent is added in the proper place (pashta, zarqa, segol, telisha). Legarmeih and paseq are visibly distinguished. Qamaz qatan is indicated by its designated Unicode character (alternatives are documented where traditions differ about its application).
The text of MAM is fully documented. The complete introduction to the edition (Hebrew) explains the types of editorial decisions that have been made and the reasons for them (English abstract). In addition, every word in the Bible about which there is some textual concern or ambiguity includes a documentation note; these notes can be viewed conveniently here. If an error is discovered, it may be reported to User:Dovi at Hebrew Wikisource. Please check the documentation notes before reporting an error.", + "formatAsPoetry": "", + "digitizedBySefaria": "", + "method": "", + "heversionSource": "", + "versionUrl": "", + "versionTitleInHebrew": "מקרא על פי המסורה", + "versionNotesInHebrew": "", + "shortVersionTitle": "", + "shortVersionTitleInHebrew": "", + "extendedNotes": "", + "extendedNotesHebrew": "", + "purchaseInformationImage": "", + "purchaseInformationURL": "", + "hasManuallyWrappedRefs": "", + "actualLanguage": "he", + "languageFamilyName": "hebrew", + "isBaseText": true, + "isSource": true, + "isPrimary": true, + "direction": "rtl", + "language": "he", + "versionSource": "https://he.wikisource.org/wiki/%D7%9E%D7%A9%D7%AA%D7%9E%D7%A9:Dovi/%D7%9E%D7%A7%D7%A8%D7%90_%D7%A2%D7%9C_%D7%A4%D7%99_%D7%94%D7%9E%D7%A1%D7%95%D7%A8%D7%94", + "versionTitle": "Miqra according to the Masorah", + "text": [], + "firstSectionRef": "Obadiah 1" + } + }, + "LinkObj": { + "title": "Root Type for LinkObj", + "description": "A single link returned by the link (and related[?]) APIs", + "type": "object", + "properties": { + "_id": { + "type": "string" + }, + "index_title": { + "description": "The cannonical title of the text in the Sefaria library.", + "type": "string" + }, + "category": { + "description": "The primary category this ref belongs to on Sefaria.", + "type": "string" + }, + "type": { + "description": "An arbitrary string assigned to the connection to identify it. Most commonly `commentary`, `reference`, or an empty string. ", + "type": "string" + }, + "ref": { + "$ref": "#/components/schemas/ref" + }, + "anchorRef": { + "description": "The submitted `ref` in the GET request at times may fall within a more encompassing ranged ref that includes multiple text segments. The `anchorRef` is that complete range the that the link is associated with, and will contain within it the specific `ref` that was passed. ", + "type": "string", + "example": "\"Esther 3:15-4:17\"" + }, + "anchorRefExpanded": { + "description": "An array of strings, where each string is a segment level `ref` of the `ref` passed in as a parameter. If a segment level `ref` is passed in, this array will have a length of 1, and only contain that segment level `ref`. If the `ref` passed in is ranged, this array will contain each of the segment level `ref`s within that range. \n\nFor example, if someone was searching for links for `Esther 4.14-15`, the `anchorRefExpanded` would contain `Esther 4.14` and `Esther 4.15`.", + "minItems": 1, + "uniqueItems": true, + "type": "array", + "items": { + "type": "string" + }, + "example": "\"anchorRefExpanded\": [\n \"Esther 4:14\",\n \"Esther 4:15\"\n]" + }, + "sourceRef": { + "$ref": "#/components/schemas/ref", + "description": "The connecting link for the submitted `ref`" + }, + "sourceHeRef": { + "$ref": "#/components/schemas/ref" + }, + "anchorVerse": { + "format": "int32", + "type": "integer" + }, + "sourceHasEn": { + "type": "boolean" + }, + "compDate": { + "description": "The estimated year of completion of the work according to the Gregorian calendar. If its length is zero the completion date is unknown. If its length is one, then the completion date is that single year. If its length is 2 then the date is a potential range with the first int in the array is the lower end of the range and the latter the higher. ", + "type": "array", + "items": { + "format": "int32", + "type": "integer" + } + }, + "commentaryNum": { + "format": "double", + "type": "number" + }, + "collectiveTitle": { + "type": "object", + "properties": { + "en": { + "type": "string" + }, + "he": { + "type": "string" + } + } + }, + "he": { + "description": "The default text written in RTL characters for the query (Usually Hebrew). It is structured as a JaggedArray (nested arrays), with the lowest level being an array of strings with some html text.\n", + "type": "string" + }, + "heVersionTitle": { + "description": "The title of the work in English for where the default `he` text came from.", + "type": "string" + }, + "heLicense": { + "description": "A string of text documenting the license for the text in Hebrew.", + "type": "string" + }, + "heVersionTitleInHebrew": { + "description": "The title of the work in Hebrew for where the default `he` text came from.", + "type": "string" + }, + "text": { + "description": "The default text written in LTR characters for the query (Usually English). It is structured as a JaggedArray (nested arrays), with the lowest level being an array of strings with some html text.", + "type": "array", + "items": {} + }, + "versionTitle": { + "description": "A descriptive string which describes what version of a text this is. Is it from a particular printing or edition of a book? An online resource? This string should describe it in English", + "type": "string" + }, + "license": { + "description": "A string of text documenting the license for the text in English.", + "type": "string" + }, + "versionTitleInHebrew": { + "description": "A descriptive string which describes what version of a text this is. Is it from a particular printing or edition of a book? An online resource? This string should describe it in Hebrew.", + "type": "string" + } + }, + "example": { + "_id": "578b4ad1d6e4a90d260c2d9a", + "index_title": "Tosafot Yom Tov on Mishnah Peah", + "category": "Commentary", + "type": "commentary", + "ref": "Tosafot Yom Tov on Mishnah Peah 4:2:1", + "anchorRef": "Mishnah Peah 4:2", + "anchorRefExpanded": [ + "Mishnah Peah 4:2" + ], + "sourceRef": "Tosafot Yom Tov on Mishnah Peah 4:2:1", + "sourceHeRef": "תוספות יום טוב על משנה פאה ד׳:ב׳:א׳", + "anchorVerse": 2, + "sourceHasEn": false, + "compDate": [ + 1613, + 1617 + ], + "commentaryNum": 2.0001, + "collectiveTitle": { + "en": "Tosafot Yom Tov", + "he": "תוספות יום טוב" + }, + "he": "[*ואחד אומר לחלק לזה שומעין וכו'. שאפילו הוא זקן ותש כח או חולה שהרי מה שאמר לחלק מפני חלישותו הוא אפילו הכי שומעין לו כך מצאתי בפירוש הנ\"ל]: \n", + "heVersionTitle": "Mishnah, ed. Romm, Vilna 1913", + "heLicense": "Public Domain", + "heVersionTitleInHebrew": "משנה, מהדורת בית דפוס ראם, וילנא 1913", + "text": [] + } + }, + "TopicGraphJSON": { + "title": "Root Type for TopicGraphJSON", + "description": "", + "type": "object", + "properties": { + "topics": { + "description": "Array of topics", + "type": "array", + "items": { + "$ref": "#/components/schemas/TopicJSON" + }, + "example": "{\n\"slug\": \"shabbat-shuvah\",\n\"titles\": [\n{\n\"text\": \"Shabbat Shuvah\",\n\"lang\": \"en\",\n\"primary\": true\n},\n{\n\"text\": \"שבת שובה\",\n\"lang\": \"he\",\n\"primary\": true\n},\n{\n\"lang\": \"he\",\n\"text\": \"שובה\"\n}\n],\n\"alt_ids\": {\n\"_temp_id\": \"שבת שובה\",\n\"_old_slug\": \"399\"\n},\n\"description\": {\n\"en\": \"Shabbat of Repentance between Rosh Hashanah and Yom Kippur.\",\n\"he\": \"\"\n},\n\"numSources\": 19,\n\"primaryTitle\": {\n\"en\": \"Shabbat Shuvah\",\n\"he\": \"שבת שובה\"\n}\n}" + }, + "links": { + "type": "array", + "items": { + "$ref": "#/components/schemas/TopicGraphLinkJSON" + } + } + }, + "example": { + "topics": [ + { + "slug": "shabbat", + "titles": [], + "alt_ids": { + "_temp_id": "שבת", + "_old_slug": "shabbat1" + }, + "properties": { + "heNliLink": { + "value": "https://www.nli.org.il/he/discover/judaism/traditions/shabbat", + "dataSource": "sefaria" + } + }, + "description": { + "en": "Shabbat (or Sabbath) falls every seventh day of the week, from Friday just before sunset until dark on Saturday night. It is a day of rest, marking the time when God stopped creating after after the six days of creation. Shabbat recognizes God as Creator of the Universe and as Redeemer of Israel from Egypt. ", + "he": "היום השביעי בשבוע, החל מיום שישי בשעת השקיעה ועד צאת הכוכבים במוצאי השבת. יום מנוחה לפי המקורות, המציין את הזמן שבו ה' נח לאחר שברא את העולם. " + }, + "categoryDescription": {}, + "displayOrder": 0, + "numSources": 1662, + "good_to_promote": true, + "description_published": true, + "data_source": "sefaria", + "image": { + "image_uri": "https://storage.googleapis.com/img.sefaria.org/topics/shabbat.jpg", + "image_caption": { + "en": "Friday Evening, Isidor Kaufmann, Austria c. 1920. The Jewish Museum, Gift of Mr. and Mrs. M. R. Schweitzer", + "he": "שישי בערב, איזידור קאופמן, וינה 1920. המוזיאון היהודי בניו יורק, מתנת מר וגברת מ.ר. שוויצר" + } + }, + "primaryTitle": { + "en": "Shabbat", + "he": "שבת" + } + }, + { + "slug": "shabbat-shuvah", + "titles": [ + { + "text": "Shabbat Shuvah", + "lang": "en", + "primary": true + }, + { + "text": "שבת שובה", + "lang": "he", + "primary": true + }, + { + "lang": "he", + "text": "שובה" + } + ], + "alt_ids": { + "_temp_id": "שבת שובה", + "_old_slug": "399" + }, + "description": { + "en": "Shabbat of Repentance between Rosh Hashanah and Yom Kippur.", + "he": "" + }, + "numSources": 19, + "primaryTitle": { + "en": "Shabbat Shuvah", + "he": "שבת שובה" + } + }, + { + "slug": "shabbat-hagadol", + "titles": [ + { + "text": "Shabbat HaGadol", + "lang": "en" + }, + { + "text": "Shabbat Hagadol", + "lang": "en", + "primary": true }, - "example": { - "media_url": "https://raw.githubusercontent.com/rneiss/PocketTorah/master/data/audio/Devarim-1.mp3", - "source": "PocketTorah", - "source_he": "\"פוקט\"-תורה", - "start_time": "36.045250", - "end_time": "49.118184", - "anchorRef": "Deuteronomy 1:2", - "license": "CC-BY-SA", - "source_site": "http://www.pockettorah.com", - "description": "Audio recordings of the weekly Torah portions used in PocketTorah. Avery-Binder style.", - "description_he": "הקלטות שמע של פרשות השבוע באמצעות \"פוקט-תורה\" בסגנון הקריאה של א. בינדר ול.אוורי." + { + "text": "שבת הגדול", + "lang": "he", + "primary": true } + ], + "alt_ids": { + "_temp_id": "שבת הגדול" + }, + "description": { + "en": "Shabbat HaGadol (“The Great Shabbat”) is the Shabbat that immediately precedes the holiday of Passover. Jewish texts offer many explanations as to why this Shabbat is called “great,” like those that point to a great miracle performed on this Shabbat during the exodus, or those that point to the word “great” at the end of the haftarah prophetic reading traditionally read on this Shabbat. In many communities, the rabbi delivers a lengthy sermon on a Passover-related topic. ", + "he": "״שבת הגדול״ היא השבת האחרונה לפני חג הפסח. שבת זו נודעה כשבת מיוחדת החל מהמאה ה-12 בבתי המדרש של רש״י וחכמי התוספות. מנהגי שבת זו כוללים דרשה של הרב בקהילתו בהלכות הפסח, וקריאת קטעים מההגדה של פסח. מספר טעמים ניתנו לשמה של שבת זו כגון שבשבת זו בני ישראל הפסיקו לעבוד עבודה זרה, או שהיה נס גדול בלקיחת השה לקרבן פסח, ועוד. " + }, + "categoryDescription": {}, + "displayOrder": 230, + "numSources": 57, + "description_published": true, + "data_source": "sefaria", + "primaryTitle": { + "en": "Shabbat Hagadol", + "he": "שבת הגדול" + } + } + ], + "links": [ + { + "toTopic": "shabbat", + "linkType": "is-a", + "class": "intraTopic", + "dataSource": "aspaklaria-edited-by-sefaria", + "fromTopic": "shabbat-shuvah", + "order": { + "linksInCommon": 0, + "toTfidf": 0, + "fromTfidf": 0 + } + }, + { + "toTopic": "shabbat", + "linkType": "is-a", + "class": "intraTopic", + "dataSource": "aspaklaria-edited-by-sefaria", + "fromTopic": "shabbat-hagadol", + "order": { + "linksInCommon": 1, + "toTfidf": 6.1420049159848755, + "fromTfidf": 9.085421387618508 + } + } + ] + } + }, + "TopicGraphLinkJSON": { + "title": "Root Type for TopicGraphLinkJSON", + "description": "", + "type": "object", + "properties": { + "toTopic": { + "description": "Slug of the `toTopic` (i.e. the topic to which the link connects to, usually the slug passed as `topic_slug` to the `api/topic-graph` endpoint).", + "type": "string" + }, + "linkType": { + "description": "The type of the link, based on the relationship within our ontology. Many links has an `is-a` relationship (such as `Genesis` `is-a` `Book`), but other topic-to-topic links have a variety of other types documented [here](https://developers.sefaria.org/docs/topic-ontology#overview-of-sefaria-link-types). \n\nSome examples include `child-of`, `parent-of`, `sibling-of` etc. ", + "type": "string" + }, + "class": { + "description": "Class of the link `intraTopic` (a link from topic-to-topic) or `refTopic` (a link from a topic-to-ref). ", + "enum": [ + "refTopic", + "intraTopic" + ], + "type": "string" + }, + "dataSource": { + "description": "Source where the topic link originated from. ", + "type": "string" + }, + "fromTopic": { + "description": "Slug of the `fromTopic` (i.e. the topic from which the link originates). ", + "type": "string" + }, + "order": { + "$ref": "#/components/schemas/OrderJSON", + "description": "A dictionary containing information regarding the links in common, as well as the to and from `tfIdf` scores. To learn more about the [tfIdf](https://en.wikipedia.org/wiki/Tf%E2%80%93idf) algorithm. ", + "properties": { + "linksInCommon": { + "format": "int32", + "type": "integer" + }, + "toTfidf": { + "format": "int32", + "type": "integer" + }, + "fromTfidf": { + "format": "int32", + "type": "integer" + } }, - "WebPagesJSON": { - "title": "Root Type for WebPagesJSON", - "description": "A JSON object containing the metadata for external webpages linked to this Sefaria `Ref`.", + "example": "{\n \"linksInCommon\": 0,\n \"toTfidf\": 0,\n \"fromTfidf\": 0\n }" + } + }, + "example": { + "toTopic": "shabbat", + "linkType": "is-a", + "class": "intraTopic", + "dataSource": "aspaklaria-edited-by-sefaria", + "fromTopic": "shabbat-shuvah", + "order": { + "linksInCommon": 0, + "toTfidf": 0, + "fromTfidf": 0 + } + } + }, + "OrderJSON": { + "title": "Root Type for OrderJSON", + "description": "", + "type": "object", + "properties": { + "linksInCommon": { + "format": "int32", + "type": "integer" + }, + "toTfidf": { + "format": "int32", + "type": "integer" + }, + "fromTfidf": { + "format": "int32", + "type": "integer" + } + }, + "example": { + "linksInCommon": 0, + "toTfidf": 0, + "fromTfidf": 0 + } + }, + "RandomByTopicJSON": { + "title": "Root Type for RandomByTopicJSON", + "description": "Response to the random-by-topic API endpoint. ", + "type": "object", + "properties": { + "ref": { + "description": "The `Ref` of the text randomly selected, which is connected to one of the recently popular topics. ", + "type": "string", + "example": "Deuteronomy 16:21" + }, + "topic": { + "$ref": "#/components/schemas/RandomByTopicTopicJSON", + "description": "The topic attached to the `Ref` returned. ", + "properties": { + "slug": { + "type": "string" + }, + "titles": { + "type": "array", + "items": {} + }, + "subclass": { + "type": "string" + }, + "alt_ids": { "type": "object", "properties": { - "url": { - "description": "URL to the related article on the webpage. ", - "type": "string", - "example": "https://etzion.org.il/en/mission-spies" - }, - "title": { - "description": "Title of the webpage", - "type": "string", - "example": "The Mission of the Spies | vbm haretzion" - }, - "refs": { - "description": "All textual references found on this webpage which link to various Sefaria `Ref`s.", - "type": "array", - "items": { - "$ref": "#/components/schemas/ref" - }, - "example": "[\n\"Joshua 2:2-3\",\n\"I Samuel 26:9\",\n\"Deuteronomy 32:51\",\n\"Numbers 34:16-29\",\n\"Numbers 26:52-56\",\n\"Joshua 14\",\n\"Numbers 13\",\n\"Numbers 20:12\",\n\"Numbers 32:9\",\n\"Deuteronomy 9:1-2\",\n\"Numbers 13:20\",\n\"Genesis 13:17\",\n\"Numbers 13:21\",\n\"Numbers 13:22\",\n\"Deuteronomy 1:37\",\n\"Joshua 2:1\",\n\"Deuteronomy 1:22\",\n\"Deuteronomy 1\",\n\"Numbers 34\",\n\"Deuteronomy 1:21\",\n\"Numbers 32\",\n\"Deuteronomy 1:24\",\n\"Joshua 18:3-9\"\n]" - }, - "description": { - "description": "Description of the article. ", - "type": "string", - "example": "Parshat HaShavua Yeshivat Har Etzion PARASHAT SHELACH The Mission of the Spies by Rav Yaakov Medan A The Problem" - }, - "linkerHits": { - "format": "int32", - "description": "Number of hits by the Sefaria linker. ", - "type": "integer" - }, - "domain": { - "description": "Domain of the webpage", - "type": "string", - "example": "etzion.org.il" - }, - "siteName": { - "description": "Name of the webpage", - "type": "string", - "example": "Torat Har Etzion" - }, - "favicon": { - "description": "Favicon of the external webspage", - "type": "string", - "example": "https://www.google.com/s2/favicons?domain=etzion.org.il" - }, - "authors": { - "type": "string" - }, - "articleSource": { - "type": "string" - }, - "anchorRef": { - "$ref": "#/components/schemas/ref", - "description": "The `Ref` connecting this webpage to the queried `Ref`. ", - "example": "Deuteronomy 1.1" - }, - "anchorRefExpanded": { - "description": "If the `anchorRef` is a ranged `Ref`, this is an array of `Refs` containing each of the segments contained within that range. So for example, if `anchorRef` is Genesis 1:1-2, then `anchorRefExpanded` will be `[\"Genesis 1:1\", \"Genesis 1:2\"]`.", - "type": "array", - "items": { - "$ref": "#/components/schemas/ref" - }, - "example": "[\"Genesis 1.1\", \"Genesis 1.2\"]" - } - }, - "example": { - "url": "https://etzion.org.il/en/mission-spies", - "title": "The Mission of the Spies | vbm haretzion", - "refs": [ - "Joshua 2:2-3", - "I Samuel 26:9", - "Deuteronomy 32:51", - "Numbers 34:16-29", - "Numbers 26:52-56", - "Joshua 14", - "Numbers 13", - "Numbers 20:12", - "Numbers 32:9", - "Deuteronomy 9:1-2", - "Numbers 13:20", - "Genesis 13:17", - "Numbers 13:21", - "Numbers 13:22", - "Deuteronomy 1:37", - "Joshua 2:1", - "Deuteronomy 1:22", - "Deuteronomy 1", - "Numbers 34", - "Deuteronomy 1:21", - "Numbers 32", - "Deuteronomy 1:24", - "Joshua 18:3-9" - ], - "description": "Parshat HaShavua Yeshivat Har Etzion PARASHAT SHELACH The Mission of the Spies by Rav Yaakov Medan A The Problem", - "linkerHits": 283, - "domain": "etzion.org.il", - "siteName": "Torat Har Etzion", - "favicon": "https://www.google.com/s2/favicons?domain=etzion.org.il", - "anchorRef": "Deuteronomy 1", - "anchorRefExpanded": [ - "Deuteronomy 1:2" - ] + "_temp_id": { + "type": "string" + }, + "old-person-key": { + "type": "string" + } } - }, - "SheetsJSON": { - "title": "Root Type for SheetsJSON", - "description": "JSON containing metadata relating for a given source sheet on [Sefaria](sefaria.org).", + }, + "properties": { "type": "object", "properties": { - "owner": { - "format": "int32", - "description": "the Sefaria User ID of the sheet's owner.", - "type": "integer" - }, - "_id": { - "description": "The unique `id` for the source sheet.", - "type": "string" - }, - "id": { - "description": "The `id` of the sheet. This is used in the URL to retrieve sheets, for example, a sheet with an `id` of 1, would be accessible on [Sefaria](sefaria.org) at [sefaria.org/sheets/1](sefaria.org/sheets/1).", - "type": "string" - }, - "public": { - "description": "Is this sheet public.", - "type": "boolean", - "example": "True" - }, - "title": { - "description": "Title of the Source Sheet.", - "type": "string", - "example": "Five Chapters, Five Theologies?" - }, - "sheetUrl": { - "description": "URL to this source sheet.", - "type": "string", - "example": "/sheets/1" - }, - "anchorRef": { - "$ref": "#/components/schemas/ref", - "description": "The Sefaria reference that connects this sheet to the submitted `ref`", - "example": "Deuteronomy 1" - }, - "anchorRefExpanded": { - "description": "An array containing the individual segments `Ref`s which comprise the `anchorRef`. \n\nExample 1: Ranged `Ref`\nIf the `anchorRef` is `Genesis 2:14-16`, the `anchorRefExpanded` is `[\"Genesis 2:14\", \"Genesis 2:15\", \"Genesis 2:16\"]`. \n\nExample 2: Segment Ref\nIf the `anchorRef` itself is a segment `Ref`, the `anchorRefExpanded` will contain that identical value. For example, `anchorRef` of `Genesis 2:11` will have an `anchorRefExpanded` of `[\"Genesis 2:11\"]`", - "type": "array", - "items": { - "$ref": "#/components/schemas/ref" - } - }, - "options": { - "description": "A JSON object containing document level options related to how this source sheet should be displayed in Sefaria's Source Sheet editor.", - "type": "object", - "properties": { - "numbered": { - "description": "Should the sources be automatically numbered in the Sefaria editor view", - "type": "boolean" - }, - "boxed": { - "description": "Should the sources be boxed o the page in the Sefaria editor view", - "type": "boolean" - }, - "assignable": { - "description": "Is this source sheet an assignment for students in the Sefaria editor view", - "type": "boolean" - }, - "bsd": { - "description": "Should the source sheet include בס\"ד at the top of the page in the Sefaria editor view", - "type": "boolean" - }, - "language": { - "description": "Default display language of the source sheet in the Sefaria editor view", - "enum": [ - "blingual", - "hebrew", - "english" - ], - "type": "string" - }, - "layout": { - "description": "Default display layout of the source sheet in the Sefaria editor view", - "type": "string" - }, - "langLayout": { - "description": "Default display side of the language in a bilingual side-by-side view in the Sefaria editor view", - "type": "string" - }, - "divineNames": { - "description": "Should the Tetragrammaton (Shem Hashem) and other variants of the divine name be replaced, and if so in what form?", - "type": "string" - }, - "highlightMode": { - "deprecated": true, - "format": "int32", - "type": "integer" - }, - "collaboration": { - "type": "string" - } - }, - "example": "{\n\"layout\": \"sideBySide\",\n\"bsd\": 0,\n\"collaboration\": \"none\",\n\"language\": \"bilingual\",\n\"boxed\": 0,\n\"langLayout\": \"enLeft\",\n\"numbered\": 0,\n\"divineNames\": \"noSub\"\n}" - }, - "collectionTOC": { - "type": "string" - }, - "ownerName": { - "description": "Name of the owner of the sheet.", - "type": "string" - }, - "via": { - "description": "Some source sheets are made by copying another users. If this is one of them, the original owner's user ID will be listed here.", - "type": "string" - }, - "viaOwnerName": { - "description": "Some source sheets are made by copying another users. If this is one of them, the original owner's display name will be listed here.", + "enWikiLink": { + "type": "object", + "properties": { + "value": { "type": "string" - }, - "assignerName": { - "description": "Some source sheets are created as assignments by a teacher to be completed by students. If this is one of those sheets the name of the assigner will be found here.", + }, + "dataSource": { "type": "string" - }, - "viaOwnerProfileUrl": { - "description": "Some source sheets are made by copying another users. If this is one of them, the path to the original owner's profile page will be listed here.", + } + } + }, + "jeLink": { + "type": "object", + "properties": { + "value": { "type": "string" - }, - "assignerProfileUrl": { - "description": "Some source sheets are created as assignments by a teacher to be completed by students. If this is one of those sheets this will be the URL path to their profile.", + }, + "dataSource": { "type": "string" - }, - "ownerProfileUrl": { - "description": "The URL Path that will link to a user's profile on the Sefaria site.", + } + } + }, + "generation": { + "type": "object", + "properties": { + "value": { "type": "string" - }, - "ownerImageUrl": { - "description": "Sheet owner image.", + }, + "dataSource": { "type": "string" - }, - "status": { - "description": "a string indicating whether the sheet is `public` or `unlisted`", - "enum": [ - "public", - "unlisted" - ], - "type": "string", - "example": "\"public\"" - }, - "views": { - "format": "int32", - "description": "Number of source sheet views.", - "type": "integer", - "example": "8509" - }, - "topics": { - "description": "Topics linked to the source sheet.", - "type": "array", - "items": { - "$ref": "#/components/schemas/SheetTopicJSON" - }, - "example": "[\n{\n\"slug\": \"גשר-מפעלים-חינוכיים\",\n\"asTyped\": \"גשר - מפעלים חינוכיים\",\n\"he\": \"גשר - מפעלים חינוכיים\",\n\"en\": \"\"\n},\n{\n\"slug\": \"parashat-devarim\",\n\"asTyped\": \"דברים\",\n\"he\": \"דברים\",\n\"en\": \"Parashat Devarim\"\n},\n{\n\"slug\": \"torah\",\n\"asTyped\": \"תורה\",\n\"he\": \"תורה\",\n\"en\": \"Torah\"\n},\n{\n\"slug\": \"tanakh\",\n\"asTyped\": \"תנ\\\"ך\",\n\"he\": \"תנ\\\"ך\",\n\"en\": \"Tanakh\"\n},\n{\n\"slug\": \"הלכות\",\n\"asTyped\": \"הלכות\",\n\"he\": \"הלכות\",\n\"en\": \"\"\n},\n{\n\"slug\": \"חמישה-חומשי-תורה\",\n\"asTyped\": \"חמישה חומשי תורה\",\n\"he\": \"חמישה חומשי תורה\",\n\"en\": \"\"\n},\n{\n\"slug\": \"moses\",\n\"asTyped\": \"משה רבנו\",\n\"he\": \"משה רבנו\",\n\"en\": \"Moses\"\n},\n{\n\"slug\": \"mishneh-torah\",\n\"asTyped\": \"משנה תורה\",\n\"he\": \"משנה תורה\",\n\"en\": \"Mishneh Torah\"\n},\n{\n\"asTyped\": \"קהילה\",\n\"slug\": \"kehillah\",\n\"he\": \"קהילה\",\n\"en\": \"Kehillah\"\n},\n{\n\"asTyped\": \"יחיד וחברה\",\n\"slug\": \"יחיד-וחברה\",\n\"he\": \"יחיד וחברה\",\n\"en\": \"\"\n},\n{\n\"asTyped\": \"מדינה\",\n\"slug\": \"state\",\n\"he\": \"מדינה\",\n\"en\": \"State\"\n},\n{\n\"asTyped\": \"יחיד וחברה\",\n\"slug\": \"יחיד-וחברה\",\n\"he\": \"יחיד וחברה\",\n\"en\": \"\"\n},\n{\n\"asTyped\": \"העם היהודי\",\n\"slug\": \"jewish-people\",\n\"he\": \"העם היהודי\",\n\"en\": \"Jewish People\"\n},\n{\n\"asTyped\": \"יחיד וחברה\",\n\"slug\": \"יחיד-וחברה\",\n\"he\": \"יחיד וחברה\",\n\"en\": \"\"\n},\n{\n\"asTyped\": \"מנהיגות\",\n\"slug\": \"leadership\",\n\"he\": \"מנהיגות\",\n\"en\": \"Leadership\"\n},\n{\n\"asTyped\": \"יחיד וחברה\",\n\"slug\": \"יחיד-וחברה\",\n\"he\": \"יחיד וחברה\",\n\"en\": \"\"\n},\n{\n\"asTyped\": \"אמונות ודעות\",\n\"slug\": \"אמונות-ודעות\",\n\"he\": \"אמונות ודעות\",\n\"en\": \"\"\n},\n{\n\"asTyped\": \"ארץ ישראל\",\n\"slug\": \"jewish-people\",\n\"he\": \"ארץ ישראל\",\n\"en\": \"Jewish People\"\n},\n{\n\"asTyped\": \"אדם ומרחב\",\n\"slug\": \"אדם-ומרחב\",\n\"he\": \"אדם ומרחב\",\n\"en\": \"\"\n},\n{\n\"asTyped\": \"אישים\",\n\"slug\": \"important-people\",\n\"he\": \"אישים\",\n\"en\": \"Important People\"\n},\n{\n\"asTyped\": \"תרבות\",\n\"slug\": \"culture\",\n\"he\": \"תרבות\",\n\"en\": \"Culture\"\n},\n{\n\"asTyped\": \"סיפורים מכוננים\",\n\"slug\": \"סיפורים-מכוננים\",\n\"he\": \"סיפורים מכוננים\",\n\"en\": \"\"\n},\n{\n\"asTyped\": \"תרבות\",\n\"slug\": \"culture\",\n\"he\": \"תרבות\",\n\"en\": \"Culture\"\n},\n{\n\"asTyped\": \"אחריות וסולידריות\",\n\"slug\": \"אחריות-וסולידריות\",\n\"he\": \"אחריות וסולידריות\",\n\"en\": \"\"\n},\n{\n\"asTyped\": \"יחיד וחברה\",\n\"slug\": \"יחיד-וחברה\",\n\"he\": \"יחיד וחברה\",\n\"en\": \"\"\n},\n{\n\"asTyped\": \"ספר דברים\",\n\"slug\": \"deuteronomy\",\n\"he\": \"ספר דברים\",\n\"en\": \"Deuteronomy\"\n},\n{\n\"asTyped\": \"פרשת השבוע\",\n\"slug\": \"torah-portions\",\n\"he\": \"פרשת השבוע\",\n\"en\": \"Torah Portions\"\n},\n{\n\"asTyped\": \"מקום\",\n\"slug\": \"places\",\n\"he\": \"מקום\",\n\"en\": \"Places\"\n},\n{\n\"asTyped\": \"אדם ומרחב\",\n\"slug\": \"אדם-ומרחב\",\n\"he\": \"אדם ומרחב\",\n\"en\": \"\"\n}\n]" - }, - "likes": { - "description": "An array of user IDs who have favorited or liked this source sheet.", - "type": "array", - "items": {} - }, - "summary": { - "description": "A user generated description of the source sheet", + } + } + }, + "sex": { + "type": "object", + "properties": { + "value": { "type": "string" - }, - "attribution": { - "description": "Some source sheets are made by copying another users. If so, an attribution field will be created and displayed here.", + }, + "dataSource": { "type": "string" - }, - "is_featured": { - "deprecated": true, - "description": "Previously a source sheet flagged with `is_featured` would be promoted throughout the site in various places. This behavior was removed in 2022 but some of the data remains. ", - "type": "boolean" - }, - "category": { - "description": "This will always return `Sheets`", + } + } + }, + "heWikiLink": { + "type": "object", + "properties": { + "data_source": { "type": "string" - }, - "type": { + }, + "value": { "type": "string" + } } - }, - "example": { - "owner": 65000, - "_id": "5ec3a6f7c73d4d278311782e", - "id": "238181", - "public": true, - "title": "סדר תיקון ליל שבועות", - "sheetUrl": "/sheets/238181", - "anchorRef": "Deuteronomy 1", - "anchorRefExpanded": [ - "Deuteronomy 1:2" - ], - "options": { - "numbered": 0, - "boxed": 0, - "assignable": 0, - "bsd": 1, - "language": "hebrew", - "layout": "stacked", - "langLayout": "heRight", - "divineNames": "ykvk", - "highlightMode": 0, - "collaboration": "none" - }, - "ownerName": "יותם גונן", - "ownerProfileUrl": "/profile/-2977", - "ownerImageUrl": "https://storage.googleapis.com/sefaria-profile-pictures/-2977-1626800304-small.png", - "status": "public", - "views": 8509, - "topics": [], - "likes": [], - "summary": "", - "is_featured": false, - "category": "Sheets", - "type": "sheet" + } + } + }, + "description": { + "type": "object", + "properties": { + "en": { + "type": "string" + }, + "he": { + "type": "string" + } + } + }, + "categoryDescription": { + "type": "object" + }, + "numSources": { + "format": "int32", + "type": "integer" + }, + "good_to_promote": { + "type": "boolean" + }, + "description_published": { + "type": "boolean" + }, + "primaryTitle": { + "type": "object", + "properties": { + "en": { + "type": "string" + }, + "he": { + "type": "string" + } } + } + }, + "example": "{\n\"slug\": \"metushelach\",\n\"titles\": [\n{\n\"text\": \"Metushelach\",\n\"lang\": \"en\",\n\"primary\": true,\n\"transliteration\": true\n},\n{\n\"text\": \"מתושלח\",\n\"lang\": \"he\",\n\"primary\": true\n},\n{\n\"text\": \"Methuselah\",\n\"lang\": \"en\"\n},\n{\n\"text\": \"Methushelach\",\n\"lang\": \"en\"\n}\n],\n\"subclass\": \"person\",\n\"alt_ids\": {\n\"_temp_id\": \"מתושלח\",\n\"wikidata\": \"Q156290\"\n},\n\"properties\": {\n\"enWikiLink\": {\n\"value\": \"https://en.wikipedia.org/wiki/Methuselah\",\n\"dataSource\": \"wikidata\"\n},\n\"heWikiLink\": {\n\"value\": \"https://he.wikipedia.org/wiki/מתושלח\",\n\"dataSource\": \"wikidata\"\n},\n\"deWikiLink\": {\n\"value\": \"https://de.wikipedia.org/wiki/Methusalem\",\n\"dataSource\": \"wikidata\"\n},\n\"esWikiLink\": {\n\"value\": \"https://es.wikipedia.org/wiki/Matusalén\",\n\"dataSource\": \"wikidata\"\n},\n\"frWikiLink\": {\n\"value\": \"https://fr.wikipedia.org/wiki/Mathusalem\",\n\"dataSource\": \"wikidata\"\n},\n\"ruWikiLink\": {\n\"value\": \"https://ru.wikipedia.org/wiki/Мафусал_(потомок_Сифа)\",\n\"dataSource\": \"wikidata\"\n}\n},\n\"numSources\": 7,\n\"good_to_promote\": true,\n\"primaryTitle\": {\n\"en\": \"Metushelach\",\n\"he\": \"מתושלח\"\n}\n}" + }, + "url": { + "description": "The `Ref` in a format appropriate for a URL, with spaces replaced with `.` etc. ", + "type": "string", + "example": "Deuteronomy.16.21" + } + }, + "example": { + "ref": "Pesachim 66a:3-6", + "topic": { + "slug": "hillel", + "titles": [], + "subclass": "person", + "alt_ids": { + "_temp_id": "הלל", + "old-person-key": "Hillel the Elder" + }, + "properties": { + "enWikiLink": { + "value": "http://en.wikipedia.org/wiki/Hillel_the_Elder", + "dataSource": "person-collection" + }, + "jeLink": { + "value": "http://www.jewishencyclopedia.com/view.jsp?artid=730&letter=H", + "dataSource": "person-collection" + }, + "generation": { + "value": "Z5", + "dataSource": "person-collection" + }, + "sex": { + "value": "M", + "dataSource": "person-collection" + }, + "heWikiLink": { + "data_source": "wikidata", + "value": "https://he.wikipedia.org/wiki/%D7%94%D7%9C%D7%9C_%D7%94%D7%96%D7%A7%D7%9F" + } + }, + "description": { + "en": "Hillel was one of the most influential and prolific of the early teachers. Coming from Babylon to learn with Avtalyon and Shemaya, he soon became famous for his scholarship and his patient and tolerant manner. Bolstered by his Davidic lineage, he served as Nasi during part of Herod’s reign.", + "he": "הלל היה אחד החכמים הראשונים, ומהפורים והמשפיעים ביניהם. הוא הגיע מבבל כדי ללמוד עם שמעיה ואבטליון, ונודע מהר מאוד בשל חוכמתו בתורה ואופיו הסבלני והסובלני. היותו צאצא של בית דוד הייתה בסיס לכהונתו כנשיא בתקופת שלטונו של הורדוס." }, - "SheetTopicJSON": { - "title": "Root Type for SheetTopicJSON", - "description": "", + "categoryDescription": {}, + "numSources": 217, + "good_to_promote": true, + "description_published": true, + "primaryTitle": { + "en": "Hillel", + "he": "הִלֵּל" + } + }, + "url": "Pesachim.66a.3-6" + } + }, + "RandomByTopicTopicJSON": { + "title": "Root Type for RandomByTopicTopicJSON", + "description": "Topic JSON for the `random-by-topic/` endpoint. ", + "required": [ + "slug" + ], + "type": "object", + "properties": { + "slug": { + "description": "The unique slug for a given topic.", + "type": "string", + "example": "mezuzah" + }, + "titles": { + "$ref": "#/components/schemas/TitlesJSON", + "description": "An array of JSON objects, each representing an alternative title for the object, in various languages. " + }, + "alt_ids": { + "description": "This is a dictionary containing the keys of naming schemes, and ids of this topic represented in that naming scheme. It’s used both for canonical names in other naming schemes and temporary storage of names when renaming slugs. All of the data here is for internal use, with the exception of the values `bfo` and `wikidata`. `bfo` refers to [basic formal ontology](https://github.com/BFO-ontology/BFO#implementations), and `wikidata` to the wikidata ontology of topics. ", + "example": "\"alt_ids\": {\n \"_temp_id\": \"משה\",\n \"wikidata\": \"Q9077\",\n \"_old_slug\": \"-75\"\n}" + }, + "categoryDescription": { + "description": "A description of the category of this topic", + "type": "string" + }, + "good_to_promote": { + "description": "A topic which will be included in our results from the `random-by-topic` endpoint. ", + "type": "boolean" + }, + "numSources": { + "description": "The number of text sources associated with a topic. ", + "type": "integer", + "example": "613" + }, + "description_published": { + "description": "A boolean representing whether or not the description was published. ", + "type": "boolean", + "example": "false" + }, + "data_source": { + "description": "How the topic was generated, whether by Sefaria, a user on a source sheet, or some other source. ", + "type": "string", + "example": "sefaria" + }, + "primary_title": { + "$ref": "#/components/schemas/BillingualJSON", + "description": "The primary title for a topic.", + "example": "{\n \"en\": \"Sukkot\",\n \"he\": \"סוכות\"\n}" + }, + "description": { + "$ref": "#/components/schemas/BillingualJSON", + "description": "A description of the topic in English" + } + }, + "example": { + "slug": "mezuzah", + "titles": [ + { + "text": "Mezuzah", + "lang": "en", + "primary": true + }, + { + "text": "מזוזה", + "lang": "he", + "primary": true + } + ], + "alt_ids": { + "_temp_id": "מזוזה" + }, + "description": { + "en": "A mezuzah is the small parchment placed inside a case and attached to the right side of entryway doorframes where Jews reside. Written on the scroll are various sections from the Torah, such as the Shema, that feature some of Judaism's central principles.", + "he": "המזוזה היא נייר קלף קטן הנמצא בתוך נרתיק (בית המזוזה) המחובר לצד הימני של משקוף הדלת בבתי יהודים. על מגילת הקלף כתובים מגוון קטעים מן התורה, דוגמת פרשת שמע הכוללת כמה מהעקרונות העיקריים של היהדות." + }, + "categoryDescription": {}, + "numSources": 120, + "good_to_promote": true, + "description_published": true, + "data_source": "sefaria", + "primaryTitle": { + "en": "Mezuzah", + "he": "מזוזה" + } + } + }, + "RefTopicLinksJSON": { + "title": "Root Type for RefTopicLinksJSON", + "description": "Response from the ref-topic-links endpoint", + "type": "object", + "properties": { + "linkType": { + "description": "The type of the link, based on the relationship within our ontology. Many links has an `is-a` relationship (such as `Genesis` `is-a` `Book`), but other topic-to-topic links have a variety of other types documented [here](https://developers.sefaria.org/docs/topic-ontology#overview-of-sefaria-link-types). \n\nSome examples include `child-of`, `parent-of`, `sibling-of` etc. ", + "type": "string", + "example": "about" + }, + "class": { + "description": "A classification of the link as either `refTopic` (i.e. a ref to a topic) or `intraTopic` (topic-to-topic). In this case, it would be expected that all returned topic links would be of type `refTopic`. ", + "enum": [ + "refTopic", + "intraTopic" + ], + "type": "string", + "example": "refTopic" + }, + "dataSource": { + "$ref": "#/components/schemas/DataSourceJSON", + "description": "Where the topic link originated from (i.e. was it added to a sheet and generated by Sefaria users, or was it created by the Sefaria learning team?)", + "properties": { + "en": { + "type": "string" + }, + "he": { + "type": "string" + }, + "slug": { + "type": "string" + } + }, + "example": "{\n\"en\": \"Sheets by Sefaria users\",\n\"he\": \"דפי מקורות ממשתמשי ספריא\",\n\"slug\": \"sefaria-users\"\n}" + }, + "is_sheet": { + "description": "Is this ref-to-topic link one that was generated by a user-created source sheet?", + "type": "boolean", + "example": "false" + }, + "order": { + "$ref": "#/components/schemas/OrderTopicLinkJSON", + "description": "This JSON includes the various metrics that are relevant for ordering the link on a topics page. We use these metrics at [Sefaria.org](sefaria.org) to change the order on the topics page.", + "properties": { + "tfidf": { + "format": "double", + "type": "number" + }, + "numDatasource": { + "format": "int32", + "type": "integer" + }, + "availableLangs": { + "type": "array", + "items": { + "type": "string" + } + }, + "comp_date": { + "format": "int32", + "type": "integer" + }, + "order_id": { + "type": "string" + }, + "pr": { + "format": "double", + "type": "number" + }, + "curatedPrimacy": { "type": "object", "properties": { - "slug": { - "description": "Slug of the topic", - "type": "string", - "example": "parashat-devarim" - }, - "asTyped": { - "description": "How the user typed the topic", - "type": "string", - "example": "tanach" - }, - "he": { - "description": "Hebrew topic title", - "type": "string", - "example": "דברים" - }, - "en": { - "description": "English topic title", - "type": "string", - "example": "Parashat Devarim" - } - }, - "example": { - "slug": "parashat-devarim", - "asTyped": "דברים", - "he": "דברים", - "en": "Parashat Devarim" + "en": { + "format": "int32", + "type": "integer" + }, + "he": { + "format": "int32", + "type": "integer" + } } + } }, - "RelatedLinkJSON": { - "title": "Root Type for RelatedLinkJSON", - "description": "The link JSON returned as part of results for the related API endpoint. ", + "example": "\"order\": {\n\"tfidf\": 53.476917039392994,\n\"numDatasource\": 2,\n\"availableLangs\": [\n\"en\",\n\"he\"\n],\n\"comp_date\": -1400,\n\"order_id\": \"A00000000300280026\",\n\"pr\": 5.15330629652094,\n\"curatedPrimacy\": {\n\"en\": 100,\n\"he\": 0\n}\n}" + }, + "descriptions": { + "description": "JSON containing descriptions for a given topic in various languages. Each language contains a `title` for the topic description, as well as a `prompt` which previews the source and asks questions to help the user engage with the text. ", + "type": "object", + "properties": { + "en": { "type": "object", "properties": { - "_id": { - "type": "string" - }, - "index_title": { - "description": "English title of the linked work. ", - "type": "string", - "example": "Rashi on Deuteronomy" - }, - "category": { - "description": "Category of the type of link, for example a link between `Rashi on Exodus` and `Exodus` would have a category of `Commentary`. ", - "type": "string", - "example": "Commentary" - }, - "type": { - "type": "string" - }, - "ref": { - "$ref": "#/components/schemas/ref", - "description": "Specific `Ref` of the segment which is linked to the queried `anchorRef`. ", - "example": "Rashi on Deuteronomy 1:11:1" - }, - "anchorRef": { - "$ref": "#/components/schemas/ref", - "description": "The submitted ref in the GET request at times may fall within a more encompassing ranged `Re`f that includes multiple text segments. The `anchorRef` is that complete range the that the link is associated with, and will contain within it the specific ref that was passed.", - "example": "Deuteronomy 1:11" - }, - "anchorRefExpanded": { - "description": "An array of strings, where each string is a segment level `Ref` of the `Ref` passed in as a parameter. If a segment level `Ref` is passed in, this array will have a length of 1, and only contain that segment level `Ref`. If the `Ref` passed in is ranged, this array will contain each of the segment level `Ref`s within that range.\n\nFor example, if someone was searching for links for Esther 4.14-15, the `anchorRefExpanded` would contain Esther 4.14 and Esther 4.15.", - "type": "array", - "items": { - "$ref": "#/components/schemas/ref" - }, - "example": "\"anchorRefExpanded\": [\n\"Deuteronomy 1:11\"\n]" - }, - "sourceRef": { - "type": "string" - }, - "sourceHeRef": { - "description": "Hebrew `Ref` of the linked source. ", - "type": "string", - "example": " רש\\\"י על דברים א׳:י״א:א׳\n" - }, - "anchorVerse": { - "format": "int32", - "type": "integer" - }, - "sourceHasEn": { - "description": "Does the source have an English translation?", - "type": "boolean", - "example": "True" - }, - "compDate": { - "description": "Date of the two books in the link were composed. Negative values indicate dates BCE. ", - "type": "array", - "items": { - "format": "int32", - "type": "integer" - }, - "example": "[\n1075,\n1105\n]" - }, - "commentaryNum": { - "format": "double", - "type": "number" - }, - "collectiveTitle": { - "type": "object", - "properties": { - "en": { - "type": "string" - }, - "he": { - "type": "string" - } - } - }, - "heTitle": { - "description": "Hebrew title of the linked work", - "type": "string", - "example": "רש\\\"י על דברים" + "title": { + "type": "string" + }, + "prompt": { + "type": "string" + } + } + } + }, + "example": "\"en\": {\n\"title\": \"A New Grain Offering\",\n\"prompt\": \"The central ritual of Shavuot as described in the Torah is a special bread offering that was brought to the Temple. This sacrifice marked the beginning of sacrifices that were brought using grain from that year, as opposed to grains from the previous year, as explained in the Book of Numbers.\"\n}" + }, + "topic": { + "description": "The title of the topic. ", + "type": "string", + "example": "passover" + }, + "anchorRef": { + "description": "The `Ref` the topic is connected to, which should overlap with the requested `Ref` passed through the endpoint. For example, if someone queries for `Bamidbar 28:21`, one of the topics returned is `passover` which has an `anchorRef` of `Numbers 28:16-24` - a range overlapping with our desired `Ref`. ", + "type": "string", + "example": "Numbers 28:16-24" + }, + "anchorRefExpanded": { + "description": "If the `anchorRef` is a ranged `Ref` (i.e. containing more than a single segment), then this is a list of strings, with each string being one of single segment level `Ref`s that together comprise the range. So for example, the `anchorRefExpanded` of `Exodus 1:1-2` would be `[\"Exodus 1:1\", \"Exodus 1:2\"]`. ", + "type": "array", + "items": { + "type": "string" + }, + "example": "\"Numbers 28:16\",\n\"Numbers 28:17\",\n\"Numbers 28:18\",\n\"Numbers 28:19\",\n\"Numbers 28:20\",\n\"Numbers 28:21\",\n\"Numbers 28:22\",\n\"Numbers 28:23\",\n\"Numbers 28:24\"" + } + }, + "example": { + "linkType": "about", + "class": "refTopic", + "dataSource": { + "en": "Aspaklaria", + "he": "אספקלריא", + "slug": "aspaklaria" + }, + "is_sheet": false, + "order": { + "tfidf": 53.476917039392994, + "numDatasource": 2, + "availableLangs": [ + "en", + "he" + ], + "comp_date": -1400, + "order_id": "A00000000300280026", + "pr": 5.15330629652094, + "curatedPrimacy": { + "en": 100, + "he": 0 + } + }, + "descriptions": { + "en": { + "title": "A New Grain Offering", + "prompt": "The central ritual of Shavuot as described in the Torah is a special bread offering that was brought to the Temple. This sacrifice marked the beginning of sacrifices that were brought using grain from that year, as opposed to grains from the previous year, as explained in the Book of Numbers." + } + }, + "topic": "shavuot", + "anchorRef": "Numbers 28:26", + "anchorRefExpanded": [ + "Numbers 28:26" + ] + } + }, + "DataSourceJSON": { + "title": "Root Type for DataSourceJSON", + "description": "JSON containing the information as to the source of the data for a given ref-to-topic link. ", + "type": "object", + "properties": { + "en": { + "description": "English title of the data source.", + "type": "string", + "example": "Aspaklaria" + }, + "he": { + "description": "Hebrew title of the data source.", + "type": "string", + "example": "אספקלריא" + }, + "slug": { + "description": "Unique slug describing the data source. ", + "type": "string", + "example": "aspaklaria" + } + }, + "example": { + "en": "Sheets by Sefaria users", + "he": "דפי מקורות ממשתמשי ספריא", + "slug": "sefaria-users" + } + }, + "OrderTopicLinkJSON": { + "title": "Root Type for OrderTopicLinkJSON", + "description": "This JSON includes the various metrics that are relevant for ordering the link on a topics page. We use these metrics at [Sefaria.org](sefaria.org) to change the order on the topics page.", + "type": "object", + "properties": { + "tfidf": { + "format": "double", + "description": "Results of the [tfidf algorithm](https://en.wikipedia.org/wiki/Tf%E2%80%93idf) run on the `Ref`s within a given topic, as another metric for evaluating the relevance of a given source on a topic page. ", + "type": "number", + "example": "53.476917039392994" + }, + "numDatasource": { + "format": "int32", + "description": "The number of datasources which connect this `Ref` to the topic. A value of `2` will occur when two sources (i.e. `aspaklaria` and `sefaria sheets` both have connections between this `Ref` and this topic.)", + "type": "integer", + "example": "3" + }, + "availableLangs": { + "description": "This topic is available in a list of languages represented as strings with their language code.", + "type": "array", + "items": { + "type": "string" + }, + "example": "[\n\"en\",\n\"he\"\n]" + }, + "comp_date": { + "format": "int32", + "description": "The date when the book referenced in the `Ref` was composed. Negative numbers indicate the work was composed BCE, whereas positive numbers indicate the book was composed CE. ", + "type": "integer", + "example": "-1400" + }, + "order_id": { + "description": "Unique ID for the `order` JSON.", + "type": "string", + "example": "A00000000300280026" + }, + "pr": { + "format": "double", + "description": "`PageRank`. Sefaria calculates `PageRank` for the sources on a given topic page using the internal Sefaria links to create a link graph and then running the [PageRank algorithm](https://en.wikipedia.org/wiki/PageRank) on that. Sources with higher `PageRank` are considered to be more centrally linked and more relevant.", + "type": "number", + "example": "5.15330629652094" + }, + "curatedPrimacy": { + "description": "This field is used for manually ordering a source on a topics page. It has a separate order value for each language.", + "type": "object", + "properties": { + "en": { + "format": "int32", + "type": "integer" + }, + "he": { + "format": "int32", + "type": "integer" + } + }, + "example": "\"curatedPrimacy\": {\n\"en\": 100,\n\"he\": 0\n}" + } + }, + "example": { + "tfidf": 53.476917039392994, + "numDatasource": 2, + "availableLangs": [ + "en", + "he" + ], + "comp_date": -1400, + "order_id": "A00000000300280026", + "pr": 5.15330629652094, + "curatedPrimacy": { + "en": 100, + "he": 0 + } + } + }, + "TermsJSON": { + "title": "Root Type for TermsJSON", + "description": "Term JSON returned to a query for a Term. ", + "required": [ + "name" + ], + "type": "object", + "properties": { + "name": { + "description": "The name of the `Term`. Since a `Term` is a shared title node that can be referenced and used by many different `Index` nodes, the `name` field is critical as it contains the shared title. ", + "type": "string", + "example": "Noah" + }, + "titles": { + "description": "Alternative titles for the term in Hebrew and English.", + "type": "array", + "items": { + "$ref": "#/components/schemas/TitlesJSON" + }, + "example": "\n{\n\"primary\": true,\n\"text\": \"Noach\",\n\"lang\": \"en\"\n},\n{\n\"primary\": true,\n\"text\": \"נח\",\n\"lang\": \"he\"\n},\n{\n\"text\": \"Parashat Noach\",\n\"lang\": \"en\"\n},\n{\n\"text\": \"פרשת נח\",\n\"lang\": \"he\"\n},\n{\n\"text\": \"Noah\",\n\"lang\": \"en\"\n},\n{\n\"text\": \"Parshat Noah\",\n\"lang\": \"en\"\n}\n]" + }, + "scheme": { + "description": "A shared `scheme` for a group of terms. ", + "type": "string", + "example": "Parasha" + }, + "order": { + "format": "int32", + "description": "Terms that share a `scheme` can be ordered within that `scheme`. So for example, _Parshiyot_ within the `Parasha` scheme can be ordered as per the order of the _Parshiyot_. ", + "type": "integer", + "example": "4" + }, + "ref": { + "$ref": "#/components/schemas/ref", + "description": "For a _Parasha_, this is the Sefaria `Ref` which correlates to this _Parasha_ in the text. For example, _Parshat Noah_ corresponds to the ranged `Ref` of `\"Genesis 6:9-11:32\"`. ", + "example": "\"Genesis 6:9-11:32\"" + }, + "category": { + "description": "The category of a specific term. ", + "type": "string", + "example": "`texts`, `Torah Portions`" + } + }, + "example": { + "name": "Noach", + "titles": [ + { + "primary": true, + "text": "Noach", + "lang": "en" + }, + { + "primary": true, + "text": "נח", + "lang": "he" + }, + { + "text": "Parashat Noach", + "lang": "en" + }, + { + "text": "פרשת נח", + "lang": "he" + }, + { + "text": "Noah", + "lang": "en" + }, + { + "text": "Parshat Noah", + "lang": "en" + } + ], + "scheme": "Parasha", + "order": 2, + "ref": "Genesis 6:9-11:32", + "category": "Torah Portions" + } + }, + "TitlesJSON": { + "title": "Root Type for TopicTitlesJSON", + "description": "Alternative title for a topic, along with the language code representing the language of the given title. ", + "type": "object", + "properties": { + "text": { + "description": "The text of the title", + "type": "string", + "example": "Sukkoth" + }, + "lang": { + "description": "The language of the title, either `en` or `he`. ", + "type": "string", + "example": "he" + }, + "Primary": { + "description": "A field depicting whether or not the title is the primary title. Note: For any given topics, one should expect two titles with this field present and set to `true`, an English and a Hebrew primary title. The English value with `primary` set to `true` will match the string value of the `primaryTitle` field on topic. ", + "type": "boolean", + "example": "false" + } + }, + "example": { + "text": "Tabernacles", + "lang": "en", + "primary": false + } + }, + "RelatedJSON": { + "title": "Root Type for RelatedJSON", + "description": "", + "type": "object", + "properties": { + "links": { + "description": "An array of JSON containing the metadata for links to the reference.", + "type": "array", + "items": { + "$ref": "#/components/schemas/RelatedLinkJSON" + }, + "example": "[\n{\n\"_id\": \"54bd48c4fbfba21733367bfa\",\n\"index_title\": \"Psalms\",\n\"category\": \"Tanakh\",\n\"type\": \"\",\n\"ref\": \"Psalms 51\",\n\"anchorRef\": \"Or HaChaim on Deuteronomy 1:1:1\",\n\"anchorRefExpanded\": [\n\"Or HaChaim on Deuteronomy 1:1:1\"\n],\n\"sourceRef\": \"Psalms 51\",\n\"sourceHeRef\": \"תהילים נ״א\",\n\"anchorVerse\": 1,\n\"sourceHasEn\": true,\n\"compDate\": [\n-1000,\n0\n],\n\"commentaryNum\": 51,\n\"collectiveTitle\": {\n\"en\": \"Psalms\",\n\"he\": \"תהילים\"\n},\n\"heTitle\": \"תהילים\"\n},\n{\n\"_id\": \"54bd48c4fbfba21733367bfc\",\n\"index_title\": \"Pirkei Avot\",\n\"category\": \"Mishnah\",\n\"type\": \"\",\n\"ref\": \"Pirkei Avot 3\",\n\"anchorRef\": \"Or HaChaim on Deuteronomy 1:1:1\",\n\"anchorRefExpanded\": [\n\"Or HaChaim on Deuteronomy 1:1:1\"\n],\n\"sourceRef\": \"Pirkei Avot 3\",\n\"sourceHeRef\": \"משנה אבות ג׳\",\n\"anchorVerse\": 1,\n\"sourceHasEn\": true,\n\"compDate\": [\n190,\n230\n],\n\"commentaryNum\": 3,\n\"collectiveTitle\": {\n\"en\": \"Pirkei Avot\",\n\"he\": \"משנה אבות\"\n},\n\"heTitle\": \"משנה אבות\"\n},\n{\n\"_id\": \"54bd48c4fbfba21733367bfe\",\n\"index_title\": \"Pirkei Avot\",\n\"category\": \"Mishnah\",\n\"type\": \"\",\n\"ref\": \"Pirkei Avot 4\",\n\"anchorRef\": \"Or HaChaim on Deuteronomy 1:1:1\",\n\"anchorRefExpanded\": [\n\"Or HaChaim on Deuteronomy 1:1:1\"\n],\n\"sourceRef\": \"Pirkei Avot 4\",\n\"sourceHeRef\": \"משנה אבות ד׳\",\n\"anchorVerse\": 1,\n\"sourceHasEn\": true,\n\"compDate\": [\n190,\n230\n],\n\"commentaryNum\": 4,\n\"collectiveTitle\": {\n\"en\": \"Pirkei Avot\",\n\"he\": \"משנה אבות\"\n},\n\"heTitle\": \"משנה אבות\"\n},\n{\n\"_id\": \"54bd48c4fbfba21733367c08\",\n\"index_title\": \"Proverbs\",\n\"category\": \"Tanakh\",\n\"type\": \"\",\n\"ref\": \"Proverbs 3\",\n\"anchorRef\": \"Or HaChaim on Deuteronomy 1:1:1\",\n\"anchorRefExpanded\": [\n\"Or HaChaim on Deuteronomy 1:1:1\"\n],\n\"sourceRef\": \"Proverbs 3\",\n\"sourceHeRef\": \"משלי ג׳\",\n\"anchorVerse\": 1,\n\"sourceHasEn\": true,\n\"compDate\": [\n-800,\n-400\n],\n\"commentaryNum\": 3,\n\"collectiveTitle\": {\n\"en\": \"Proverbs\",\n\"he\": \"משלי\"\n},\n\"heTitle\": \"משלי\"\n},\n{\n\"_id\": \"54bd48c4fbfba21733367c0e\",\n\"index_title\": \"Yoma\",\n\"category\": \"Talmud\",\n\"type\": \"\",\n\"ref\": \"Yoma 19b\",\n\"anchorRef\": \"Or HaChaim on Deuteronomy 1:1:1\",\n\"anchorRefExpanded\": [\n\"Or HaChaim on Deuteronomy 1:1:1\"\n],\n\"sourceRef\": \"Yoma 19b\",\n\"sourceHeRef\": \"יומא י״ט ב\",\n\"anchorVerse\": 1,\n\"sourceHasEn\": true,\n\"compDate\": [\n450,\n550\n],\n\"commentaryNum\": 38,\n\"collectiveTitle\": {\n\"en\": \"Yoma\",\n\"he\": \"יומא\"\n},\n\"heTitle\": \"יומא\"\n},\n{\n\"_id\": \"53f17c73fbfba22336eaba1e\",\n\"index_title\": \"Deuteronomy\",\n\"category\": \"Tanakh\",\n\"type\": \"commentary\",\n\"ref\": \"Deuteronomy 1:1\",\n\"anchorRef\": \"Or HaChaim on Deuteronomy 1:1:1\",\n\"anchorRefExpanded\": [\n\"Or HaChaim on Deuteronomy 1:1:1\"\n],\n\"sourceRef\": \"Deuteronomy 1:1\",\n\"sourceHeRef\": \"דברים א׳:א׳\",\n\"anchorVerse\": 1,\n\"sourceHasEn\": true,\n\"compDate\": [\n-1400,\n-400\n],\n\"commentaryNum\": 1.0001,\n\"collectiveTitle\": {\n\"en\": \"Deuteronomy\",\n\"he\": \"דברים\"\n},\n\"heTitle\": \"דברים\"\n},\n{\n\"_id\": \"54bd48c4fbfba21733367bf8\",\n\"index_title\": \"Exodus\",\n\"category\": \"Tanakh\",\n\"type\": \"\",\n\"ref\": \"Exodus 19:2\",\n\"anchorRef\": \"Or HaChaim on Deuteronomy 1:1:1\",\n\"anchorRefExpanded\": [\n\"Or HaChaim on Deuteronomy 1:1:1\"\n],\n\"sourceRef\": \"Exodus 19:2\",\n\"sourceHeRef\": \"שמות י״ט:ב׳\",\n\"anchorVerse\": 1,\n\"sourceHasEn\": true,\n\"compDate\": [\n-1400,\n-400\n],\n\"commentaryNum\": 19.0002,\n\"collectiveTitle\": {\n\"en\": \"Exodus\",\n\"he\": \"שמות\"\n},\n\"heTitle\": \"שמות\"\n},\n{\n\"_id\": \"54bd48c4fbfba21733367c00\",\n\"index_title\": \"Numbers\",\n\"category\": \"Tanakh\",\n\"type\": \"\",\n\"ref\": \"Numbers 20\",\n\"anchorRef\": \"Or HaChaim on Deuteronomy 1:1:1\",\n\"anchorRefExpanded\": [\n\"Or HaChaim on Deuteronomy 1:1:1\"\n],\n\"sourceRef\": \"Numbers 20\",\n\"sourceHeRef\": \"במדבר כ׳\",\n\"anchorVerse\": 1,\n\"sourceHasEn\": true,\n\"compDate\": [\n-1400,\n-400\n],\n\"commentaryNum\": 20,\n\"collectiveTitle\": {\n\"en\": \"Numbers\",\n\"he\": \"במדבר\"\n},\n\"heTitle\": \"במדבר\"\n},\n{\n\"_id\": \"54bd48c4fbfba21733367c02\",\n\"index_title\": \"Numbers\",\n\"category\": \"Tanakh\",\n\"type\": \"\",\n\"ref\": \"Numbers 12:8\",\n\"anchorRef\": \"Or HaChaim on Deuteronomy 1:1:1\",\n\"anchorRefExpanded\": [\n\"Or HaChaim on Deuteronomy 1:1:1\"\n],\n\"sourceRef\": \"Numbers 12:8\",\n\"sourceHeRef\": \"במדבר י״ב:ח׳\",\n\"anchorVerse\": 1,\n\"sourceHasEn\": true,\n\"compDate\": [\n-1400,\n-400\n],\n\"commentaryNum\": 12.0008,\n\"collectiveTitle\": {\n\"en\": \"Numbers\",\n\"he\": \"במדבר\"\n},\n\"heTitle\": \"במדבר\"\n},\n{\n\"_id\": \"54bd48c4fbfba21733367c06\",\n\"index_title\": \"Kiddushin\",\n\"category\": \"Talmud\",\n\"type\": \"\",\n\"ref\": \"Kiddushin 38a\",\n\"anchorRef\": \"Or HaChaim on Deuteronomy 1:1:1\",\n\"anchorRefExpanded\": [\n\"Or HaChaim on Deuteronomy 1:1:1\"\n],\n\"sourceRef\": \"Kiddushin 38a\",\n\"sourceHeRef\": \"קידושין ל״ח א\",\n\"anchorVerse\": 1,\n\"sourceHasEn\": true,\n\"compDate\": [\n450,\n550\n],\n\"commentaryNum\": 75,\n\"collectiveTitle\": {\n\"en\": \"Kiddushin\",\n\"he\": \"קידושין\"\n},\n\"heTitle\": \"קידושין\"\n},\n{\n\"_id\": \"54bd48c4fbfba21733367c0a\",\n\"index_title\": \"Berakhot\",\n\"category\": \"Talmud\",\n\"type\": \"\",\n\"ref\": \"Berakhot 7a\",\n\"anchorRef\": \"Or HaChaim on Deuteronomy 1:1:1\",\n\"anchorRefExpanded\": [\n\"Or HaChaim on Deuteronomy 1:1:1\"\n],\n\"sourceRef\": \"Berakhot 7a\",\n\"sourceHeRef\": \"ברכות ז׳ א\",\n\"anchorVerse\": 1,\n\"sourceHasEn\": true,\n\"compDate\": [\n450,\n550\n],\n\"commentaryNum\": 13,\n\"collectiveTitle\": {\n\"en\": \"Berakhot\",\n\"he\": \"ברכות\"\n},\n\"heTitle\": \"ברכות\"\n},\n{\n\"_id\": \"54bd48c4fbfba21733367c0c\",\n\"index_title\": \"Eruvin\",\n\"category\": \"Talmud\",\n\"type\": \"\",\n\"ref\": \"Eruvin 54a\",\n\"anchorRef\": \"Or HaChaim on Deuteronomy 1:1:1\",\n\"anchorRefExpanded\": [\n\"Or HaChaim on Deuteronomy 1:1:1\"\n],\n\"sourceRef\": \"Eruvin 54a\",\n\"sourceHeRef\": \"עירובין נ״ד א\",\n\"anchorVerse\": 1,\n\"sourceHasEn\": true,\n\"compDate\": [\n450,\n550\n],\n\"commentaryNum\": 107,\n\"collectiveTitle\": {\n\"en\": \"Eruvin\",\n\"he\": \"עירובין\"\n},\n\"heTitle\": \"עירובין\"\n},\n{\n\"_id\": \"54bd48c4fbfba21733367c10\",\n\"index_title\": \"Genesis\",\n\"category\": \"Tanakh\",\n\"type\": \"\",\n\"ref\": \"Genesis 14:13\",\n\"anchorRef\": \"Or HaChaim on Deuteronomy 1:1:1\",\n\"anchorRefExpanded\": [\n\"Or HaChaim on Deuteronomy 1:1:1\"\n],\n\"sourceRef\": \"Genesis 14:13\",\n\"sourceHeRef\": \"בראשית י״ד:י״ג\",\n\"anchorVerse\": 1,\n\"sourceHasEn\": true,\n\"compDate\": [\n-1400,\n-400\n],\n\"commentaryNum\": 14.0013,\n\"collectiveTitle\": {\n\"en\": \"Genesis\",\n\"he\": \"בראשית\"\n},\n\"heTitle\": \"בראשית\"\n},\n{\n\"_id\": \"54bd48c4fbfba21733367c12\",\n\"index_title\": \"Genesis\",\n\"category\": \"Tanakh\",\n\"type\": \"\",\n\"ref\": \"Genesis 25:27\",\n\"anchorRef\": \"Or HaChaim on Deuteronomy 1:1:1\",\n\"anchorRefExpanded\": [\n\"Or HaChaim on Deuteronomy 1:1:1\"\n],\n\"sourceRef\": \"Genesis 25:27\",\n\"sourceHeRef\": \"בראשית כ״ה:כ״ז\",\n\"anchorVerse\": 1,\n\"sourceHasEn\": true,\n\"compDate\": [\n-1400,\n-400\n],\n\"commentaryNum\": 25.0027,\n\"collectiveTitle\": {\n\"en\": \"Genesis\",\n\"he\": \"בראשית\"\n},\n\"heTitle\": \"בראשית\"\n},\n{\n\"_id\": \"5c17ba58b071e100bf4f3c69\",\n\"index_title\": \"Megillah\",\n\"category\": \"Talmud\",\n\"type\": \"\",\n\"ref\": \"Megillah 31b:8\",\n\"anchorRef\": \"Or HaChaim on Deuteronomy 1:1:1\",\n\"anchorRefExpanded\": [\n\"Or HaChaim on Deuteronomy 1:1:1\"\n],\n\"sourceRef\": \"Megillah 31b:8\",\n\"sourceHeRef\": \"מגילה ל״א ב:ח׳\",\n\"anchorVerse\": 1,\n\"sourceHasEn\": true,\n\"compDate\": [\n450,\n550\n],\n\"commentaryNum\": 62.0008,\n\"collectiveTitle\": {\n\"en\": \"Megillah\",\n\"he\": \"מגילה\"\n},\n\"heTitle\": \"מגילה\"\n}\n]" + }, + "sheets": { + "description": "All public source sheets linked to a given `Ref` or containing that `Ref` on the sheet. ", + "type": "array", + "items": { + "$ref": "#/components/schemas/SheetsJSON" + }, + "example": "{\n\"owner\": 65000,\n\"_id\": \"5ec3a6f7c73d4d278311782e\",\n\"id\": \"238181\",\n\"public\": true,\n\"title\": \"סדר תיקון ליל שבועות\",\n\"sheetUrl\": \"/sheets/238181\",\n\"anchorRef\": \"Deuteronomy 1\",\n\"anchorRefExpanded\": [\n\"Deuteronomy 1:2\"\n],\n\"options\": {\n\"numbered\": 0,\n\"boxed\": 0,\n\"assignable\": 0,\n\"bsd\": 1,\n\"language\": \"hebrew\",\n\"layout\": \"stacked\",\n\"langLayout\": \"heRight\",\n\"divineNames\": \"ykvk\",\n\"highlightMode\": 0,\n\"collaboration\": \"none\"\n},\n\"collectionTOC\": null,\n\"ownerName\": \"יותם גונן\",\n\"via\": null,\n\"viaOwnerName\": null,\n\"assignerName\": null,\n\"viaOwnerProfileUrl\": null,\n\"assignerProfileUrl\": null,\n\"ownerProfileUrl\": \"/profile/-2977\",\n\"ownerImageUrl\": \"https://storage.googleapis.com/sefaria-profile-pictures/-2977-1626800304-small.png\",\n\"status\": \"public\",\n\"views\": 8509,\n\"topics\": [],\n\"likes\": [],\n\"summary\": \"\",\n\"attribution\": null,\n\"is_featured\": false,\n\"category\": \"Sheets\",\n\"type\": \"sheet\"\n}" + }, + "notes": { + "description": "Any notes a user has on a given `Ref`. **Note:** This data is only available for logged-in users to view their own notes on a text. This field will always present as an empty array for third party developers. ", + "type": "array", + "items": {} + }, + "webpages": { + "description": "Webpages related to the `Ref`. ", + "type": "array", + "items": { + "$ref": "#/components/schemas/WebPagesJSON" + }, + "example": "{\n\"url\": \"https://etzion.org.il/en/mission-spies\",\n\"title\": \"The Mission of the Spies | vbm haretzion\",\n\"refs\": [\n\"Joshua 2:2-3\",\n\"I Samuel 26:9\",\n\"Deuteronomy 32:51\",\n\"Numbers 34:16-29\",\n\"Numbers 26:52-56\",\n\"Joshua 14\",\n\"Numbers 13\",\n\"Numbers 20:12\",\n\"Numbers 32:9\",\n\"Deuteronomy 9:1-2\",\n\"Numbers 13:20\",\n\"Genesis 13:17\",\n\"Numbers 13:21\",\n\"Numbers 13:22\",\n\"Deuteronomy 1:37\",\n\"Joshua 2:1\",\n\"Deuteronomy 1:22\",\n\"Deuteronomy 1\",\n\"Numbers 34\",\n\"Deuteronomy 1:21\",\n\"Numbers 32\",\n\"Deuteronomy 1:24\",\n\"Joshua 18:3-9\"\n],\n\"description\": \"Parshat HaShavua Yeshivat Har Etzion PARASHAT SHELACH The Mission of the Spies by Rav Yaakov Medan A The Problem\",\n\"linkerHits\": 283,\n\"domain\": \"etzion.org.il\",\n\"siteName\": \"Torat Har Etzion\",\n\"favicon\": \"https://www.google.com/s2/favicons?domain=etzion.org.il\",\n\"authors\": null,\n\"articleSource\": null,\n\"anchorRef\": \"Deuteronomy 1\",\n\"anchorRefExpanded\": [\n\"Deuteronomy 1:2\"\n]\n}" + }, + "topics": { + "description": "Topics related to a given `Ref`. ", + "type": "array", + "items": { + "$ref": "#/components/schemas/RelatedTopicJSON" + }, + "example": "{\n\"linkType\": \"about\",\n\"class\": \"refTopic\",\n\"dataSource\": {\n\"en\": \"Sheets by Sefaria users\",\n\"he\": \"דפי מקורות ממשתמשי ספריא\",\n\"slug\": \"sefaria-users\"\n},\n\"is_sheet\": false,\n\"generatedBy\": \"sheet-topic-aggregator\",\n\"order\": {\n\"user_votes\": 14,\n\"tfidf\": 10.783834565585545,\n\"numDatasource\": 1,\n\"availableLangs\": [\n\"en\",\n\"he\"\n],\n\"comp_date\": -1400,\n\"order_id\": \"A00000000400010001-00010011\",\n\"pr\": 8.083013483888324,\n\"numSources\": 143\n},\n\"topic\": \"parashat-devarim\",\n\"title\": {\n\"en\": \"Parashat Devarim\",\n\"he\": \"פרשת דברים\"\n},\n\"titleIsTransliteration\": {\n\"en\": false,\n\"he\": false\n},\n\"description\": {\n\"en\": \"Devarim (“Words”) is the first Torah portion in the Book of Deuteronomy, the final book of the Torah. In it, Moses recounts events from the Israelites’ travels in the desert, like the appointment of judges, the sin of the spies, and the wars with the Emorite kings Sihon and Og.\",\n\"he\": \"דברים היא הפרשה הראשונה בספר דברים, החומש החמישי והאחרון בתורה. בספר מובאים נאומי משה, שבהם הוא מזכיר אירועים מהעבר, סוקר מצוות שכבר ניתנו ומצווה מצוות חדשות. בפרשה משה מספר על הצורך במינוי שופטים להנהגת העם. הוא גם מזכיר את חטא המרגלים, שבו התלונן העם על הכניסה העתידית לארץ כנען, את העונש שהוטל על העם לנדוד במדבר ארבעים שנה ואת מלחמות ישראל במדבר.\"\n},\n\"anchorRef\": \"Deuteronomy 1:1-11\",\n\"anchorRefExpanded\": [\n\"Deuteronomy 1:1\",\n\"Deuteronomy 1:2\",\n\"Deuteronomy 1:3\",\n\"Deuteronomy 1:4\",\n\"Deuteronomy 1:5\",\n\"Deuteronomy 1:6\",\n\"Deuteronomy 1:7\",\n\"Deuteronomy 1:8\",\n\"Deuteronomy 1:9\",\n\"Deuteronomy 1:10\",\n\"Deuteronomy 1:11\"\n]\n}" + }, + "manuscripts": { + "description": "An array of manuscript objects containing data of related manuscripts. ", + "type": "array", + "items": { + "$ref": "#/components/schemas/ManuscriptJSON" + }, + "example": "[\n{\n\"manuscript_slug\": \"leningrad-codex-(1008-ce)\",\n\"page_id\": \"LC_Folio_98v\",\n\"image_url\": \"https://manuscripts.sefaria.org/leningrad-color/BIB_LENCDX_F098B.jpg\",\n\"thumbnail_url\": \"https://manuscripts.sefaria.org/leningrad-color/BIB_LENCDX_F098B_thumbnail.jpg\",\n\"anchorRef\": \"Deuteronomy 1:1-21\",\n\"anchorRefExpanded\": [\n\"Deuteronomy 1:2\"\n],\n\"manuscript\": {\n\"slug\": \"leningrad-codex-(1008-ce)\",\n\"title\": \"Leningrad Codex (1008 CE)\",\n\"he_title\": \"כתב יד לנינגרד (1008)\",\n\"source\": \"https://dornsife.usc.edu/wsrp/biblical-manuscripts\",\n\"description\": \"Bruce Zuckerman, West Semitic Research, in collaboration with the Ancient Biblical Manuscript Center; courtesy Russian National Library, Saltykov-Schedrin\",\n\"he_description\": \"\"\n}\n}\n]" + }, + "media": { + "description": "An array of JSON containing any media related to the `Ref`. ", + "type": "array", + "items": { + "$ref": "#/components/schemas/MediaJSON" + }, + "example": "[\n{\n\"media_url\": \"https://raw.githubusercontent.com/rneiss/PocketTorah/master/data/audio/Devarim-1.mp3\",\n\"source\": \"PocketTorah\",\n\"source_he\": \"\\\"פוקט\\\"-תורה\",\n\"start_time\": \"36.045250\",\n\"end_time\": \"49.118184\",\n\"anchorRef\": \"Deuteronomy 1:2\",\n\"license\": \"CC-BY-SA\",\n\"source_site\": \"http://www.pockettorah.com\",\n\"description\": \"Audio recordings of the weekly Torah portions used in PocketTorah. Avery-Binder style.\",\n\"description_he\": \"הקלטות שמע של פרשות השבוע באמצעות \\\"פוקט-תורה\\\" בסגנון הקריאה של א. בינדר ול.אוורי.\"\n}\n]" + } + }, + "example": { + "links": [ + { + "_id": "54bd48c4fbfba21733367bfa", + "index_title": "Psalms", + "category": "Tanakh", + "type": "", + "ref": "Psalms 51", + "anchorRef": "Or HaChaim on Deuteronomy 1:1:1", + "anchorRefExpanded": [ + "Or HaChaim on Deuteronomy 1:1:1" + ], + "sourceRef": "Psalms 51", + "sourceHeRef": "תהילים נ״א", + "anchorVerse": 1, + "sourceHasEn": true, + "compDate": [ + -1000, + 0 + ], + "commentaryNum": 51, + "collectiveTitle": { + "en": "Psalms", + "he": "תהילים" + }, + "heTitle": "תהילים" + }, + { + "_id": "54bd48c4fbfba21733367bfc", + "index_title": "Pirkei Avot", + "category": "Mishnah", + "type": "", + "ref": "Pirkei Avot 3", + "anchorRef": "Or HaChaim on Deuteronomy 1:1:1", + "anchorRefExpanded": [ + "Or HaChaim on Deuteronomy 1:1:1" + ], + "sourceRef": "Pirkei Avot 3", + "sourceHeRef": "משנה אבות ג׳", + "anchorVerse": 1, + "sourceHasEn": true, + "compDate": [ + 190, + 230 + ], + "commentaryNum": 3, + "collectiveTitle": { + "en": "Pirkei Avot", + "he": "משנה אבות" + }, + "heTitle": "משנה אבות" + }, + { + "_id": "54bd48c4fbfba21733367bfe", + "index_title": "Pirkei Avot", + "category": "Mishnah", + "type": "", + "ref": "Pirkei Avot 4", + "anchorRef": "Or HaChaim on Deuteronomy 1:1:1", + "anchorRefExpanded": [ + "Or HaChaim on Deuteronomy 1:1:1" + ], + "sourceRef": "Pirkei Avot 4", + "sourceHeRef": "משנה אבות ד׳", + "anchorVerse": 1, + "sourceHasEn": true, + "compDate": [ + 190, + 230 + ], + "commentaryNum": 4, + "collectiveTitle": { + "en": "Pirkei Avot", + "he": "משנה אבות" + }, + "heTitle": "משנה אבות" + }, + { + "_id": "54bd48c4fbfba21733367c08", + "index_title": "Proverbs", + "category": "Tanakh", + "type": "", + "ref": "Proverbs 3", + "anchorRef": "Or HaChaim on Deuteronomy 1:1:1", + "anchorRefExpanded": [ + "Or HaChaim on Deuteronomy 1:1:1" + ], + "sourceRef": "Proverbs 3", + "sourceHeRef": "משלי ג׳", + "anchorVerse": 1, + "sourceHasEn": true, + "compDate": [ + -800, + -400 + ], + "commentaryNum": 3, + "collectiveTitle": { + "en": "Proverbs", + "he": "משלי" + }, + "heTitle": "משלי" + }, + { + "_id": "54bd48c4fbfba21733367c0e", + "index_title": "Yoma", + "category": "Talmud", + "type": "", + "ref": "Yoma 19b", + "anchorRef": "Or HaChaim on Deuteronomy 1:1:1", + "anchorRefExpanded": [ + "Or HaChaim on Deuteronomy 1:1:1" + ], + "sourceRef": "Yoma 19b", + "sourceHeRef": "יומא י״ט ב", + "anchorVerse": 1, + "sourceHasEn": true, + "compDate": [ + 450, + 550 + ], + "commentaryNum": 38, + "collectiveTitle": { + "en": "Yoma", + "he": "יומא" + }, + "heTitle": "יומא" + }, + { + "_id": "53f17c73fbfba22336eaba1e", + "index_title": "Deuteronomy", + "category": "Tanakh", + "type": "commentary", + "ref": "Deuteronomy 1:1", + "anchorRef": "Or HaChaim on Deuteronomy 1:1:1", + "anchorRefExpanded": [ + "Or HaChaim on Deuteronomy 1:1:1" + ], + "sourceRef": "Deuteronomy 1:1", + "sourceHeRef": "דברים א׳:א׳", + "anchorVerse": 1, + "sourceHasEn": true, + "compDate": [ + -1400, + -400 + ], + "commentaryNum": 1.0001, + "collectiveTitle": { + "en": "Deuteronomy", + "he": "דברים" + }, + "heTitle": "דברים" + }, + { + "_id": "54bd48c4fbfba21733367bf8", + "index_title": "Exodus", + "category": "Tanakh", + "type": "", + "ref": "Exodus 19:2", + "anchorRef": "Or HaChaim on Deuteronomy 1:1:1", + "anchorRefExpanded": [ + "Or HaChaim on Deuteronomy 1:1:1" + ], + "sourceRef": "Exodus 19:2", + "sourceHeRef": "שמות י״ט:ב׳", + "anchorVerse": 1, + "sourceHasEn": true, + "compDate": [ + -1400, + -400 + ], + "commentaryNum": 19.0002, + "collectiveTitle": { + "en": "Exodus", + "he": "שמות" + }, + "heTitle": "שמות" + }, + { + "_id": "54bd48c4fbfba21733367c00", + "index_title": "Numbers", + "category": "Tanakh", + "type": "", + "ref": "Numbers 20", + "anchorRef": "Or HaChaim on Deuteronomy 1:1:1", + "anchorRefExpanded": [ + "Or HaChaim on Deuteronomy 1:1:1" + ], + "sourceRef": "Numbers 20", + "sourceHeRef": "במדבר כ׳", + "anchorVerse": 1, + "sourceHasEn": true, + "compDate": [ + -1400, + -400 + ], + "commentaryNum": 20, + "collectiveTitle": { + "en": "Numbers", + "he": "במדבר" + }, + "heTitle": "במדבר" + }, + { + "_id": "54bd48c4fbfba21733367c02", + "index_title": "Numbers", + "category": "Tanakh", + "type": "", + "ref": "Numbers 12:8", + "anchorRef": "Or HaChaim on Deuteronomy 1:1:1", + "anchorRefExpanded": [ + "Or HaChaim on Deuteronomy 1:1:1" + ], + "sourceRef": "Numbers 12:8", + "sourceHeRef": "במדבר י״ב:ח׳", + "anchorVerse": 1, + "sourceHasEn": true, + "compDate": [ + -1400, + -400 + ], + "commentaryNum": 12.0008, + "collectiveTitle": { + "en": "Numbers", + "he": "במדבר" + }, + "heTitle": "במדבר" + }, + { + "_id": "54bd48c4fbfba21733367c06", + "index_title": "Kiddushin", + "category": "Talmud", + "type": "", + "ref": "Kiddushin 38a", + "anchorRef": "Or HaChaim on Deuteronomy 1:1:1", + "anchorRefExpanded": [ + "Or HaChaim on Deuteronomy 1:1:1" + ], + "sourceRef": "Kiddushin 38a", + "sourceHeRef": "קידושין ל״ח א", + "anchorVerse": 1, + "sourceHasEn": true, + "compDate": [ + 450, + 550 + ], + "commentaryNum": 75, + "collectiveTitle": { + "en": "Kiddushin", + "he": "קידושין" + }, + "heTitle": "קידושין" + }, + { + "_id": "54bd48c4fbfba21733367c0a", + "index_title": "Berakhot", + "category": "Talmud", + "type": "", + "ref": "Berakhot 7a", + "anchorRef": "Or HaChaim on Deuteronomy 1:1:1", + "anchorRefExpanded": [ + "Or HaChaim on Deuteronomy 1:1:1" + ], + "sourceRef": "Berakhot 7a", + "sourceHeRef": "ברכות ז׳ א", + "anchorVerse": 1, + "sourceHasEn": true, + "compDate": [ + 450, + 550 + ], + "commentaryNum": 13, + "collectiveTitle": { + "en": "Berakhot", + "he": "ברכות" + }, + "heTitle": "ברכות" + }, + { + "_id": "54bd48c4fbfba21733367c0c", + "index_title": "Eruvin", + "category": "Talmud", + "type": "", + "ref": "Eruvin 54a", + "anchorRef": "Or HaChaim on Deuteronomy 1:1:1", + "anchorRefExpanded": [ + "Or HaChaim on Deuteronomy 1:1:1" + ], + "sourceRef": "Eruvin 54a", + "sourceHeRef": "עירובין נ״ד א", + "anchorVerse": 1, + "sourceHasEn": true, + "compDate": [ + 450, + 550 + ], + "commentaryNum": 107, + "collectiveTitle": { + "en": "Eruvin", + "he": "עירובין" + }, + "heTitle": "עירובין" + }, + { + "_id": "54bd48c4fbfba21733367c10", + "index_title": "Genesis", + "category": "Tanakh", + "type": "", + "ref": "Genesis 14:13", + "anchorRef": "Or HaChaim on Deuteronomy 1:1:1", + "anchorRefExpanded": [ + "Or HaChaim on Deuteronomy 1:1:1" + ], + "sourceRef": "Genesis 14:13", + "sourceHeRef": "בראשית י״ד:י״ג", + "anchorVerse": 1, + "sourceHasEn": true, + "compDate": [ + -1400, + -400 + ], + "commentaryNum": 14.0013, + "collectiveTitle": { + "en": "Genesis", + "he": "בראשית" + }, + "heTitle": "בראשית" + }, + { + "_id": "54bd48c4fbfba21733367c12", + "index_title": "Genesis", + "category": "Tanakh", + "type": "", + "ref": "Genesis 25:27", + "anchorRef": "Or HaChaim on Deuteronomy 1:1:1", + "anchorRefExpanded": [ + "Or HaChaim on Deuteronomy 1:1:1" + ], + "sourceRef": "Genesis 25:27", + "sourceHeRef": "בראשית כ״ה:כ״ז", + "anchorVerse": 1, + "sourceHasEn": true, + "compDate": [ + -1400, + -400 + ], + "commentaryNum": 25.0027, + "collectiveTitle": { + "en": "Genesis", + "he": "בראשית" + }, + "heTitle": "בראשית" + }, + { + "_id": "5c17ba58b071e100bf4f3c69", + "index_title": "Megillah", + "category": "Talmud", + "type": "", + "ref": "Megillah 31b:8", + "anchorRef": "Or HaChaim on Deuteronomy 1:1:1", + "anchorRefExpanded": [ + "Or HaChaim on Deuteronomy 1:1:1" + ], + "sourceRef": "Megillah 31b:8", + "sourceHeRef": "מגילה ל״א ב:ח׳", + "anchorVerse": 1, + "sourceHasEn": true, + "compDate": [ + 450, + 550 + ], + "commentaryNum": 62.0008, + "collectiveTitle": { + "en": "Megillah", + "he": "מגילה" + }, + "heTitle": "מגילה" + } + ], + "sheets": [ + { + "owner": 10614, + "_id": "60ee8884d6d0a523b1342111", + "id": "335567", + "public": true, + "title": "Gentle Rebuke", + "sheetUrl": "/sheets/335567", + "anchorRef": "Or HaChaim on Deuteronomy 1:1:1", + "anchorRefExpanded": [ + "Or HaChaim on Deuteronomy 1:1:1" + ], + "options": { + "numbered": 0, + "boxed": 0, + "assignable": 0, + "bsd": 0, + "language": "bilingual", + "layout": "sideBySide", + "langLayout": "heRight", + "divineNames": "noSub", + "highlightMode": 0, + "collaboration": "none" + }, + "ownerName": "Rabbi Yossi Orkin", + "ownerProfileUrl": "/profile/yossi-orkin", + "ownerImageUrl": "https://storage.googleapis.com/sefaria-profile-pictures/yossi-orkin-1626415935-small.png", + "status": "public", + "views": 398, + "topics": [ + { + "slug": "deuteronomy", + "asTyped": "Parshat Devarim", + "en": "Parshat Devarim", + "he": "ספר דברים" + } + ], + "likes": [], + "summary": "Parshat Devarim Questions", + "is_featured": false, + "category": "Sheets", + "type": "sheet" + }, + { + "owner": 92910, + "_id": "60ec76e6340e9458714cc018", + "id": "335153", + "public": true, + "title": "R'Isaac Bernstein -1st of series on \"themes in Devorim\".", + "sheetUrl": "/sheets/335153", + "anchorRef": "Or HaChaim on Deuteronomy 1:1:1", + "anchorRefExpanded": [ + "Or HaChaim on Deuteronomy 1:1:1" + ], + "options": { + "numbered": 0, + "boxed": 0, + "assignable": 0, + "bsd": 0, + "language": "hebrew", + "layout": "stacked", + "langLayout": "heRight", + "divineNames": "h", + "highlightMode": 0, + "collaboration": "none" + }, + "ownerName": "I am Anonymous", + "ownerProfileUrl": "/profile/i-am-anonymous", + "ownerImageUrl": "", + "status": "public", + "views": 278, + "topics": [ + { + "slug": "parshanut1", + "asTyped": "Parshanut", + "en": "Parshanut", + "he": "פרשנות" + }, + { + "slug": "torah-portions", + "asTyped": "Parsha", + "en": "Parsha", + "he": "פרשות השבוע" + } + ], + "likes": [], + "summary": "Parsha shiurim by R'Isaac Bernsein", + "is_featured": false, + "category": "Sheets", + "type": "sheet" + }, + { + "owner": 62800, + "_id": "62ed99e8a85e3ca24ef0064f", + "id": "423213", + "public": true, + "title": "OHR HACHAIM ON DEVARIM", + "sheetUrl": "/sheets/423213", + "anchorRef": "Or HaChaim on Deuteronomy 1:1", + "anchorRefExpanded": [ + "Or HaChaim on Deuteronomy 1:1:1" + ], + "options": { + "numbered": 0, + "boxed": 0, + "assignable": 0, + "bsd": 0, + "language": "hebrew", + "layout": "stacked", + "langLayout": "heRight", + "divineNames": "noSub", + "highlightMode": 0, + "collaboration": "none" + }, + "ownerName": "Yitzi Adlin", + "ownerProfileUrl": "/profile/yitzi-adlin", + "ownerImageUrl": "", + "status": "public", + "views": 186, + "topics": [], + "likes": [], + "summary": "", + "is_featured": false, + "category": "Sheets", + "type": "sheet" + } + ], + "notes": [], + "webpages": [], + "topics": [], + "manuscripts": [], + "media": [] + } + }, + "MediaJSON": { + "title": "Root Type for MediaJSON", + "description": "JSON containing metadata for media linked to `Ref`s on [Sefaria](sefaria.org)", + "type": "object", + "properties": { + "media_url": { + "description": "The URL for the media. ", + "type": "string", + "example": "https://raw.githubusercontent.com/rneiss/PocketTorah/master/data/audio/Devarim-2.mp3" + }, + "source": { + "description": "Source of the media. ", + "type": "string", + "example": "PocketTorah" + }, + "source_he": { + "description": "Hebrew title of the media source. ", + "type": "string", + "example": "פוקט\\\"-תורה" + }, + "start_time": { + "description": "Start time of the media associated with this `Ref`.", + "type": "string", + "example": "0" + }, + "end_time": { + "description": "End time of the portion of the associated media which correlates to this `Ref`. ", + "type": "string", + "example": "27.26476" + }, + "anchorRef": { + "$ref": "#/components/schemas/ref", + "description": "The `Ref` in the query.", + "example": "Deuteronomy 1:2" + }, + "license": { + "description": "The license on the media. ", + "type": "string", + "example": "CC-BY-SA" + }, + "source_site": { + "description": "Website of the source.", + "type": "string", + "example": "http://www.pockettorah.com" + }, + "description": { + "description": "A description of the associated media in English. ", + "type": "string", + "example": "Audio recordings of the weekly Torah portions used in PocketTorah. Avery-Binder style." + }, + "description_he": { + "description": "A description of the associated media in Hebrew. ", + "type": "string", + "example": "הקלטות שמע של פרשות השבוע באמצעות \\\"פוקט-תורה\\\" בסגנון הקריאה של א. בינדר ול.אוורי." + } + }, + "example": { + "media_url": "https://raw.githubusercontent.com/rneiss/PocketTorah/master/data/audio/Devarim-1.mp3", + "source": "PocketTorah", + "source_he": "\"פוקט\"-תורה", + "start_time": "36.045250", + "end_time": "49.118184", + "anchorRef": "Deuteronomy 1:2", + "license": "CC-BY-SA", + "source_site": "http://www.pockettorah.com", + "description": "Audio recordings of the weekly Torah portions used in PocketTorah. Avery-Binder style.", + "description_he": "הקלטות שמע של פרשות השבוע באמצעות \"פוקט-תורה\" בסגנון הקריאה של א. בינדר ול.אוורי." + } + }, + "WebPagesJSON": { + "title": "Root Type for WebPagesJSON", + "description": "A JSON object containing the metadata for external webpages linked to this Sefaria `Ref`.", + "type": "object", + "properties": { + "url": { + "description": "URL to the related article on the webpage. ", + "type": "string", + "example": "https://etzion.org.il/en/mission-spies" + }, + "title": { + "description": "Title of the webpage", + "type": "string", + "example": "The Mission of the Spies | vbm haretzion" + }, + "refs": { + "description": "All textual references found on this webpage which link to various Sefaria `Ref`s.", + "type": "array", + "items": { + "$ref": "#/components/schemas/ref" + }, + "example": "[\n\"Joshua 2:2-3\",\n\"I Samuel 26:9\",\n\"Deuteronomy 32:51\",\n\"Numbers 34:16-29\",\n\"Numbers 26:52-56\",\n\"Joshua 14\",\n\"Numbers 13\",\n\"Numbers 20:12\",\n\"Numbers 32:9\",\n\"Deuteronomy 9:1-2\",\n\"Numbers 13:20\",\n\"Genesis 13:17\",\n\"Numbers 13:21\",\n\"Numbers 13:22\",\n\"Deuteronomy 1:37\",\n\"Joshua 2:1\",\n\"Deuteronomy 1:22\",\n\"Deuteronomy 1\",\n\"Numbers 34\",\n\"Deuteronomy 1:21\",\n\"Numbers 32\",\n\"Deuteronomy 1:24\",\n\"Joshua 18:3-9\"\n]" + }, + "description": { + "description": "Description of the article. ", + "type": "string", + "example": "Parshat HaShavua Yeshivat Har Etzion PARASHAT SHELACH The Mission of the Spies by Rav Yaakov Medan A The Problem" + }, + "linkerHits": { + "format": "int32", + "description": "Number of hits by the Sefaria linker. ", + "type": "integer" + }, + "domain": { + "description": "Domain of the webpage", + "type": "string", + "example": "etzion.org.il" + }, + "siteName": { + "description": "Name of the webpage", + "type": "string", + "example": "Torat Har Etzion" + }, + "favicon": { + "description": "Favicon of the external webspage", + "type": "string", + "example": "https://www.google.com/s2/favicons?domain=etzion.org.il" + }, + "authors": { + "type": "string" + }, + "articleSource": { + "type": "string" + }, + "anchorRef": { + "$ref": "#/components/schemas/ref", + "description": "The `Ref` connecting this webpage to the queried `Ref`. ", + "example": "Deuteronomy 1.1" + }, + "anchorRefExpanded": { + "description": "If the `anchorRef` is a ranged `Ref`, this is an array of `Refs` containing each of the segments contained within that range. So for example, if `anchorRef` is Genesis 1:1-2, then `anchorRefExpanded` will be `[\"Genesis 1:1\", \"Genesis 1:2\"]`.", + "type": "array", + "items": { + "$ref": "#/components/schemas/ref" + }, + "example": "[\"Genesis 1.1\", \"Genesis 1.2\"]" + } + }, + "example": { + "url": "https://etzion.org.il/en/mission-spies", + "title": "The Mission of the Spies | vbm haretzion", + "refs": [ + "Joshua 2:2-3", + "I Samuel 26:9", + "Deuteronomy 32:51", + "Numbers 34:16-29", + "Numbers 26:52-56", + "Joshua 14", + "Numbers 13", + "Numbers 20:12", + "Numbers 32:9", + "Deuteronomy 9:1-2", + "Numbers 13:20", + "Genesis 13:17", + "Numbers 13:21", + "Numbers 13:22", + "Deuteronomy 1:37", + "Joshua 2:1", + "Deuteronomy 1:22", + "Deuteronomy 1", + "Numbers 34", + "Deuteronomy 1:21", + "Numbers 32", + "Deuteronomy 1:24", + "Joshua 18:3-9" + ], + "description": "Parshat HaShavua Yeshivat Har Etzion PARASHAT SHELACH The Mission of the Spies by Rav Yaakov Medan A The Problem", + "linkerHits": 283, + "domain": "etzion.org.il", + "siteName": "Torat Har Etzion", + "favicon": "https://www.google.com/s2/favicons?domain=etzion.org.il", + "anchorRef": "Deuteronomy 1", + "anchorRefExpanded": [ + "Deuteronomy 1:2" + ] + } + }, + "SheetsJSON": { + "title": "Root Type for SheetsJSON", + "description": "JSON containing metadata relating for a given source sheet on [Sefaria](sefaria.org).", + "type": "object", + "properties": { + "owner": { + "format": "int32", + "description": "the Sefaria User ID of the sheet's owner.", + "type": "integer" + }, + "_id": { + "description": "The unique `id` for the source sheet.", + "type": "string" + }, + "id": { + "description": "The `id` of the sheet. This is used in the URL to retrieve sheets, for example, a sheet with an `id` of 1, would be accessible on [Sefaria](sefaria.org) at [sefaria.org/sheets/1](sefaria.org/sheets/1).", + "type": "string" + }, + "public": { + "description": "Is this sheet public.", + "type": "boolean", + "example": "True" + }, + "title": { + "description": "Title of the Source Sheet.", + "type": "string", + "example": "Five Chapters, Five Theologies?" + }, + "sheetUrl": { + "description": "URL to this source sheet.", + "type": "string", + "example": "/sheets/1" + }, + "anchorRef": { + "$ref": "#/components/schemas/ref", + "description": "The Sefaria reference that connects this sheet to the submitted `ref`", + "example": "Deuteronomy 1" + }, + "anchorRefExpanded": { + "description": "An array containing the individual segments `Ref`s which comprise the `anchorRef`. \n\nExample 1: Ranged `Ref`\nIf the `anchorRef` is `Genesis 2:14-16`, the `anchorRefExpanded` is `[\"Genesis 2:14\", \"Genesis 2:15\", \"Genesis 2:16\"]`. \n\nExample 2: Segment Ref\nIf the `anchorRef` itself is a segment `Ref`, the `anchorRefExpanded` will contain that identical value. For example, `anchorRef` of `Genesis 2:11` will have an `anchorRefExpanded` of `[\"Genesis 2:11\"]`", + "type": "array", + "items": { + "$ref": "#/components/schemas/ref" + } + }, + "options": { + "description": "A JSON object containing document level options related to how this source sheet should be displayed in Sefaria's Source Sheet editor.", + "type": "object", + "properties": { + "numbered": { + "description": "Should the sources be automatically numbered in the Sefaria editor view", + "type": "boolean" + }, + "boxed": { + "description": "Should the sources be boxed o the page in the Sefaria editor view", + "type": "boolean" + }, + "assignable": { + "description": "Is this source sheet an assignment for students in the Sefaria editor view", + "type": "boolean" + }, + "bsd": { + "description": "Should the source sheet include בס\"ד at the top of the page in the Sefaria editor view", + "type": "boolean" + }, + "language": { + "description": "Default display language of the source sheet in the Sefaria editor view", + "enum": [ + "blingual", + "hebrew", + "english" + ], + "type": "string" + }, + "layout": { + "description": "Default display layout of the source sheet in the Sefaria editor view", + "type": "string" + }, + "langLayout": { + "description": "Default display side of the language in a bilingual side-by-side view in the Sefaria editor view", + "type": "string" + }, + "divineNames": { + "description": "Should the Tetragrammaton (Shem Hashem) and other variants of the divine name be replaced, and if so in what form?", + "type": "string" + }, + "highlightMode": { + "deprecated": true, + "format": "int32", + "type": "integer" + }, + "collaboration": { + "type": "string" + } + }, + "example": "{\n\"layout\": \"sideBySide\",\n\"bsd\": 0,\n\"collaboration\": \"none\",\n\"language\": \"bilingual\",\n\"boxed\": 0,\n\"langLayout\": \"enLeft\",\n\"numbered\": 0,\n\"divineNames\": \"noSub\"\n}" + }, + "collectionTOC": { + "type": "string" + }, + "ownerName": { + "description": "Name of the owner of the sheet.", + "type": "string" + }, + "via": { + "description": "Some source sheets are made by copying another users. If this is one of them, the original owner's user ID will be listed here.", + "type": "string" + }, + "viaOwnerName": { + "description": "Some source sheets are made by copying another users. If this is one of them, the original owner's display name will be listed here.", + "type": "string" + }, + "assignerName": { + "description": "Some source sheets are created as assignments by a teacher to be completed by students. If this is one of those sheets the name of the assigner will be found here.", + "type": "string" + }, + "viaOwnerProfileUrl": { + "description": "Some source sheets are made by copying another users. If this is one of them, the path to the original owner's profile page will be listed here.", + "type": "string" + }, + "assignerProfileUrl": { + "description": "Some source sheets are created as assignments by a teacher to be completed by students. If this is one of those sheets this will be the URL path to their profile.", + "type": "string" + }, + "ownerProfileUrl": { + "description": "The URL Path that will link to a user's profile on the Sefaria site.", + "type": "string" + }, + "ownerImageUrl": { + "description": "Sheet owner image.", + "type": "string" + }, + "status": { + "description": "a string indicating whether the sheet is `public` or `unlisted`", + "enum": [ + "public", + "unlisted" + ], + "type": "string", + "example": "\"public\"" + }, + "views": { + "format": "int32", + "description": "Number of source sheet views.", + "type": "integer", + "example": "8509" + }, + "topics": { + "description": "Topics linked to the source sheet.", + "type": "array", + "items": { + "$ref": "#/components/schemas/SheetTopicJSON" + }, + "example": "[\n{\n\"slug\": \"גשר-מפעלים-חינוכיים\",\n\"asTyped\": \"גשר - מפעלים חינוכיים\",\n\"he\": \"גשר - מפעלים חינוכיים\",\n\"en\": \"\"\n},\n{\n\"slug\": \"parashat-devarim\",\n\"asTyped\": \"דברים\",\n\"he\": \"דברים\",\n\"en\": \"Parashat Devarim\"\n},\n{\n\"slug\": \"torah\",\n\"asTyped\": \"תורה\",\n\"he\": \"תורה\",\n\"en\": \"Torah\"\n},\n{\n\"slug\": \"tanakh\",\n\"asTyped\": \"תנ\\\"ך\",\n\"he\": \"תנ\\\"ך\",\n\"en\": \"Tanakh\"\n},\n{\n\"slug\": \"הלכות\",\n\"asTyped\": \"הלכות\",\n\"he\": \"הלכות\",\n\"en\": \"\"\n},\n{\n\"slug\": \"חמישה-חומשי-תורה\",\n\"asTyped\": \"חמישה חומשי תורה\",\n\"he\": \"חמישה חומשי תורה\",\n\"en\": \"\"\n},\n{\n\"slug\": \"moses\",\n\"asTyped\": \"משה רבנו\",\n\"he\": \"משה רבנו\",\n\"en\": \"Moses\"\n},\n{\n\"slug\": \"mishneh-torah\",\n\"asTyped\": \"משנה תורה\",\n\"he\": \"משנה תורה\",\n\"en\": \"Mishneh Torah\"\n},\n{\n\"asTyped\": \"קהילה\",\n\"slug\": \"kehillah\",\n\"he\": \"קהילה\",\n\"en\": \"Kehillah\"\n},\n{\n\"asTyped\": \"יחיד וחברה\",\n\"slug\": \"יחיד-וחברה\",\n\"he\": \"יחיד וחברה\",\n\"en\": \"\"\n},\n{\n\"asTyped\": \"מדינה\",\n\"slug\": \"state\",\n\"he\": \"מדינה\",\n\"en\": \"State\"\n},\n{\n\"asTyped\": \"יחיד וחברה\",\n\"slug\": \"יחיד-וחברה\",\n\"he\": \"יחיד וחברה\",\n\"en\": \"\"\n},\n{\n\"asTyped\": \"העם היהודי\",\n\"slug\": \"jewish-people\",\n\"he\": \"העם היהודי\",\n\"en\": \"Jewish People\"\n},\n{\n\"asTyped\": \"יחיד וחברה\",\n\"slug\": \"יחיד-וחברה\",\n\"he\": \"יחיד וחברה\",\n\"en\": \"\"\n},\n{\n\"asTyped\": \"מנהיגות\",\n\"slug\": \"leadership\",\n\"he\": \"מנהיגות\",\n\"en\": \"Leadership\"\n},\n{\n\"asTyped\": \"יחיד וחברה\",\n\"slug\": \"יחיד-וחברה\",\n\"he\": \"יחיד וחברה\",\n\"en\": \"\"\n},\n{\n\"asTyped\": \"אמונות ודעות\",\n\"slug\": \"אמונות-ודעות\",\n\"he\": \"אמונות ודעות\",\n\"en\": \"\"\n},\n{\n\"asTyped\": \"ארץ ישראל\",\n\"slug\": \"jewish-people\",\n\"he\": \"ארץ ישראל\",\n\"en\": \"Jewish People\"\n},\n{\n\"asTyped\": \"אדם ומרחב\",\n\"slug\": \"אדם-ומרחב\",\n\"he\": \"אדם ומרחב\",\n\"en\": \"\"\n},\n{\n\"asTyped\": \"אישים\",\n\"slug\": \"important-people\",\n\"he\": \"אישים\",\n\"en\": \"Important People\"\n},\n{\n\"asTyped\": \"תרבות\",\n\"slug\": \"culture\",\n\"he\": \"תרבות\",\n\"en\": \"Culture\"\n},\n{\n\"asTyped\": \"סיפורים מכוננים\",\n\"slug\": \"סיפורים-מכוננים\",\n\"he\": \"סיפורים מכוננים\",\n\"en\": \"\"\n},\n{\n\"asTyped\": \"תרבות\",\n\"slug\": \"culture\",\n\"he\": \"תרבות\",\n\"en\": \"Culture\"\n},\n{\n\"asTyped\": \"אחריות וסולידריות\",\n\"slug\": \"אחריות-וסולידריות\",\n\"he\": \"אחריות וסולידריות\",\n\"en\": \"\"\n},\n{\n\"asTyped\": \"יחיד וחברה\",\n\"slug\": \"יחיד-וחברה\",\n\"he\": \"יחיד וחברה\",\n\"en\": \"\"\n},\n{\n\"asTyped\": \"ספר דברים\",\n\"slug\": \"deuteronomy\",\n\"he\": \"ספר דברים\",\n\"en\": \"Deuteronomy\"\n},\n{\n\"asTyped\": \"פרשת השבוע\",\n\"slug\": \"torah-portions\",\n\"he\": \"פרשת השבוע\",\n\"en\": \"Torah Portions\"\n},\n{\n\"asTyped\": \"מקום\",\n\"slug\": \"places\",\n\"he\": \"מקום\",\n\"en\": \"Places\"\n},\n{\n\"asTyped\": \"אדם ומרחב\",\n\"slug\": \"אדם-ומרחב\",\n\"he\": \"אדם ומרחב\",\n\"en\": \"\"\n}\n]" + }, + "likes": { + "description": "An array of user IDs who have favorited or liked this source sheet.", + "type": "array", + "items": {} + }, + "summary": { + "description": "A user generated description of the source sheet", + "type": "string" + }, + "attribution": { + "description": "Some source sheets are made by copying another users. If so, an attribution field will be created and displayed here.", + "type": "string" + }, + "is_featured": { + "deprecated": true, + "description": "Previously a source sheet flagged with `is_featured` would be promoted throughout the site in various places. This behavior was removed in 2022 but some of the data remains. ", + "type": "boolean" + }, + "category": { + "description": "This will always return `Sheets`", + "type": "string" + }, + "type": { + "type": "string" + } + }, + "example": { + "owner": 65000, + "_id": "5ec3a6f7c73d4d278311782e", + "id": "238181", + "public": true, + "title": "סדר תיקון ליל שבועות", + "sheetUrl": "/sheets/238181", + "anchorRef": "Deuteronomy 1", + "anchorRefExpanded": [ + "Deuteronomy 1:2" + ], + "options": { + "numbered": 0, + "boxed": 0, + "assignable": 0, + "bsd": 1, + "language": "hebrew", + "layout": "stacked", + "langLayout": "heRight", + "divineNames": "ykvk", + "highlightMode": 0, + "collaboration": "none" + }, + "ownerName": "יותם גונן", + "ownerProfileUrl": "/profile/-2977", + "ownerImageUrl": "https://storage.googleapis.com/sefaria-profile-pictures/-2977-1626800304-small.png", + "status": "public", + "views": 8509, + "topics": [], + "likes": [], + "summary": "", + "is_featured": false, + "category": "Sheets", + "type": "sheet" + } + }, + "SheetTopicJSON": { + "title": "Root Type for SheetTopicJSON", + "description": "", + "type": "object", + "properties": { + "slug": { + "description": "Slug of the topic", + "type": "string", + "example": "parashat-devarim" + }, + "asTyped": { + "description": "How the user typed the topic", + "type": "string", + "example": "tanach" + }, + "he": { + "description": "Hebrew topic title", + "type": "string", + "example": "דברים" + }, + "en": { + "description": "English topic title", + "type": "string", + "example": "Parashat Devarim" + } + }, + "example": { + "slug": "parashat-devarim", + "asTyped": "דברים", + "he": "דברים", + "en": "Parashat Devarim" + } + }, + "RelatedLinkJSON": { + "title": "Root Type for RelatedLinkJSON", + "description": "The link JSON returned as part of results for the related API endpoint. ", + "type": "object", + "properties": { + "_id": { + "type": "string" + }, + "index_title": { + "description": "English title of the linked work. ", + "type": "string", + "example": "Rashi on Deuteronomy" + }, + "category": { + "description": "Category of the type of link, for example a link between `Rashi on Exodus` and `Exodus` would have a category of `Commentary`. ", + "type": "string", + "example": "Commentary" + }, + "type": { + "type": "string" + }, + "ref": { + "$ref": "#/components/schemas/ref", + "description": "Specific `Ref` of the segment which is linked to the queried `anchorRef`. ", + "example": "Rashi on Deuteronomy 1:11:1" + }, + "anchorRef": { + "$ref": "#/components/schemas/ref", + "description": "The submitted ref in the GET request at times may fall within a more encompassing ranged `Re`f that includes multiple text segments. The `anchorRef` is that complete range the that the link is associated with, and will contain within it the specific ref that was passed.", + "example": "Deuteronomy 1:11" + }, + "anchorRefExpanded": { + "description": "An array of strings, where each string is a segment level `Ref` of the `Ref` passed in as a parameter. If a segment level `Ref` is passed in, this array will have a length of 1, and only contain that segment level `Ref`. If the `Ref` passed in is ranged, this array will contain each of the segment level `Ref`s within that range.\n\nFor example, if someone was searching for links for Esther 4.14-15, the `anchorRefExpanded` would contain Esther 4.14 and Esther 4.15.", + "type": "array", + "items": { + "$ref": "#/components/schemas/ref" + }, + "example": "\"anchorRefExpanded\": [\n\"Deuteronomy 1:11\"\n]" + }, + "sourceRef": { + "type": "string" + }, + "sourceHeRef": { + "description": "Hebrew `Ref` of the linked source. ", + "type": "string", + "example": " רש\\\"י על דברים א׳:י״א:א׳\n" + }, + "anchorVerse": { + "format": "int32", + "type": "integer" + }, + "sourceHasEn": { + "description": "Does the source have an English translation?", + "type": "boolean", + "example": "True" + }, + "compDate": { + "description": "Date of the two books in the link were composed. Negative values indicate dates BCE. ", + "type": "array", + "items": { + "format": "int32", + "type": "integer" + }, + "example": "[\n1075,\n1105\n]" + }, + "commentaryNum": { + "format": "double", + "type": "number" + }, + "collectiveTitle": { + "type": "object", + "properties": { + "en": { + "type": "string" + }, + "he": { + "type": "string" + } + } + }, + "heTitle": { + "description": "Hebrew title of the linked work", + "type": "string", + "example": "רש\\\"י על דברים" + } + }, + "example": { + "_id": "52245641edbab41a9d003f13", + "index_title": "Rashi on Deuteronomy", + "category": "Commentary", + "type": "commentary", + "ref": "Rashi on Deuteronomy 1:11:1", + "anchorRef": "Deuteronomy 1:11", + "anchorRefExpanded": [ + "Deuteronomy 1:11" + ], + "sourceRef": "Rashi on Deuteronomy 1:11:1", + "sourceHeRef": "רש\"י על דברים א׳:י״א:א׳", + "anchorVerse": 11, + "sourceHasEn": true, + "compDate": [ + 1075, + 1105 + ], + "commentaryNum": 11.0001, + "collectiveTitle": { + "en": "Rashi", + "he": "רש\"י" + }, + "heTitle": "רש\"י על דברים" + } + }, + "RelatedTopicJSON": { + "title": "Root Type for RelatedTopicJSON", + "description": "Topic JSON returned in the `topic` field of the related API endpoint. ", + "type": "object", + "properties": { + "linkType": { + "description": "The type of link between the topic and the `Ref`. For more on Sefaria's topic ontology, see [here](https://developers.sefaria.org/docs/topic-ontology). ", + "type": "string", + "example": "about" + }, + "class": { + "description": "A classification of the link as either `refTopic` (i.e. a ref to a topic) or `intraTopic` (topic-to-topic). In this case, it would be expected that all returned topic links would be of type `refTopic`.", + "enum": [ + "refTopic", + "intraTopic" + ], + "type": "string" + }, + "dataSource": { + "$ref": "#/components/schemas/DataSourceJSON", + "description": "JSON containing the information as to the source of the data for a given ref-to-topic link.", + "example": " {\n\"en\": \"Sheets by Sefaria users\",\n\"he\": \"דפי מקורות ממשתמשי ספריא\",\n\"slug\": \"sefaria-users\"\n}" + }, + "is_sheet": { + "description": "Is this ref-to-topic link one that was generated by a user-created source sheet?", + "type": "boolean", + "example": "True" + }, + "generatedBy": { + "description": "How the topic was generated (i.e. by a user, aspaklaria, Sefaria staff)", + "type": "string", + "example": "sheet-topic-aggregator" + }, + "order": { + "$ref": "#/components/schemas/OrderTopicLinkJSON", + "description": "This JSON includes the various metrics that are relevant for ordering the link on a topics page. We use these metrics at [Sefaria.org](sefaria.org) to change the order on the topics page.", + "properties": { + "user_votes": { + "format": "int32", + "type": "integer" + }, + "tfidf": { + "format": "double", + "type": "number" + }, + "numDatasource": { + "format": "int32", + "type": "integer" + }, + "availableLangs": { + "type": "array", + "items": { + "type": "string" + } + }, + "comp_date": { + "format": "int32", + "type": "integer" + }, + "order_id": { + "type": "string" + }, + "pr": { + "format": "double", + "type": "number" + }, + "numSources": { + "format": "int32", + "type": "integer" + } + }, + "example": "{\n\"user_votes\": 14,\n\"tfidf\": 10.783834565585545,\n\"numDatasource\": 1,\n\"availableLangs\": [\n\"en\",\n\"he\"\n],\n\"comp_date\": -1400,\n\"order_id\": \"A00000000400010001-00010011\",\n\"pr\": 8.083013483888324,\n\"numSources\": 143\n}" + }, + "topic": { + "description": "Topic slug", + "type": "string", + "example": "parashat-devarim" + }, + "title": { + "description": "The title of the topic in Hebrew (`he`) and English (`en`).", + "type": "object", + "example": "{\n\"en\": \"Parashat Devarim\",\n\"he\": \"פרשת דברים\"\n}" + }, + "titleIsTransliteration": { + "description": "A boolean value for the `he` and `en` fields inside the title JSON, indicating whether or not either translation is a transliteration. ", + "type": "object", + "example": "{\n\"en\": false,\n\"he\": false\n}" + }, + "description": { + "description": "JSON containing descriptions for a given topic in various languages. Each language contains a title for the topic description, as well as a prompt which previews the source and asks questions to help the user engage with the text.", + "type": "object", + "example": "{\n\"en\": \"Devarim (“Words”) is the first Torah portion in the Book of Deuteronomy, the final book of the Torah. In it, Moses recounts events from the Israelites’ travels in the desert, like the appointment of judges, the sin of the spies, and the wars with the Emorite kings Sihon and Og.\",\n\"he\": \"דברים היא הפרשה הראשונה בספר דברים, החומש החמישי והאחרון בתורה. בספר מובאים נאומי משה, שבהם הוא מזכיר אירועים מהעבר, סוקר מצוות שכבר ניתנו ומצווה מצוות חדשות. בפרשה משה מספר על הצורך במינוי שופטים להנהגת העם. הוא גם מזכיר את חטא המרגלים, שבו התלונן העם על הכניסה העתידית לארץ כנען, את העונש שהוטל על העם לנדוד במדבר ארבעים שנה ואת מלחמות ישראל במדבר.\"\n}" + }, + "anchorRef": { + "$ref": "#/components/schemas/ref", + "description": "The `Ref` in the query." + }, + "anchorRefExpanded": { + "description": "The segment `Ref`s within the `anchorRef`. ", + "type": "array", + "items": { + "$ref": "#/components/schemas/ref" + } + } + }, + "example": { + "linkType": "about", + "class": "refTopic", + "dataSource": {}, + "is_sheet": false, + "generatedBy": "sheet-topic-aggregator", + "order": { + "user_votes": 14, + "tfidf": 10.783834565585545, + "numDatasource": 1, + "availableLangs": [ + "en", + "he" + ], + "comp_date": -1400, + "order_id": "A00000000400010001-00010011", + "pr": 8.083013483888324, + "numSources": 143 + }, + "topic": "parashat-devarim", + "title": {}, + "titleIsTransliteration": {}, + "description": {}, + "anchorRef": "Deuteronomy 1:1-11", + "anchorRefExpanded": [] + } + }, + "RawIndexJSON": { + "title": "Root Type for RawIndexJSON", + "description": "The full mongo record JSON from the database for a given Sefaria `Index`. ", + "type": "object", + "properties": { + "title": { + "description": "Title of the work.", + "type": "string", + "example": "Pesachim" + }, + "categories": { + "description": "The categories within which this text falls. *Note:* The order of the strings in the array is significant. The categories should go from most general at position `0`, to most specific. ", + "type": "array", + "items": { + "type": "string" + }, + "example": "[\n\"Talmud\",\n\"Bavli\",\n\"Seder Moed\"\n]" + }, + "schema": { + "$ref": "#/components/schemas/RawIndexSchemaJSON", + "description": "The structure of the Index within the Sefaria specific schema for texts. ", + "properties": { + "nodeType": { + "type": "string" + }, + "depth": { + "format": "int32", + "type": "integer" + }, + "addressTypes": { + "type": "array", + "items": { + "type": "string" + } + }, + "sectionNames": { + "type": "array", + "items": { + "type": "string" + } + }, + "match_templates": { + "type": "array", + "items": { + "type": "object", + "properties": { + "term_slugs": { + "type": "array", + "items": { + "type": "string" + } } - }, - "example": { - "_id": "52245641edbab41a9d003f13", - "index_title": "Rashi on Deuteronomy", - "category": "Commentary", - "type": "commentary", - "ref": "Rashi on Deuteronomy 1:11:1", - "anchorRef": "Deuteronomy 1:11", - "anchorRefExpanded": [ - "Deuteronomy 1:11" - ], - "sourceRef": "Rashi on Deuteronomy 1:11:1", - "sourceHeRef": "רש\"י על דברים א׳:י״א:א׳", - "anchorVerse": 11, - "sourceHasEn": true, - "compDate": [ - 1075, - 1105 - ], - "commentaryNum": 11.0001, - "collectiveTitle": { - "en": "Rashi", - "he": "רש\"י" + } + } + }, + "lengths": { + "type": "array", + "items": { + "format": "int32", + "type": "integer" + } + }, + "referenceableSections": { + "type": "array", + "items": { + "type": "boolean" + } + }, + "titles": { + "type": "array", + "items": { + "type": "object", + "properties": { + "text": { + "type": "string" }, - "heTitle": "רש\"י על דברים" + "lang": { + "type": "string" + } + } } - }, - "RelatedTopicJSON": { - "title": "Root Type for RelatedTopicJSON", - "description": "Topic JSON returned in the `topic` field of the related API endpoint. ", + }, + "key": { + "type": "string" + }, + "checkFirst": { "type": "object", "properties": { - "linkType": { - "description": "The type of link between the topic and the `Ref`. For more on Sefaria's topic ontology, see [here](https://developers.sefaria.org/docs/topic-ontology). ", - "type": "string", - "example": "about" - }, - "class": { - "description": "A classification of the link as either `refTopic` (i.e. a ref to a topic) or `intraTopic` (topic-to-topic). In this case, it would be expected that all returned topic links would be of type `refTopic`.", - "enum": [ - "refTopic", - "intraTopic" - ], - "type": "string" - }, - "dataSource": { - "$ref": "#/components/schemas/DataSourceJSON", - "description": "JSON containing the information as to the source of the data for a given ref-to-topic link.", - "example": " {\n\"en\": \"Sheets by Sefaria users\",\n\"he\": \"דפי מקורות ממשתמשי ספריא\",\n\"slug\": \"sefaria-users\"\n}" - }, - "is_sheet": { - "description": "Is this ref-to-topic link one that was generated by a user-created source sheet?", - "type": "boolean", - "example": "True" - }, - "generatedBy": { - "description": "How the topic was generated (i.e. by a user, aspaklaria, Sefaria staff)", - "type": "string", - "example": "sheet-topic-aggregator" - }, - "order": { - "$ref": "#/components/schemas/OrderTopicLinkJSON", - "description": "This JSON includes the various metrics that are relevant for ordering the link on a topics page. We use these metrics at [Sefaria.org](sefaria.org) to change the order on the topics page.", - "properties": { - "user_votes": { - "format": "int32", - "type": "integer" - }, - "tfidf": { - "format": "double", - "type": "number" - }, - "numDatasource": { - "format": "int32", - "type": "integer" - }, - "availableLangs": { - "type": "array", - "items": { - "type": "string" - } - }, - "comp_date": { - "format": "int32", - "type": "integer" - }, - "order_id": { - "type": "string" - }, - "pr": { - "format": "double", - "type": "number" - }, - "numSources": { - "format": "int32", - "type": "integer" - } - }, - "example": "{\n\"user_votes\": 14,\n\"tfidf\": 10.783834565585545,\n\"numDatasource\": 1,\n\"availableLangs\": [\n\"en\",\n\"he\"\n],\n\"comp_date\": -1400,\n\"order_id\": \"A00000000400010001-00010011\",\n\"pr\": 8.083013483888324,\n\"numSources\": 143\n}" - }, - "topic": { - "description": "Topic slug", - "type": "string", - "example": "parashat-devarim" - }, - "title": { - "description": "The title of the topic in Hebrew (`he`) and English (`en`).", - "type": "object", - "example": "{\n\"en\": \"Parashat Devarim\",\n\"he\": \"פרשת דברים\"\n}" - }, - "titleIsTransliteration": { - "description": "A boolean value for the `he` and `en` fields inside the title JSON, indicating whether or not either translation is a transliteration. ", - "type": "object", - "example": "{\n\"en\": false,\n\"he\": false\n}" - }, - "description": { - "description": "JSON containing descriptions for a given topic in various languages. Each language contains a title for the topic description, as well as a prompt which previews the source and asks questions to help the user engage with the text.", - "type": "object", - "example": "{\n\"en\": \"Devarim (“Words”) is the first Torah portion in the Book of Deuteronomy, the final book of the Torah. In it, Moses recounts events from the Israelites’ travels in the desert, like the appointment of judges, the sin of the spies, and the wars with the Emorite kings Sihon and Og.\",\n\"he\": \"דברים היא הפרשה הראשונה בספר דברים, החומש החמישי והאחרון בתורה. בספר מובאים נאומי משה, שבהם הוא מזכיר אירועים מהעבר, סוקר מצוות שכבר ניתנו ומצווה מצוות חדשות. בפרשה משה מספר על הצורך במינוי שופטים להנהגת העם. הוא גם מזכיר את חטא המרגלים, שבו התלונן העם על הכניסה העתידית לארץ כנען, את העונש שהוטל על העם לנדוד במדבר ארבעים שנה ואת מלחמות ישראל במדבר.\"\n}" - }, - "anchorRef": { - "$ref": "#/components/schemas/ref", - "description": "The `Ref` in the query." - }, - "anchorRefExpanded": { - "description": "The segment `Ref`s within the `anchorRef`. ", - "type": "array", - "items": { - "$ref": "#/components/schemas/ref" - } - } - }, - "example": { - "linkType": "about", - "class": "refTopic", - "dataSource": {}, - "is_sheet": false, - "generatedBy": "sheet-topic-aggregator", - "order": { - "user_votes": 14, - "tfidf": 10.783834565585545, - "numDatasource": 1, - "availableLangs": [ - "en", - "he" - ], - "comp_date": -1400, - "order_id": "A00000000400010001-00010011", - "pr": 8.083013483888324, - "numSources": 143 - }, - "topic": "parashat-devarim", - "title": {}, - "titleIsTransliteration": {}, - "description": {}, - "anchorRef": "Deuteronomy 1:1-11", - "anchorRefExpanded": [] + "he": { + "type": "string" + }, + "en": { + "type": "string" + } } + } }, - "RawIndexJSON": { - "title": "Root Type for RawIndexJSON", - "description": "The full mongo record JSON from the database for a given Sefaria `Index`. ", + "example": "{\n\"nodeType\": \"JaggedArrayNode\",\n\"depth\": 2,\n\"addressTypes\": [\n\"Talmud\",\n\"Integer\"\n],\n\"sectionNames\": [\n\"Daf\",\n\"Line\"\n],\n\"match_templates\": [],\n\"lengths\": [\n242,\n3519\n],\n\"referenceableSections\": [\ntrue,\nfalse\n],\n\"titles\": [\n{\n\"text\": \"Masekhet Pesachim\",\n\"lang\": \"en\"\n},\n{\n\"text\": \"Talmud Pesachim\",\n\"lang\": \"en\"\n},\n{\n\"text\": \"Tractate Pesachim\",\n\"lang\": \"en\"\n},\n{\n\"text\": \"Pesahim\",\n\"lang\": \"en\"\n},\n{\n\"text\": \"Pes.\",\n\"lang\": \"en\"\n},\n{\n\"text\": \"P’saḥim\",\n\"lang\": \"en\"\n},\n{\n\"text\": \"Pessachim\",\n\"lang\": \"en\"\n},\n{\n\"text\": \"BT Pesachim\",\n\"lang\": \"en\"\n},\n{\n\"text\": \"Psachim\",\n\"lang\": \"en\"\n},\n{\n\"text\": \"Pesaḥim \",\n\"lang\": \"en\"\n},\n{\n\"text\": \"פסחי'\",\n\"lang\": \"he\"\n},\n{\n\"text\": \"פסחי׳\",\n\"lang\": \"he\"\n},\n{\n\"text\": \"פסחים\",\n\"lang\": \"he\",\n\"primary\": true\n},\n{\n\"text\": \"Pesachim\",\n\"lang\": \"en\",\n\"primary\": true\n}\n],\n\"key\": \"Pesachim\",\n\"checkFirst\": {\n\"he\": \"משנה פסחים\",\n\"en\": \"Mishnah Pesachim\"\n}\n}" + }, + "alt_structs": { + "$ref": "#/components/schemas/RawIndexAltStructsJSON", + "description": "Alternative structures for the text.", + "properties": { + "Chapters": { "type": "object", "properties": { - "title": { - "description": "Title of the work.", - "type": "string", - "example": "Pesachim" - }, - "categories": { - "description": "The categories within which this text falls. *Note:* The order of the strings in the array is significant. The categories should go from most general at position `0`, to most specific. ", - "type": "array", - "items": { - "type": "string" - }, - "example": "[\n\"Talmud\",\n\"Bavli\",\n\"Seder Moed\"\n]" - }, - "schema": { - "$ref": "#/components/schemas/RawIndexSchemaJSON", - "description": "The structure of the Index within the Sefaria specific schema for texts. ", - "properties": { - "nodeType": { - "type": "string" - }, - "depth": { - "format": "int32", - "type": "integer" - }, - "addressTypes": { - "type": "array", - "items": { - "type": "string" - } - }, - "sectionNames": { - "type": "array", - "items": { - "type": "string" - } - }, - "match_templates": { - "type": "array", - "items": { - "type": "object", - "properties": { - "term_slugs": { - "type": "array", - "items": { - "type": "string" - } - } - } - } - }, - "lengths": { - "type": "array", - "items": { - "format": "int32", - "type": "integer" - } - }, - "referenceableSections": { - "type": "array", - "items": { - "type": "boolean" - } - }, - "titles": { + "nodes": { + "type": "array", + "items": { + "type": "object", + "properties": { + "nodeType": { + "type": "string" + }, + "depth": { + "format": "int32", + "type": "integer" + }, + "wholeRef": { + "type": "string" + }, + "includeSections": { + "type": "boolean" + }, + "match_templates": { + "type": "array", + "items": { + "type": "object", + "properties": { + "term_slugs": { "type": "array", "items": { - "type": "object", - "properties": { - "text": { - "type": "string" - }, - "lang": { - "type": "string" - } - } + "type": "string" } - }, - "key": { + }, + "scope": { "type": "string" - }, - "checkFirst": { - "type": "object", - "properties": { - "he": { - "type": "string" - }, - "en": { - "type": "string" - } - } + } } + } }, - "example": "{\n\"nodeType\": \"JaggedArrayNode\",\n\"depth\": 2,\n\"addressTypes\": [\n\"Talmud\",\n\"Integer\"\n],\n\"sectionNames\": [\n\"Daf\",\n\"Line\"\n],\n\"match_templates\": [],\n\"lengths\": [\n242,\n3519\n],\n\"referenceableSections\": [\ntrue,\nfalse\n],\n\"titles\": [\n{\n\"text\": \"Masekhet Pesachim\",\n\"lang\": \"en\"\n},\n{\n\"text\": \"Talmud Pesachim\",\n\"lang\": \"en\"\n},\n{\n\"text\": \"Tractate Pesachim\",\n\"lang\": \"en\"\n},\n{\n\"text\": \"Pesahim\",\n\"lang\": \"en\"\n},\n{\n\"text\": \"Pes.\",\n\"lang\": \"en\"\n},\n{\n\"text\": \"P’saḥim\",\n\"lang\": \"en\"\n},\n{\n\"text\": \"Pessachim\",\n\"lang\": \"en\"\n},\n{\n\"text\": \"BT Pesachim\",\n\"lang\": \"en\"\n},\n{\n\"text\": \"Psachim\",\n\"lang\": \"en\"\n},\n{\n\"text\": \"Pesaḥim \",\n\"lang\": \"en\"\n},\n{\n\"text\": \"פסחי'\",\n\"lang\": \"he\"\n},\n{\n\"text\": \"פסחי׳\",\n\"lang\": \"he\"\n},\n{\n\"text\": \"פסחים\",\n\"lang\": \"he\",\n\"primary\": true\n},\n{\n\"text\": \"Pesachim\",\n\"lang\": \"en\",\n\"primary\": true\n}\n],\n\"key\": \"Pesachim\",\n\"checkFirst\": {\n\"he\": \"משנה פסחים\",\n\"en\": \"Mishnah Pesachim\"\n}\n}" - }, - "alt_structs": { - "$ref": "#/components/schemas/RawIndexAltStructsJSON", - "description": "Alternative structures for the text.", - "properties": { - "Chapters": { - "type": "object", - "properties": { - "nodes": { - "type": "array", - "items": { - "type": "object", - "properties": { - "nodeType": { - "type": "string" - }, - "depth": { - "format": "int32", - "type": "integer" - }, - "wholeRef": { - "type": "string" - }, - "includeSections": { - "type": "boolean" - }, - "match_templates": { - "type": "array", - "items": { - "type": "object", - "properties": { - "term_slugs": { - "type": "array", - "items": { - "type": "string" - } - }, - "scope": { - "type": "string" - } - } - } - }, - "numeric_equivalent": { - "format": "int32", - "type": "integer" - }, - "titles": { - "type": "array", - "items": { - "type": "object", - "properties": { - "primary": { - "type": "boolean" - }, - "text": { - "type": "string" - }, - "lang": { - "type": "string" - } - } - } - } - } - } - } - } + "numeric_equivalent": { + "format": "int32", + "type": "integer" + }, + "titles": { + "type": "array", + "items": { + "type": "object", + "properties": { + "primary": { + "type": "boolean" + }, + "text": { + "type": "string" + }, + "lang": { + "type": "string" + } } + } } + } + } + } + } + } + } + }, + "default_struct": { + "description": "Which structure of the available structures is default. ", + "type": "string", + "example": "\"chapters\"" + }, + "exclude_structs": { + "type": "array", + "items": { + "type": "string" + } + }, + "order": { + "type": "array", + "items": { + "format": "int32", + "type": "integer" + } + }, + "authors": { + "description": "Author(s) of the text.", + "type": "array", + "items": {} + }, + "enDesc": { + "description": "A longer English description of the index. ", + "type": "string", + "example": "\"Pesachim (“Passover Festivals”) is the third tractate in Seder Moed (“Festivals”). Its ten chapters discuss laws relating to Passover: the consumption of matzah (unleavened bread) and maror (bitter herbs), the prohibitions against owning or consuming chametz (leavened bread) on the festival, the paschal lamb that used to be offered at the Temple in Jerusalem, and the order of the seder (ritual feast) held on the first evening of the holiday.\\n.\"\n" + }, + "enShortDesc": { + "description": "A short English description of the index. ", + "type": "string", + "example": "Passover: ridding of chametz, the Paschal lamb offering, matzah, maror, and the Seder." + }, + "heShortDesc": { + "description": "A short description of the text in Hebrew. ", + "type": "string", + "example": "דינים הקשורים לחג הפסח: איסור חמץ, קורבן הפסח, מצה, מרור וליל הסדר." + }, + "pubDate": { + "description": "Date(s) of publication. *Note:* A negative value indicates the work was published BCE. ", + "type": "array", + "items": { + "format": "int32", + "type": "integer" + } + }, + "hasErrorMargin": { + "description": "This field tells you if `compDate` is list of 2 integers (i.e. is a range) because much of the time `compDate` will be a range only when there's an error margin in our knowledge of the completion date. ", + "type": "boolean" + }, + "compDate": { + "description": "Date(s) of text composition. \n\n**Notes:** \n- A negative value indicates BCE. \n- The integers are Gregorian years.\n- If it has 2 values, that is the range of years it was composed.\n- If has 1 value, that is the year it was composed.\n- If it has 0, we don’t know the year it was composed.", + "type": "array", + "items": { + "format": "int32", + "type": "integer" + } + }, + "compPlace": { + "description": "Location of composition", + "type": "string", + "example": "Talmudic Babylon" + }, + "pubPlace": { + "description": "Location of publication", + "type": "string", + "example": "Venice" + }, + "era": { + "description": "Era of the text. The value will be represented by one of the following codes. \n\n```\n \"Gaonim\": \"GN\",\n \"Rishonim\": \"RI\",\n \"Achronim\": \"AH\",\n \"Tannaim\": \"T\",\n \"Amoraim\": \"A\",\n \"Contemporary\": \"CO\"\n```", + "type": "string" + }, + "is_cited": { + "description": "Indicator of whether ot not this text is cited by others in our library. Functionally, this means we will pick up links to this text when cited in other texts.", + "type": "boolean", + "example": "True" + }, + "corpora": { + "type": "array", + "items": { + "type": "string" + }, + "example": "[\n\"Bavli\"\n]" + } + }, + "example": { + "title": "Pesachim", + "categories": [ + "Talmud", + "Bavli", + "Seder Moed" + ], + "schema": { + "nodeType": "JaggedArrayNode", + "depth": 2, + "addressTypes": [ + "Talmud", + "Integer" + ], + "sectionNames": [ + "Daf", + "Line" + ], + "match_templates": [ + { + "term_slugs": [ + "talmud", + "bavli", + "pesachim" + ] + }, + { + "term_slugs": [ + "talmud", + "bavli", + "tractate", + "pesachim" + ] + }, + { + "term_slugs": [ + "talmud", + "pesachim" + ] + }, + { + "term_slugs": [ + "bavli", + "pesachim" + ] + }, + { + "term_slugs": [ + "gemara", + "pesachim" + ] + }, + { + "term_slugs": [ + "bavli", + "tractate", + "pesachim" + ] + }, + { + "term_slugs": [ + "gemara", + "tractate", + "pesachim" + ] + }, + { + "term_slugs": [ + "tractate", + "pesachim" + ] + }, + { + "term_slugs": [ + "pesachim" + ] + } + ], + "lengths": [ + 242, + 3519 + ], + "referenceableSections": [ + true, + false + ], + "titles": [ + { + "text": "Masekhet Pesachim", + "lang": "en" + }, + { + "text": "Talmud Pesachim", + "lang": "en" + }, + { + "text": "Tractate Pesachim", + "lang": "en" + }, + { + "text": "Pesahim", + "lang": "en" + }, + { + "text": "Pes.", + "lang": "en" + }, + { + "text": "P’saḥim", + "lang": "en" + }, + { + "text": "Pessachim", + "lang": "en" + }, + { + "text": "BT Pesachim", + "lang": "en" + }, + { + "text": "Psachim", + "lang": "en" + }, + { + "text": "Pesaḥim ", + "lang": "en" + }, + { + "text": "פסחי'", + "lang": "he" + }, + { + "text": "פסחי׳", + "lang": "he" + }, + { + "text": "פסחים", + "lang": "he", + "primary": true + }, + { + "text": "Pesachim", + "lang": "en", + "primary": true + } + ], + "key": "Pesachim", + "checkFirst": { + "he": "משנה פסחים", + "en": "Mishnah Pesachim" + } + }, + "alt_structs": { + "Chapters": { + "nodes": [ + { + "nodeType": "ArrayMapNode", + "depth": 0, + "wholeRef": "Pesachim 2a:1-21a:7", + "includeSections": true, + "match_templates": [ + { + "term_slugs": [ + "perek", + "chapter-129" + ], + "scope": "any" }, - "default_struct": { - "description": "Which structure of the available structures is default. ", - "type": "string", - "example": "\"chapters\"" - }, - "exclude_structs": { - "type": "array", - "items": { - "type": "string" - } - }, - "order": { - "type": "array", - "items": { - "format": "int32", - "type": "integer" - } - }, - "authors": { - "description": "Author(s) of the text.", - "type": "array", - "items": {} - }, - "enDesc": { - "description": "A longer English description of the index. ", - "type": "string", - "example": "\"Pesachim (“Passover Festivals”) is the third tractate in Seder Moed (“Festivals”). Its ten chapters discuss laws relating to Passover: the consumption of matzah (unleavened bread) and maror (bitter herbs), the prohibitions against owning or consuming chametz (leavened bread) on the festival, the paschal lamb that used to be offered at the Temple in Jerusalem, and the order of the seder (ritual feast) held on the first evening of the holiday.\\n.\"\n" - }, - "enShortDesc": { - "description": "A short English description of the index. ", - "type": "string", - "example": "Passover: ridding of chametz, the Paschal lamb offering, matzah, maror, and the Seder." - }, - "heShortDesc": { - "description": "A short description of the text in Hebrew. ", - "type": "string", - "example": "דינים הקשורים לחג הפסח: איסור חמץ, קורבן הפסח, מצה, מרור וליל הסדר." - }, - "pubDate": { - "description": "Date(s) of publication. *Note:* A negative value indicates the work was published BCE. ", - "type": "array", - "items": { - "format": "int32", - "type": "integer" - } - }, - "hasErrorMargin": { - "description": "This field tells you if `compDate` is list of 2 integers (i.e. is a range) because much of the time `compDate` will be a range only when there's an error margin in our knowledge of the completion date. ", - "type": "boolean" - }, - "compDate": { - "description": "Date(s) of text composition. \n\n**Notes:** \n- A negative value indicates BCE. \n- The integers are Gregorian years.\n- If it has 2 values, that is the range of years it was composed.\n- If has 1 value, that is the year it was composed.\n- If it has 0, we don’t know the year it was composed.", - "type": "array", - "items": { - "format": "int32", - "type": "integer" - } - }, - "compPlace": { - "description": "Location of composition", - "type": "string", - "example": "Talmudic Babylon" - }, - "pubPlace": { - "description": "Location of publication", - "type": "string", - "example": "Venice" + { + "term_slugs": [ + "perek", + "first" + ] }, - "era": { - "description": "Era of the text. The value will be represented by one of the following codes. \n\n```\n \"Gaonim\": \"GN\",\n \"Rishonim\": \"RI\",\n \"Achronim\": \"AH\",\n \"Tannaim\": \"T\",\n \"Amoraim\": \"A\",\n \"Contemporary\": \"CO\"\n```", - "type": "string" + { + "term_slugs": [ + "chapter-129" + ], + "scope": "any" }, - "is_cited": { - "description": "Indicator of whether ot not this text is cited by others in our library. Functionally, this means we will pick up links to this text when cited in other texts.", - "type": "boolean", - "example": "True" + { + "term_slugs": [ + "first" + ] + } + ], + "numeric_equivalent": 1, + "titles": [ + { + "primary": true, + "text": "Chapter 1", + "lang": "en" }, - "corpora": { - "type": "array", - "items": { - "type": "string" - }, - "example": "[\n\"Bavli\"\n]" + { + "primary": true, + "text": "אור לארבעה עשר", + "lang": "he" } + ] }, - "example": { - "title": "Pesachim", - "categories": [ - "Talmud", - "Bavli", - "Seder Moed" - ], - "schema": { - "nodeType": "JaggedArrayNode", - "depth": 2, - "addressTypes": [ - "Talmud", - "Integer" - ], - "sectionNames": [ - "Daf", - "Line" - ], - "match_templates": [ - { - "term_slugs": [ - "talmud", - "bavli", - "pesachim" - ] - }, - { - "term_slugs": [ - "talmud", - "bavli", - "tractate", - "pesachim" - ] - }, - { - "term_slugs": [ - "talmud", - "pesachim" - ] - }, - { - "term_slugs": [ - "bavli", - "pesachim" - ] - }, - { - "term_slugs": [ - "gemara", - "pesachim" - ] - }, - { - "term_slugs": [ - "bavli", - "tractate", - "pesachim" - ] - }, - { - "term_slugs": [ - "gemara", - "tractate", - "pesachim" - ] - }, - { - "term_slugs": [ - "tractate", - "pesachim" - ] - }, - { - "term_slugs": [ - "pesachim" - ] - } - ], - "lengths": [ - 242, - 3519 - ], - "referenceableSections": [ - true, - false - ], - "titles": [ - { - "text": "Masekhet Pesachim", - "lang": "en" - }, - { - "text": "Talmud Pesachim", - "lang": "en" - }, - { - "text": "Tractate Pesachim", - "lang": "en" - }, - { - "text": "Pesahim", - "lang": "en" - }, - { - "text": "Pes.", - "lang": "en" - }, - { - "text": "P’saḥim", - "lang": "en" - }, - { - "text": "Pessachim", - "lang": "en" - }, - { - "text": "BT Pesachim", - "lang": "en" - }, - { - "text": "Psachim", - "lang": "en" - }, - { - "text": "Pesaḥim ", - "lang": "en" - }, - { - "text": "פסחי'", - "lang": "he" - }, - { - "text": "פסחי׳", - "lang": "he" - }, - { - "text": "פסחים", - "lang": "he", - "primary": true - }, - { - "text": "Pesachim", - "lang": "en", - "primary": true - } - ], - "key": "Pesachim", - "checkFirst": { - "he": "משנה פסחים", - "en": "Mishnah Pesachim" - } - }, - "alt_structs": { - "Chapters": { - "nodes": [ - { - "nodeType": "ArrayMapNode", - "depth": 0, - "wholeRef": "Pesachim 2a:1-21a:7", - "includeSections": true, - "match_templates": [ - { - "term_slugs": [ - "perek", - "chapter-129" - ], - "scope": "any" - }, - { - "term_slugs": [ - "perek", - "first" - ] - }, - { - "term_slugs": [ - "chapter-129" - ], - "scope": "any" - }, - { - "term_slugs": [ - "first" - ] - } - ], - "numeric_equivalent": 1, - "titles": [ - { - "primary": true, - "text": "Chapter 1", - "lang": "en" - }, - { - "primary": true, - "text": "אור לארבעה עשר", - "lang": "he" - } - ] - }, - { - "nodeType": "ArrayMapNode", - "depth": 0, - "wholeRef": "Pesachim 21a:8-42a:14", - "includeSections": true, - "match_templates": [ - { - "term_slugs": [ - "perek", - "chapter-224" - ], - "scope": "any" - }, - { - "term_slugs": [ - "perek", - "second" - ] - }, - { - "term_slugs": [ - "chapter-224" - ], - "scope": "any" - }, - { - "term_slugs": [ - "second" - ] - } - ], - "numeric_equivalent": 2, - "titles": [ - { - "primary": true, - "text": "Chapter 2", - "lang": "en" - }, - { - "primary": true, - "text": "כל שעה", - "lang": "he" - } - ] - }, - { - "nodeType": "ArrayMapNode", - "depth": 0, - "wholeRef": "Pesachim 42a:15-50a:22", - "includeSections": true, - "match_templates": [ - { - "term_slugs": [ - "perek", - "chapter-324" - ], - "scope": "any" - }, - { - "term_slugs": [ - "perek", - "third" - ] - }, - { - "term_slugs": [ - "chapter-324" - ], - "scope": "any" - }, - { - "term_slugs": [ - "third" - ] - } - ], - "numeric_equivalent": 3, - "titles": [ - { - "primary": true, - "text": "Chapter 3", - "lang": "en" - }, - { - "primary": true, - "text": "אלו עוברין", - "lang": "he" - } - ] - }, - { - "nodeType": "ArrayMapNode", - "depth": 0, - "wholeRef": "Pesachim 50a:23-57b:3", - "includeSections": true, - "match_templates": [ - { - "term_slugs": [ - "perek", - "chapter-420" - ], - "scope": "any" - }, - { - "term_slugs": [ - "perek", - "fourth" - ] - }, - { - "term_slugs": [ - "chapter-420" - ], - "scope": "any" - }, - { - "term_slugs": [ - "fourth" - ] - } - ], - "numeric_equivalent": 4, - "titles": [ - { - "primary": true, - "text": "Chapter 4", - "lang": "en" - }, - { - "primary": true, - "text": "מקום שנהגו", - "lang": "he" - } - ] - }, - { - "nodeType": "ArrayMapNode", - "depth": 0, - "wholeRef": "Pesachim 58a:1-65b:9", - "includeSections": true, - "match_templates": [ - { - "term_slugs": [ - "perek", - "chapter-518" - ], - "scope": "any" - }, - { - "term_slugs": [ - "perek", - "fifth" - ] - }, - { - "term_slugs": [ - "chapter-518" - ], - "scope": "any" - }, - { - "term_slugs": [ - "fifth" - ] - } - ], - "numeric_equivalent": 5, - "titles": [ - { - "primary": true, - "text": "Chapter 5", - "lang": "en" - }, - { - "primary": true, - "text": "תמיד נשחט", - "lang": "he" - } - ] - }, - { - "nodeType": "ArrayMapNode", - "depth": 0, - "wholeRef": "Pesachim 65b:10-73b:16", - "includeSections": true, - "match_templates": [ - { - "term_slugs": [ - "perek", - "chapter-616" - ], - "scope": "any" - }, - { - "term_slugs": [ - "perek", - "sixth" - ] - }, - { - "term_slugs": [ - "chapter-616" - ], - "scope": "any" - }, - { - "term_slugs": [ - "sixth" - ] - } - ], - "numeric_equivalent": 6, - "titles": [ - { - "primary": true, - "text": "Chapter 6", - "lang": "en" - }, - { - "primary": true, - "text": "אלו דברים", - "lang": "he" - } - ] - }, - { - "nodeType": "ArrayMapNode", - "depth": 0, - "wholeRef": "Pesachim 74a:1-86b:13", - "includeSections": true, - "match_templates": [ - { - "term_slugs": [ - "perek", - "chapter-714" - ], - "scope": "any" - }, - { - "term_slugs": [ - "perek", - "seventh" - ] - }, - { - "term_slugs": [ - "chapter-714" - ], - "scope": "any" - }, - { - "term_slugs": [ - "seventh" - ] - } - ], - "numeric_equivalent": 7, - "titles": [ - { - "primary": true, - "text": "Chapter 7", - "lang": "en" - }, - { - "primary": true, - "text": "כיצד צולין", - "lang": "he" - } - ] - }, - { - "nodeType": "ArrayMapNode", - "depth": 0, - "wholeRef": "Pesachim 87a:1-92b:3", - "includeSections": true, - "match_templates": [ - { - "term_slugs": [ - "perek", - "chapter-814" - ], - "scope": "any" - }, - { - "term_slugs": [ - "perek", - "eighth" - ] - }, - { - "term_slugs": [ - "chapter-814" - ], - "scope": "any" - }, - { - "term_slugs": [ - "eighth" - ] - } - ], - "numeric_equivalent": 8, - "titles": [ - { - "primary": true, - "text": "Chapter 8", - "lang": "en" - }, - { - "primary": true, - "text": "האשה", - "lang": "he" - } - ] - }, - { - "nodeType": "ArrayMapNode", - "depth": 0, - "wholeRef": "Pesachim 92b:4-99a:5", - "includeSections": true, - "match_templates": [ - { - "term_slugs": [ - "perek", - "chapter-914" - ], - "scope": "any" - }, - { - "term_slugs": [ - "perek", - "ninth" - ] - }, - { - "term_slugs": [ - "chapter-914" - ], - "scope": "any" - }, - { - "term_slugs": [ - "ninth" - ] - } - ], - "numeric_equivalent": 9, - "titles": [ - { - "primary": true, - "text": "Chapter 9", - "lang": "en" - }, - { - "primary": true, - "text": "מי שהיה טמא", - "lang": "he" - } - ] - }, - { - "nodeType": "ArrayMapNode", - "depth": 0, - "wholeRef": "Pesachim 99b:1-121b:3", - "includeSections": true, - "match_templates": [ - { - "term_slugs": [ - "perek", - "chapter-109" - ], - "scope": "any" - }, - { - "term_slugs": [ - "perek", - "tenth" - ] - }, - { - "term_slugs": [ - "chapter-109" - ], - "scope": "any" - }, - { - "term_slugs": [ - "tenth" - ] - }, - { - "term_slugs": [ - "perek", - "last" - ] - }, - { - "term_slugs": [ - "last" - ] - } - ], - "numeric_equivalent": 10, - "titles": [ - { - "primary": true, - "text": "Chapter 10", - "lang": "en" - }, - { - "primary": true, - "text": "ערבי פסחים", - "lang": "he" - } - ] - } - ] - } - }, - "default_struct": "Chapters", - "exclude_structs": [ - "schema" - ], - "order": [ - 4, - 3 - ], - "authors": [], - "enDesc": "Pesachim (“Passover Festivals”) is the third tractate in Seder Moed (“Festivals”). Its ten chapters discuss laws relating to Passover: the consumption of matzah (unleavened bread) and maror (bitter herbs), the prohibitions against owning or consuming chametz (leavened bread) on the festival, the paschal lamb that used to be offered at the Temple in Jerusalem, and the order of the seder (ritual feast) held on the first evening of the holiday.\n.", - "enShortDesc": "Passover: ridding of chametz, the Paschal lamb offering, matzah, maror, and the Seder.", - "heShortDesc": "דינים הקשורים לחג הפסח: איסור חמץ, קורבן הפסח, מצה, מרור וליל הסדר.", - "pubDate": [ - 1523 - ], - "hasErrorMargin": true, - "compDate": [ - 450, - 550 - ], - "compPlace": "Talmudic Babylon", - "pubPlace": "Venice", - "era": "A", - "is_cited": true, - "corpora": [ - "Bavli" - ] - } - }, - "RawIndexSchemaJSON": { - "title": "Root Type for RawIndexSchemaJSON", - "description": "Schema JSON for an Index. ", - "type": "object", - "properties": { - "nodeType": { - "description": "The type of node. Nodes can either be `SchemaNodes` or `JaggedArray` nodes. A `JaggedArray` is a nested array (2D or 3D), whereas a `SchemaNode` is a node with children of either type. All tree leaves in the Sefaria text tree must be `JaggedArray` nodes.", - "enum": [ - "JaggedArrayNode", - "SchemaNode" - ], - "type": "string", - "example": "JaggedArrayNode" - }, - "depth": { - "format": "int32", - "description": "The depth of a text. For example, a book of Tanakh with chapters and verses has a depth 2, whereas a commentary on that book of Tanakh, with multiple comments on each verse (so a chapter-verse-comment structure) would have a depth of 3. ", - "type": "integer", - "example": "2" + { + "nodeType": "ArrayMapNode", + "depth": 0, + "wholeRef": "Pesachim 21a:8-42a:14", + "includeSections": true, + "match_templates": [ + { + "term_slugs": [ + "perek", + "chapter-224" + ], + "scope": "any" }, - "addressTypes": { - "description": "A list which length reflects the depth of the text structure, with string values indicating class names for address types for each level.", - "type": "array", - "items": { - "type": "string" - }, - "example": "[\n\"Talmud\",\n\"Integer\"\n]" + { + "term_slugs": [ + "perek", + "second" + ] }, - "sectionNames": { - "description": "An array containing the type names of the sections of this text. The length of `sectionNames` gives the depth of the structure of this text. For example, Kohelet (`[\"Chapter\", \"Verse\"]`) has depth 2, while Mishneh Torah (`[\"Book\", \"Topic\", \"Section\", \"Law\"]`) has depth 4. Comparing this depth to the depth of sections will show if the request was for the lowest level, or a higher level, of the text.", - "type": "array", - "items": { - "type": "string" - }, - "example": "[\"Book\", \"Topic\", \"Section\", \"Law\"]" + { + "term_slugs": [ + "chapter-224" + ], + "scope": "any" }, - "match_templates": { - "description": "This data is used for the linker.", - "type": "array", - "items": {} + { + "term_slugs": [ + "second" + ] + } + ], + "numeric_equivalent": 2, + "titles": [ + { + "primary": true, + "text": "Chapter 2", + "lang": "en" }, - "lengths": { - "description": "The lengths of the text at each level of depth. For example, a text of depth 2 will have an array with two values, the first representing the number of sections, and the second value representing the number of verses. So, if Genesis has lengths, it's array will look like this `[50, 1533]`. This is interpreted to mean the Genesis Index has 50 chapters (sections) and 1533 verses (segments).\n\nA depth-3 text (a commentary, for example) will have three values, representing the number of super sections, sections, and segments. ", - "type": "array", - "items": { - "format": "int32", - "type": "integer" - }, - "example": "[50, 1533]" + { + "primary": true, + "text": "כל שעה", + "lang": "he" + } + ] + }, + { + "nodeType": "ArrayMapNode", + "depth": 0, + "wholeRef": "Pesachim 42a:15-50a:22", + "includeSections": true, + "match_templates": [ + { + "term_slugs": [ + "perek", + "chapter-324" + ], + "scope": "any" }, - "referenceableSections": { - "type": "array", - "items": { - "type": "boolean" - } + { + "term_slugs": [ + "perek", + "third" + ] }, - "titles": { - "description": "Titles for the index.", - "type": "array", - "items": { - "$ref": "#/components/schemas/TitlesJSON" - }, - "example": "[\n{\n\"text\": \"Masekhet Pesachim\",\n\"lang\": \"en\"\n},\n{\n\"text\": \"Talmud Pesachim\",\n\"lang\": \"en\"\n},\n{\n\"text\": \"Tractate Pesachim\",\n\"lang\": \"en\"\n},\n{\n\"text\": \"Pesahim\",\n\"lang\": \"en\"\n},\n{\n\"text\": \"Pes.\",\n\"lang\": \"en\"\n},\n{\n\"text\": \"P’saḥim\",\n\"lang\": \"en\"\n},\n{\n\"text\": \"Pessachim\",\n\"lang\": \"en\"\n},\n{\n\"text\": \"BT Pesachim\",\n\"lang\": \"en\"\n},\n{\n\"text\": \"Psachim\",\n\"lang\": \"en\"\n},\n{\n\"text\": \"Pesaḥim \",\n\"lang\": \"en\"\n},\n{\n\"text\": \"פסחי'\",\n\"lang\": \"he\"\n},\n{\n\"text\": \"פסחי׳\",\n\"lang\": \"he\"\n},\n{\n\"text\": \"פסחים\",\n\"lang\": \"he\",\n\"primary\": true\n},\n{\n\"text\": \"Pesachim\",\n\"lang\": \"en\",\n\"primary\": true\n}\n]" + { + "term_slugs": [ + "chapter-324" + ], + "scope": "any" }, - "key": { - "description": "Unique key for the text, usually matches the `Index` title. ", - "type": "string", - "example": "Pesachim" + { + "term_slugs": [ + "third" + ] + } + ], + "numeric_equivalent": 3, + "titles": [ + { + "primary": true, + "text": "Chapter 3", + "lang": "en" }, - "checkFirst": { - "type": "object", - "properties": { - "he": { - "type": "string" - }, - "en": { - "type": "string" - } - } + { + "primary": true, + "text": "אלו עוברין", + "lang": "he" } + ] }, - "example": { - "nodeType": "JaggedArrayNode", - "depth": 2, - "addressTypes": [ - "Talmud", - "Integer" - ], - "sectionNames": [ - "Daf", - "Line" - ], - "match_templates": [], - "lengths": [ - 242, - 3519 - ], - "referenceableSections": [ - true, - false - ], - "titles": [], - "key": "Pesachim", - "checkFirst": { - "he": "משנה פסחים", - "en": "Mishnah Pesachim" + { + "nodeType": "ArrayMapNode", + "depth": 0, + "wholeRef": "Pesachim 50a:23-57b:3", + "includeSections": true, + "match_templates": [ + { + "term_slugs": [ + "perek", + "chapter-420" + ], + "scope": "any" + }, + { + "term_slugs": [ + "perek", + "fourth" + ] + }, + { + "term_slugs": [ + "chapter-420" + ], + "scope": "any" + }, + { + "term_slugs": [ + "fourth" + ] } - } - }, - "RawIndexAltStructsJSON": { - "title": "Root Type for RawIndexAltStructsJSON", - "description": "The JSON returned for the alt structs of an Index. ", - "type": "object", - "properties": { - "Chapters": { - "$ref": "#/components/schemas/RawIndexNodesJSON", - "properties": { - "nodes": { - "type": "array", - "items": {} - } - } + ], + "numeric_equivalent": 4, + "titles": [ + { + "primary": true, + "text": "Chapter 4", + "lang": "en" + }, + { + "primary": true, + "text": "מקום שנהגו", + "lang": "he" } + ] }, - "example": "\"alt_structs\": {\n\"Chapters\": {\n\"nodes\": [\n{\n\"nodeType\": \"ArrayMapNode\",\n\"depth\": 0,\n\"wholeRef\": \"Pesachim 2a:1-21a:7\",\n\"includeSections\": true,\n\"match_templates\": [\n{\n\"term_slugs\": [\n\"perek\",\n\"chapter-129\"\n],\n\"scope\": \"any\"\n},\n{\n\"term_slugs\": [\n\"perek\",\n\"first\"\n]\n},\n{\n\"term_slugs\": [\n\"chapter-129\"\n],\n\"scope\": \"any\"\n},\n{\n\"term_slugs\": [\n\"first\"\n]\n}\n],\n\"numeric_equivalent\": 1,\n\"titles\": [\n{\n\"primary\": true,\n\"text\": \"Chapter 1\",\n\"lang\": \"en\"\n},\n{\n\"primary\": true,\n\"text\": \"אור לארבעה עשר\",\n\"lang\": \"he\"\n}\n]\n},\n{\n\"nodeType\": \"ArrayMapNode\",\n\"depth\": 0,\n\"wholeRef\": \"Pesachim 21a:8-42a:14\",\n\"includeSections\": true,\n\"match_templates\": [\n{\n\"term_slugs\": [\n\"perek\",\n\"chapter-224\"\n],\n\"scope\": \"any\"\n},\n{\n\"term_slugs\": [\n\"perek\",\n\"second\"\n]\n},\n{\n\"term_slugs\": [\n\"chapter-224\"\n],\n\"scope\": \"any\"\n},\n{\n\"term_slugs\": [\n\"second\"\n]\n}\n],\n\"numeric_equivalent\": 2,\n\"titles\": [\n{\n\"primary\": true,\n\"text\": \"Chapter 2\",\n\"lang\": \"en\"\n},\n{\n\"primary\": true,\n\"text\": \"כל שעה\",\n\"lang\": \"he\"\n}\n]\n},\n{\n\"nodeType\": \"ArrayMapNode\",\n\"depth\": 0,\n\"wholeRef\": \"Pesachim 42a:15-50a:22\",\n\"includeSections\": true,\n\"match_templates\": [\n{\n\"term_slugs\": [\n\"perek\",\n\"chapter-324\"\n],\n\"scope\": \"any\"\n},\n{\n\"term_slugs\": [\n\"perek\",\n\"third\"\n]\n},\n{\n\"term_slugs\": [\n\"chapter-324\"\n],\n\"scope\": \"any\"\n},\n{\n\"term_slugs\": [\n\"third\"\n]\n}\n],\n\"numeric_equivalent\": 3,\n\"titles\": [\n{\n\"primary\": true,\n\"text\": \"Chapter 3\",\n\"lang\": \"en\"\n},\n{\n\"primary\": true,\n\"text\": \"אלו עוברין\",\n\"lang\": \"he\"\n}\n]\n},\n{\n\"nodeType\": \"ArrayMapNode\",\n\"depth\": 0,\n\"wholeRef\": \"Pesachim 50a:23-57b:3\",\n\"includeSections\": true,\n\"match_templates\": [\n{\n\"term_slugs\": [\n\"perek\",\n\"chapter-420\"\n],\n\"scope\": \"any\"\n},\n{\n\"term_slugs\": [\n\"perek\",\n\"fourth\"\n]\n},\n{\n\"term_slugs\": [\n\"chapter-420\"\n],\n\"scope\": \"any\"\n},\n{\n\"term_slugs\": [\n\"fourth\"\n]\n}\n],\n\"numeric_equivalent\": 4,\n\"titles\": [\n{\n\"primary\": true,\n\"text\": \"Chapter 4\",\n\"lang\": \"en\"\n},\n{\n\"primary\": true,\n\"text\": \"מקום שנהגו\",\n\"lang\": \"he\"\n}\n]\n},\n{\n\"nodeType\": \"ArrayMapNode\",\n\"depth\": 0,\n\"wholeRef\": \"Pesachim 58a:1-65b:9\",\n\"includeSections\": true,\n\"match_templates\": [\n{\n\"term_slugs\": [\n\"perek\",\n\"chapter-518\"\n],\n\"scope\": \"any\"\n},\n{\n\"term_slugs\": [\n\"perek\",\n\"fifth\"\n]\n},\n{\n\"term_slugs\": [\n\"chapter-518\"\n],\n\"scope\": \"any\"\n},\n{\n\"term_slugs\": [\n\"fifth\"\n]\n}\n],\n\"numeric_equivalent\": 5,\n\"titles\": [\n{\n\"primary\": true,\n\"text\": \"Chapter 5\",\n\"lang\": \"en\"\n},\n{\n\"primary\": true,\n\"text\": \"תמיד נשחט\",\n\"lang\": \"he\"\n}\n]\n},\n{\n\"nodeType\": \"ArrayMapNode\",\n\"depth\": 0,\n\"wholeRef\": \"Pesachim 65b:10-73b:16\",\n\"includeSections\": true,\n\"match_templates\": [\n{\n\"term_slugs\": [\n\"perek\",\n\"chapter-616\"\n],\n\"scope\": \"any\"\n},\n{\n\"term_slugs\": [\n\"perek\",\n\"sixth\"\n]\n},\n{\n\"term_slugs\": [\n\"chapter-616\"\n],\n\"scope\": \"any\"\n},\n{\n\"term_slugs\": [\n\"sixth\"\n]\n}\n],\n\"numeric_equivalent\": 6,\n\"titles\": [\n{\n\"primary\": true,\n\"text\": \"Chapter 6\",\n\"lang\": \"en\"\n},\n{\n\"primary\": true,\n\"text\": \"אלו דברים\",\n\"lang\": \"he\"\n}\n]\n},\n{\n\"nodeType\": \"ArrayMapNode\",\n\"depth\": 0,\n\"wholeRef\": \"Pesachim 74a:1-86b:13\",\n\"includeSections\": true,\n\"match_templates\": [\n{\n\"term_slugs\": [\n\"perek\",\n\"chapter-714\"\n],\n\"scope\": \"any\"\n},\n{\n\"term_slugs\": [\n\"perek\",\n\"seventh\"\n]\n},\n{\n\"term_slugs\": [\n\"chapter-714\"\n],\n\"scope\": \"any\"\n},\n{\n\"term_slugs\": [\n\"seventh\"\n]\n}\n],\n\"numeric_equivalent\": 7,\n\"titles\": [\n{\n\"primary\": true,\n\"text\": \"Chapter 7\",\n\"lang\": \"en\"\n},\n{\n\"primary\": true,\n\"text\": \"כיצד צולין\",\n\"lang\": \"he\"\n}\n]\n},\n{\n\"nodeType\": \"ArrayMapNode\",\n\"depth\": 0,\n\"wholeRef\": \"Pesachim 87a:1-92b:3\",\n\"includeSections\": true,\n\"match_templates\": [\n{\n\"term_slugs\": [\n\"perek\",\n\"chapter-814\"\n],\n\"scope\": \"any\"\n},\n{\n\"term_slugs\": [\n\"perek\",\n\"eighth\"\n]\n},\n{\n\"term_slugs\": [\n\"chapter-814\"\n],\n\"scope\": \"any\"\n},\n{\n\"term_slugs\": [\n\"eighth\"\n]\n}\n],\n\"numeric_equivalent\": 8,\n\"titles\": [\n{\n\"primary\": true,\n\"text\": \"Chapter 8\",\n\"lang\": \"en\"\n},\n{\n\"primary\": true,\n\"text\": \"האשה\",\n\"lang\": \"he\"\n}\n]\n},\n{\n\"nodeType\": \"ArrayMapNode\",\n\"depth\": 0,\n\"wholeRef\": \"Pesachim 92b:4-99a:5\",\n\"includeSections\": true,\n\"match_templates\": [\n{\n\"term_slugs\": [\n\"perek\",\n\"chapter-914\"\n],\n\"scope\": \"any\"\n},\n{\n\"term_slugs\": [\n\"perek\",\n\"ninth\"\n]\n},\n{\n\"term_slugs\": [\n\"chapter-914\"\n],\n\"scope\": \"any\"\n},\n{\n\"term_slugs\": [\n\"ninth\"\n]\n}\n],\n\"numeric_equivalent\": 9,\n\"titles\": [\n{\n\"primary\": true,\n\"text\": \"Chapter 9\",\n\"lang\": \"en\"\n},\n{\n\"primary\": true,\n\"text\": \"מי שהיה טמא\",\n\"lang\": \"he\"\n}\n]\n},\n{\n\"nodeType\": \"ArrayMapNode\",\n\"depth\": 0,\n\"wholeRef\": \"Pesachim 99b:1-121b:3\",\n\"includeSections\": true,\n\"match_templates\": [\n{\n\"term_slugs\": [\n\"perek\",\n\"chapter-109\"\n],\n\"scope\": \"any\"\n},\n{\n\"term_slugs\": [\n\"perek\",\n\"tenth\"\n]\n},\n{\n\"term_slugs\": [\n\"chapter-109\"\n],\n\"scope\": \"any\"\n},\n{\n\"term_slugs\": [\n\"tenth\"\n]\n},\n{\n\"term_slugs\": [\n\"perek\",\n\"last\"\n]\n},\n{\n\"term_slugs\": [\n\"last\"\n]\n}\n],\n\"numeric_equivalent\": 10,\n\"titles\": [\n{\n\"primary\": true,\n\"text\": \"Chapter 10\",\n\"lang\": \"en\"\n},\n{\n\"primary\": true,\n\"text\": \"ערבי פסחים\",\n\"lang\": \"he\"\n}\n]\n}\n]\n}\n}" - }, - "RawIndexAltStructNodeJSON": { - "title": "Root Type for RawIndexAltStructNodeJSON", - "description": "", - "type": "object", - "properties": { - "nodeType": { - "description": "The type of node", - "type": "string" - }, - "depth": { - "format": "int32", - "description": "The depth of the Node.", - "type": "integer" - }, - "wholeRef": { - "$ref": "#/components/schemas/ref", - "description": "The specific ranged `Ref` that corresponds to this section of text.", - "example": "\"Pesachim 2a:1-21a:7" + { + "nodeType": "ArrayMapNode", + "depth": 0, + "wholeRef": "Pesachim 58a:1-65b:9", + "includeSections": true, + "match_templates": [ + { + "term_slugs": [ + "perek", + "chapter-518" + ], + "scope": "any" }, - "includeSections": { - "type": "boolean" + { + "term_slugs": [ + "perek", + "fifth" + ] }, - "match_templates": { - "description": "Data used for linker purposes.", - "type": "array", - "items": { - "type": "object", - "properties": { - "term_slugs": { - "type": "array", - "items": { - "type": "string" - } - }, - "scope": { - "type": "string" - } - } - } + { + "term_slugs": [ + "chapter-518" + ], + "scope": "any" }, - "numeric_equivalent": { - "format": "int32", - "description": "The numeric equivalent of the section. So for example, if chapter two of Masechet Pesachim is referred to as `כל שעה`, the `numeric_equivalent` is 2.", - "type": "integer", - "example": "3" + { + "term_slugs": [ + "fifth" + ] + } + ], + "numeric_equivalent": 5, + "titles": [ + { + "primary": true, + "text": "Chapter 5", + "lang": "en" }, - "titles": { - "description": "Titles for this section of text.", - "type": "array", - "items": { - "$ref": "#/components/schemas/TitlesJSON" - }, - "example": "[\n{\n\"primary\": true,\n\"text\": \"Chapter 1\",\n\"lang\": \"en\"\n},\n{\n\"primary\": true,\n\"text\": \"אור לארבעה עשר\",\n\"lang\": \"he\"\n}\n]" + { + "primary": true, + "text": "תמיד נשחט", + "lang": "he" } + ] }, - "example": { - "nodeType": "ArrayMapNode", - "depth": 0, - "wholeRef": "Pesachim 2a:1-21a:7", - "includeSections": true, - "match_templates": [ - { - "term_slugs": [ - "perek", - "chapter-129" - ], - "scope": "any" - }, - { - "term_slugs": [ - "perek", - "first" - ] - }, - { - "term_slugs": [ - "chapter-129" - ], - "scope": "any" - }, - { - "term_slugs": [ - "first" - ] - } - ], - "numeric_equivalent": 1, - "titles": [ - { - "primary": true, - "text": "Chapter 1", - "lang": "en" - }, - { - "primary": true, - "text": "אור לארבעה עשר", - "lang": "he" - } - ] - } - }, - "RawIndexNodesJSON": { - "title": "Root Type for RawIndexNodesJSON", - "description": "", - "type": "object", - "properties": { - "nodes": { - "type": "array", - "items": { - "$ref": "#/components/schemas/RawIndexAltStructNodeJSON" - } + { + "nodeType": "ArrayMapNode", + "depth": 0, + "wholeRef": "Pesachim 65b:10-73b:16", + "includeSections": true, + "match_templates": [ + { + "term_slugs": [ + "perek", + "chapter-616" + ], + "scope": "any" + }, + { + "term_slugs": [ + "perek", + "sixth" + ] + }, + { + "term_slugs": [ + "chapter-616" + ], + "scope": "any" + }, + { + "term_slugs": [ + "sixth" + ] } - }, - "example": { - "nodes": [] - } - }, - "FindRefsPOSTRequest": { - "title": "Root Type for FindRefsPOSTRequest", - "description": "A properly formatted POST request for the Find Refs API", - "required": [ - "lang", - "text" - ], - "type": "object", - "properties": { - "text": { - "description": "Initially designed for websites, this API expects the `text` field to contain both a `body` and a `title`. When parsing arbitrary text feel free to just use `body` and pass an empty string `''` to `title`", - "type": "object", - "properties": { - "body": { - "type": "string" - }, - "title": { - "type": "string" - } - } + ], + "numeric_equivalent": 6, + "titles": [ + { + "primary": true, + "text": "Chapter 6", + "lang": "en" }, - "lang": { - "description": "Either `he` or `en`. If not included, it will default to one based on the number of Hebrew or Latin characters in the `body` of the `text`.", - "enum": [ - "he", - "en" - ], - "type": "string", - "example": "en" + { + "primary": true, + "text": "אלו דברים", + "lang": "he" } + ] }, - "example": { - "text": { - "body": "Genesis 1:1 is a citation and also Mishnah Peah 3-4. So is שמות ב", - "title": "Some thoughts on Sefer Bereishit 1" - }, - "lang": "en" - } - }, - "SearchPOSTData": { - "title": "Root Type for SearchPOSTData", - "description": "", - "type": "object", - "properties": { - "aggs": { - "description": "List of fields to aggregate on. Common fields are `path` for the `text` type and `group` or `topics` for the `sheet` type", - "type": "array", - "items": { - "type": "string" - } + { + "nodeType": "ArrayMapNode", + "depth": 0, + "wholeRef": "Pesachim 74a:1-86b:13", + "includeSections": true, + "match_templates": [ + { + "term_slugs": [ + "perek", + "chapter-714" + ], + "scope": "any" }, - "field": { - "description": "The field you want to query. Common fields to query are `exact` or `naive_lemmatizer` for the `text` and `merged` indices. For querying the `sheet` index, commonly you'll query the `content` field", - "type": "string" + { + "term_slugs": [ + "perek", + "seventh" + ] }, - "filter_fields": { - "description": "Must be the same length as `filters`. Each entry specifies the field to apply the corresponding filter in `filters`. For queries of type `text` this has no effect since there's only one field to filter text queries on (`path`. this field is explained in `filters`). For `sheet` queries, the following fields can appear in `filter_fields`: `collections` (corresponds to the collections that the sheet is in), `topics_en` (corresponds to the topics for this sheet, translated into English), `topics_he` (corresponds to the topics for this sheet, translated into Hebrew).", - "type": "array", - "items": {} + { + "term_slugs": [ + "chapter-714" + ], + "scope": "any" }, - "filters": { - "description": "A list of filters to filter results. These filters cannot include RegEx. Any RegEx characters will be escaped. Each filter is applied to the corresponding field in the `filter_fields` list. E.g. if filters is `[\"Passover\", \"Torah Talks\"]` and `filter_fields` is `[\"topics_en\", \"collections\"]` then the `\"Passover\"` filter will be applied to the `\"topics_en\"` field and the `\"Torah Talks\"` filter will be applied to the `\"collections\"` field. For `text` queries, filters always applies to the `path` field of documents. This essentially corresponds to the category path of the book in Sefaria's table of contents (there are some differences with regards to commentary paths). For `sheet` queries, filters can be applied to `collections`, `topics_en` or `topics_he`. These fields are explained in `filter_fields` param.", - "type": "array", - "items": {} + { + "term_slugs": [ + "seventh" + ] + } + ], + "numeric_equivalent": 7, + "titles": [ + { + "primary": true, + "text": "Chapter 7", + "lang": "en" }, - "query": { - "description": "Your search query.", - "type": "string" + { + "primary": true, + "text": "כיצד צולין", + "lang": "he" + } + ] + }, + { + "nodeType": "ArrayMapNode", + "depth": 0, + "wholeRef": "Pesachim 87a:1-92b:3", + "includeSections": true, + "match_templates": [ + { + "term_slugs": [ + "perek", + "chapter-814" + ], + "scope": "any" }, - "size": { - "format": "int32", - "description": "For paginating results. The total number of results to return, starting from `start`", - "type": "integer" + { + "term_slugs": [ + "perek", + "eighth" + ] }, - "slop": { - "format": "int32", - "description": "The maximum distance between each query word in the resulting document. `0` means an exact match must be found", - "type": "integer" + { + "term_slugs": [ + "chapter-814" + ], + "scope": "any" }, - "sort_fields": { - "description": "List of fields to sort on. If `sort_method = 'score'` this list should have exactly one item. Common fields to sort on are `comp_date` (which list results from titles published chronologically), `order` (which list results based on Sefaria's table of contents structure), `pagesheetrank` (most relevant results based on the Sheet Rank algorithm), `dateCreated` (for sheet results returned chronologically), `views` (for sheet results based on popularity).", - "type": "array", - "items": { - "type": "string" - } + { + "term_slugs": [ + "eighth" + ] + } + ], + "numeric_equivalent": 8, + "titles": [ + { + "primary": true, + "text": "Chapter 8", + "lang": "en" }, - "sort_method": { - "description": "How to sort results. If sort, the values are sorted according to `sort_fields`. If `score`, the value in `sort_fields` is multiplied with the default ElasticSearch score.", - "enum": [ - "sort", - "score" - ], - "type": "string" + { + "primary": true, + "text": "האשה", + "lang": "he" + } + ] + }, + { + "nodeType": "ArrayMapNode", + "depth": 0, + "wholeRef": "Pesachim 92b:4-99a:5", + "includeSections": true, + "match_templates": [ + { + "term_slugs": [ + "perek", + "chapter-914" + ], + "scope": "any" }, - "sort_reverse": { - "description": "Whether or not to reverse the sort applied on `sort_fields`", - "type": "boolean" + { + "term_slugs": [ + "perek", + "ninth" + ] }, - "sort_score_missing": { - "format": "double", - "description": "The number used in case there is a value missing in your `sort_field`", - "type": "number" + { + "term_slugs": [ + "chapter-914" + ], + "scope": "any" }, - "source_proj": { - "description": "By default, the ElasticSearch document is not returned. Specifying `true` will return the entire document. Specifying a `str` or `list(str)` will perform a projection on the document for the specified fields", - "type": "boolean" + { + "term_slugs": [ + "ninth" + ] + } + ], + "numeric_equivalent": 9, + "titles": [ + { + "primary": true, + "text": "Chapter 9", + "lang": "en" }, - "type": { - "description": "The ElasticSearch index you want to query, and the results you expect to get back. `sheet` returns results from Sefaria's user generated source sheets, while `text` returns results from the library.", - "enum": [ - "text", - "sheet" - ], - "type": "string" + { + "primary": true, + "text": "מי שהיה טמא", + "lang": "he" } + ] }, - "example": { - "aggs": [ - "path" - ], - "field": "naive_lemmatizer", - "filter_fields": [], - "filters": [], - "query": "banana", - "size": 50, - "slop": 10, - "sort_fields": [ - "pagesheetrank" - ], - "sort_method": "score", - "sort_reverse": false, - "sort_score_missing": 0.04, - "source_proj": true, - "type": "text" - } - }, - "ShapeJSON": { - "description": "The shape API allows one to retrieve information about the shape of an Index on Sefaria. The shape refers some basic statistics about the Index, mostly the number of chapters, and the number of segments per chapter.", - "required": [ - "Book", - "heBook", - "Chapters" - ], - "type": "object", - "properties": { - "Section": { - "description": "The parent section for this `Index`. (So for example, the `section` for `Jonah` is `Prophets`. The `section` for `Pesachim` is `Seder Moed`)", - "type": "string", - "example": "Prophets" + { + "nodeType": "ArrayMapNode", + "depth": 0, + "wholeRef": "Pesachim 99b:1-121b:3", + "includeSections": true, + "match_templates": [ + { + "term_slugs": [ + "perek", + "chapter-109" + ], + "scope": "any" }, - "isComplex": { - "description": "A boolean representing whether or not this is a complex text. ", - "type": "boolean" + { + "term_slugs": [ + "perek", + "tenth" + ] }, - "Length": { - "description": "The number of chapters or top-level sections in the `Index`. " + { + "term_slugs": [ + "chapter-109" + ], + "scope": "any" }, - "Book": { - "description": "Title of the `Index` in English", - "type": "string" + { + "term_slugs": [ + "tenth" + ] }, - "heBook": { - "description": "Title of the `Index` in Hebrew. ", - "type": "string" + { + "term_slugs": [ + "perek", + "last" + ] }, - "Chapters": { - "description": "For simple texts, this is a list of chapter lengths. For complex texts or categories, the Shape API will return a list of dicts for each text within that category or text. ", - "type": "array", - "items": { - "$ref": "#/components/schemas/ShapeJSON" - }, - "example": " \"chapters\": [\n 16,\n 11,\n 10,\n 11\n ]" + { + "term_slugs": [ + "last" + ] } - } - }, - "CatJSON": { - "title": "Root Type for CatJSON", - "description": "JSON response for a Category GET request", - "type": "object", - "properties": { - "path": { - "description": "The full path of the category", - "type": "array", - "items": { - "type": "string" - } - }, - "titles": { - "description": "The titles for the category, in Hebrew and English.", - "type": "array", - "items": { - "$ref": "#/components/schemas/TitlesJSON" - } + ], + "numeric_equivalent": 10, + "titles": [ + { + "primary": true, + "text": "Chapter 10", + "lang": "en" }, - "lastPath": { - "description": "The immediate parent of the current category. So for example, with the category `Tanakh/Torah/Genesis`, the `lastPath` is `Torah`. ", - "type": "string" + { + "primary": true, + "text": "ערבי פסחים", + "lang": "he" } + ] + } + ] + } + }, + "default_struct": "Chapters", + "exclude_structs": [ + "schema" + ], + "order": [ + 4, + 3 + ], + "authors": [], + "enDesc": "Pesachim (“Passover Festivals”) is the third tractate in Seder Moed (“Festivals”). Its ten chapters discuss laws relating to Passover: the consumption of matzah (unleavened bread) and maror (bitter herbs), the prohibitions against owning or consuming chametz (leavened bread) on the festival, the paschal lamb that used to be offered at the Temple in Jerusalem, and the order of the seder (ritual feast) held on the first evening of the holiday.\n.", + "enShortDesc": "Passover: ridding of chametz, the Paschal lamb offering, matzah, maror, and the Seder.", + "heShortDesc": "דינים הקשורים לחג הפסח: איסור חמץ, קורבן הפסח, מצה, מרור וליל הסדר.", + "pubDate": [ + 1523 + ], + "hasErrorMargin": true, + "compDate": [ + 450, + 550 + ], + "compPlace": "Talmudic Babylon", + "pubPlace": "Venice", + "era": "A", + "is_cited": true, + "corpora": [ + "Bavli" + ] + } + }, + "RawIndexSchemaJSON": { + "title": "Root Type for RawIndexSchemaJSON", + "description": "Schema JSON for an Index. ", + "type": "object", + "properties": { + "nodeType": { + "description": "The type of node. Nodes can either be `SchemaNodes` or `JaggedArray` nodes. A `JaggedArray` is a nested array (2D or 3D), whereas a `SchemaNode` is a node with children of either type. All tree leaves in the Sefaria text tree must be `JaggedArray` nodes.", + "enum": [ + "JaggedArrayNode", + "SchemaNode" + ], + "type": "string", + "example": "JaggedArrayNode" + }, + "depth": { + "format": "int32", + "description": "The depth of a text. For example, a book of Tanakh with chapters and verses has a depth 2, whereas a commentary on that book of Tanakh, with multiple comments on each verse (so a chapter-verse-comment structure) would have a depth of 3. ", + "type": "integer", + "example": "2" + }, + "addressTypes": { + "description": "A list which length reflects the depth of the text structure, with string values indicating class names for address types for each level.", + "type": "array", + "items": { + "type": "string" + }, + "example": "[\n\"Talmud\",\n\"Integer\"\n]" + }, + "sectionNames": { + "description": "An array containing the type names of the sections of this text. The length of `sectionNames` gives the depth of the structure of this text. For example, Kohelet (`[\"Chapter\", \"Verse\"]`) has depth 2, while Mishneh Torah (`[\"Book\", \"Topic\", \"Section\", \"Law\"]`) has depth 4. Comparing this depth to the depth of sections will show if the request was for the lowest level, or a higher level, of the text.", + "type": "array", + "items": { + "type": "string" + }, + "example": "[\"Book\", \"Topic\", \"Section\", \"Law\"]" + }, + "match_templates": { + "description": "This data is used for the linker.", + "type": "array", + "items": {} + }, + "lengths": { + "description": "The lengths of the text at each level of depth. For example, a text of depth 2 will have an array with two values, the first representing the number of sections, and the second value representing the number of verses. So, if Genesis has lengths, it's array will look like this `[50, 1533]`. This is interpreted to mean the Genesis Index has 50 chapters (sections) and 1533 verses (segments).\n\nA depth-3 text (a commentary, for example) will have three values, representing the number of super sections, sections, and segments. ", + "type": "array", + "items": { + "format": "int32", + "type": "integer" + }, + "example": "[50, 1533]" + }, + "referenceableSections": { + "type": "array", + "items": { + "type": "boolean" + } + }, + "titles": { + "description": "Titles for the index.", + "type": "array", + "items": { + "$ref": "#/components/schemas/TitlesJSON" + }, + "example": "[\n{\n\"text\": \"Masekhet Pesachim\",\n\"lang\": \"en\"\n},\n{\n\"text\": \"Talmud Pesachim\",\n\"lang\": \"en\"\n},\n{\n\"text\": \"Tractate Pesachim\",\n\"lang\": \"en\"\n},\n{\n\"text\": \"Pesahim\",\n\"lang\": \"en\"\n},\n{\n\"text\": \"Pes.\",\n\"lang\": \"en\"\n},\n{\n\"text\": \"P’saḥim\",\n\"lang\": \"en\"\n},\n{\n\"text\": \"Pessachim\",\n\"lang\": \"en\"\n},\n{\n\"text\": \"BT Pesachim\",\n\"lang\": \"en\"\n},\n{\n\"text\": \"Psachim\",\n\"lang\": \"en\"\n},\n{\n\"text\": \"Pesaḥim \",\n\"lang\": \"en\"\n},\n{\n\"text\": \"פסחי'\",\n\"lang\": \"he\"\n},\n{\n\"text\": \"פסחי׳\",\n\"lang\": \"he\"\n},\n{\n\"text\": \"פסחים\",\n\"lang\": \"he\",\n\"primary\": true\n},\n{\n\"text\": \"Pesachim\",\n\"lang\": \"en\",\n\"primary\": true\n}\n]" + }, + "key": { + "description": "Unique key for the text, usually matches the `Index` title. ", + "type": "string", + "example": "Pesachim" + }, + "checkFirst": { + "type": "object", + "properties": { + "he": { + "type": "string" + }, + "en": { + "type": "string" + } + } + } + }, + "example": { + "nodeType": "JaggedArrayNode", + "depth": 2, + "addressTypes": [ + "Talmud", + "Integer" + ], + "sectionNames": [ + "Daf", + "Line" + ], + "match_templates": [], + "lengths": [ + 242, + 3519 + ], + "referenceableSections": [ + true, + false + ], + "titles": [], + "key": "Pesachim", + "checkFirst": { + "he": "משנה פסחים", + "en": "Mishnah Pesachim" + } + } + }, + "RawIndexAltStructsJSON": { + "title": "Root Type for RawIndexAltStructsJSON", + "description": "The JSON returned for the alt structs of an Index. ", + "type": "object", + "properties": { + "Chapters": { + "$ref": "#/components/schemas/RawIndexNodesJSON", + "properties": { + "nodes": { + "type": "array", + "items": {} + } + } + } + }, + "example": "\"alt_structs\": {\n\"Chapters\": {\n\"nodes\": [\n{\n\"nodeType\": \"ArrayMapNode\",\n\"depth\": 0,\n\"wholeRef\": \"Pesachim 2a:1-21a:7\",\n\"includeSections\": true,\n\"match_templates\": [\n{\n\"term_slugs\": [\n\"perek\",\n\"chapter-129\"\n],\n\"scope\": \"any\"\n},\n{\n\"term_slugs\": [\n\"perek\",\n\"first\"\n]\n},\n{\n\"term_slugs\": [\n\"chapter-129\"\n],\n\"scope\": \"any\"\n},\n{\n\"term_slugs\": [\n\"first\"\n]\n}\n],\n\"numeric_equivalent\": 1,\n\"titles\": [\n{\n\"primary\": true,\n\"text\": \"Chapter 1\",\n\"lang\": \"en\"\n},\n{\n\"primary\": true,\n\"text\": \"אור לארבעה עשר\",\n\"lang\": \"he\"\n}\n]\n},\n{\n\"nodeType\": \"ArrayMapNode\",\n\"depth\": 0,\n\"wholeRef\": \"Pesachim 21a:8-42a:14\",\n\"includeSections\": true,\n\"match_templates\": [\n{\n\"term_slugs\": [\n\"perek\",\n\"chapter-224\"\n],\n\"scope\": \"any\"\n},\n{\n\"term_slugs\": [\n\"perek\",\n\"second\"\n]\n},\n{\n\"term_slugs\": [\n\"chapter-224\"\n],\n\"scope\": \"any\"\n},\n{\n\"term_slugs\": [\n\"second\"\n]\n}\n],\n\"numeric_equivalent\": 2,\n\"titles\": [\n{\n\"primary\": true,\n\"text\": \"Chapter 2\",\n\"lang\": \"en\"\n},\n{\n\"primary\": true,\n\"text\": \"כל שעה\",\n\"lang\": \"he\"\n}\n]\n},\n{\n\"nodeType\": \"ArrayMapNode\",\n\"depth\": 0,\n\"wholeRef\": \"Pesachim 42a:15-50a:22\",\n\"includeSections\": true,\n\"match_templates\": [\n{\n\"term_slugs\": [\n\"perek\",\n\"chapter-324\"\n],\n\"scope\": \"any\"\n},\n{\n\"term_slugs\": [\n\"perek\",\n\"third\"\n]\n},\n{\n\"term_slugs\": [\n\"chapter-324\"\n],\n\"scope\": \"any\"\n},\n{\n\"term_slugs\": [\n\"third\"\n]\n}\n],\n\"numeric_equivalent\": 3,\n\"titles\": [\n{\n\"primary\": true,\n\"text\": \"Chapter 3\",\n\"lang\": \"en\"\n},\n{\n\"primary\": true,\n\"text\": \"אלו עוברין\",\n\"lang\": \"he\"\n}\n]\n},\n{\n\"nodeType\": \"ArrayMapNode\",\n\"depth\": 0,\n\"wholeRef\": \"Pesachim 50a:23-57b:3\",\n\"includeSections\": true,\n\"match_templates\": [\n{\n\"term_slugs\": [\n\"perek\",\n\"chapter-420\"\n],\n\"scope\": \"any\"\n},\n{\n\"term_slugs\": [\n\"perek\",\n\"fourth\"\n]\n},\n{\n\"term_slugs\": [\n\"chapter-420\"\n],\n\"scope\": \"any\"\n},\n{\n\"term_slugs\": [\n\"fourth\"\n]\n}\n],\n\"numeric_equivalent\": 4,\n\"titles\": [\n{\n\"primary\": true,\n\"text\": \"Chapter 4\",\n\"lang\": \"en\"\n},\n{\n\"primary\": true,\n\"text\": \"מקום שנהגו\",\n\"lang\": \"he\"\n}\n]\n},\n{\n\"nodeType\": \"ArrayMapNode\",\n\"depth\": 0,\n\"wholeRef\": \"Pesachim 58a:1-65b:9\",\n\"includeSections\": true,\n\"match_templates\": [\n{\n\"term_slugs\": [\n\"perek\",\n\"chapter-518\"\n],\n\"scope\": \"any\"\n},\n{\n\"term_slugs\": [\n\"perek\",\n\"fifth\"\n]\n},\n{\n\"term_slugs\": [\n\"chapter-518\"\n],\n\"scope\": \"any\"\n},\n{\n\"term_slugs\": [\n\"fifth\"\n]\n}\n],\n\"numeric_equivalent\": 5,\n\"titles\": [\n{\n\"primary\": true,\n\"text\": \"Chapter 5\",\n\"lang\": \"en\"\n},\n{\n\"primary\": true,\n\"text\": \"תמיד נשחט\",\n\"lang\": \"he\"\n}\n]\n},\n{\n\"nodeType\": \"ArrayMapNode\",\n\"depth\": 0,\n\"wholeRef\": \"Pesachim 65b:10-73b:16\",\n\"includeSections\": true,\n\"match_templates\": [\n{\n\"term_slugs\": [\n\"perek\",\n\"chapter-616\"\n],\n\"scope\": \"any\"\n},\n{\n\"term_slugs\": [\n\"perek\",\n\"sixth\"\n]\n},\n{\n\"term_slugs\": [\n\"chapter-616\"\n],\n\"scope\": \"any\"\n},\n{\n\"term_slugs\": [\n\"sixth\"\n]\n}\n],\n\"numeric_equivalent\": 6,\n\"titles\": [\n{\n\"primary\": true,\n\"text\": \"Chapter 6\",\n\"lang\": \"en\"\n},\n{\n\"primary\": true,\n\"text\": \"אלו דברים\",\n\"lang\": \"he\"\n}\n]\n},\n{\n\"nodeType\": \"ArrayMapNode\",\n\"depth\": 0,\n\"wholeRef\": \"Pesachim 74a:1-86b:13\",\n\"includeSections\": true,\n\"match_templates\": [\n{\n\"term_slugs\": [\n\"perek\",\n\"chapter-714\"\n],\n\"scope\": \"any\"\n},\n{\n\"term_slugs\": [\n\"perek\",\n\"seventh\"\n]\n},\n{\n\"term_slugs\": [\n\"chapter-714\"\n],\n\"scope\": \"any\"\n},\n{\n\"term_slugs\": [\n\"seventh\"\n]\n}\n],\n\"numeric_equivalent\": 7,\n\"titles\": [\n{\n\"primary\": true,\n\"text\": \"Chapter 7\",\n\"lang\": \"en\"\n},\n{\n\"primary\": true,\n\"text\": \"כיצד צולין\",\n\"lang\": \"he\"\n}\n]\n},\n{\n\"nodeType\": \"ArrayMapNode\",\n\"depth\": 0,\n\"wholeRef\": \"Pesachim 87a:1-92b:3\",\n\"includeSections\": true,\n\"match_templates\": [\n{\n\"term_slugs\": [\n\"perek\",\n\"chapter-814\"\n],\n\"scope\": \"any\"\n},\n{\n\"term_slugs\": [\n\"perek\",\n\"eighth\"\n]\n},\n{\n\"term_slugs\": [\n\"chapter-814\"\n],\n\"scope\": \"any\"\n},\n{\n\"term_slugs\": [\n\"eighth\"\n]\n}\n],\n\"numeric_equivalent\": 8,\n\"titles\": [\n{\n\"primary\": true,\n\"text\": \"Chapter 8\",\n\"lang\": \"en\"\n},\n{\n\"primary\": true,\n\"text\": \"האשה\",\n\"lang\": \"he\"\n}\n]\n},\n{\n\"nodeType\": \"ArrayMapNode\",\n\"depth\": 0,\n\"wholeRef\": \"Pesachim 92b:4-99a:5\",\n\"includeSections\": true,\n\"match_templates\": [\n{\n\"term_slugs\": [\n\"perek\",\n\"chapter-914\"\n],\n\"scope\": \"any\"\n},\n{\n\"term_slugs\": [\n\"perek\",\n\"ninth\"\n]\n},\n{\n\"term_slugs\": [\n\"chapter-914\"\n],\n\"scope\": \"any\"\n},\n{\n\"term_slugs\": [\n\"ninth\"\n]\n}\n],\n\"numeric_equivalent\": 9,\n\"titles\": [\n{\n\"primary\": true,\n\"text\": \"Chapter 9\",\n\"lang\": \"en\"\n},\n{\n\"primary\": true,\n\"text\": \"מי שהיה טמא\",\n\"lang\": \"he\"\n}\n]\n},\n{\n\"nodeType\": \"ArrayMapNode\",\n\"depth\": 0,\n\"wholeRef\": \"Pesachim 99b:1-121b:3\",\n\"includeSections\": true,\n\"match_templates\": [\n{\n\"term_slugs\": [\n\"perek\",\n\"chapter-109\"\n],\n\"scope\": \"any\"\n},\n{\n\"term_slugs\": [\n\"perek\",\n\"tenth\"\n]\n},\n{\n\"term_slugs\": [\n\"chapter-109\"\n],\n\"scope\": \"any\"\n},\n{\n\"term_slugs\": [\n\"tenth\"\n]\n},\n{\n\"term_slugs\": [\n\"perek\",\n\"last\"\n]\n},\n{\n\"term_slugs\": [\n\"last\"\n]\n}\n],\n\"numeric_equivalent\": 10,\n\"titles\": [\n{\n\"primary\": true,\n\"text\": \"Chapter 10\",\n\"lang\": \"en\"\n},\n{\n\"primary\": true,\n\"text\": \"ערבי פסחים\",\n\"lang\": \"he\"\n}\n]\n}\n]\n}\n}" + }, + "RawIndexAltStructNodeJSON": { + "title": "Root Type for RawIndexAltStructNodeJSON", + "description": "", + "type": "object", + "properties": { + "nodeType": { + "description": "The type of node", + "type": "string" + }, + "depth": { + "format": "int32", + "description": "The depth of the Node.", + "type": "integer" + }, + "wholeRef": { + "$ref": "#/components/schemas/ref", + "description": "The specific ranged `Ref` that corresponds to this section of text.", + "example": "\"Pesachim 2a:1-21a:7" + }, + "includeSections": { + "type": "boolean" + }, + "match_templates": { + "description": "Data used for linker purposes.", + "type": "array", + "items": { + "type": "object", + "properties": { + "term_slugs": { + "type": "array", + "items": { + "type": "string" + } }, - "example": { - "path": [ - "Tanakh", - "Torah" - ], - "titles": [ - { - "lang": "en", - "text": "Torah", - "primary": true - }, - { - "lang": "he", - "text": "תורה", - "primary": true - } - ], - "lastPath": "Torah" + "scope": { + "type": "string" } + } + } + }, + "numeric_equivalent": { + "format": "int32", + "description": "The numeric equivalent of the section. So for example, if chapter two of Masechet Pesachim is referred to as `כל שעה`, the `numeric_equivalent` is 2.", + "type": "integer", + "example": "3" + }, + "titles": { + "description": "Titles for this section of text.", + "type": "array", + "items": { + "$ref": "#/components/schemas/TitlesJSON" + }, + "example": "[\n{\n\"primary\": true,\n\"text\": \"Chapter 1\",\n\"lang\": \"en\"\n},\n{\n\"primary\": true,\n\"text\": \"אור לארבעה עשר\",\n\"lang\": \"he\"\n}\n]" + } + }, + "example": { + "nodeType": "ArrayMapNode", + "depth": 0, + "wholeRef": "Pesachim 2a:1-21a:7", + "includeSections": true, + "match_templates": [ + { + "term_slugs": [ + "perek", + "chapter-129" + ], + "scope": "any" + }, + { + "term_slugs": [ + "perek", + "first" + ] + }, + { + "term_slugs": [ + "chapter-129" + ], + "scope": "any" + }, + { + "term_slugs": [ + "first" + ] + } + ], + "numeric_equivalent": 1, + "titles": [ + { + "primary": true, + "text": "Chapter 1", + "lang": "en" + }, + { + "primary": true, + "text": "אור לארבעה עשר", + "lang": "he" + } + ] + } + }, + "RawIndexNodesJSON": { + "title": "Root Type for RawIndexNodesJSON", + "description": "", + "type": "object", + "properties": { + "nodes": { + "type": "array", + "items": { + "$ref": "#/components/schemas/RawIndexAltStructNodeJSON" + } + } + }, + "example": { + "nodes": [] + } + }, + "FindRefsPOSTRequest": { + "title": "Root Type for FindRefsPOSTRequest", + "description": "A properly formatted POST request for the Find Refs API", + "required": [ + "lang", + "text" + ], + "type": "object", + "properties": { + "text": { + "description": "Initially designed for websites, this API expects the `text` field to contain both a `body` and a `title`. When parsing arbitrary text feel free to just use `body` and pass an empty string `''` to `title`", + "type": "object", + "properties": { + "body": { + "type": "string" + }, + "title": { + "type": "string" + } + } + }, + "lang": { + "description": "Either `he` or `en`. If not included, it will default to one based on the number of Hebrew or Latin characters in the `body` of the `text`.", + "enum": [ + "he", + "en" + ], + "type": "string", + "example": "en" + } + }, + "example": { + "text": { + "body": "Genesis 1:1 is a citation and also Mishnah Peah 3-4. So is שמות ב", + "title": "Some thoughts on Sefer Bereishit 1" + }, + "lang": "en" + } + }, + "SearchPOSTData": { + "title": "Root Type for SearchPOSTData", + "description": "", + "type": "object", + "properties": { + "aggs": { + "description": "List of fields to aggregate on. Common fields are `path` for the `text` type and `group` or `topics` for the `sheet` type", + "type": "array", + "items": { + "type": "string" + } + }, + "field": { + "description": "The field you want to query. Common fields to query are `exact` or `naive_lemmatizer` for the `text` and `merged` indices. For querying the `sheet` index, commonly you'll query the `content` field", + "type": "string" + }, + "filter_fields": { + "description": "Must be the same length as `filters`. Each entry specifies the field to apply the corresponding filter in `filters`. For queries of type `text` this has no effect since there's only one field to filter text queries on (`path`. this field is explained in `filters`). For `sheet` queries, the following fields can appear in `filter_fields`: `collections` (corresponds to the collections that the sheet is in), `topics_en` (corresponds to the topics for this sheet, translated into English), `topics_he` (corresponds to the topics for this sheet, translated into Hebrew).", + "type": "array", + "items": {} + }, + "filters": { + "description": "A list of filters to filter results. These filters cannot include RegEx. Any RegEx characters will be escaped. Each filter is applied to the corresponding field in the `filter_fields` list. E.g. if filters is `[\"Passover\", \"Torah Talks\"]` and `filter_fields` is `[\"topics_en\", \"collections\"]` then the `\"Passover\"` filter will be applied to the `\"topics_en\"` field and the `\"Torah Talks\"` filter will be applied to the `\"collections\"` field. For `text` queries, filters always applies to the `path` field of documents. This essentially corresponds to the category path of the book in Sefaria's table of contents (there are some differences with regards to commentary paths). For `sheet` queries, filters can be applied to `collections`, `topics_en` or `topics_he`. These fields are explained in `filter_fields` param.", + "type": "array", + "items": {} + }, + "query": { + "description": "Your search query.", + "type": "string" + }, + "size": { + "format": "int32", + "description": "For paginating results. The total number of results to return, starting from `start`", + "type": "integer" + }, + "slop": { + "format": "int32", + "description": "The maximum distance between each query word in the resulting document. `0` means an exact match must be found", + "type": "integer" + }, + "sort_fields": { + "description": "List of fields to sort on. If `sort_method = 'score'` this list should have exactly one item. Common fields to sort on are `comp_date` (which list results from titles published chronologically), `order` (which list results based on Sefaria's table of contents structure), `pagesheetrank` (most relevant results based on the Sheet Rank algorithm), `dateCreated` (for sheet results returned chronologically), `views` (for sheet results based on popularity).", + "type": "array", + "items": { + "type": "string" + } + }, + "sort_method": { + "description": "How to sort results. If sort, the values are sorted according to `sort_fields`. If `score`, the value in `sort_fields` is multiplied with the default ElasticSearch score.", + "enum": [ + "sort", + "score" + ], + "type": "string" + }, + "sort_reverse": { + "description": "Whether or not to reverse the sort applied on `sort_fields`", + "type": "boolean" + }, + "sort_score_missing": { + "format": "double", + "description": "The number used in case there is a value missing in your `sort_field`", + "type": "number" + }, + "source_proj": { + "description": "By default, the ElasticSearch document is not returned. Specifying `true` will return the entire document. Specifying a `str` or `list(str)` will perform a projection on the document for the specified fields", + "type": "boolean" + }, + "type": { + "description": "The ElasticSearch index you want to query, and the results you expect to get back. `sheet` returns results from Sefaria's user generated source sheets, while `text` returns results from the library.", + "enum": [ + "text", + "sheet" + ], + "type": "string" + } + }, + "example": { + "aggs": [ + "path" + ], + "field": "naive_lemmatizer", + "filter_fields": [], + "filters": [], + "query": "banana", + "size": 50, + "slop": 10, + "sort_fields": [ + "pagesheetrank" + ], + "sort_method": "score", + "sort_reverse": false, + "sort_score_missing": 0.04, + "source_proj": true, + "type": "text" + } + }, + "ShapeJSON": { + "description": "The shape API allows one to retrieve information about the shape of an Index on Sefaria. The shape refers some basic statistics about the Index, mostly the number of chapters, and the number of segments per chapter.", + "required": [ + "Book", + "heBook", + "Chapters" + ], + "type": "object", + "properties": { + "Section": { + "description": "The parent section for this `Index`. (So for example, the `section` for `Jonah` is `Prophets`. The `section` for `Pesachim` is `Seder Moed`)", + "type": "string", + "example": "Prophets" + }, + "isComplex": { + "description": "A boolean representing whether or not this is a complex text. ", + "type": "boolean" + }, + "Length": { + "description": "The number of chapters or top-level sections in the `Index`. " + }, + "Book": { + "description": "Title of the `Index` in English", + "type": "string" + }, + "heBook": { + "description": "Title of the `Index` in Hebrew. ", + "type": "string" + }, + "Chapters": { + "description": "For simple texts, this is a list of chapter lengths. For complex texts or categories, the Shape API will return a list of dicts for each text within that category or text. ", + "type": "array", + "items": { + "$ref": "#/components/schemas/ShapeJSON" + }, + "example": " \"chapters\": [\n 16,\n 11,\n 10,\n 11\n ]" + } + } + }, + "CatJSON": { + "title": "Root Type for CatJSON", + "description": "JSON response for a Category GET request", + "type": "object", + "properties": { + "path": { + "description": "The full path of the category", + "type": "array", + "items": { + "type": "string" + } + }, + "titles": { + "description": "The titles for the category, in Hebrew and English.", + "type": "array", + "items": { + "$ref": "#/components/schemas/TitlesJSON" + } + }, + "lastPath": { + "description": "The immediate parent of the current category. So for example, with the category `Tanakh/Torah/Genesis`, the `lastPath` is `Torah`. ", + "type": "string" + } + }, + "example": { + "path": [ + "Tanakh", + "Torah" + ], + "titles": [ + { + "lang": "en", + "text": "Torah", + "primary": true + }, + { + "lang": "he", + "text": "תורה", + "primary": true } + ], + "lastPath": "Torah" } + } } + } } \ No newline at end of file