501 fiches sur les personnages, lieux, véhicules, armes, activités et radios de Leonida, en français et en anglais. Un seul format pour tout, une clé gratuite, et la carte en GeoJSON.
const res = await fetch("https://vice-city.app/api/v1/characters?lang=fr", {
headers: { "x-api-key": "vc_demo" },
});
const { data, meta } = await res.json();
import requests
res = requests.get(
"https://vice-city.app/api/v1/characters?lang=fr",
headers={"x-api-key": "vc_demo"},
)
data = res.json()["data"]
Obtenez votre clé
Connectez-vous à votre compte MadamNazar.io et ouvrez la section Developer API. Votre clé commence par mn_live_. vice-city.app est édité par la même équipe : la même clé fonctionne sur les deux API.
Demandez ce qu’il vous faut
Filtrez, choisissez les champs et la langue dans l’URL. Ceci renvoie les sportives officielles, noms seulement :
const res = await fetch("https://vice-city.app/api/v1/vehicles?filter[class]=sport&filter[reliability]=official&fields=name&lang=fr", {
headers: { "x-api-key": "YOUR_KEY" },
});
const { data, meta } = await res.json();
import requests
res = requests.get(
"https://vice-city.app/api/v1/vehicles?filter[class]=sport&filter[reliability]=official&fields=name&lang=fr",
headers={"x-api-key": "YOUR_KEY"},
)
data = res.json()["data"]
Authentification
Envoyez votre clé à chaque requête, dans l’en-tête x-api-key. Authorization: Bearer … fonctionne aussi.
Header
x-api-key: mn_live_xxxxxxxxxxxxxxxxxxxxxxxx
L’API accepte les appels depuis un navigateur (CORS ouvert), mais une clé dans du code front est visible par tous. Appelez l’API depuis votre serveur, ou mettez-y les réponses en cache.
URL de base : https://vice-city.app/api/v1
Offres et limites
Gratuit
0 €
Pour essayer l’API et pour les petits projets personnels.
Les requêtes sont comptées par clé et par jour, et le compteur repart à zéro à 00:00 UTC. Les appels à cette API et à l’API MadamNazar.io sont comptés séparément. Chaque réponse vous dit où vous en êtes :
Avec 5 requêtes par jour, une clé gratuite sert à tester : demandez 25 fiches par appel et gardez les réponses. Les données changent quelques fois par jour au plus.
Modèle de données
Un personnage, une voiture et un bar ont tous la même forme. Apprenez-la une fois : toutes les collections se lisent pareil, y compris celles ajoutées après la sortie.
id
Stable et jamais réutilisé, type.slug. C’est lui qu’il faut stocker.
name, summary
Textes traduits.
attributes
Ce qui est propre au type : la classe d’un véhicule, le modèle réel d’une arme. /types les liste.
relations
Liens typés vers d’autres fiches, avec leur nom et leur adresse.
reliability
official (montré ou nommé par Rockstar), press ou community. Les fuites et les rumeurs ne sont jamais dans l’API.
verified_in_game
Passe à true une fois la fiche vérifiée dans le jeu, à partir du 19 novembre 2026.
spoiler
Contenu lié à l’histoire. Absent des listes, sauf avec spoilers=true.
sources
Les pages dont la fiche provient.
url
La page de la fiche sur vice-city.app, pour faire un lien.
Déclarées et vides jusqu’à la sortie, puis remplies depuis le jeu : /missions/collectibles/trophies/cheats.
Langues
Chaque texte traduit existe en français et en anglais. Par défaut vous recevez les deux, pratique pour une app bilingue ou une copie locale :
200 OK · sans lang
{
"id": "character.jason-duval",
"name": {
"en": "Jason Duval",
"fr": "Jason Duval"
},
"summary": {
"en": "Playable protagonist. Former soldier now working for smugglers in the Keys; Brian's employee and tenant in Key Lento.",
"fr": "Protagoniste jouable. Ancien militaire, travaille pour des trafiquants des Keys ; employé et locataire de Brian à Key Lento."
}
}
Ajoutez lang=fr et les mêmes champs deviennent des chaînes simples :
200 OK · lang=fr
{
"id": "character.jason-duval",
"name": "Jason Duval",
"summary": "Protagoniste jouable. Ancien militaire, travaille pour des trafiquants des Keys ; employé et locataire de Brian à Key Lento."
}
Référence de l’API
Tous les endpoints sont en GET et commencent par https://vice-city.app/api/v1. Les réponses sont du JSON avec un champ data et un champ meta. Les boutons Lancer appellent la vraie API avec la clé de démo.
Catalogue
GET/{collection}
Gratuit
Lister une collection. Renvoie les fiches d’une collection, triées par nom, avec filtres et pagination.
langen | fr
Une seule langue, en chaînes simples. Sans ce paramètre, vous recevez les deux.
limit1–25 · 1–200
Taille de page. Jusqu’à 25 avec une clé Gratuit, 200 avec une clé Développeur.
cursorstring
Valeur de links.next_cursor de la page précédente.
filter[…]string
Garde les fiches qui correspondent à un champ, un attribut ou une relation : filter[class]=sport, filter[reliability]=official, filter[region]=vice-city. Répétez pour combiner.
qstring
Garde les fiches dont le nom ou le résumé contient ce texte.
sortname | updated_at | created_at
Préfixez par - pour l’ordre décroissant.
fieldsliste
Champs de premier niveau à garder, séparés par des virgules : fields=name,attributes.
const res = await fetch("https://vice-city.app/api/v1/characters/jason-duval?lang=fr", {
headers: { "x-api-key": "YOUR_KEY" },
});
const { data, meta } = await res.json();
import requests
res = requests.get(
"https://vice-city.app/api/v1/characters/jason-duval?lang=fr",
headers={"x-api-key": "YOUR_KEY"},
)
data = res.json()["data"]
200 OK · exemple
{
"data": {
"id": "character.jason-duval",
"type": "character",
"name": "Jason Duval",
"summary": "Protagoniste jouable. Ancien militaire, travaille pour des trafiquants des Keys ; employé et locataire de Brian à Key Lento.",
"attributes": {
"alias": null,
"group": "Protagonistes",
"appearances": "Trailer 2, Extended Look, trailer de lancement, jaquette, bio Rockstar",
"voice": null
},
"reliability": "official",
"verified_in_game": false,
"sources": [
{
"url": "https://www.rockstargames.com/VI",
"site": "rockstargames.com"
}
],
"url": "https://vice-city.app/fr/personnages/jason-duval",
"updated_at": "2026-11-16"
},
"meta": {
"api_version": "v1",
"data_version": "90a83462d68e",
"plan": "free",
"docs": "https://vice-city.app/developers"
}
}
GET/{collection}/{slug}/related
Gratuit
Lire les fiches liées. Renvoie les fiches vers lesquelles celle-ci pointe et celles qui pointent vers elle. Pour une région : ses quartiers et ses enseignes.
langen | fr
Une seule langue, en chaînes simples. Sans ce paramètre, vous recevez les deux.
limit1–25 · 1–200
Nombre de fiches à renvoyer.
fieldsliste
Champs de premier niveau à garder, séparés par des virgules : fields=name,attributes.
Chercher partout. Cherche dans toutes les collections à la fois, en français et en anglais, sans tenir compte des accents. Les noms d’abord, puis les résumés et les attributs.
qstring, obligatoire
Au moins 2 caractères.
langen | fr
Une seule langue, en chaînes simples. Sans ce paramètre, vous recevez les deux.
limit1–25 · 1–200
Nombre de résultats à renvoyer.
fieldsliste
Champs de premier niveau à garder, séparés par des virgules : fields=name,attributes.
Lister les collections et leurs champs. Renvoie chaque collection avec son nombre de fiches et les attributs de son type. Lisez-le au démarrage : votre code découvre seul les nouvelles collections (missions, objets à collectionner…).
langen | fr
Une seule langue, en chaînes simples. Sans ce paramètre, vous recevez les deux.
const res = await fetch("https://vice-city.app/api/v1/game?lang=fr", {
headers: { "x-api-key": "YOUR_KEY" },
});
const { data, meta } = await res.json();
import requests
res = requests.get(
"https://vice-city.app/api/v1/game?lang=fr",
headers={"x-api-key": "YOUR_KEY"},
)
data = res.json()["data"]
200 OK · exemple
{
"data": {
"title": "Grand Theft Auto VI",
"developer": "Rockstar Games",
"publisher": "Take-Two Interactive",
"release_date": "2026-11-19",
"platforms": [
"PlayStation 5",
"Xbox Series X|S"
],
"setting": "L'État de Leonida, où se trouve Vice City",
"official_site": "https://www.rockstargames.com/VI"
},
"meta": {
"api_version": "v1",
"data_version": "90a83462d68e",
"plan": "free",
"docs": "https://vice-city.app/developers"
}
}
Offre Développeur
GET/map/{layer}
Développeur
Lire une couche de carte. GeoJSON de la carte de Leonida. districts contient 109 contours, landmarks 3334 points avec leurs tags et leur équivalent réel.
layerdistricts | landmarks
Dans le chemin.
bboxminX,minY,maxX,maxY
Seulement les éléments qui touchent ce rectangle, en unités du jeu.
tagstring
Repères uniquement : tag=hotel.
Les coordonnées sont en unités du jeu (x vers l’est, y vers le nord), pas en latitude et longitude. Cette couche vient du projet communautaire gtadb.org (CC BY 4.0) : elle n’est pas confirmée par Rockstar.
Lire les changements. Fiches créées, modifiées ou supprimées depuis une date. Un appel par jour suffit pour garder une copie locale à jour sans tout retélécharger.
sincedate, obligatoire
YYYY-MM-DD
langen | fr
Une seule langue, en chaînes simples. Sans ce paramètre, vous recevez les deux.
fieldsliste
Champs de premier niveau à garder, séparés par des virgules : fields=name,attributes.
Les données ne changent que lorsque nous publions une mise à jour : mettez-les en cache. Chaque réponse porte un ETag : renvoyez-le dans If-None-Match et vous recevez un 304 vide si rien n’a changé. meta.data_version change à chaque mise à jour des données.
Un 304 compte quand même comme une requête. Vérifiez data_version avec /game, l’appel le plus léger, avant de rafraîchir toute une copie.
Erreurs
Les erreurs suivent la RFC 9457 (application/problem+json). Testez code, qui ne change jamais, et affichez detail, qui dit quoi faire. Donnez-nous instance si vous nous écrivez pour un problème.
429 Too Many Requests
{
"type": "https://vice-city.app/developers#errors",
"title": "Daily limit reached",
"status": 429,
"detail": "This key allows 5 requests a day on this API. The counter resets at 00:00 UTC.",
"code": "rate_limited",
"instance": "cdg1::abcde-1794845763624"
}
400
invalid_queryinvalid_sortinvalid_cursorinvalid_bboxinvalid_sinceinvalid_lang Un paramètre est faux. detail dit lequel et donne un exemple valide.
401
missing_api_keyinvalid_api_key Clé absente, ou clé inconnue.
403
plan_upgrade_required Endpoint Développeur appelé avec une clé Gratuit.
403
subscription_inactivedemo_key L’abonnement lié à la clé est terminé, ou la clé de démo a demandé une deuxième page.
404
unknown_collectionnot_foundunknown_layer Rien à cette adresse.
429
rate_limited Limite quotidienne atteinte. Retry-After donne les secondes avant 00:00 UTC.
503
keys_unavailable Les clés ne peuvent pas être vérifiées pour l’instant. Réessayez dans une minute.
Conditions
Avec une clé Gratuit, l’usage reste non commercial et affiche un crédit visible « Données : vice-city.app » avec un lien.
Une clé Développeur autorise l’usage commercial. Le crédit est apprécié, pas obligatoire.
Les données de carte doivent aussi créditer gtadb.org (CC BY 4.0).
Ne revendez pas et ne republiez pas les exports tels quels.
L’API ne sert aucune image ni aucun contenu issu de fuites.
vice-city.app n’est ni affilié à Rockstar Games ou Take-Two Interactive, ni approuvé ou sponsorisé par eux. Une question ou un bug : contact@lucasbonomi.com.
Everything in Excess★Gateway to Paradise★Live Hard★Wild, Wild Country★Only in Leonida★Everything in Excess★Gateway to Paradise★Live Hard★Wild, Wild Country★Only in Leonida★Everything in Excess★Gateway to Paradise★Live Hard★Wild, Wild Country★Only in Leonida★Everything in Excess★Gateway to Paradise★Live Hard★Wild, Wild Country★Only in Leonida★
Nous utilisons Google Analytics pour compter les visites et améliorer le site. D’accord ? Confidentialité