---
title: "GET /v1/songs/popular"
method: GET
path: "/v1/songs/popular"
tags: ["Songs"]
---

# GET /v1/songs/popular

`GET /v1/songs/popular`

## Request

- Base URL: `https://api.neume.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.neume.io/v1/songs/popular`
- Auth: none declared

## Query parameters

- `page` number, required
- `limit` number, required

## Response `200`

- ListSongDto
  - `data` ListSongItemDto[], required: List of songs
    - `reaction` 'LIKE' | 'DISLIKE': User's reaction to the song
    - `songId` string, required: Song ID
    - `title` string, required: Song title
    - `image` string, required: Song image URL
    - `user` SongUser, required
      - `userId` string, required: User ID
      - `publicName` string, required: User public name
      - `firstName` string, required: User first name
      - `lastName` string, required: User last name
    - `stems` StemDto[], required: Stems
      - `songStemId` string, required: Stem ID
      - `stemType` string, required: Stem type
    - `isExplicit` boolean, required: If the song uses explicit language
    - `visibility` string, required: Song visibility status
    - `status` string, required: Song status
    - `ownership` string, required: Who owns the song
    - `kind` string, required: The kind of song
    - `playCount` number, required: Number of times the song has been played
    - `createdAt` string, date-time, required: Song creation date
    - `model` 'free' | 'pro': Generation model tier
  - `pagination` PaginationDto, required
    - `page` number, required: Current page number
    - `limit` number, required: Items per page
    - `total` number, required: Total number of items

---

[API](https://skmtc.dev/neume/apis/neume-api.md) · [All operations](https://skmtc.dev/neume/apis/neume-api/llms.txt) · [OpenAPI document](https://skmtc.dev/neume/apis/neume-api/revisions/ddfaa546b0be?raw)