vice-city.app
FR

vice-city.app / Développeurs

API vice-city.app :
GTA 6 en JSON

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.

  • 501fiches
  • 11collections
  • EN · FRtous les textes
  • OpenAPI 3.1openapi.json
Request
GET /api/v1/vehicles/grotti-95-cheetah?lang=fr
200 OK
{
  "data": {
    "id": "vehicle.grotti-95-cheetah",
    "type": "vehicle",
    "name": "Grotti '95 Cheetah",
    "attributes": {
      "manufacturer": "Grotti",
      "model": "'95 Cheetah",
      "class": "Sport",
      "inspiration": "Ferrari",
      "seen_in": "Ultimate Edition"
    },
    "relations": [
      {
        "rel": "manufacturer",
        "id": "manufacturer.grotti",
        "name": "Grotti"
      }
    ],
    "reliability": "official",
    "url": "https://vice-city.app/fr/vehicules/grotti-95-cheetah"
  }
}

Démarrage rapide

  1. Faites un premier appel

    La clé vc_demo ne demande aucun compte. Elle renvoie les 5 premiers résultats de chaque liste, assez pour voir le format.

    curl "https://vice-city.app/api/v1/characters?lang=fr" \
      -H "x-api-key: vc_demo"
  2. 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.

  3. Demandez ce qu’il vous faut

    Filtrez, choisissez les champs et la langue dans l’URL. Ceci renvoie les sportives officielles, noms seulement :

    curl "https://vice-city.app/api/v1/vehicles?filter[class]=sport&filter[reliability]=official&fields=name&lang=fr" \
      -H "x-api-key: YOUR_KEY"

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.

  • Requêtes par jour5
  • Résultats par page25
  • Catalogue et recherche✓
  • Français et anglais✓
  • Carte de Leonida (GeoJSON)–
  • Flux des changements–
  • Exports complets (NDJSON)–
  • Usage commercial–
  • API et Premium MadamNazar.io inclus–
Obtenir une clé gratuite

Développeur

4,99 € par mois, ou 39 € par an

Pour les apps, bots et sites qui tournent tous les jours.

  • Requêtes par jour1 000
  • Résultats par page200
  • Catalogue et recherche✓
  • Français et anglais✓
  • Carte de Leonida (GeoJSON)✓
  • Flux des changements✓
  • Exports complets (NDJSON)✓
  • Usage commercial✓
  • API et Premium MadamNazar.io inclus✓
Passer à Développeur

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 :

En-têtes de réponse
RateLimit-Limit: 5
RateLimit-Remaining: 3
RateLimit-Reset: 28412

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.
created_at, updated_at
Dates, pour synchroniser avec /changes.

Collections

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.
curl "https://vice-city.app/api/v1/vehicles?filter[class]=sport&fields=name&limit=3&lang=fr" \
  -H "x-api-key: YOUR_KEY"
200 OK · exemple
{
  "data": [
    {
      "id": "vehicle.bravado-buffalo-course-46",
      "type": "vehicle",
      "name": "Bravado Buffalo (course #46)"
    },
    {
      "id": "vehicle.classic-roadster-36",
      "type": "vehicle",
      "name": "Roadster classique n°36"
    },
    {
      "id": "vehicle.classic-roadster-r-badge",
      "type": "vehicle",
      "name": "Roadster classique (logo R)"
    }
  ],
  "links": {
    "self": "https://vice-city.app/api/v1/vehicles?filter[class]=sport&limit=3",
    "next": "https://vice-city.app/api/v1/vehicles?filter[class]=sport&limit=3&cursor=Mw",
    "next_cursor": "Mw"
  },
  "meta": {
    "api_version": "v1",
    "data_version": "90a83462d68e",
    "plan": "free",
    "total": 4,
    "docs": "https://vice-city.app/developers"
  }
}

GET/{collection}/{slug}

Gratuit

Lire une fiche. Renvoie une fiche avec tous ses champs. Le slug est la dernière partie de son id.

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.
curl "https://vice-city.app/api/v1/characters/jason-duval?lang=fr" \
  -H "x-api-key: YOUR_KEY"
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"
  }
}

Découverte

GET/types

Gratuit

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.

L’exemple montre une collection sur 15.

curl "https://vice-city.app/api/v1/types?lang=fr" \
  -H "x-api-key: YOUR_KEY"
200 OK · exemple
{
  "data": [
    {
      "name": "weapons",
      "type": "weapon",
      "title": "Armes",
      "count": 37,
      "attributes": {
        "category": {
          "type": "text"
        },
        "real_model": {
          "type": "text"
        },
        "seen_in": {
          "type": "text"
        }
      },
      "href": "https://vice-city.app/api/v1/weapons"
    }
  ],
  "meta": {
    "api_version": "v1",
    "data_version": "90a83462d68e",
    "plan": "free",
    "docs": "https://vice-city.app/developers"
  }
}

GET/game

Gratuit

Lire la fiche du jeu. Date de sortie, plateformes, développeur et éditeur.

langen | fr
Une seule langue, en chaînes simples. Sans ce paramètre, vous recevez les deux.
curl "https://vice-city.app/api/v1/game?lang=fr" \
  -H "x-api-key: YOUR_KEY"
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.

curl "https://vice-city.app/api/v1/map/districts?bbox=0,0,2000,3000" \
  -H "x-api-key: YOUR_KEY"
200 OK · exemple
{
  "type": "FeatureCollection",
  "crs": "gta6-world (game units, x east, y north)",
  "features": [
    {
      "type": "Feature",
      "id": "district.ky01",
      "bbox": [
        -9707.6,
        955.6,
        -6684.4,
        4479.8
      ],
      "properties": {
        "code": "KY01",
        "name": "Sandbars & Crude Islands",
        "county": "Kelly County",
        "reliability": "community"
      },
      "geometry": {
        "type": "Polygon",
        "coordinates": [
          [
            [
              -7299.5,
              955.6
            ],
            [
              -7297.2,
              980.4
            ],
            [
              -7296.7,
              1005.2
            ],
            "…"
          ]
        ]
      }
    }
  ],
  "meta": {
    "api_version": "v1",
    "data_version": "90a83462d68e",
    "plan": "developer",
    "total": 109,
    "docs": "https://vice-city.app/developers"
  }
}

GET/changes

Développeur

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.
curl "https://vice-city.app/api/v1/changes?since=2026-11-19&fields=name&lang=fr" \
  -H "x-api-key: YOUR_KEY"
200 OK · exemple
{
  "data": {
    "created": [
      {
        "id": "character.jason-duval",
        "type": "character",
        "name": "Jason Duval"
      }
    ],
    "updated": [],
    "removed": []
  },
  "meta": {
    "api_version": "v1",
    "data_version": "90a83462d68e",
    "plan": "developer",
    "since": "2026-11-19",
    "total": 1,
    "docs": "https://vice-city.app/developers"
  }
}

GET/export/{collection}

Développeur

Exporter une collection. Toute la collection en un appel, en NDJSON : une fiche JSON par ligne, simple à charger dans une base.

langen | fr
Une seule langue, en chaînes simples. Sans ce paramètre, vous recevez les deux.

La réponse est en application/x-ndjson. L’exemple montre une ligne, indentée pour la lecture.

curl "https://vice-city.app/api/v1/export/vehicles?lang=fr" \
  -H "x-api-key: YOUR_KEY"
200 OK · exemple
{
  "id": "vehicle.grotti-95-cheetah",
  "type": "vehicle",
  "name": "Grotti '95 Cheetah",
  "attributes": {
    "manufacturer": "Grotti",
    "model": "'95 Cheetah",
    "class": "Sport",
    "inspiration": "Ferrari",
    "seen_in": "Ultimate Edition"
  },
  "reliability": "official"
}

Cache

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.

curl
curl "https://vice-city.app/api/v1/weapons" \
  -H "x-api-key: YOUR_KEY" \
  -H 'If-None-Match: "ArBkgtbVqGOZaazeWq6yboZlsDE"'

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_query invalid_sort invalid_cursor invalid_bbox invalid_since invalid_lang
Un paramètre est faux. detail dit lequel et donne un exemple valide.
401
missing_api_key invalid_api_key
Clé absente, ou clé inconnue.
403
plan_upgrade_required
Endpoint Développeur appelé avec une clé Gratuit.
403
subscription_inactive demo_key
L’abonnement lié à la clé est terminé, ou la clé de démo a demandé une deuxième page.
404
unknown_collection not_found unknown_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.

Tapez pour chercher dans toute la base