L

Introduction

API Lyrics Free

Bienvenue sur la documentation de l'API publique Lyrics Free — la base de données collaborative de paroles de chansons africaines, conçue pour alimenter les outils de traduction et de recherche linguistique.

Vue d'ensemble

L'API Lyrics Free expose les données de la plateforme au format JSON-LD (schema.org). Elle permet d'accéder aux chansons publiées, à leurs paroles découpées ligne par ligne, aux traductions validées par la communauté, ainsi qu'à la liste des artistes et des langues disponibles.

L'API est particulièrement adaptée à la construction de corpus linguistiques pour l'entraînement de modèles de traduction automatique sur des paires de langues peu dotées (Fon, Yoruba, Dioula, etc.) vers le Français ou l'Anglais.

Avantages

Base linguistique structurée

Accédez à des paroles de chansons africaines découpées ligne par ligne, avec traductions validées — idéal pour entraîner des modèles de traduction Fon ↔ Français.

Format JSON-LD

Les réponses utilisent le format JSON-LD (schema.org) enrichi du namespace lf:, garantissant une interopérabilité maximale avec les outils du web sémantique.

Simple à intégrer

Une clé API, un en-tête HTTP — c'est tout. Compatible avec n'importe quel langage ou outil capable de faire des requêtes HTTP.

Accès contrôlé

Chaque clé est personnelle et traçable. Limite de 100 requêtes par heure pour garantir la disponibilité du service à tous.

Démarrage rapide

En moins de 2 minutes, effectuez votre première requête :

1Générer une clé API

Connectez-vous et rendez-vous dans Clés API pour créer votre première clé.

2Effectuer votre première requête
curl
curl https://lyricsfree.app/api/v1/songs \
  -H "Authorization: Bearer lf_votre_cle_api"
3Exploiter la réponse JSON-LD
Réponse
{
  "@context": "https://schema.org",
  "@type": "ItemList",
  "numberOfItems": 42,
  "lf:page": 1,
  "lf:totalPages": 3,
  "itemListElement": [
    {
      "@type": "ListItem",
      "position": 1,
      "item": {
        "@type": "MusicRecording",
        "name": "Gbe lɔ",
        "inLanguage": "fon",
        "byArtist": { "name": "Zeynab" }
      }
    }
  ]
}

Prêt à commencer ?

Créez votre clé API et explorez les endpoints disponibles.