@vonuyvico/supreme-court-elib-sdk

A simple SDK for scraping documents from the Philippine Supreme Court E-Library. Built because there is no public API.

Server-side only. This SDK uses HTTP requests that will fail in browser environments. Use it in Node.js, server actions, API routes, or any server-side runtime only.

Installation

npm install @vonuyvico/supreme-court-elib-sdk

Usage

import { elib, Month } from '@vonuyvico/supreme-court-elib-sdk';

// Get all decisions for a given month and year
const docs = await elib.decisions.getDocumentsByDate(Month.Jan, 2026);

// Get full document content (html + text) by elib_id
const detail = await elib.decisions.getDocumentById('70321');

Document shape

// getDocumentsByDate returns ELibDocument[]
{
  title: string;
  original_identifier_number: string; // e.g. "G.R. No. 266431"
  url: string;
  elib_id: string;
  year: number;
  month: string;
  day: number;
}

// getDocumentById returns ELibDocumentDetail (extends ELibDocument)
{
  ...ELibDocument,
  html: string; // inner HTML of the decision body
  text: string; // plain text of the decision body
}

Month enum

import { Month } from '@vonuyvico/supreme-court-elib-sdk';

Month.Jan // 'Jan'
Month.Feb // 'Feb'
// ...

String month names also work:

await elib.decisions.getDocumentsByDate('january', 2026);