API Documentation

App.apiDescription

Getting Started

To use the YTMP3CV.COM API, you'll need an API key. If you don't have one yet, contact us to get started.

All API requests should be made to the following base URL:

https://api.ytmp3cv.com/

Authentication

Include your API key in the header of all requests:

Authorization: Bearer YOUR_API_KEY

Endpoints

Convert YouTube to MP3

POST /convert

Convert a YouTube video to MP3 format.

Parameters

Name Type Description
url string The YouTube video URL
quality string Optional. Audio quality (high, medium, low). Default: high

Example Request


import requests

api_key = 'YOUR_API_KEY'
headers = {
    'Authorization': f'Bearer {api_key}',
    'Content-Type': 'application/json'
}

data = {
    'url': 'https://www.youtube.com/watch?v=dQw4w9WgXcQ',
    'quality': 'high'
}

response = requests.post('https://api.ytmp3cv.com/convert', headers=headers, json=data)

if response.status_code == 200:
    result = response.json()
    print(f"Download URL: {result['download_url']}")
else:
    print(f"Error: {response.status_code}")

Get Conversion Status

GET /status/{conversion_id}

Check the status of a conversion job.

Parameters

Name Type Description
conversion_id string The ID of the conversion job

Example Request


import requests

api_key = 'YOUR_API_KEY'
headers = {
    'Authorization': f'Bearer {api_key}'
}

conversion_id = 'abc123'
response = requests.get(f'https://api.ytmp3cv.com/status/{conversion_id}', headers=headers)

if response.status_code == 200:
    result = response.json()
    print(f"Status: {result['status']}")
    print(f"Progress: {result['progress']}%")
else:
    print(f"Error: {response.status_code}")

Batch Conversion

POST /batch-convert

Convert multiple YouTube videos to MP3 format in a single request.

Parameters

Name Type Description
urls array An array of YouTube video URLs
quality string Optional. Audio quality (high, medium, low). Default: high

Example Request


import requests

api_key = 'YOUR_API_KEY'
headers = {
    'Authorization': f'Bearer {api_key}',
    'Content-Type': 'application/json'
}

data = {
    'urls': [
        'https://www.youtube.com/watch?v=dQw4w9WgXcQ',
        'https://www.youtube.com/watch?v=9bZkp7q19f0'
    ],
    'quality': 'high'
}

response = requests.post('https://api.ytmp3cv.com/batch-convert', headers=headers, json=data)

if response.status_code == 200:
    result = response.json()
    for job in result['jobs']:
        print(f"Conversion ID: {job['conversion_id']}")
else:
    print(f"Error: {response.status_code}")

Rate Limiting

To ensure fair usage and maintain service quality, our API implements rate limiting. The current limits are:

Time Frame Request Limit
Per Minute 100 requests
Per Hour 1,000 requests
Per Day 10,000 requests

If you exceed these limits, you'll receive a 429 Too Many Requests response. The response will include the following headers:

  • X-RateLimit-Limit: The rate limit ceiling for that given request
  • X-RateLimit-Remaining: The number of requests left for the time window
  • X-RateLimit-Reset: The remaining window before the rate limit resets in UTC epoch seconds

For higher rate limits tailored to your specific use case, please contact our sales team.

Error Handling

Description

Code Description
200 OK The request was successful.
400 Bad Request The request was invalid or cannot be served. The exact error is explained in the error message.
401 Unauthorized The request requires user authentication.
403 Forbidden เซิร์ฟเวอร์เข้าใจคำขอแต่ปฏิเสธที่จะอนุญาต
404 Not Found ไม่พบทรัพยากรที่ร้องขอ
429 Too Many Requests คุณส่งคำขอมากเกินไปในช่วงเวลาที่กำหนด
500 Internal Server Error เรามีปัญหากับเซิร์ฟเวอร์ของเรา โปรดลองอีกครั้งในภายหลัง

การตอบสนองข้อผิดพลาดทั้งหมดจะรวมวัตถุ JSON ในเนื้อหาการตอบสนองด้วยโครงสร้างต่อไปนี้:


{
    "error": {
        "code": "ERROR_CODE",
        "message": "A human-readable error message"
    }
}

เราแนะนำให้ใช้การจัดการข้อผิดพลาดที่เหมาะสมในแอปพลิเคชันของคุณเพื่อจัดการกับสถานการณ์เหล่านี้อย่างสง่างามและมอบประสบการณ์ผู้ใช้ที่ราบรื่น

เริ่มต้นใช้งาน API ของเรา

พร้อมที่จะรวมการแปลง YouTube เป็น MP3 ที่ทรงพลังเข้ากับแอปพลิเคชันของคุณแล้วหรือยัง?

ติดต่อฝ่ายขาย