Skip to main content
GET
/
api
/
research
/
cities
cURL
curl --request GET \
  --url https://api.recoupable.com/api/research/cities
{
  "status": "success",
  "cities": [
    {
      "name": "<string>",
      "country": "<string>",
      "listeners": 123
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://developers.recoupable.com/llms.txt

Use this file to discover all available pages before exploring further.

Query Parameters

artist
string
required

Artist name or Recoup artist ID (UUID).

Response

Top listener cities

status
enum<string>
Available options:
success,
error
Example:

"success"

cities
object[]

Cities ranked by listener concentration.