vice-city.app
EN

vice-city.app / Developers

vice-city.app API:
GTA 6 data as JSON

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.

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

Quick start

  1. Make a first call

    The vc_demo key needs no account. It returns the first 5 results of each list, which is enough to see the format.

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

  3. Ask for what you need

    Filter, pick fields and choose a language in the URL. This returns the official sports cars, names only:

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

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.

Base URL : https://vice-city.app/api/v1

Plans and limits

Free

€0

To try the API and for small personal projects.

  • Requests a day5
  • Results per page25
  • Catalogue and search✓
  • English and French✓
  • Map of Leonida (GeoJSON)–
  • Change feed–
  • Full exports (NDJSON)–
  • Commercial use–
  • MadamNazar.io API and Premium included–
Get a free key

Developer

€4.99 a month, or €39 a year

For apps, bots and sites that run every day.

  • Requests a day1,000
  • Results per page200
  • Catalogue and search✓
  • English and French✓
  • Map of Leonida (GeoJSON)✓
  • Change feed✓
  • Full exports (NDJSON)✓
  • Commercial use✓
  • MadamNazar.io API and Premium included✓
Get a Developer key

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:

Response headers
RateLimit-Limit: 5
RateLimit-Remaining: 3
RateLimit-Reset: 28412

With 5 requests a day, a free key is for testing: ask for 25 entries per call and keep the answers. The data changes a few times a day at most.

Data model

A character, a car and a bar all have the same shape. Learn it once and every collection reads the same way, including the ones added after launch.

id
Stable and never reused, type.slug. Store this one.
name, summary
Translated texts.
attributes
What is specific to the type: a vehicle’s class, a weapon’s real model. /types lists them.
relations
Typed links to other entries, with their name and address.
reliability
official (shown or named by Rockstar), press or community. Leaks and rumours are never in the API.
verified_in_game
Turns true once we have checked the entry in the game, from November 19, 2026.
spoiler
Story content. Left out of lists unless you send spoilers=true.
sources
The pages the entry comes from.
url
The entry’s page on vice-city.app, to link back to.
created_at, updated_at
Dates, to sync with /changes.

Collections

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.
curl "https://vice-city.app/api/v1/vehicles?filter[class]=sport&fields=name&limit=3&lang=en" \
  -H "x-api-key: YOUR_KEY"
200 OK · example
{
  "data": [
    {
      "id": "vehicle.bravado-buffalo-course-46",
      "type": "vehicle",
      "name": "Bravado Buffalo (course #46)"
    },
    {
      "id": "vehicle.classic-roadster-36",
      "type": "vehicle",
      "name": "Classic roadster #36"
    },
    {
      "id": "vehicle.classic-roadster-r-badge",
      "type": "vehicle",
      "name": "Classic roadster (R badge)"
    }
  ],
  "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}

Free

Get one entry. Returns one entry with all its fields. The slug is the last part of its id.

langen | fr
One language as plain strings. Leave it out to get both.
fieldslist
Top-level fields to keep, comma-separated: fields=name,attributes.
curl "https://vice-city.app/api/v1/characters/jason-duval?lang=en" \
  -H "x-api-key: YOUR_KEY"
200 OK · example
{
  "data": {
    "id": "character.jason-duval",
    "type": "character",
    "name": "Jason Duval",
    "summary": "Playable protagonist. Former soldier now working for smugglers in the Keys; Brian's employee and tenant in Key Lento.",
    "attributes": {
      "alias": null,
      "group": "Protagonists",
      "appearances": "Trailer 2, Extended Look, launch trailer, cover art, Rockstar bio",
      "voice": null
    },
    "reliability": "official",
    "verified_in_game": false,
    "sources": [
      {
        "url": "https://www.rockstargames.com/VI",
        "site": "rockstargames.com"
      }
    ],
    "url": "https://vice-city.app/characters/jason-duval",
    "updated_at": "2026-11-16"
  },
  "meta": {
    "api_version": "v1",
    "data_version": "90a83462d68e",
    "plan": "free",
    "docs": "https://vice-city.app/developers"
  }
}

Discovery

GET/types

Free

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.

The example shows one collection out of 15.

curl "https://vice-city.app/api/v1/types?lang=en" \
  -H "x-api-key: YOUR_KEY"
200 OK · example
{
  "data": [
    {
      "name": "weapons",
      "type": "weapon",
      "title": "Weapons",
      "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

Free

Get the game facts. Release date, platforms, developer and publisher.

langen | fr
One language as plain strings. Leave it out to get both.
curl "https://vice-city.app/api/v1/game?lang=en" \
  -H "x-api-key: YOUR_KEY"
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.

curl "https://vice-city.app/api/v1/map/districts?bbox=0,0,2000,3000" \
  -H "x-api-key: YOUR_KEY"
200 OK · example
{
  "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

Developer

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.
curl "https://vice-city.app/api/v1/changes?since=2026-11-19&fields=name&lang=en" \
  -H "x-api-key: YOUR_KEY"
200 OK · example
{
  "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}

Developer

Export a collection. The whole collection in one call, as NDJSON: one JSON entry per line, easy to stream into a database.

langen | fr
One language as plain strings. Leave it out to get both.

The response is application/x-ndjson. The example shows one line, pretty-printed.

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

Caching

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.

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

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_query invalid_sort invalid_cursor invalid_bbox invalid_since invalid_lang
A parameter is wrong. detail says which one and gives a valid example.
401
missing_api_key invalid_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_inactive demo_key
The subscription behind the key has ended, or the demo key was asked for a second page.
404
unknown_collection not_found unknown_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.

Type to search the whole database