Viberate General City API
The General City API from Viberate — 2 operation(s) for general city.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/viberate:viberate-general-city-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Viberate General City API
description: '# Introduction
Welcome to Viberate API, your source of daily-refreshed data on millions of music entities.'
version: 1.24.0
x-logo:
url: https://viberate.ams3.cdn.digitaloceanspaces.com/share/docs-logo.png
altText: Viberate logo
href: https://www.viberate.com/home
servers:
- url: https://data.viberate.com/api/v1
security:
- Access-Key: []
tags:
- name: General City
x-displayName: General
paths:
/city/{id}/details:
get:
summary: City’s Details
tags:
- General City
description: Get city’s detailed information.
parameters:
- in: path
name: id
required: true
description: "\n\nCity slug \n\n*Example: `3`*"
schema:
type: string
responses:
'200':
description: OK
content:
application/json:
schema:
type: object
properties:
api_version:
type: string
example: v1.24.0
data:
type: object
properties:
id:
type: integer
example: 3
name:
type: string
example: Berlin
slug:
type: string
example: berlin
country_alpha2:
type: string
example: DE
coordinates:
type: object
properties:
lat:
type: null
example: 52.5219193
lng:
type: null
example: 13.4132147
region:
type: string
example: Berlin
major:
type: boolean
example: true
'400':
description: invalid_request
'404':
description: not_found
'500':
description: internal_server_error
operationId: getCityByIdDetails
x-operation-id-source: derived
/city/search:
get:
summary: City Search by Name
tags:
- General City
description: Search for cities by their name. Search is elastic, so approximates can provide correct search results.
parameters:
- in: query
name: q
required: true
description: '
City’s name'
schema:
type: string
- in: query
name: limit
required: false
description: '
Maximum number of results per page'
schema:
type: integer
default: 20
- in: query
name: offset
required: false
description: Offset of results
schema:
type: integer
default: 0
responses:
'200':
description: OK
content:
application/json:
schema:
type: object
properties:
api_version:
type: string
example: v1.24.0
data:
type: array
items:
type: object
properties:
id:
type: integer
example: 3
name:
type: string
example: Berlin
slug:
type: string
example: berlin
country_alpha2:
type: string
example: DE
coordinates:
type: object
properties:
lat:
type: null
example: 52.5219193
lng:
type: null
example: 13.4132147
region:
type: string
example: Berlin
major:
type: boolean
example: true
example:
- id: 3
name: Berlin
slug: berlin
country_alpha2: DE
coordinates:
lat: 52.5219193
lng: 13.4132147
region: Berlin
major: true
- id: 11142
name: Berlin
slug: berlin-ct
country_alpha2: US
coordinates:
lat: 41.622509
lng: -72.745369
region: CT
major: false
- id: 10743
name: Berlin
slug: berlin-md
country_alpha2: US
coordinates:
lat: 38.3222008
lng: -75.2183685
region: MD
major: false
- id: 10957
name: New Berlin
slug: new-berlin
country_alpha2: US
coordinates:
lat: 42.9753914
lng: -88.1185608
region: WI
major: false
- id: 13243
name: Berlin Center
slug: berlin-center
country_alpha2: US
coordinates:
lat: 41.0101509
lng: -80.9475479
region: OH
major: false
- id: 15836
name: New Berlin
slug: new-berlin-il
country_alpha2: US
coordinates:
lat: 39.7248116
lng: -89.9126892
region: IL
major: false
- id: 7675
name: Rüdersdorf bei Berlin
slug: rudersdorf-bei-berlin
country_alpha2: DE
coordinates:
lat: 52.4714012
lng: 13.7847795
region: Brandenburg
major: false
- id: 6238
name: Bernau bei Berlin
slug: bernau-bei-berlin
country_alpha2: DE
coordinates:
lat: 52.6807289
lng: 13.5833797
region: Brandenburg
major: false
- id: 8011
name: Neuenhagen bei Berlin
slug: neuenhagen-bei-berlin
country_alpha2: DE
coordinates:
lat: 52.5269012
lng: 13.6889696
region: Brandenburg
major: false
- id: 14268
name: Oberlin
slug: oberlin
country_alpha2: US
coordinates:
lat: 41.2939911
lng: -82.217308
region: OH
major: false
pagination:
type: object
properties:
total:
type: integer
example: 26
current:
type: integer
example: 10
limit:
type: integer
example: 20
offset:
type: integer
example: 0
'400':
description: invalid_request
'404':
description: not_found
'500':
description: internal_server_error
operationId: getCitySearch
x-operation-id-source: derived
components:
securitySchemes:
Access-Key:
type: apiKey
description: API key to authorize requests.
name: Access-Key
in: header
x-tagGroups:
- name: ''
tags:
- MCP Connection Guide
- name: ''
tags:
- Rate Limiting
- name: ''
tags:
- Viberate Entity IDs
- name: Artist
tags:
- General
- Airplay
- Beatport
- Deezer
- Facebook
- Instagram
- TikTok
- Shazam
- Social Media
- Soundcloud
- Spotify
- Viberate
- Youtube
- Apple Music
- name: Track
tags:
- General Track
- Airplay Track
- Deezer Track
- Facebook Track
- Instagram Track
- Twitter Track
- TikTok Track
- Shazam Track
- Social Track
- Soundcloud Track
- Spotify Track
- Apple Track
- Viberate Track
- Youtube Track
- Trending Track
- name: Label
tags:
- General Label
- Spotify Label
- Viberate Label
- name: Event
tags:
- General Event
- name: Venue
tags:
- General Venue
- Viberate Venue
- name: Spotify Playlist
tags:
- General Playlist
- Viberate Playlist
- name: Apple Playlist
tags:
- General Apple Playlist
- Viberate Apple Playlist
- name: Festival
tags:
- General Festival
- Instagram Festival
- TikTok Festival
- Spotify Festival
- Viberate Festival
- Youtube Festival
- name: City
tags:
- General City
- Viberate City