ข้ามไปยังเนื้อหา
TH
รับคีย์ API
เรียกดูเอกสาร

เอกสารอ้างอิง API

YouTube ข้อมูลกํากับภาพวิดีโอ API

รับคีย์ API

เรียกข้อมูลกํากับวิดีโอโดย YouTube วิดีโอ IDทั้งรายละเอียดทางช่อง, จํานวนการหมั้น, ภาพตัวอย่าง, รูปแบบและบทที่มี

สร้างคำขอ

เดอะ 11- ช่างทําเล็บ ID จากวีดีโอ URLไม่เต็ม URL.

POSThttps://data.flashdata.dev/v1/queries/realtime
Python 3 · requests
python3 -m pip install requests
import json

import requests

api_key = "YOUR_API_KEY"
payload = {
    "source": "youtube_metadata",
    "video_id": "dQw4w9WgXcQ",
    "params": {
        "include_formats": False,
        "include_chapters": True,
    },
}

response = requests.post(
    "https://data.flashdata.dev/v1/queries/realtime",
    headers={"X-API-Key": api_key, "Accept": "application/json"},
    json=payload,
    timeout=120,
)
response.raise_for_status()
print(json.dumps(response.json(), ensure_ascii=False, indent=2))
ผลในการตอบสนอง HTTPX-API-Key ยืนยัน

พารามิเตอร์

ส่ง source ถึง video_id ที่ระดับบนสุด ตัวเลือกของแหล่งอยู่ใน params. ช่องข้อมูลทางเลือกสามารถยกเลิกได้

เนื้อหาคำขอ

sourcestring / จำเป็น
กําหนดเป็น youtube_metadata
video_idstring / จำเป็น
เดอะ 11- ช่างทําเล็บ YouTube วิดีโอ IDเช่น FUFGCZ092b0. รับจดหมาย ตัวเลข อุปทาน และไฮเฟน
ตรงกับ 11 ตัวอักษรค่าปริยาย: ยังไม่ได้ตั้งค่า
รูปแบบที่ยอมรับได้^[A-Za-z0-9_-]{11}$
paramsobject / ไม่บังคับ
Settings สําหรับการร้องขอนี้
ค่าปริยาย: {}
callback_urlstring · nullable / ไม่บังคับ
Async และชุดเท่านั้น สาธารณะ HTTPS เสร็จสมบูรณ์แล้ว URL บนพอร์ต 443ถึง 2,048 ตัวละคร ไม่มีเอกสารรับรองผู้ใช้หรือส่วน URL Omit, ใช้ null หรือข้อความเปล่าสําหรับไม่ให้แจ้งเตือน ในชุดนี้ กําหนดให้แต่ละคําถาม ภายนอกพม่า
ค่าปริยาย: ยังไม่ได้ตั้งค่า

ตัวเลือกการตอบกลับ

params.include_formatsboolean / ไม่บังคับ
รวมรูปแบบของสื่อที่มี และการเข้ารหัส, มติและข้อมูลอัตราส่งถ่ายข้อมูลด้วย
true หรือ falseค่าปริยาย: true
params.include_chaptersboolean / ไม่บังคับ
รวมไปถึงบทที่วิดีโอมี
true หรือ falseค่าปริยาย: true

คำตอบ

Realtime กลับค่า status: done. อ่านผลลัพธ์ที่ส่งมาจากแหล่ง results[0]; usage.credits บันทึกค่าใช้จ่าย.

ข้อมูลกํากับภาพของวิดีโอหนึ่งรวม videoIdชื่อเพลง รายละเอียดทางช่อง ช่วงเวลาและการหมั้นนับ

อ่านผลที่ออกมา

บันทึกความสําเร็จ JSON ตอบกลับเป็น response.json. บันทึกนี้เป็น read-response.py และเรียกไพธอน read-response.py. มันใช้เฉพาะ Pythonห้องสมุดมาตรฐาน และไม่มีการร้องขอใหม่

read-response.py
import json
from pathlib import Path

response = json.loads(Path("response.json").read_text(encoding="utf-8-sig"))
if response.get("status") not in ("done", "completed") or not isinstance(response.get("results"), list):
    raise SystemExit("Expected completed result JSON; inspect the response or job status.")
if not response["results"]:
    print("[]")
    raise SystemExit(0)
result = response["results"][0]

output = {name: result.get(name) for name in (
    "videoId", "title", "channel", "duration", "hasTranscripts", "transcriptLanguages"
)}
print(json.dumps(output, ensure_ascii=False, indent=2))

ตัวเลือกการตอบกลับทั้งสองแบบ จะหมายถึง true เมื่อตัดการเชื่อมต่อแล้ว ปิดการใช้งาน include_formats สําหรับการตอบสนองที่มีขนาดเล็ก เมื่อคุณต้องการเฉพาะข้อมูลกํากับ บทต่าง ๆ จะปรากฎก็ต่อเมื่อมีการร้องขอและใช้ได้เท่านั้น จํานวนที่ไม่สามารถวัดได้อาจจะเป็น null

formats จงอธิบายรหัสอักขระที่มีอยู่; มันไม่ได้ดาวน์โหลดวิดีโอ hasTranscripts ถึง transcriptLanguages อธิบายได้แต่ไม่ปรากฏข้อความร่าง ใช้ API ดาวน์โหลด สําหรับสื่อและ ทรานสคริปต์ API สําหรับข้อความ

ช่องข้อมูลทั้งหมด
ช่องข้อมูลคําอธิบาย
sourcestringสิ่งที่ร้องขอมา API แหล่งข่าว
statusstringเสร็จสิ้นเมื่อการร้องขอจริง สําเร็จ
created_atstringช่วงเวลาการสร้างแบบ ISO 8601
usage.creditsnumberบัตรเครดิตตามที่ขอ จากแผนของคุณ
results[0].videoIdstringYouTube วิดีโอ ID.
results[0].titlestringชื่อวิดีโอ
results[0].descriptionstringรายละเอียดวิดีโอทั้งหมด
results[0].channelstringชื่อทางช่อง
results[0].channelIdstringช่อง ID.
results[0].channelUrlstringช่อง URL.
results[0].channelSubscriberCountnumber · nullableนับสมาชิกทางช่อง
results[0].viewCountnumber · nullableดูนับสิ
results[0].likeCountnumber · nullableเหมือนนับ
results[0].commentCountnumber · nullableนับด้วยความคิดเห็น
results[0].uploadDatestring · nullableวันที่อัพโหลด
results[0].durationnumber · nullableระยะเวลาวิดีโอเป็นวินาที
results[0].durationStringstring · nullableช่วงเวลารูปแบบเมื่อมีใช้งาน
results[0].thumbnailsarrayภาพตัวอย่าง URLs และขนาด
results[0].categoriesarrayหมวดหมู่วิดีโอ
results[0].tagsarrayแท็กวิดีโอ
results[0].ageLimitintegerห้ามอายุ หรือ 0 เมื่อเกิดความไม่สงบ
results[0].isLivebooleanจะใช้วีดิทัศน์ปัจจุบันหรือไม่
results[0].wasLivebooleanวีดีโอเป็นกระแสสดหรือเปล่า
results[0].hasTranscriptsbooleanมีคําบรรยายภาพอยู่หรือไม่
results[0].transcriptLanguagesarrayโค้ดภาษาของคําบรรยายภาพที่มีอยู่
results[0].formatsarray · optionalรูปแบบสื่อที่มีเมื่อ include_formats คือ true.
results[0].chaptersarray · optionalชื่อเพลงบท start_time ถึง end_time ไม่กี่วินาทีเมื่อร้องขอและว่าง

ช่องข้อมูลด้านบน จะใช้อธิบายค่าปริยาย JSON ตอบสนอง JSONข้อความธรรมดาและ Markdown รูปแบบ.

Async คืนค่าเป็นใบเสร็จงานหนึ่งตัว; จํานวนครั้งจะคืนค่ากลับมาเป็นหนึ่งตัว วิดีโอ ID. โปรดตรวจสอบสถานะงานพิมพ์แต่ละงาน และรับผลของมันโดยใช้ที่อยู่เชื่อมโยงที่ส่งกลับ

Async วงจรชีวิตแบบชุด

การรับช่วงนําใบเสร็จกลับมา ไม่ใช่ผลลัพธ์ Async สร้างงานหนึ่งงาน; กลุ่มต่าง ๆ จะคืนค่ากลับมาเป็นงานที่แยกไว้ queries[] สําหรับทุก ๆ คนที่สอบถามเจ้า ติดตามและรับงานแต่ละงานเป็นอิสระ

ส่งข้อมูลไปยัง data.flashdata.dev; สืบค้นสถานะงานและผลลัพธ์จาก api.flashdata.dev กับ X-API-Key แบบเดียวกัน ความ เกี่ยว พัน API ตัวอย่างพื้นฐานที่ใช้ Python ถึง cURL.

  1. 1. บันทึกงาน IDs

    เก็บรายการที่ต้องการของแหล่งนี้เมื่อสลับไปยัง Async สําหรับ Batchใส่การร้องขอแต่ละในลําดับของ JSON วัตถุ บันทึกงานที่ส่งกลับทั้งหมด ID

    Async ร้องขอและใบเสร็จ · Batch ต้องการตัวบุคคล

  2. 2. ตรวจสอบสถานะ

    GET https://api.flashdata.dev/v2/jobs/{jobId}

    pending / processing: โพลด้วยความล่าช้าและความเคารพ Retry-After เมื่อถึงวันนี้ completed: รับผล failed: สืบค้นเมื่อ job.error.

    อ่าน job.status ไม่ใช่สถานะใบเสร็จรับส่ง

    ตรวจสอบสถานะที่: Python ถึง cURL

    สถานะงาน API อ้างอิง
  3. 3. ดึงข้อมูลผลลัพธ์

    GET https://api.flashdata.dev/v2/jobs/{jobId}/results

    หลังจากเติมให้สมบูรณ์แล้ว ให้ยืนยันการอ่านผลที่อ่านแล้ว 302 คลังสื่อ URL # หากไม่มีเธอ # API กุญแจ บันทึก JSON ภายใน 24 ชั่วโมงของการเติมให้สมบูรณ์

    ดึงข้อมูลผลลัพธ์ที่ออกมา Python ถึง cURL · รูปแบบคำตอบ

    ดาวน์โหลดผลลัพธ์ API อ้างอิง

การ สํารวจ และ ได้ ผล ที่ มี อยู่ แล้ว ไม่ ได้ ใช้ เงิน เครดิต ที่ สอบ ถาม. จับเวลาแบบสํารวจไม่ได้ยกเลิกงาน: ให้ ID แทนการส่งงานที่ซ้ํากัน % 1 ไม่ถูกต้อง!.

Webhook เมื่อเสร็จสิ้น

บอกรับต่อคําค้น

ตั้งค่า callback_url ที่ระดับบนสุดของการร้องขอ Asinc หรือ ภายในแต่ละคําถาม ในชุดที่อยู่นอก params. ไม่มีความต้องการการแยกเว็บฮุค- regressing Realtime ร้องขอไม่ให้ส่งการเรียกกลับ

ใช้สาธารณะชน HTTPS URL บนพอร์ต 443. FlashDataPOSTS แจ้งเตือนสําหรับแต่ละงานพิมพ์ที่ไปถึง completed หรือ failed; เหตุการณ์ที่บรรจุลิงก์ ไม่ใช่ผลลัพธ์เอง

การยอมรับและตรวจสอบ

กลับค่า 2xx หลังจากยอมรับเหตุการณ์นั้น บิดเบี้ยวโดย delivery_id, ยังถูกส่งมาเป็น X-Delivery-Id. ไม่ ปฏิบัติ ตาม การ ชี้ นํา.

การส่งล้มเหลว การลองใหม่ด้วยการกลับแบบเอกซ์โปเนนเชียลขึ้นไป 8 พยายามรวมทั้งหมด และที่มากที่สุด 24 ชั่วโมงหลังจากเติมให้สมบูรณ์แล้ว. ให้การวินิจฉัยเป็น การผิดพลาด

การเรียกตัวยังไม่แน่ชัด ยืนยันงาน IDแหล่งที่มาและสถานะปลายทางผ่าน สถานะที่ยืนยันแล้ว ก่อนที่จะประมวลผลการแจ้งเตือน การส่งมอบ ID สําหรับ deduction, ไม่ใช่ข้อพิสูจน์ของความเป็นจริง

ตัวอย่าง Hook เหตุการณ์และช่องข้อมูล
แจ้งเตือนการเติมให้สมบูรณ์
{
  "delivery_id": "completion:job_example0001",
  "id": "job_example0001",
  "source": "youtube_metadata",
  "status": "completed",
  "links": [
    {
      "rel": "self",
      "href": "https://api.flashdata.dev/v2/jobs/job_example0001",
      "method": "GET"
    },
    {
      "rel": "results",
      "href": "https://api.flashdata.dev/v2/jobs/job_example0001/results",
      "method": "GET"
    }
  ]
}
ช่องข้อมูลคําอธิบาย
delivery_idstringเครื่องระบุการจัดส่งที่ทนทาน การแจ้งให้ทราบแบบย่อโดยใช้ค่านี้; มันถูกส่งมาใน X-Delivery-Id ส่วนหัว
idstringJoob ID.
sourcestringต้องการแหล่งข้อมูล
statusstringเสร็จสมบูรณ์หรือล้มเหลว
linksarrayสถานะและการเชื่อมโยงผลลัพธ์ การแจ้งให้ทราบไม่รวมเนื้อหาหรือรายการที่มีผล API กุญแจ
links[].relstringตัวตนหรือผลลัพธ์
links[].hrefstringการจัดการสัมบูรณ์ API URL2; ยืนยันตัวด้วย API กุญแจ
links[].methodstringGET.

สัญญาเว็บฮุคแบบเต็มและ URL จํากัด

ประมวลผลไฟล์แบบ Bulk

อัปโหลดหนึ่งวิดีโอ ID ต่อบรรทัดและสร้าง Bulk ทํางานกับแหล่ง: youtube_metadata. ตัวเลือกที่ใช้ร่วมกันจะถูกปรับใช้กับทุกแฟ้มคือ ID

ตัวเลือกของแหล่ง: include_formats, include_chapters. เพิ่มตัวเลือกเมื่อสร้างงาน Bulk

รับค่าสะสมที่สมบูรณ์เป็นรายการและบีบอัดข้อมูล gzip NDJSON ชิ้นส่วนผลลัพธ์ แหล่ง ข้อมูล ยัง สามารถ ส่ง ส่วน ต่าง ๆ ที่ ได้ จาก การ เก็บ เมฆ ของ คุณ ได้ ด้วย โดย การ วาง options.result_storage เมื่อสร้าง Bulk งาน เว้นแต่คํากล่าวที่รัดกุมชัดเจนเท่านั้น 24 หนึ่งชั่วโมงหลังจากทั้งหมด Bulk งานเสร็จสมบูรณ์แล้ว

Bulk การประมวลผล API · Python ถึง cURL · Batch JSON ต้องการ

สร้าง Bulk การ ไหล เวียน ของ แหล่ง นี้ · หยุดชั่วคราว และทําต่อและฟื้นตัว

การกู้คืนผิดพลาด

เพิ่มข้อมูล 11- วิดีโอคาหนังคาทอลิก IDไม่เต็ม YouTube URL. ใช้ได้ ID ไม่รับประกันว่าวิดีโอจะเข้าถึงได้: วิดีโอที่เอาออก, ส่วนตัว หรือถูกจํากัดไว้อาจจะล้มเหลวในระหว่างการประมวลผล จํานวนที่ขาดอาจจะ nullการขาดบทหรือรูปแบบไม่ได้ล้มเหลว

สําหรับการตรวจสอบสิทธิ์, ดุลยภาพ, ร้องขอunit-format และอัตราการสิ้นสุดของอัตรา - การอ้างอิงข้อผิดพลาดร่วมกัน เวลา ที่ ใช้ ไป แล้ว อาจ ยัง คง สร้าง งาน อยู่; ตรวจ สอบ งาน ที่ มี อยู่ ก่อน จะ ลอง ทํา ใหม่.

ข้อผิดพลาดและรหัสสถานะ · เมื่อต้องการลองใหม่ · ข้อจํากัดของอัตรา

ไกด์ทีละขั้น: รับข้อมูลและใช้ข้อมูลกํากับภาพวิดีโอ

ราคา

แผนอัตราการใช้ต่อ 1,000 คำขอมาตรฐานสมาชิกรวมการให้เครดิตต่อช่วงเวลาเรียกเก็บเงิน
จ่ายตามการใช้งานUS$0.50ไม่มีค่าบริการรายเดือนเติมเครดิตเมื่อจำเป็น
MicroUS$0.40US$49.00 / เดือน1,000 เครดิต (Chonder)US$50.00 ของ API การใช้) รวม
StarterUS$0.35US$199.00 / เดือน4,000 เครดิต (Chonder)US$200.00 ของ API การใช้) รวม
ProUS$0.30US$499.00 / เดือน10,000 เครดิต (Chonder)US$500.00 ของ API การใช้) รวม
ScaleUS$0.25US$999.00 / เดือน20,000 เครดิต (Chonder)US$1,000.00 ของ API การใช้) รวม
BusinessUS$0.20US$1,999.00 / เดือน40,000 เครดิต (Chonder)US$2,000.00 ของ API การใช้) รวม

หนึ่งแผนต่อบัญชี ใช้เครดิตร่วมกันทั้งสามผลิตภัณฑ์ การใช้งานที่ครอบคลุมด้วยเครดิตในแผนจะไม่ถูกคิดค่าบริการซ้ำ

ราคาและแผนจํากัดในปัจจุบัน