List music videos

November 10, 2026

Table of contents

  1. Request Headers
  2. Query Parameters
  3. Responses
  4. Model
  5. Examples
  6. Try It

Lists the music videos of one account, newest first, including ones made on the PixVerse website. Each entry has the video_id to use with GET music-video/video_id, which returns the settings and the extra files.

To make one, use POST music-video/create.

https://api.useapi.net/v2/pixverse/music-video/?…

Request Headers 
Authorization: Bearer {API token}
Query Parameters

  • email is optional when only one account is configured. However, if you have multiple accounts configured, this parameter becomes required.

  • offset is optional, default 0.

  • limit is optional, default 20. Valid range: 1…40

PixVerse pages through all of its music projects (beat mixes and other music features too), and the API keeps only the music videos, so a page can hold fewer than limit entries while has_more is still true. Continue with offset set to next_offset.

Responses

  • 200 OK

    video_id and video appear once PixVerse has produced the video.

    {
    "data": [
        {
            "video_id": "user:<userid>-pixverse:<email>-video:370538497751884",
            "project_id": 304006225895014,
            "status": "succeeded",
            "name": "Music Project_304006225895014",
            "video": {
                "video_id": "user:<userid>-pixverse:<email>-video:370538497751884",
                "url": "https://media.pixverse.ai/pixverse%2Fmp4%2Fmedia%2Fweb%2Fori%2Fs-2cb36fb5-390b-4163-ba8d-e06fd001b115_seed6406858824.mp4",
                "cover_url": "https://media.pixverse.ai/pixverse%2Fvideo%2Fframe%2Fb3329a4a-5a17-48ea-b369-517ff26bf95a.jpg",
                "first_frame": "https://media.pixverse.ai/pixverse%2Fvideo%2Fframe%2Fb3329a4a-5a17-48ea-b369-517ff26bf95a.jpg",
                "width": 720,
                "height": 1280,
                "duration": 11,
                "format": "mp4"
            },
            "created_at": "2026-11-10T07:07:01Z",
            "updated_at": "2026-11-10T07:10:56Z"
        }
    ],
    "next_offset": 0,
    "has_more": false
}

  • 400 Bad Request

    {
  "error": "Parameter limit (41) is more than 40",
  "code": 400
}

  • 401 Unauthorized

    {
  "error": "Unauthorized"
}

  • 596 Pending mod message

    The account has a pending error, and the API does not use it until you add it again with POST accounts/email. You receive an email when this happens. There are three causes.

    PixVerse could not sign the account in, most often because its password was changed. Add the account again with the current password.

    {
  "error": "Your PixVerse account has pending error. Please address this issue at https://useapi.net/docs/api-pixverse-v2/post-pixverse-accounts-email before making any new API calls.",
  "code": 596
}

    Or PixVerse suspended the account. PixVerse suspends accounts that break its content rules and does not say which generation caused it. The first response carries PixVerse’s own details in account_moderation, and later calls return the same error. Add the account again after reinstatement_at. To ask PixVerse to lift the suspension earlier, write to the support_email it gives.

    {
  "error": "PixVerse suspended account [email protected] for 30 days, from 2026-10-16 09:26 UTC until 2026-11-15 09:26 UTC. PixVerse suspends accounts that break its content rules and does not say which generation caused it. Add the account again at https://useapi.net/docs/api-pixverse-v2/post-pixverse-accounts-email after 2026-11-15 09:26 UTC. To ask PixVerse to lift it earlier, write to [email protected].",
  "code": 596,
  "account_moderation": {
    "ban_level": "suspend_30d",
    "action": "temporary_suspend",
    "duration_days": 30,
    "suspended_at": "2026-10-16 09:26:25 (UTC)",
    "reinstatement_at": "2026-11-15 09:26:25 (UTC)",
    "support_email": "[email protected]"
  }
}

    Or PixVerse banned the account for violating its community guidelines. A ban is permanent unless PixVerse accepts an appeal, and the error quotes PixVerse’s own message, which says how to appeal. Remove the account with DELETE accounts/email, or add it again only if PixVerse lifts the ban.

    {
  "error": "PixVerse banned account [email protected] for violating its community guidelines (400024). A ban is permanent unless PixVerse accepts an appeal. PixVerse says: \"Your account has been banned for violating community guidelines. If you wish to appeal, please contact us via ...\" Remove it with DELETE /v2/pixverse/accounts/[email protected], or add it again (https://useapi.net/docs/api-pixverse-v2/post-pixverse-accounts-email) only if PixVerse lifts the ban.",
  "code": 596
}

    If every account you have is in this state, a request without email returns 596 as well.

Model 
{ // TypeScript, all fields are optional
    data: {
        video_id: string
        project_id: number
        status: 'pending' | 'processing' | 'succeeded' | 'failed'
        name: string
        video: {
            video_id: string
            url: string
            cover_url: string
            first_frame: string
            width: number
            height: number
            duration: number
            format: string
        }
        created_at: string
        updated_at: string
    }[]
    next_offset: number
    has_more: boolean
}
Examples 
  • curl "https://api.useapi.net/v2/pixverse/music-video/?email=email" \
   -H "Accept: application/json" \
   -H "Authorization: Bearer …"

  • const token = "API token";
const email = "Previously configured account email";
const apiUrl = `https://api.useapi.net/v2/pixverse/music-video/?email=${email}`;
const response = await fetch(apiUrl, {
  headers: {
    "Authorization": `Bearer ${token}`,
  },
});
const result = await response.json();
console.log("response", {response, result});

  • import requests
token = "API token"
email = "Previously configured account email"
apiUrl = f"https://api.useapi.net/v2/pixverse/music-video/?email={email}"
headers = {
    "Content-Type": "application/json",
    "Authorization" : f"Bearer {token}"
}
response = requests.get(apiUrl, headers=headers)
print(response, response.json())
Try It