Yoinku API

YouTube・TikTokの動画メタデータとダウンロードURLを取得できる無料のHTTP APIです。APIキー不要・CORS対応で、ターミナル・スクリプト・ブラウザから直接呼び出せます。

APIキー不要CORS対応JSONレスポンス30回/分

ベースURL

https://yoinku.com/api/v1

エンドポイント

GET/api/v1/info

動画情報の取得

動画のタイトル・サムネイル・長さと、利用可能なフォーマット一覧を返します。

パラメータ

url (必須): YouTubeまたはTikTokの動画URL。

リクエスト例

curl "https://yoinku.com/api/v1/info?url=https://youtu.be/dQw4w9WgXcQ"

レスポンス例

{
  "ok": true,
  "data": {
    "id": "dQw4w9WgXcQ",
    "platform": "youtube",
    "title": "Example video",
    "durationSeconds": 213,
    "thumbnailUrl": "https://i.ytimg.com/...",
    "formats": [
      { "id": "v-1080", "kind": "video", "container": "mp4",
        "quality": "1080p", "height": 1080,
        "hasVideo": true, "hasAudio": true },
      { "id": "a-mp3", "kind": "audio", "container": "mp3",
        "quality": "MP3", "hasVideo": false, "hasAudio": true }
    ]
  }
}

GET/api/v1/download

ダウンロードURLの取得

ファイルを生成し、短時間有効なダウンロードURL（約1時間）を返します。redirect=1 を付けると302でファイルへ直接リダイレクトします（curl -L に便利）。

パラメータ

url (必須): YouTubeまたはTikTokの動画URL。
format (必須): info レスポンスのフォーマットID（例: v-720、a-mp3）。
redirect (任意): 1 を指定するとJSONではなく302でファイルへリダイレクトします。

リクエスト例

# Get a short-lived download URL (JSON)
curl "https://yoinku.com/api/v1/download?url=https://youtu.be/dQw4w9WgXcQ&format=v-720"

# …or download the file directly
curl -L -o video.mp4 \
  "https://yoinku.com/api/v1/download?url=https://youtu.be/dQw4w9WgXcQ&format=v-720&redirect=1"

レスポンス例

{
  "ok": true,
  "url": "https://<bucket>.r2.cloudflarestorage.com/...",
  "filename": "Example video.mp4",
  "expiresInSeconds": 3600
}

フォーマットID

info レスポンスの formats 配列からIDを選びます。動画IDは v-1080・v-720・v-360（高さ基準）、音声IDは a-mp3・a-m4a です。

フェアユース

リクエストはIPごとに1分あたり30回までです。超過するとRetry-Afterヘッダー付きのHTTP 429を返します。可能な範囲でレスポンスをキャッシュし、節度あるご利用をお願いします。

エラー

失敗時は { "ok": false, "error": { "code", "message" } } の形で、対応するHTTPステータスを返します: 400（入力不正）・404（見つからない）・422（非対応または失敗）・429（レート制限）。

UIで使いたい方へ

ブラウザでYoinkuのWebアプリをどうぞ。リンクを貼ってダウンロードするだけ、コード不要です。

ダウンローダーを開く

本APIは、自分が権利を持つ、またはダウンロードの許可を得たコンテンツにのみ使用してください。利用方法についての責任は利用者にあります。