เรียกดูเอกสาร
เอกสารอ้างอิง API
YouTube Search API
ค้นหา YouTube วีดิทัศน์โดยคําค้นและเรียกชื่อเรื่อง, ช่อง, ความยาว, จํานวนมุมมอง และภาพตัวอย่างต่าง ๆ ว่า JSON.
สร้างคำขอ
จํานวนสูงสุดของผลการค้นหาที่จะกลับมา
พารามิเตอร์ขั้นสูง
https://data.flashdata.dev/v1/queries/realtimeพารามิเตอร์
ส่ง source ถึง query ที่ระดับบนสุด ตัวเลือกของแหล่งอยู่ใน params. ช่องข้อมูลทางเลือกสามารถยกเลิกได้
เนื้อหาคำขอ
sourcestring / จำเป็น- กําหนดเป็น youtube_search
querystring / จำเป็น- สืบค้น1 ถึง 2,000 ตัวอักษรค่าปริยาย:
ยังไม่ได้ตั้งค่า paramsobject / ไม่บังคับ- Settings สําหรับการร้องขอนี้ค่าปริยาย:
{} callback_urlstring · nullable / ไม่บังคับ- Async และชุดเท่านั้น สาธารณะ HTTPS เสร็จสมบูรณ์แล้ว URL บนพอร์ต 443ถึง 2,048 ตัวละคร ไม่มีเอกสารรับรองผู้ใช้หรือส่วน URL Omit, ใช้ null หรือข้อความเปล่าสําหรับไม่ให้แจ้งเตือน ในชุดนี้ กําหนดให้แต่ละคําถาม ภายนอกพม่าค่าปริยาย:
ยังไม่ได้ตั้งค่า
จํานวนผลลัพธ์
params.max_resultsinteger / ไม่บังคับ- ร้องขอผลนับ อาจ มี ผล เพียง ไม่ กี่ อย่าง.1 ถึง 20, จํานวนเต็มค่าปริยาย:
20
ตัวกรองการค้นหา
params.filtersobject · nullable / ไม่บังคับ- วันที่อัปโหลดไปเสริม, ประเภทผลลัพธ์, ช่วงเวลา, จัดเรียงและคุณสมบัติการกรอง Omit หรือใช้ null เพื่อไม่มีตัวกรองค่าปริยาย:
ยังไม่ได้ตั้งค่า params.filters.upload_datestring / ไม่บังคับ- กรองด้วยวันที่อัปโหลด1 ถึง 2,000 ตัวอักษรค่าต่าง ๆ:
today / last_hour / this_week / this_month / this_yearค่าปริยาย:ยังไม่ได้ตั้งค่า params.filters.typestring / ไม่บังคับ- กรองด้วยประเภทผลลัพธ์1 ถึง 2,000 ตัวอักษรค่าต่าง ๆ:
video / channel / playlist / movieค่าปริยาย:ยังไม่ได้ตั้งค่า params.filters.durationstring / ไม่บังคับ- กรองด้วยความยาววิดีโอหน่วยเป็นนาที1 ถึง 2,000 ตัวอักษรค่าต่าง ๆ:
<4 / 4-20 / >20ค่าปริยาย:ยังไม่ได้ตั้งค่า params.filters.sort_bystring / ไม่บังคับ- ผลการสั่งซื้อ ใช้ Omit YouTubeการเรียงลําดับปริยาย1 ถึง 2,000 ตัวอักษรค่าต่าง ๆ:
rating / relevance / view_count / upload_dateค่าปริยาย:ยังไม่ได้ตั้งค่า params.filters.360boolean / ไม่บังคับ- ตั้งค่า true ที่ต้องการ 360 โดดเด่น
trueหรือfalseค่าปริยาย:ยังไม่ได้ตั้งค่า params.filters.3dboolean / ไม่บังคับ- ตั้งค่า true ต้องการคุณสมบัติ 3d
trueหรือfalseค่าปริยาย:ยังไม่ได้ตั้งค่า params.filters.4kboolean / ไม่บังคับ- ตั้งค่า true ต้องการคุณสมบัติ 4k
trueหรือfalseค่าปริยาย:ยังไม่ได้ตั้งค่า params.filters.creative_commonsboolean / ไม่บังคับ- ตั้ง true เพื่อใช้คุณสมบัติสร้างสรรค์ร่วมกัน
trueหรือfalseค่าปริยาย:ยังไม่ได้ตั้งค่า params.filters.hdboolean / ไม่บังคับ- ตั้งค่า true เพื่อต้องการคุณสมบัติของ HD
trueหรือfalseค่าปริยาย:ยังไม่ได้ตั้งค่า params.filters.hdrboolean / ไม่บังคับ- ตั้ง true เพื่อเรียกดูคุณสมบัติ hdr
trueหรือfalseค่าปริยาย:ยังไม่ได้ตั้งค่า params.filters.liveboolean / ไม่บังคับ- ตั้งค่า true ต้องการสิ่งอํานวยความสะดวก
trueหรือfalseค่าปริยาย:ยังไม่ได้ตั้งค่า params.filters.locationboolean / ไม่บังคับ- ตั้งค่า true ต้องการตําแหน่งสถานที่
trueหรือfalseค่าปริยาย:ยังไม่ได้ตั้งค่า params.filters.purchasedboolean / ไม่บังคับ- ตั้งค่า true ต้องการคุณสมบัติที่ซื้อแล้ว
trueหรือfalseค่าปริยาย:ยังไม่ได้ตั้งค่า params.filters.subtitlesboolean / ไม่บังคับ- ตั้งค่า true เพื่อต้องการคุณสมบัติคําบรรยาย
trueหรือfalseค่าปริยาย:ยังไม่ได้ตั้งค่า params.filters.vr180boolean / ไม่บังคับ- ตั้งค่า true เพื่อต้องการลักษณะ vir180
trueหรือfalseค่าปริยาย:ยังไม่ได้ตั้งค่า
คำตอบ
Realtime กลับค่า status: done. อ่านผลลัพธ์ที่ส่งมาจากแหล่ง results[0].results; usage.credits บันทึกค่าใช้จ่าย.
การค้นหาผลลัพธ์ที่แสดงออกมา มีการค้นหาอยู่ totalResults และของที่นํามาคืน totalResults หมายเลขคืนแล้ว ไม่ใช่ YouTubeตรงกับแค็ตตาล็อกทั้งหมด
อ่านผลที่ออกมา
บันทึกความสําเร็จ JSON ตอบกลับเป็น response.json. บันทึกนี้เป็น read-response.py และเรียกไพธอน read-response.py. มันใช้เฉพาะ Pythonห้องสมุดมาตรฐาน และไม่มีการร้องขอใหม่
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 = [
{"videoId": item.get("videoId"), "title": item.get("title"), "channel": item.get("channel")}
for item in result.get("results", [])
]
print(json.dumps(output, ensure_ascii=False, indent=2))max_results ค่าปริยายไปยัง 20 และยอมรับ 1 ถึง 20. รองรับการค้นหาที่ขยายออกไปยัง 700 ด้วยอัตราการใช้งานที่แยกกัน
ตัวกรองอยู่ใน params.filters, ไม่ใช่ด้านข้างของพารัม ตัวกรอง Omit ที่ใช้ YouTubeพฤติกรรมปกติ ราย ละเอียด ที่ ได้ คืน มา ขึ้น อยู่ กับ ชนิด ของ ผล และ ความ สามารถ.
ช่องข้อมูลทั้งหมด
| ช่องข้อมูล | คําอธิบาย |
|---|---|
sourcestring | สิ่งที่ร้องขอมา API แหล่งข่าว |
statusstring | เสร็จสิ้นเมื่อการร้องขอจริง สําเร็จ |
created_atstring | ช่วงเวลาการสร้างแบบ ISO 8601 |
usage.creditsnumber | บัตรเครดิตตามที่ขอ จากแผนของคุณ |
results[0].querystring | สืบค้นดู |
results[0].totalResultsinteger | จํานวนของผลลัพธ์ที่ได้กลับมา |
results[0].resultsarray | สืบค้นผลในลําดับที่ส่งกลับมา |
results[0].results[].videoIdstring | YouTube วิดีโอ ID. |
results[0].results[].titlestring | ชื่อวิดีโอ |
results[0].results[].channelstring | ชื่อทางช่อง |
results[0].results[].channelIdstring · nullable | ช่อง ID เมื่อมีการใช้งาน |
results[0].results[].channelUrlstring · nullable | ช่อง URL เมื่อมีการใช้งาน |
results[0].results[].durationnumber · nullable | ระยะเวลาวิดีโอเป็นวินาที |
results[0].results[].durationStringstring · nullable | ฟอร์แมตความยาวของวิดีโอเมื่อมีใช้งาน |
results[0].results[].viewCountnumber · nullable | แสดงจํานวนเมื่อมี |
results[0].results[].uploadDatestring · nullable | วันที่อัปโหลดเมื่อมีการใช้งานอยู่ |
results[0].results[].descriptionstring · nullable | คําอธิบายที่ตัดมา จนถึง 500 ตัวอักษร, หรือ null เมื่อไม่มี |
results[0].results[].thumbnailsarray | ภาพตัวอย่าง URLs และขนาด |
ช่องข้อมูลด้านบน จะใช้อธิบายค่าปริยาย JSON ตอบสนอง JSONข้อความธรรมดาและ Markdown รูปแบบ.
Async คืนค่าเป็นใบเสร็จงานหนึ่งตัว; จํานวนครั้งจะคืนค่ากลับมาเป็นหนึ่งตัว สืบค้น. โปรดตรวจสอบสถานะงานพิมพ์แต่ละงาน และรับผลของมันโดยใช้ที่อยู่เชื่อมโยงที่ส่งกลับ
Async วงจรชีวิตแบบชุด
การรับช่วงนําใบเสร็จกลับมา ไม่ใช่ผลลัพธ์ Async สร้างงานหนึ่งงาน; กลุ่มต่าง ๆ จะคืนค่ากลับมาเป็นงานที่แยกไว้ queries[] สําหรับทุก ๆ คนที่สอบถามเจ้า ติดตามและรับงานแต่ละงานเป็นอิสระ
ส่งข้อมูลไปยัง data.flashdata.dev; สืบค้นสถานะงานและผลลัพธ์จาก api.flashdata.dev กับ X-API-Key แบบเดียวกัน ความ เกี่ยว พัน API ตัวอย่างพื้นฐานที่ใช้ Python ถึง cURL.
1. บันทึกงาน IDs
เก็บรายการที่ต้องการของแหล่งนี้เมื่อสลับไปยัง Async สําหรับ Batchใส่การร้องขอแต่ละในลําดับของ JSON วัตถุ บันทึกงานที่ส่งกลับทั้งหมด ID
2. ตรวจสอบสถานะ
GET https://api.flashdata.dev/v2/jobs/{jobId}pending/processing: โพลด้วยความล่าช้าและความเคารพRetry-Afterเมื่อถึงวันนี้completed: รับผลfailed: สืบค้นเมื่อjob.error.อ่าน job.status ไม่ใช่สถานะใบเสร็จรับส่ง
ตรวจสอบสถานะที่: Python ถึง cURL
สถานะงาน API อ้างอิง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_search",
"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 ส่วนหัว |
idstring | Joob ID. |
sourcestring | ต้องการแหล่งข้อมูล |
statusstring | เสร็จสมบูรณ์หรือล้มเหลว |
linksarray | สถานะและการเชื่อมโยงผลลัพธ์ การแจ้งให้ทราบไม่รวมเนื้อหาหรือรายการที่มีผล API กุญแจ |
links[].relstring | ตัวตนหรือผลลัพธ์ |
links[].hrefstring | การจัดการสัมบูรณ์ API URL2; ยืนยันตัวด้วย API กุญแจ |
links[].methodstring | GET. |
การกู้คืนผิดพลาด
การค้นหาที่ประสบความสําเร็จอาจส่งรายการที่น้อยกว่าที่ต้องการกลับมา ทําการกรองหรือปรับค่าคําค้นก่อนทําการส่งข้อมูลอีกรูปแบบหนึ่ง แต่ผลลัพธ์ที่ว่างอยู่ ไม่ใช่ความล้มเหลวของงาน
สําหรับการตรวจสอบสิทธิ์, ดุลยภาพ, ร้องขอunit-format และอัตราการสิ้นสุดของอัตรา - การอ้างอิงข้อผิดพลาดร่วมกัน เวลา ที่ ใช้ ไป แล้ว อาจ ยัง คง สร้าง งาน อยู่; ตรวจ สอบ งาน ที่ มี อยู่ ก่อน จะ ลอง ทํา ใหม่.
ข้อผิดพลาดและรหัสสถานะ · เมื่อต้องการลองใหม่ · ข้อจํากัดของอัตรา
ไกด์ทีละขั้น: ค้นหาวีดิทัศน์สําหรับหัวข้อ
ราคา
| แผน | อัตราการใช้ต่อ 1,000 คำขอมาตรฐาน | สมาชิก | รวมการให้เครดิตต่อช่วงเวลาเรียกเก็บเงิน |
|---|---|---|---|
| จ่ายตามการใช้งาน | US$0.50 | ไม่มีค่าบริการรายเดือน | เติมเครดิตเมื่อจำเป็น |
| Micro | US$0.40 | US$49.00 / เดือน | 1,000 เครดิต (Chonder)US$50.00 ของ API การใช้) รวม |
| Starter | US$0.35 | US$199.00 / เดือน | 4,000 เครดิต (Chonder)US$200.00 ของ API การใช้) รวม |
| Pro | US$0.30 | US$499.00 / เดือน | 10,000 เครดิต (Chonder)US$500.00 ของ API การใช้) รวม |
| Scale | US$0.25 | US$999.00 / เดือน | 20,000 เครดิต (Chonder)US$1,000.00 ของ API การใช้) รวม |
| Business | US$0.20 | US$1,999.00 / เดือน | 40,000 เครดิต (Chonder)US$2,000.00 ของ API การใช้) รวม |
หนึ่งแผนต่อบัญชี ใช้เครดิตร่วมกันทั้งสามผลิตภัณฑ์ การใช้งานที่ครอบคลุมด้วยเครดิตในแผนจะไม่ถูกคิดค่าบริการซ้ำ
ราคาและแผนจํากัดในปัจจุบัน