---
title: "GET /api/pvs/for-songs"
method: GET
path: "/api/pvs/for-songs"
tags: ["PVApi"]
---

# GET /api/pvs/for-songs

`GET /api/pvs/for-songs`

## Query parameters

- `name` string
- `author` string
- `service` 'NicoNicoDouga' | 'Youtube' | 'SoundCloud' | 'Vimeo' | 'Piapro' | 'Bilibili' | 'File' | 'LocalFile' | 'Creofuga' | 'Bandcamp'
- `maxResults` integer
- `getTotalCount` boolean
- `lang` 'Default' | 'Japanese' | 'Romaji' | 'English'

## Response `200`

Success

- PVForSongContractPartialFindResult
  - `items` PVForSongContract[], nullable
    - `song` SongContract
      - `additionalNames` string, nullable
      - `artistString` string, nullable
      - `createDate` string, date-time
      - `deleted` boolean
      - `favoritedTimes` integer
      - `id` integer
      - `lengthSeconds` integer
      - `name` string, nullable
      - `nicoId` string, nullable
      - `publishDate` string, date-time, nullable
      - `pvServices` 'Nothing' | 'NicoNicoDouga' | 'Youtube' | 'SoundCloud' | 'Vimeo' | 'Piapro' | 'Bilibili' | 'File' | 'LocalFile' | 'Creofuga' | 'Bandcamp'
      - `ratingScore` integer
      - `songType` 'Unspecified' | 'Original' | 'Remaster' | 'Remix' | 'Cover' | 'Arrangement' | 'Instrumental' | 'Mashup' | 'MusicPV' | 'DramaPV' | 'Live' | 'Illustration' | 'Other' | 'Rearrangement' | 'ShortVersion'
      - `status` 'Draft' | 'Finished' | 'Approved' | 'Locked'
      - `thumbUrl` string, nullable
      - `version` integer
    - `author` string, nullable
    - `createdBy` integer, nullable
    - `description` string, nullable
    - `disabled` boolean
    - `extendedMetadata` PVExtendedMetadata
      - `json` string, nullable
    - `id` integer
    - `length` integer
    - `name` string, nullable
    - `publishDate` string, date-time, nullable
    - `pvId` string, nullable
    - `service` 'NicoNicoDouga' | 'Youtube' | 'SoundCloud' | 'Vimeo' | 'Piapro' | 'Bilibili' | 'File' | 'LocalFile' | 'Creofuga' | 'Bandcamp'
    - `pvType` 'Original' | 'Reprint' | 'Other'
    - `thumbUrl` string, nullable
    - `url` string, nullable
  - `term` string, nullable
  - `totalCount` integer

---

[API](https://skmtc.net/vocadb/apis/vocadbweb.md) · [All operations](https://skmtc.net/vocadb/apis/vocadbweb/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vocadb/vocadbweb/versions/d1328dfaa36f/schema)