---
title: "vice-city.app API · free GTA 6 API, JSON data for developers"
description: "A free GTA 6 API: characters, locations, vehicles, weapons and the map of Leonida as JSON, in English and French. OpenAPI 3.1, free key."
url: https://vice-city.app/developers
lang: en
---
[vice-city.app](https://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.

- **501** entries
- **11** collections
- **EN · FR** every text
- **OpenAPI 3.1** [openapi.json](https://vice-city.app/openapi.json)

## 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](https://madamnazar.io/account#api) 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 day 5
- Results per page 25
- 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](https://madamnazar.io/account#api)

### Developer

**€4.99** a month, or €39 a year

For apps, bots and sites that run every day.

- Requests a day 1,000
- Results per page 200
- 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](https://madamnazar.io/account#api)

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.

## Collections

- `/locations` **94** The 6 regions of Leonida, their districts and towns.
- `/businesses` **69** Bars, clubs, stores, hotels, garages and other named places.
- `/characters` **31** Protagonists, supporting cast and radio hosts shown or named officially.
- `/manufacturers` **32** In-game vehicle brands and the real-world make each one stands for.
- `/vehicles` **172** Cars, bikes, boats and aircraft, with their class and real-world inspiration.
- `/weapons` **37** Firearms, melee weapons and throwables, with the real-world model behind each one.
- `/activities` **37** Side activities and minigames shown by Rockstar or described by the press.
- `/radio-stations` **8** Stations, genres, hosts and the tracks heard so far.
- `/trailers` **4** Official trailers, their date, music and what each one revealed.
- `/editions` **4** Standard and Ultimate editions, pre-order bonuses and prices.
- `/events` **13** Key dates of the game, from early development to launch.

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.

### GET `/{collection}`

Free

**List a collection.** Returns the entries of one collection, sorted by name, with filters and paging.

```
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`.

```
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"
  }
}
```

### GET `/{collection}/{slug}/related`

Free

**Get linked entries.** Returns the entries this one points to and the ones that point to it. For a region: its districts and businesses.

```
curl "https://vice-city.app/api/v1/locations/vice-city/related?fields=name&limit=3&lang=en" \
  -H "x-api-key: YOUR_KEY"
```

200 OK · example

```
{
  "data": [
    {
      "id": "location.ocean-beach",
      "type": "location",
      "name": "Ocean Beach"
    },
    {
      "id": "location.washington-beach",
      "type": "location",
      "name": "Washington Beach"
    },
    {
      "id": "location.vice-beach",
      "type": "location",
      "name": "Vice Beach"
    }
  ],
  "meta": {
    "api_version": "v1",
    "data_version": "90a83462d68e",
    "plan": "free",
    "total": 81,
    "docs": "https://vice-city.app/developers"
  }
}
```

### GET `/search`

Free

**Search everything.** Searches every collection at once, in English and French, ignoring accents. Names first, then summaries and attributes.

```
curl "https://vice-city.app/api/v1/search?q=cheetah&fields=name&lang=en" \
  -H "x-api-key: YOUR_KEY"
```

200 OK · example

```
{
  "data": [
    {
      "id": "vehicle.grotti-95-cheetah",
      "type": "vehicle",
      "name": "Grotti '95 Cheetah"
    },
    {
      "id": "vehicle.grotti-cheetah-classic",
      "type": "vehicle",
      "name": "Grotti Cheetah Classic"
    }
  ],
  "meta": {
    "api_version": "v1",
    "data_version": "90a83462d68e",
    "plan": "free",
    "total": 2,
    "docs": "https://vice-city.app/developers"
  }
}
```

### 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.

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.

```
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"
  }
}
```

### 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.

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.

```
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.

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"
}
```

## 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](mailto:contact@lucasbonomi.com).

---

vice-city.app is an unofficial GTA 6 fan site, not affiliated with Rockstar Games or Take-Two Interactive. Every English page is also available as Markdown (send `Accept: text/markdown`). Site map: [sitemap.xml](https://vice-city.app/sitemap.xml) · Agent guide: [llms.txt](https://vice-city.app/llms.txt) · JSON API: [vice-city.app API](https://vice-city.app/developers) ([OpenAPI](https://vice-city.app/openapi.json)).
