501 entries on Leonida’s characters, locations, vehicles, weapons, activities and radio stations, in English and French. One format for everything, a free key, and a map as GeoJSON.
const res = await fetch("https://vice-city.app/api/v1/characters?lang=en", {
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=en",
headers={"x-api-key": "vc_demo"},
)
data = res.json()["data"]
Get your own key
Sign in to your MadamNazar.io account and open the Developer API section. Your key starts with mn_live_. vice-city.app is run by the same team, so the same key works on both APIs.
Ask for what you need
Filter, pick fields and choose a language in the URL. This returns the official sports cars, names only:
const res = await fetch("https://vice-city.app/api/v1/vehicles?filter[class]=sport&filter[reliability]=official&fields=name&lang=en", {
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=en",
headers={"x-api-key": "YOUR_KEY"},
)
data = res.json()["data"]
Authentication
Send your key with every request, in the x-api-key header. Authorization: Bearer … works too.
Header
x-api-key: mn_live_xxxxxxxxxxxxxxxxxxxxxxxx
The API accepts calls from a browser (CORS is open), but a key in front-end code is visible to everyone. Call the API from your server, or cache the answers there.
Requests are counted per key and per day, and the counter resets at 00:00 UTC. Calls to this API and to the MadamNazar.io API are counted separately. Every answer tells you where you stand:
Declared and empty until the game is out, then filled from the game : /missions/collectibles/trophies/cheats.
Languages
Every translated text comes in English and French. By default you get both, which suits a bilingual app or a local copy:
200 OK · without 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."
}
}
Add lang=en and the same fields become plain strings:
200 OK · lang=en
{
"id": "character.jason-duval",
"name": "Jason Duval",
"summary": "Playable protagonist. Former soldier now working for smugglers in the Keys; Brian's employee and tenant in Key Lento."
}
API reference
All endpoints are GET and start with https://vice-city.app/api/v1. Answers are JSON with a data field and a meta field. The Run buttons call the live API with the demo key.
Catalogue
GET/{collection}
Free
List a collection. Returns the entries of one collection, sorted by name, with filters and paging.
langen | fr
One language as plain strings. Leave it out to get both.
limit1–25 · 1–200
Page size. Up to 25 with a Free key, 200 with a Developer key.
cursorstring
Value of links.next_cursor from the previous page.
filter[…]string
Keep entries matching a field, an attribute or a relation: filter[class]=sport, filter[reliability]=official, filter[region]=vice-city. Repeat to combine.
qstring
Keep entries whose name or summary contains this text.
sortname | updated_at | created_at
Prefix with - for descending order.
fieldslist
Top-level fields to keep, comma-separated: fields=name,attributes.
List collections and their fields. Returns every collection with its entry count and the attributes of its type. Read it at startup and your code picks up new collections (missions, collectibles…) on its own.
langen | fr
One language as plain strings. Leave it out to get both.
const res = await fetch("https://vice-city.app/api/v1/game?lang=en", {
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=en",
headers={"x-api-key": "YOUR_KEY"},
)
data = res.json()["data"]
200 OK · example
{
"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": "The state of Leonida, home of Vice City",
"official_site": "https://www.rockstargames.com/VI"
},
"meta": {
"api_version": "v1",
"data_version": "90a83462d68e",
"plan": "free",
"docs": "https://vice-city.app/developers"
}
}
Developer plan
GET/map/{layer}
Developer
Get a map layer. GeoJSON for the map of Leonida. districts has 109 outlines, landmarks has 3,334 points with tags and their real-world counterpart.
layerdistricts | landmarks
In the path.
bboxminX,minY,maxX,maxY
Only features touching this box, in game units.
tagstring
Landmarks only: tag=hotel.
Coordinates are in-game units (x east, y north), not latitude and longitude. This layer comes from the gtadb.org community project (CC BY 4.0): it is not confirmed by Rockstar.
Get what changed. Entries created, edited or removed since a date. Call it once a day to keep a local copy in sync without downloading everything again.
sincedate, required
YYYY-MM-DD
langen | fr
One language as plain strings. Leave it out to get both.
fieldslist
Top-level fields to keep, comma-separated: fields=name,attributes.
The data only changes when we publish an update, so cache it. Every answer has an ETag: send it back in If-None-Match and you get an empty 304 when nothing changed. meta.data_version changes with every update of the dataset.
A 304 still counts as a request. Check data_version with /game, the lightest call, before refreshing a whole copy.
Errors
Errors follow RFC 9457 (application/problem+json). Branch on code, which never changes, and show detail, which says what to do. Give us instance if you write about a problem.
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 A parameter is wrong. detail says which one and gives a valid example.
401
missing_api_keyinvalid_api_key No key, or a key we don’t know.
403
plan_upgrade_required A Developer endpoint called with a Free key.
403
subscription_inactivedemo_key The subscription behind the key has ended, or the demo key was asked for a second page.
404
unknown_collectionnot_foundunknown_layer Nothing at this address.
429
rate_limited Daily limit reached. Retry-After gives the seconds until 00:00 UTC.
503
keys_unavailable Keys can’t be checked right now. Retry in a minute.
Terms of use
With a Free key, the use stays non-commercial and shows a visible “Data: vice-city.app” credit with a link.
A Developer key allows commercial use. The credit is appreciated, not required.
Map data must also credit gtadb.org (CC BY 4.0).
Don’t resell or republish the exports as they are.
The API serves no image and no leaked content.
vice-city.app is not affiliated with, endorsed by or sponsored by Rockstar Games or Take-Two Interactive. A question or a 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★
We use Google Analytics to count visits and improve the site. OK with you? Privacy