Skip to content

Untitled-Master/Verbi-Back

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Verbi

French Verb Conjugation API

Overview

Verbi is a REST API that provides French verb conjugations by scraping data from leconjugueur.lefigaro.fr. It supports searching for verbs and retrieving full conjugation tables across all tenses and moods.

Features

  • Full verb conjugation retrieval
  • Search/suggestions for verbs
  • Filter by mode (Indicatif, Subjonctif, Conditionnel, Impératif, Infinitif, Participe)
  • Filter by specific tense within a mode

Installation

npm install

Usage

node index.js

The server runs on port 3000 by default.

API Endpoints

Endpoint Description
GET / API information
GET /api/search/:query Search for verbs
GET /api/conjugate/:verb Get all conjugations for a verb
GET /api/conjugate/:verb/:mode Get conjugations for a specific mode
GET /api/conjugate/:verb/:mode/:tense Get conjugations for a specific tense

Examples

# Search for verbs starting with "fair"
curl http://localhost:3000/api/search/fair

# Get all conjugations for "faire"
curl http://localhost:3000/api/conjugate/faire

# Get only Indicatif mode
curl http://localhost:3000/api/conjugate/faire/indicatif

# Get a specific tense
curl http://localhost:3000/api/conjugate/faire/indicatif/present

Tech Stack

  • Express.js
  • Axios
  • Cheerio (HTML scraping)
  • CORS

Releases

No releases published

Packages

 
 
 

Contributors