Τεκμηρίωση API

Για τιμολόγηση API κάντε κλικ εδώ

Το Soundc.com API φιλοξενείται στο soundc.com .

Πιστοποίηση

Για να αποκτήσετε πρόσβαση στο Soundc.com API, πρέπει να συμπεριλάβετε το μοναδικό κλειδί API σας. Μπορείτε να αποκτήσετε ένα κλειδί API κάνοντας εγγραφή με τη διεύθυνση email σας. Μην ξεχνάτε να διατηρείτε το κλειδί σας API εμπιστευτικό.

Ο έλεγχος ταυτότητας με το API γίνεται μέσω κεφαλίδων HTTP. Όλα τα αιτήματα απαιτούν μια κεφαλίδα εξουσιοδότησης που περιέχει το κλειδί API στο κλειδί μορφής: YOUR_API_KEY , όπου YOUR_API_KEY είναι το κλειδί που είναι διαθέσιμο στη σελίδα του λογαριασμού σας.

Για ασφάλεια, όλα τα αιτήματα πρέπει να αποστέλλονται μέσω κρυπτογραφημένης σύνδεσης HTTPS για την προστασία των δεδομένων σας κατά τη μετάδοση.

Download Endpoint

Extract media from any supported URL with a single synchronous request. No polling required.

POST https://api.soundc.com/api/download

Headers: Authorization: YOUR_API_KEY, Content-Type: application/json

import requests

headers = {
    "Authorization": "API_KEY",
    "Content-Type": "application/json"
}
r = requests.post(
    url="https://api.soundc.com/api/download",
    headers=headers,
    json={"url": "URL"}
)

if r.status_code == 200:
    data = r.json()
    for item in data.get("items", []):
        print(f"Type: {item['type']}, URL: {item['url']}")
else:
    print(f"Error: {r.status_code} - {r.text}")

const axios = require('axios');

async function download() {
    try {
        const response = await axios.post(
            'https://api.soundc.com/api/download',
            { url: "URL" },
            { headers: { "Authorization": "API_KEY", "Content-Type": "application/json" } }
        );

        for (const item of response.data.items) {
            console.log(`Type: ${item.type}, URL: ${item.url}`);
        }
    } catch (error) {
        console.error(`Error: ${error.response?.status} - ${error.response?.data}`);
    }
}

download();

<?php

$ch = curl_init("https://api.soundc.com/api/download");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: API_KEY",
    "Content-Type: application/json"
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode(["url" => "URL"]));

$response = curl_exec($ch);
$statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($statusCode === 200) {
    $data = json_decode($response, true);
    foreach ($data['items'] as $item) {
        echo "Type: {$item['type']}, URL: {$item['url']}\n";
    }
} else {
    echo "Error: $statusCode - $response\n";
}

?>

curl -X POST "https://api.soundc.com/api/download" \
  -H "Authorization: API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "URL"}'

Response

{
    "success": true,
    "items": [
        {
            "url": "https://...",
            "type": "video",
            "thumbnail": "https://...",
            "mime_type": "video/mp4",
            "site": "tiktok",
            "title": "Video title"
        }
    ]
}

Conversion Endpoints

Convert media to different formats. Returns a binary file stream.

All conversion endpoints are at https://api.soundc.com.

Request body (JSON):

Example: Convert to MP3

import requests

headers = {
    "Authorization": "API_KEY",
    "Content-Type": "application/json"
}

r = requests.post(
    url="https://api.soundc.com/api/convert/mp3",
    headers=headers,
    json={
        "url": "URL",
        "options": {
            "audio_quality": "192",
            "start_time": 10,
            "end_time": 45
        }
    },
    stream=True
)

if r.status_code == 200:
    with open("output.mp3", "wb") as f:
        for chunk in r.iter_content(chunk_size=8192):
            f.write(chunk)
    print("Downloaded output.mp3")
else:
    print(f"Error: {r.status_code} - {r.text}")

curl -X POST "https://api.soundc.com/api/convert/mp3" \
  -H "Authorization: API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "URL", "options": {"audio_quality": "192"}}' \
  --output output.mp3

Error Handling

All errors return a JSON response with an error field:

// 400 Bad Request
{"error": "Missing URL"}

// 401 Unauthorized
{"error": "Invalid API token"}

// 402 Payment Required
{"error": "Insufficient credits"}