API REST publique v1

Documentation de l'API

L'API Talents2Kin vous donne accès au répertoire complet des artistes congolais — discographies, vidéos, provinces, et plus encore. Gratuit, sans clé API, sans carte bancaire.

Gratuit & public Pas de clé API Lecture seule JSON · REST

URL de base

https://talents2kin.com/api/v1

Toutes les requêtes doivent être faites en HTTPS. Les réponses sont encodées en UTF-8, format JSON.

Authentification

Lecture publique

Les endpoints GETsont entièrement publics. Aucune clé, aucun header d'authentification requis.

Écriture (admin)

Les endpoints POST / PATCH / DELETE nécessitent un compte administrateur.

Codes d'erreur

Code	Signification
`200`	Succès
`400`	Paramètre invalide ou données malformées
`401`	Non authentifié (route admin uniquement)
`404`	Ressource introuvable
`500`	Erreur interne du serveur

Les erreurs retournent toujours un objet { "error": "message" }.

Limites de taux

L'API est actuellement non limitée. Pour des projets à fort volume, pensez à mettre en cache les résultats côté client (TTL recommandé : 5–10 minutes). Des limites pourront être appliquées à l'avenir sans préavis.

Artists

Répertoire complet des artistes congolais.

GET/api/v1/artists

Lister les artistes avec pagination, recherche et filtres.

Paramètres

Nom	Type	Description
`page`	`number`	Numéro de page (défaut : 1)
`limit`	`number`	Résultats par page (max 100, défaut : 20)
`search`	`string`	Recherche par nom de scène
`province`	`string`	Filtre province (ex: KINSHASA)
`category`	`string`	Filtre catégorie (ex: MUSIQUE)
`claimStatus`	`string`	Filtre statut (UNCLAIMED \| CLAIMED \| VERIFIED)

Réponse

{
  "data": [
    {
      "id": "cmo761f4c000014f1…",
      "slug": "fally-ipupa",
      "stageName": "Fally Ipupa",
      "realName": "Fally Ipupa Control",
      "category": "MUSIQUE",
      "province": "KINSHASA",
      "claimStatus": "VERIFIED",
      "photoUrl": "https://…",
      "spotifyArtistId": "6IflU2YrY5Cyw7YoBICosV",
      "createdAt": "2024-01-15T10:00:00.000Z",
      "updatedAt": "2024-03-20T14:22:00.000Z"
    }
  ],
  "meta": {
    "total": 142,
    "page": 1,
    "limit": 20,
    "totalPages": 8
  }
}

Exemple cURL

curl "https://talents2kin.com/api/v1/artists?province=KINSHASA&category=MUSIQUE&limit=10"

GET/api/v1/artists/:id

Récupérer un artiste par son ID ou slug. Inclut les comptages (albums, pistes, vidéos).

Paramètres

Nom	Type	Description
`id`req.	`string`	ID ou slug de l'artiste

Réponse

{
  "data": {
    "id": "cmo761f4c000014f1…",
    "slug": "fally-ipupa",
    "stageName": "Fally Ipupa",
    "bio": "Fally Ipupa Control est un chanteur…",
    "category": "MUSIQUE",
    "province": "KINSHASA",
    "claimStatus": "VERIFIED",
    "photoUrl": "https://…",
    "bannerUrl": "https://…",
    "socialLinks": { "spotify": "…", "instagram": "…" },
    "spotifyArtistId": "6IflU2YrY5Cyw7YoBICosV",
    "youtubeChannelId": "UCxxx",
    "_count": { "albums": 18, "tracks": 241, "youtubeVideos": 67 }
  }
}

Exemple cURL

curl "https://talents2kin.com/api/v1/artists/fally-ipupa"

Tracks

Pistes musicales par artiste.

GET/api/v1/artists/:id/tracks

Lister toutes les pistes d'un artiste, triées par popularité.

Paramètres

Nom	Type	Description
`id`req.	`string`	ID ou slug de l'artiste

Réponse

{
  "data": [
    {
      "id": "clk9…",
      "title": "Survivor",
      "slug": "survivor",
      "durationMs": 252480,
      "previewUrl": "https://p.scdn.co/mp3-preview/…",
      "spotifyPopularity": 72,
      "isTopTrack": true,
      "geniusSongId": "12345",
      "geniusSongUrl": "https://genius.com/…",
      "lyricsText": null,
      "albumId": "clk8…"
    }
  ]
}

Exemple cURL

curl "https://talents2kin.com/api/v1/artists/fally-ipupa/tracks"

Videos

Vidéos YouTube importées pour chaque artiste.

GET/api/v1/artists/:id/videos

Lister les vidéos YouTube d'un artiste, triées par vues décroissantes.

Paramètres

Nom	Type	Description
`id`req.	`string`	ID ou slug de l'artiste

Réponse

{
  "data": [
    {
      "id": "cll1…",
      "youtubeVideoId": "dQw4w9WgXcQ",
      "title": "Fally Ipupa - Eza ft. …",
      "description": "…",
      "thumbnailUrl": "https://i.ytimg.com/vi/…/hqdefault.jpg",
      "publishedAt": "2023-06-15T00:00:00.000Z",
      "viewCount": "48200000"
    }
  ]
}

Exemple cURL

curl "https://talents2kin.com/api/v1/artists/fally-ipupa/videos"

Provinces

Les 26 provinces de la République Démocratique du Congo.

GET/api/v1/provinces

Lister toutes les provinces avec le nombre d'artistes par province.

Réponse

{
  "data": [
    {
      "value": "KINSHASA",
      "label": "Kinshasa",
      "slug": "kinshasa",
      "artistCount": 87
    },
    {
      "value": "NORD_KIVU",
      "label": "Nord-Kivu",
      "slug": "nord-kivu",
      "artistCount": 23
    }
  ]
}

Exemple cURL

curl "https://talents2kin.com/api/v1/provinces"

Insights catalogue

Agrégats publics (vues de fiches, albums, morceaux, provinces, catégories) — alignés sur la page /chiffres.

GET/api/v1/insights

Un seul JSON avec totaux et listes de classements. Mis en cache côté CDN (s-maxage 300s).

Réponse

{
  "generatedAt": "2026-04-21T12:00:00.000Z",
  "totals": {
    "artistCount": 120,
    "albumCount": 340,
    "trackCount": 2100,
    "albumsWithDate": 280
  },
  "mostViewedArtists": [
    { "slug": "…", "stageName": "…", "photoUrl": null, "value": 420, "label": "vues" }
  ],
  "provincesByArtistCount": [
    { "label": "Kinshasa", "href": "/provinces/kinshasa", "value": 40, "valueLabel": "artistes" }
  ],
  "categoriesByArtistCount": [],
  "artistsWithMostAlbums": [],
  "artistsWithMostTracks": [],
  "albumsWithMostTracks": [],
  "albumsWithMostLyricTracks": [],
  "longestAlbumsByDuration": [],
  "albumsPerReleaseYear": []
}

Exemple cURL

curl "https://talents2kin.com/api/v1/insights"

Valeurs : Catégories

Utilisé pour le paramètre category.

MUSIQUECINEMACOMEDIEDANSETHEATRERADIO_TVMODESPORTLITTERATUREARTS_VISUELSAUTRE

Valeurs : Provinces

Utilisé pour le paramètre province.

KINSHASAKONGO_CENTRALKWANGOKWILUMAI_NDOMBEKASAIKASAI_CENTRALKASAI_ORIENTALLOMAMISANKURUMANIEMASUD_KIVUNORD_KIVUITURIHAUT_UELETSHOPOBAS_UELENORD_UBANGIMONGALASUD_UBANGIEQUATEURTSHUAPATANGANYIKAHAUT_LOMAMILUALABAHAUT_KATANGA

Une question ? Un projet ?

Explorez le répertoire complet des artistes ou créez votre compte pour contribuer à la plateforme.

Explorer les artistes Créer un compte

Code

Signification

200

Succès

400

Paramètre invalide ou données malformées

401

Non authentifié (route admin uniquement)

404

Ressource introuvable

500

Erreur interne du serveur

Nom

Type

Description

page

number

Numéro de page (défaut : 1)

limit

number

Résultats par page (max 100, défaut : 20)

search

string

Recherche par nom de scène

province

string

Filtre province (ex: KINSHASA)

category

string

Filtre catégorie (ex: MUSIQUE)

claimStatus

string

Filtre statut (UNCLAIMED | CLAIMED | VERIFIED)

{ "data": [ { "id": "cmo761f4c000014f1…", "slug": "fally-ipupa", "stageName": "Fally Ipupa", "realName": "Fally Ipupa Control", "category": "MUSIQUE", "province": "KINSHASA", "claimStatus": "VERIFIED", "photoUrl": "https://…", "spotifyArtistId": "6IflU2YrY5Cyw7YoBICosV", "createdAt": "2024-01-15T10:00:00.000Z", "updatedAt": "2024-03-20T14:22:00.000Z" } ], "meta": { "total": 142, "page": 1, "limit": 20, "totalPages": 8 } }

Nom

Type

Description

idreq.

string

ID ou slug de l'artiste

{ "data": { "id": "cmo761f4c000014f1…", "slug": "fally-ipupa", "stageName": "Fally Ipupa", "bio": "Fally Ipupa Control est un chanteur…", "category": "MUSIQUE", "province": "KINSHASA", "claimStatus": "VERIFIED", "photoUrl": "https://…", "bannerUrl": "https://…", "socialLinks": { "spotify": "…", "instagram": "…" }, "spotifyArtistId": "6IflU2YrY5Cyw7YoBICosV", "youtubeChannelId": "UCxxx", "_count": { "albums": 18, "tracks": 241, "youtubeVideos": 67 } } }

Nom

Type

Description

idreq.

string

ID ou slug de l'artiste

{ "data": [ { "id": "clk9…", "title": "Survivor", "slug": "survivor", "durationMs": 252480, "previewUrl": "https://p.scdn.co/mp3-preview/…", "spotifyPopularity": 72, "isTopTrack": true, "geniusSongId": "12345", "geniusSongUrl": "https://genius.com/…", "lyricsText": null, "albumId": "clk8…" } ] }

Nom

Type

Description

idreq.

string

ID ou slug de l'artiste

{ "data": [ { "id": "cll1…", "youtubeVideoId": "dQw4w9WgXcQ", "title": "Fally Ipupa - Eza ft. …", "description": "…", "thumbnailUrl": "https://i.ytimg.com/vi/…/hqdefault.jpg", "publishedAt": "2023-06-15T00:00:00.000Z", "viewCount": "48200000" } ] }

{ "data": [ { "value": "KINSHASA", "label": "Kinshasa", "slug": "kinshasa", "artistCount": 87 }, { "value": "NORD_KIVU", "label": "Nord-Kivu", "slug": "nord-kivu", "artistCount": 23 } ] }

{ "generatedAt": "2026-04-21T12:00:00.000Z", "totals": { "artistCount": 120, "albumCount": 340, "trackCount": 2100, "albumsWithDate": 280 }, "mostViewedArtists": [ { "slug": "…", "stageName": "…", "photoUrl": null, "value": 420, "label": "vues" } ], "provincesByArtistCount": [ { "label": "Kinshasa", "href": "/provinces/kinshasa", "value": 40, "valueLabel": "artistes" } ], "categoriesByArtistCount": [], "artistsWithMostAlbums": [], "artistsWithMostTracks": [], "albumsWithMostTracks": [], "albumsWithMostLyricTracks": [], "longestAlbumsByDuration": [], "albumsPerReleaseYear": [] }