Skip to main content
Convert
curl --request POST \
  --url https://ytrss.xyz/api/v1/convert \
  --header 'Content-Type: application/json' \
  --data '
{
  "urls": [
    "<string>"
  ]
}
'
{
  "batch_id": "batch_abc123xyz",
  "message": "Conversion jobs created successfully",
  "jobs": [
    {
      "id": "job_def456uvw",
      "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
      "status": "CREATED"
    },
    {
      "id": "job_ghi789rst",
      "url": "https://www.youtube.com/watch?v=jNQXAC9IVRw",
      "status": "CREATED"
    }
  ]
}

Overview

Submit one or more YouTube URLs to be converted into audio files.

Endpoint

POST https://ytrss.xyz/api/v1/convert

Body

urls
string[]
required
An array of one or more YouTube video URLs to convert

Request Example

{
    "urls": [
        "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
        "https://www.youtube.com/watch?v=jNQXAC9IVRw"
    ]
}

Response

batch_id
string
Unique identifier for this batch of conversion jobs
message
string
Status message describing the result
jobs
object[]
Array of job objects representing each conversion task
{
  "batch_id": "batch_abc123xyz",
  "message": "Conversion jobs created successfully",
  "jobs": [
    {
      "id": "job_def456uvw",
      "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
      "status": "CREATED"
    },
    {
      "id": "job_ghi789rst",
      "url": "https://www.youtube.com/watch?v=jNQXAC9IVRw",
      "status": "CREATED"
    }
  ]
}