ビデオダウンロードAPI ドキュメント

Any4K.comのビデオダウンロードAPIを使用すると、YouTube、TikTok、Twitterなどの人気のあるソーシャルメディアプラットフォームから簡単に動画をダウンロードできます。このAPIは様々な動画品質やフォーマットに対応し、動画と音声の抽出機能を提供します。

APIエンドポイント

動画情報チェック

動画のメタデータと利用可能なダウンロードフォーマットを取得します。

エンドポイント: https://api.any4k.com/v1/dlp/check
メソッド: POST
Content-Type: application/json

リクエストパラメータ

パラメータ	型	必須	説明
url	string	はい	ダウンロードする動画のURL
lang	string	いいえ	言語コード（デフォルト: en）
country	string	いいえ	国コード（デフォルト: US）
platform	string	いいえ	プラットフォーム名（デフォルト: Web）
deviceId	string	いいえ	一意のデバイス識別子

リクエスト例

cURL

curl -X POST https://api.any4k.com/v1/dlp/check \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.youtube.com/watch?v=VIDEO_ID",
    "lang": "ja",
    "country": "JP",
    "platform": "Web",
    "deviceId": "your-device-id"
  }'

Node.js

const axios = require('axios');

async function checkVideo() {
  try {
    const response = await axios.post('https://api.any4k.com/v1/dlp/check', {
      url: 'https://www.youtube.com/watch?v=VIDEO_ID',
      lang: 'ja',
      country: 'JP',
      platform: 'Web',
      deviceId: 'your-device-id'
    }, {
      headers: {
        'Content-Type': 'application/json'
      }
    });
    console.log(response.data);
  } catch (error) {
    console.error('エラー:', error.response.data);
  }
}

レスポンスフォーマット

{
  "err_code": 0,
  "err_msg": "",
  "data": {
    "id": "VIDEO_ID",
    "title": "動画タイトル",
    "description": "動画の説明",
    "duration": 180,
    "view_count": 1000000,
    "upload_date": "20240401",
    "extractor": "youtube",
    "is_live": false,
    "thumbnail": "https://example.com/thumbnail.jpg",
    "download": [
      {
        "id": "format_id",
        "ext": "mp4",
        "res_text": "1080p",
        "filesize": 104857600
      }
    ],
    "raw_video": [
      {
        "id": "format_id",
        "ext": "mp4",
        "res_text": "4K",
        "filesize": 524288000,
        "vcodec": "h264"
      }
    ],
    "raw_audio": [
      {
        "id": "format_id",
        "ext": "m4a",
        "filesize": 3145728,
        "acodec": "aac",
        "asr": 44100
      }
    ]
  }
}

動画ダウンロード

指定されたフォーマットで動画をダウンロードします。

エンドポイント: https://api.any4k.com/v1/dlp/download
メソッド: POST
Content-Type: application/json

リクエストパラメータ

パラメータ	型	必須	説明
url	string	はい	動画のURL
format	string	はい	チェックレスポンスからのフォーマットID
lang	string	いいえ	言語コード（デフォルト: en）
country	string	いいえ	国コード（デフォルト: US）

リクエスト例

cURL

curl -X POST https://api.any4k.com/v1/dlp/download \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.youtube.com/watch?v=VIDEO_ID",
    "format": "format_id",
    "lang": "ja",
    "country": "JP"
  }'

Node.js

const axios = require('axios');

async function downloadVideo() {
  try {
    const response = await axios.post('https://api.any4k.com/v1/dlp/download', {
      url: 'https://www.youtube.com/watch?v=VIDEO_ID',
      format: 'format_id',
      lang: 'ja',
      country: 'JP'
    }, {
      headers: {
        'Content-Type': 'application/json'
      },
      responseType: 'stream'
    });
    
    // 動画ストリームの処理
    response.data.pipe(fs.createWriteStream('video.mp4'));
  } catch (error) {
    console.error('エラー:', error.message);
  }
}

エラーコード

コード	説明
0	成功
400	不正なリクエスト - 無効なパラメータ
401	未認証 - 無効なAPIキー
403	禁止 - アクセス拒否
404	未検出 - 動画が見つかりません
429	リクエスト過多 - レート制限超過
500	サーバー内部エラー
502	バッドゲートウェイ - 動画プラットフォームエラー