# Sefaria Jewish Texts API
> The Sefaria library of Jewish texts as an API. Fetch any passage in both Hebrew and English — the Torah, the Prophets and Writings (Tanakh), the Mishnah, the Talmud, Midrash, Halakhah and centuries of commentary. Resolve a reference or name to its canonical citation, browse the full table of contents, and pull every commentary and connection on a given passage (Rashi, Ramban, Rashbam and more). Get today's daily-learning calendar — the weekly Torah portion (Parashat Hashavua), the Haftarah and the Daf Yomi — and explore the topic graph. Real data, no key needed upstream. Ideal for study apps, Torah readers, Jewish-education tools and research.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/sefaria-api/..."
```

## Pricing
- **Free** (Free) — 12,000 calls/Mo, 2 req/s
- **Starter** ($3/Mo) — 150,000 calls/Mo, 8 req/s
- **Pro** ($15/Mo) — 750,000 calls/Mo, 25 req/s
- **Mega** ($55/Mo) — 3,400,000 calls/Mo, 50 req/s

## Endpoints

### Texts

#### `GET /v1/index` — The library table of contents

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/sefaria-api/v1/index"
```

**Response:**
```json
{
    "data": {
        "count": 14,
        "table_of_contents": [
            {
                "title": "Tanakh",
                "category": "Tanakh",
                "contents": [
                    {
                        "title": "Torah",
                        "category": "Torah",
                        "heCategory": "תורה"
                    },
                    {
                        "title": "Prophets",
                        "category": "Prophets",
                        "heCategory": "נביאים"
                    },
                    {
                        "title": "Writings",
                        "category": "Writings",
                        "heCategory": "כתובים"
                    },
                    {
                        "title": "Targum",
                        "category": "Targum",
                        "heCategory": "תרגומים"
                    },
                    {
                        "title": "Rishonim on Tanakh",
                        "category": "Rishonim on Tanakh",
                        "heCategory": "ראשונים על התנ״ך"
                    },
                    {
                        "title": "Acharonim on Tanakh",
                        "category": "Acharonim on Tanakh",
                        "heCategory": "אחרונים על התנ״ך"
                    },
                    {
                        "title": "Modern Commentary on Tanakh",
                 
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/links` — Commentaries & connections on a passage

**Parameters:**
- `ref` (query, required, string) — A textual reference, e.g. Genesis 1:1 Example: `Genesis 1:1`
- `limit` (query, optional, string) — Max links (default 50) Example: `50`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/sefaria-api/v1/links?ref=Genesis+1%3A1&limit=50"
```

**Response:**
```json
{
    "data": {
        "ref": "Genesis 1:1",
        "links": [
            {
                "ref": "Rashbam on Genesis 1:1:1",
                "type": "commentary",
                "category": "Commentary",
                "commentator": "Rashbam"
            },
            {
                "ref": "Ramban on Genesis 1:1:1",
                "type": "commentary",
                "category": "Commentary",
                "commentator": "Ramban"
            },
            {
                "ref": "Sforno on Genesis 1:1:1",
                "type": "commentary",
                "category": "Commentary",
                "commentator": "Sforno"
            },
            {
                "ref": "Sforno on Genesis 1:1:2",
                "type": "commentary",
                "category": "Commentary",
                "commentator": "Sforno"
            },
            {
                "ref": "Sforno on Genesis 1:1:3",
                "type": "commentary",
                "category": "Commentary",
                "commentator": "Sforno"
            },
            {
                "ref": "Sforno on Genesis 1:1:4",
                "type": "commentary",
                "category": "Commentary",
                "commentator": "Sforno"
            },
            {
                "ref": "Sforno on Genesis 1:1:5",
                "type": "commentary",
                "category": "Commentary",
                "commentator": "Sforno"
            },
            {
                "ref": "Kl
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/name` — Resolve a reference or name

**Parameters:**
- `name` (query, required, string) — A name or partial reference, e.g. Rashi Example: `Rashi`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/sefaria-api/v1/name?name=Rashi"
```

**Response:**
```json
{
    "data": {
        "type": "AuthorTopic",
        "query": "Rashi",
        "is_ref": false,
        "completions": [
            "Rashi on Job",
            "Rashi on Amos",
            "Rashi on Avot",
            "Rashi",
            "Rashi on Ezra",
            "Rashi on Joel",
            "Rashi on Ruth",
            "Rashi on Yoma",
            "Rashi on Hosea",
            "Rashi on Jonah",
            "Rashi on Micah",
            "Rashi on Nahum"
        ]
    },
    "meta": {
        "timestamp": "2026-06-08T01:19:32.525Z",
        "request_id": "98d0940e-7cb2-4791-a833-4f96c72590d1"
    },
    "status": "ok",
    "message": "Name resolved successfully",
    "success": true
}
```

#### `GET /v1/text` — A passage in Hebrew & English

**Parameters:**
- `ref` (query, required, string) — A textual reference, e.g. Genesis 1:1 Example: `Genesis 1:1`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/sefaria-api/v1/text?ref=Genesis+1%3A1"
```

**Response:**
```json
{
    "data": {
        "text": {
            "ref": "Genesis 1:1",
            "he_ref": "בראשית א׳:א׳",
            "hebrew": "בְּרֵאשִׁ֖ית בָּרָ֣א אֱלֹהִ֑ים אֵ֥ת הַשָּׁמַ֖יִם וְאֵ֥ת הָאָֽרֶץ׃",
            "english": "When God began to create heaven and earth—",
            "sections": [
                "1",
                "1"
            ],
            "is_spanning": false,
            "hebrew_version": "Miqra according to the Masorah",
            "english_version": "THE JPS TANAKH: Gender-Sensitive Edition",
            "available_versions": [
                {
                    "title": "THE JPS TANAKH: Gender-Sensitive Edition",
                    "language": "en"
                },
                {
                    "title": "The Contemporary Torah, Jewish Publication Society, 2006",
                    "language": "en"
                },
                {
                    "title": "The Five Books of Moses, by Everett Fox. New York, Schocken Books, 1995",
                    "language": "en"
                },
                {
                    "title": "The Koren Jerusalem Bible",
                    "language": "en"
                },
                {
                    "title": "Metsudah Chumash, Metsudah Publications, 2009",
                    "language": "en"
                },
                {
                    "title": "The Kehot Chumash; Chabad House Publications, Los An
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/topics` — Topics list, or one topic

**Parameters:**
- `slug` (query, optional, string) — A topic slug (omit for the list)
- `limit` (query, optional, string) — Max topics (default 30) Example: `30`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/sefaria-api/v1/topics?limit=30"
```

**Response:**
```json
{
    "data": {
        "count": 30,
        "topics": [
            {
                "slug": "rabbi-yochanan-b-napacha",
                "title": "Rabbi Yochanan b. Napacha",
                "hebrew_title": "רבי יוחנן"
            },
            {
                "slug": "rabbi-yehudah-b-ilai",
                "title": "Rabbi Yehudah [b. Il'ai]",
                "hebrew_title": "רבי יהודה"
            },
            {
                "slug": "rava",
                "title": "Rava",
                "hebrew_title": "רבא"
            },
            {
                "slug": "rav",
                "title": "Rav",
                "hebrew_title": "רב (שם אמורא)"
            },
            {
                "slug": "rabbi-yose-b-chalafta",
                "title": "Rabbi Yose b. Chalafta",
                "hebrew_title": "רבי יוסי"
            },
            {
                "slug": "rabbi-meir",
                "title": "Rabbi Meir",
                "hebrew_title": "רבי מאיר"
            },
            {
                "slug": "shimon-bar-yochai",
                "title": "Rabbi Shimon bar Yochai",
                "hebrew_title": "רבי שמעון בר יוחאי"
            },
            {
                "slug": "shmuel-(amora)",
                "title": "Shmuel (Amora)",
                "hebrew_title": "שמואל (שם אמורא)"
            },
            {
                "slug": "abaye",
                "title": "Abaye",
   
…(truncated, see openapi.json for full schema)
```

### Learning

#### `GET /v1/calendars` — Today's daily-learning calendar

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/sefaria-api/v1/calendars"
```

**Response:**
```json
{
    "data": {
        "date": "2026-06-07",
        "items": [
            {
                "ref": "Numbers 13:1-15:41",
                "title": "Parashat Hashavua",
                "value": "Sh'lach",
                "category": "Tanakh",
                "hebrew_title": "פרשת השבוע",
                "hebrew_value": "שלח"
            },
            {
                "ref": "Joshua 2:1-24",
                "title": "Haftarah",
                "value": "Joshua 2:1-24",
                "category": "Tanakh",
                "hebrew_title": "הפטרה",
                "hebrew_value": "יהושע ב׳:א׳-כ״ד"
            },
            {
                "ref": "Chullin 38",
                "title": "Daf Yomi",
                "value": "Chullin 38",
                "category": "Talmud",
                "hebrew_title": "דף יומי",
                "hebrew_value": "חולין ל״ח"
            },
            {
                "ref": "Joshua 14",
                "title": "929",
                "value": "Joshua 14 (201)",
                "category": "Tanakh",
                "hebrew_title": "929",
                "hebrew_value": "יהושע י״ד (201)"
            },
            {
                "ref": "Mishnah Kelim 9:1-2",
                "title": "Daily Mishnah",
                "value": "Mishnah Kelim 9:1-2",
                "category": "Mishnah",
                "hebrew_title": "משנה יומית",
                "hebrew_value": "משנה כלים
…(truncated, see openapi.json for full schema)
```

### Meta

#### `GET /v1/meta` — Service description & endpoints

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/sefaria-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "service": "sefaria-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/name": "Resolve a reference or name (name=).",
            "GET /v1/text": "A passage in Hebrew & English (ref=, e.g. 'Genesis 1:1').",
            "GET /v1/index": "The library table of contents.",
            "GET /v1/links": "Commentaries & connections on a passage (ref=).",
            "GET /v1/topics": "Topics list, or one topic (slug=).",
            "GET /v1/calendars": "Today's daily-learning calendar."
        },
        "description": "Jewish texts via the Sefaria library: fetch any passage in Hebrew and English (Torah, Talmud, Mishnah, commentaries), resolve a reference or name, browse the table of contents, pull the commentaries and connections on a passage, the daily-learning calendar (Parashat Hashavua, Daf Yomi and more) and topics. Real data, no key."
    },
    "meta": {
        "timestamp": "2026-06-08T01:19:33.350Z",
        "request_id": "d241cfbd-2f25-4fe7-87b5-567b572932d2"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


---
Marketplace page: https://www.oanor.com/api/sefaria-api
OpenAPI spec: https://www.oanor.com/api/sefaria-api/openapi.json