📅 Daf Yomi API Documentation

This API provides information about the current Daf Yomi (daily Talmud study page), including the masechta (tractate), daf number, cycle information, and upcoming masechta schedule.

🔗 Base URL

https://www.shas.org/daf-yomi-api/

📋 Endpoint

📝 Request Parameters

📤 Response Format

application/json

✅ Example Response

GET /

{
    "current_daf": {
        "masechta": "Berachos",
        "key": "berachos",
        "daf": 15
    },
    "cycle": {
        "number": 14,
        "label": "14th cycle"
    },
    "next_masechta": {
        "name": "Shabbos",
        "key": "shabbos",
        "starts": "2025-02-10"
    },
    "date": "2024-06-15"
}

📖 Masechta Order

The Daf Yomi follows this order through the Babylonian Talmud:

🔧 Integration Examples

JavaScript/Fetch API

// Fetch current Daf Yomi
async function getCurrentDaf() {
    const response = await fetch('https://www.shas.org/daf-yomi-api/');
    const data = await response.json();
    
    console.log(`Today's Daf: ${data.current_daf.masechta} ${data.current_daf.daf}`);
    console.log(`Cycle: ${data.cycle.label}`);
    console.log(`Next: ${data.next_masechta.name} starts ${data.next_masechta.starts}`);
    
    return data;
}

// Fetch Daf Yomi for a specific date
async function getDafForDate(dateString) {
    const response = await fetch(`https://www.shas.org/daf-yomi-api/?date=${dateString}`);
    const data = await response.json();
    
    console.log(`Daf on ${data.date}: ${data.current_daf.masechta} ${data.current_daf.daf}`);
    
    return data;
}

getCurrentDaf();
getDafForDate('2023-09-15');

jQuery

// Display Daf Yomi on your webpage
$.getJSON('https://www.shas.org/daf-yomi-api/', function(data) {
    $('#daf-display').html(
        data.current_daf.masechta + ' ' + data.current_daf.daf
    );
    $('#cycle-info').text(data.cycle.label);
});

// Get daf for a specific date
$.getJSON('https://www.shas.org/daf-yomi-api/?date=2023-09-15', function(data) {
    console.log('Daf on ' + data.date + ': ' + data.current_daf.masechta + ' ' + data.current_daf.daf);
});

PHP/cURL

// Fetch Daf Yomi in PHP
$ch = curl_init('https://www.shas.org/daf-yomi-api/');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
echo "Today's Daf: " . $data['current_daf']['masechta'] . " " . $data['current_daf']['daf'];

// Get daf for specific date
$date = '2023-09-15';
$ch = curl_init("https://www.shas.org/daf-yomi-api/?date=$date");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
echo "Daf on $date: " . $data['current_daf']['masechta'] . " " . $data['current_daf']['daf'];

Python

import requests
from datetime import datetime, timedelta

# Get current Daf Yomi
response = requests.get('https://www.shas.org/daf-yomi-api/')
data = response.json()

print(f"Today's Daf: {data['current_daf']['masechta']} {data['current_daf']['daf']}")
print(f"Cycle: {data['cycle']['label']}")
print(f"Next: {data['next_masechta']['name']} starts {data['next_masechta']['starts']}")

# Get daf for a specific date
date = '2023-09-15'
response = requests.get(f'https://www.shas.org/daf-yomi-api/?date={date}')
data = response.json()

print(f"Daf on {data['date']}: {data['current_daf']['masechta']} {data['current_daf']['daf']}")

# Get daf for yesterday
yesterday = (datetime.now() - timedelta(days=1)).strftime('%Y-%m-%d')
response = requests.get(f'https://www.shas.org/daf-yomi-api/?date={yesterday}')
data = response.json()

print(f"Yesterday's Daf: {data['current_daf']['masechta']} {data['current_daf']['daf']}")

🎯 Live Demo

💡 Use Cases

• Synagogue Websites: Display the current daf on your shul's website
• Study Apps: Integrate with learning applications to show daily progress
• Email Reminders: Send daily daf notifications to subscribers
• Calendar Integration: Sync Daf Yomi schedule with digital calendars
• Progress Tracking: Build applications that track individual or community learning progress
• Historical Lookups: Check which daf was learned on any date in the past
• Future Planning: See what daf will be studied on any future date
• PDF Integration: Combine with the Daf PDF API to display both info and content

🔄 Combining with PDF API

You can combine this API with the Daf PDF API to create a complete Daf Yomi viewer:

async function displayTodaysDaf() {
    // Get current daf info
    const infoResponse = await fetch('daf-yomi-api/');
    const info = await infoResponse.json();
    
    // Convert masechta name to lowercase with hyphens for PDF API
    const masechta = info.current_daf.masechta
        .toLowerCase()
        .replace(/\s+/g, '-')
        .replace(/'/g, '');
    
    // Build PDF URL
    const pdfUrl = `api/?masechta=${masechta}&daf=${info.current_daf.daf}&amud=a`;
    
    // Display info
    document.getElementById('daf-title').textContent = 
        `${info.current_daf.masechta} ${info.current_daf.daf}`;
    
    // Load PDF
    document.getElementById('pdf-viewer').src = pdfUrl;
    
    // Show next masechta
    document.getElementById('next-info').textContent = 
        `Next: ${info.next_masechta.name} (${info.next_masechta.starts})`;
}

displayTodaysDaf();

❌ Error Responses

{
    "error": "Invalid date format",
    "message": "Date must be in YYYY-MM-DD format (e.g., 2025-01-15)"
}

{
    "error": "Invalid date",
    "message": "The date 2025-02-30 is not a valid calendar date"
}

⚠️ Important Notes

• Time Zone: The API uses server time to calculate the current daf when no date parameter is provided. Ensure your server is set to the correct timezone for accurate results.
• Date Parameter: When using the date parameter, provide dates in YYYY-MM-DD format (ISO 8601). The calculation is timezone-agnostic for specific dates.
• Historical Dates: You can query any date back to the start of Daf Yomi (September 11, 1923) or into the future.
• Daf Numbering: Dapim start from 2 (Talmudic convention), not 1.
• Cycle History: The first cycle began on September 11, 1923 (11 Elul 5683).
• No Caching Required: The API is lightweight and can be called frequently without performance concerns.
• CORS Enabled: The API includes proper CORS headers for cross-origin requests.

🔗 Related Resources

• Daf PDF Viewer API - Access the actual PDF files