# Apify ทางเลือกสำหรับ YouTube ข้อมูล

เปรียบเทียบ FlashData กับ Apify YouTube นักแสดง: ราคาเฉพาะนักแสดง งบประมาณการใช้งานรายเดือน ข้อมูลเมตาและเวิร์กโฟลว์คำอธิบายภาพ และตัวอย่างการย้ายข้อมูล Python และ Bash ที่รันได้

จากนักแสดงวิ่งไปจนถึงการค้นหาวิดีโอโดยตรง เริ่มต้นด้วย IDs ที่ทราบ รักษาฟิลด์แอปพลิเคชันของคุณไว้ และย้ายผู้ผลิตหนึ่งรายก่อนที่จะเปลี่ยนไปป์ไลน์ที่เหลือ

Apify ตรวจสอบข้อเท็จจริงแล้ว 2026-11-10 อัตรา FlashData และค่าเผื่อการทดลองใช้ใช้แคตตาล็อกสาธารณะในปัจจุบัน

- [คุณสมบัติ](#features)
- [ราคานักแสดง](#actors)
- [เปรียบเทียบค่าใช้จ่าย](#costs)
- [ย้ายการค้นหา](#migration)
- [ชุดข้อมูลและกำหนดการ](#production)
- [สำหรับตัวแทน AI](#agents)
- [คำถามที่พบบ่อย](#faq)

<a id="features"></a>
## เปรียบเทียบคุณสมบัติ

### ทำให้การค้นหาแบบกำหนดเป้าหมายประหยัด

| คุณสมบัติ | FlashData | Apify YouTube นักแสดง |
| --- | --- | --- |
| การใช้งานแบบชำระเงินโดยไม่มีการสมัครสมาชิกรายเดือน | ใช่ — เครดิตแบบจ่ายตามการใช้งาน เติมเงินตั้งแต่ $10 | ฟรีงบประมาณ จากนั้นจึงมีแผนแบบชำระเงิน — $5/เดือน ฟรี; Starter $19/เดือน พร้อมการใช้งาน $19 |
| ข้อมูลเมตาสำหรับ 1,000 วิดีโอที่รู้จัก IDs | $0.50 — อัตราการใช้งานแบบจ่ายตามการใช้งาน | $3.00 — อัตราสตรีมเมอร์/youtube-scraper · Starter หักออกจากงบประมาณของแผน |
| การค้นหาวิดีโอเดียว | ใช่ — หนึ่งรายการที่ชัดเจน video_id | ขึ้นอยู่กับนักแสดง — สตรีมเมอร์รองรับมัน API ขณะนี้ Dojo ไม่รวมวิดีโอเดี่ยว URLs |

### ค้นหาและปรับปรุงวิดีโอที่แอปของคุณต้องการ

| คุณสมบัติ | FlashData | Apify YouTube นักแสดง |
| --- | --- | --- |
| การค้นพบคำหลักพร้อมตัวกรองการค้นหา | ใช่ — ตัวกรองวันที่ ระยะเวลา ประเภท และการเรียงลำดับ | ใช่ — searchQueries พร้อมตัวกรองการเรียงลำดับ วันที่ และวิดีโอ |
| ชื่อ ช่องทาง และข้อมูลการมีส่วนร่วม | ใช่ — ค้นหาข้อมูลเมตาโดยเฉพาะตามวิดีโอ ID | ใช่ — บันทึกวิดีโอในชุดข้อมูลนักแสดง |
| รีเฟรชข้อมูลเมตาแยกจากคำอธิบายภาพ | ใช่ — ขอเพียง youtube_metadata สำหรับการรีเฟรช | ใช่ — วิ่งด้วย transcriptionAndSubtitle=NONE |

### เตรียมหลักฐานคำบรรยายสำหรับการสมัครของคุณ

| คุณสมบัติ | FlashData | Apify YouTube นักแสดง |
| --- | --- | --- |
| เลือกภาษาคำบรรยายที่มีอยู่หลายภาษา | ภาษาที่ชัดเจนมากถึง 10 — แทร็กบวกข้อผิดพลาดต่อภาษาในคำขอถอดเสียงหนึ่งรายการ | นักแสดงหลัก: ภาษาเดียวหรืออะไรก็ได้ — ผู้แสดงที่แตกต่างกันสามารถเปิดเผยอินพุตที่แตกต่างกันได้ |
| เลือกที่มาของคำอธิบายภาพที่เข้มงวด | ผู้อัปโหลดหรือสร้างขึ้น YouTube — params.auto เลือกหนึ่งต้นทาง ไม่มีทางเลือกแบบข้ามต้นทาง | นักแสดงหลัก: การตั้งค่าต้นกำเนิด — preferAutoGeneratedSubtitles เป็นการตั้งค่า ไม่ใช่สัญญาเดียวกัน |
| ข้อความประทับเวลาสำหรับการอ้างอิงแหล่งที่มา | ส่วน JSON ที่ทำให้เป็นมาตรฐาน — ส่งข้อความด้วย start/end ครั้งในหน่วยวินาที | คำบรรยาย SRT, VTT หรือ XML — แยกวิเคราะห์รูปแบบคำบรรยายที่เลือกสำหรับการกำหนดเวลาการอ้างอิง |
| ข้อความธรรมดาสำหรับการสรุป | fullText ควบคู่ไปกับกลุ่ม | รูปแบบคำบรรยายข้อความธรรมดา — หรือแยกวิเคราะห์และเข้าร่วมเอาต์พุตคำบรรยายตามกำหนดเวลา |
| วิดีโอที่ไม่มีข้อความถอดเสียงอยู่ | แจ้งเส้นทางที่หายไป — ไม่มีการสร้างคำพูดเป็นข้อความ | การถอดความ AI เสริม — โหมดทางเลือกหรือโหมดถอดเสียงตลอดเวลา ค่าธรรมเนียมการใช้งานแยกต่างหาก |

### รันเวิร์กโฟลว์โดยใช้โค้ดบูรณาการน้อยลง

| คุณสมบัติ | FlashData | Apify YouTube นักแสดง |
| --- | --- | --- |
| ผลลัพธ์โดยตรงโดยไม่ต้องจัดการทรัพยากรของนักแสดง | ผลลัพธ์แบบเรียลไทม์[] + การใช้งาน — ไม่มีนักแสดง ID บิลด์หรือการตั้งค่าหน่วยความจำ | นักแสดงรัน + สคีมาอินพุต — ตำแหน่งข้อมูลการซิงค์ยังสามารถส่งคืนผลลัพธ์ในการเรียก HTTP หนึ่งครั้ง |
| ประมวลผลรายการที่บันทึกไว้ในคอนโซลของเบราว์เซอร์ | Bulk Jobs โดยใช้ไฟล์ ID วิดีโอ — ติดตามความคืบหน้าและดึงข้อมูลรายการและส่วนผลลัพธ์ | คอนโซลนักแสดงพร้อมอินพุต URL — รองรับการนำเข้าแผ่นงาน CSV หรือ Google |
| ผลลัพธ์เบื้องหลังหลังจากที่ไคลเอ็นต์ยกเลิกการเชื่อมต่อ | บันทึก async หรืองานจำนวนมาก ID — ตรวจสอบสถานะต่อและดึงข้อมูลเอาต์พุต completed | การรันและชุดข้อมูลของนักแสดงที่บันทึกไว้ IDs — ตรวจสอบการรันและเรียกข้อมูลรายการชุดข้อมูล |
| รูปแบบเอาต์พุตของแอปพลิเคชันและเอเจนต์ | JSON ข้อความธรรมดา หรือ Markdown | การส่งออกชุดข้อมูล — JSON, CSV, Excel และรูปแบบอื่นๆ |
| คอลเลกชันที่เกิดซ้ำ | ตัวกำหนดเวลาหรือโฮสต์ตัวแทนของคุณ — ใช้ข้อมูลประจำตัวของเจ้าของซ้ำและสถานะงานที่บันทึกไว้ | ตารางนักแสดงนำชาย — Cron การตั้งค่าเขตเวลา และ webhooks เสริม |
| ข้อมูลเมตา คำบรรยาย และ Google ค้นหาในสัญญา API เดียว | หนึ่งแบบสอบถาม API สิทธิ์เฉพาะแหล่งที่มา — ยอดคงเหลือในบัญชีที่ใช้ร่วมกัน ราคาเฉพาะแหล่งที่มา | แพลตฟอร์มที่ใช้ร่วมกัน สคีมาเฉพาะนักแสดง — เลือกและรักษาอินพุตและเอาต์พุตของนักแสดงที่เกี่ยวข้อง |
| CLI, SDK และ MCP สำหรับระบบอัตโนมัติ | ใช่ — แบบสแตนด์อโลน CLI; Python, TypeScript และ Go SDK; MCP | ใช่ — Apify CLI, Python/JavaScript ลูกค้า และ MCP |

แถวเฉพาะนักแสดงหมายถึงสตรีมเมอร์/youtube-scraper เว้นแต่จะมีการตั้งชื่อนักแสดงคนอื่น บริการทั้งสองมี SDK CLI และ MCP Apify ยังรันโค้ดที่กำหนดเอง ตารางเวลาที่โฮสต์ และโปรแกรมขูดของเว็บไซต์อื่นๆ

### ทำให้การค้นหาวิดีโอเดียวมีขนาดเล็ก

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

### เก็บโมเดลข้อมูลของแอปพลิเคชันของคุณไว้

แมปฟิลด์ที่แอปของคุณอ่านจริง รักษาจำนวน null รักษาวันที่เผยแพร่ให้ชัดเจน และบันทึกอาร์เรย์ JSON สำหรับผู้บริโภคที่เคยอ่านรายการชุดข้อมูลก่อนหน้านี้

### แยกการค้นพบออกจากการเพิ่มคุณค่า

ดำเนินการขั้นตอนการค้นหาที่เป็นประโยชน์ต่อไป ขจัดวิดีโอที่ซ้ำกัน IDs จากนั้นเพิ่มเฉพาะวิดีโอที่ผลิตภัณฑ์ของคุณต้องการด้วย FlashData

<a id="actors"></a>
## ไม่มีราคาเดี่ยว Apify YouTube

ผู้เขียนนักแสดงเลือกปัจจัยเข้า ผลลัพธ์ และแบบจำลองการกำหนดราคา นักแสดงทั้งสามคนนี้ใช้เหตุการณ์ต่อผลลัพธ์ แต่มีความสามารถที่แตกต่างกัน ราคาด้านล่างคือ USD ต่อ 1,000 วิดีโอที่ส่งคืน

| นักแสดง | วิดีโอฟรี / 1,000 | Starter | Scale | Business | เลือกมันเพื่อ |
| --- | --- | --- | --- | --- | --- |
| streamers/youtube-scraper | $4.00 | $3.00 | $2.60 | $2.40 | วิดีโอ URLs การค้นพบและคำบรรยายที่มีอยู่เพิ่มเติม นี่คือนักแสดงของเครื่องคิดเลข |
| streamers/youtube-channel-scraper | $1.30 | $1.00 | $0.80 | $0.50 | การค้นพบช่องด้วยข้อมูลวิดีโอพื้นฐาน ไม่ใช่การค้นหาข้อมูลเมตาแบบเต็มสำหรับ ID โดยพลการ |
| apidojo/youtube-scraper | $0.50 | $0.50 | $0.50 | $0.50 | อินพุตการค้นพบ README ปัจจุบันไม่รวมวิดีโอเดี่ยว URLs และต้องมีวิดีโออย่างน้อย 10 ต่ออินพุต สาธิตฟรี: 5 รัน/เดือน สูงสุด 10 รายการ/run. |

แผนรายเดือนแบบบริการตนเอง: Starter แมปกับ Bronze, Scale ถึง Silver และ Business ถึง Gold ตัวดำเนินการค้นพบที่ถูกกว่าจะไม่ถูกแทนที่ในเครื่องคิดเลขวิดีโอที่รู้จัก

### ตรวจสอบเหตุการณ์ที่เรียกเก็บเงินได้

Apify รองรับรูปแบบการจ่ายต่อเหตุการณ์ การจ่ายต่อการใช้งาน และรูปแบบรวม สำหรับสตรีมเมอร์/youtube-scraper ให้นับเหตุการณ์ผลลัพธ์และส่วนเสริมที่เลือก ไม่ต้องเพิ่มค่าธรรมเนียมการประมวลผลทั่วไปโดยอัตโนมัติ ตรวจสอบรายละเอียดกิจกรรมของการวิ่งนักแสดงของคุณเอง

### แยกคำบรรยายที่มีอยู่ออกจากการถอดเสียงแบบ AI

นักแสดงหลักสามารถใส่คำบรรยายที่มีอยู่ในผลลัพธ์ได้ การถอดเสียง AI จะถูกเรียกเก็บเงินต่อนาทีที่เริ่มต้นต่อวิดีโอ: ใน Starter วิดีโอความยาว 10 นาทีจะเพิ่ม $0.41 ก่อนเหตุการณ์ผลลัพธ์ $0.003 ข้อมูลสรุป AI คำอธิบาย และการกรองวันที่ของช่องมีราคากิจกรรมของตัวเองด้วย FlashData ดึงข้อมูลแทร็กที่มีอยู่ มันไม่สร้างคำบรรยายที่ขาดหายไป

### แยกการค้นพบออกจากการเพิ่มคุณค่า

ใช้วิดีโอที่รู้จัก IDs เมื่อนั่นคือสิ่งที่แอปของคุณมีอยู่แล้ว การรวบรวมข้อมูลการค้นพบสามารถส่งคืนวิดีโอที่คุณไม่เคยใช้ การค้นพบงบประมาณและการตกแต่งใดๆ ที่ตามมาแยกจากกัน

<a id="costs"></a>
## เปรียบเทียบอัตราต่อหน่วยและค่าธรรมเนียมรายเดือน

USD แผนรายการรายเดือน โมเดลนี้ใช้เหตุการณ์ผลลัพธ์ของสตรีมเมอร์/youtube-scraper หนึ่งวิดีโอที่ส่งคืนต่ออินพุต ID โดยปิดการกรองวันที่และส่วนเสริม AI คำบรรยายที่มีอยู่จะใช้การตั้งค่า ALWAYS_SUBTITLES ข้อมูลเมตาและคำอธิบายภาพเป็นผลลัพธ์ของนักแสดงหนึ่งรายการ แต่มีคำขอ FlashData สองรายการ FlashData ราคามาจากแคตตาล็อกข้อมูลปัจจุบัน YouTube ยอดคงเหลือที่รวมไว้ทั้งหมดของแต่ละแผนจะถูกจัดสรรให้กับเวิร์กโฟลว์นี้ก่อนที่จะเพิ่มการใช้งานเพิ่มเติม Apify แวะจอดฟรีด้วยงบประมาณ $5 แผนแบบชำระเงินจะเพิ่มการใช้งานเกินกว่างบประมาณที่รวมไว้ FlashData การซื้อจากยอดคงเหลือเป็นศูนย์จะรวมการเติมเงินขั้นต่ำ $10 เมื่อจำเป็นต้องมีเครดิตเพิ่มเติม ไม่รวมภาษี ส่วนลดรายปี นักแสดงคนอื่นๆ พื้นที่จัดเก็บแยกต่างหาก/export และความพยายาม failed หากเป็นศูนย์วิดีโอ แผนการชำระเงินที่เลือกยังคงมีค่าบริการรายเดือน ไม่ได้กำหนดราคาต่อวิดีโอที่มีประสิทธิภาพ

### Apify แผนแพลตฟอร์ม

| Apify แผน | ค่าบริการรายเดือน | รวมการใช้งาน/เดือน | นักแสดงหลัก / 1,000 วิดีโอ | วิดีโอภายในงบประมาณนี้ |
| --- | --- | --- | --- | --- |
| ฟรี | $0.00 | $5.00 | $4.00 | 1,250 |
| Starter | $19.00 | $19.00 | $3.00 | 6,333 |
| Scale | $199.00 | $199.00 | $2.60 | 76,538 |
| Business | $999.00 | $999.00 | $2.40 | 416,250 |

จำนวนเหล่านี้จะจัดสรรงบประมาณทั้งหมดให้กับกิจกรรมผลลัพธ์โดยไม่ต้องใช้ส่วนเสริมหรือการใช้งานแพลตฟอร์มอื่นๆ หากคุณเก็บ Apify ไว้สำหรับนักแสดงคนอื่น การสมัครสมาชิกจะยังคงอยู่ เปรียบเทียบการใช้งานที่เพิ่มขึ้นกับงบประมาณที่เหลืออยู่ของคุณ

### FlashData YouTube แผนข้อมูล

| FlashData แผน | ต่อคำขอ 1,000 | ค่าบริการรายเดือน | จำนวนคำขอที่รวมต่อเดือน |
| --- | --- | --- | --- |
| ชำระตามการใช้งาน | $0.50 | $0.00 | 0 |
| Micro | $0.40 | $49.00 | 125,000 |
| Starter | $0.35 | $199.00 | 571,428 |
| Pro | $0.30 | $499.00 | 1,666,666 |
| Scale | $0.25 | $999.00 | 4,000,000 |
| Business | $0.20 | $1,999.00 | 10,000,000 |

นี่คืออัตรา YouTube Data มาตรฐาน Extended Search และ Download มีราคาแยกต่างหาก [ราคาทั้งหมด](https://flashdata.dev/th/pricing/youtube-data).

### ตัวอย่างการทำงาน

FlashData จ่ายตามการใช้งาน เทียบกับ Apify Starter และสตรีมเมอร์/youtube-scraper. ข้อมูลเมตาและคำบรรยายที่มีอยู่เป็นกิจกรรมผลลัพธ์ของนักแสดงหนึ่งรายการ แต่มีคำขอ FlashData สองรายการ นี่เป็นการประมาณการการใช้งานและค่าใช้จ่ายรายเดือน ไม่ใช่การอ้างสิทธิ์ในฟิลด์ตอบกลับที่เหมือนกัน

| วิดีโอ | ขั้นตอนการทำงาน | คำขอ FlashData | FlashData การใช้งานตามแบบจำลอง | การใช้กิจกรรมของนักแสดง | Apify ค่าใช้จ่ายรายเดือนรวมค่าธรรมเนียมแล้ว |
| --- | --- | --- | --- | --- | --- |
| 1,000 | ข้อมูลเมตาสำหรับวิดีโอที่รู้จัก IDs | 1,000 | $0.50 | $3.00 | $19.00 |
| 1,000 | ข้อมูลเมตา + คำอธิบายภาพที่มีอยู่ | 2,000 | $1.00 | $3.00 | $19.00 |
| 10,000 | ข้อมูลเมตาสำหรับวิดีโอที่รู้จัก IDs | 10,000 | $5.00 | $30.00 | $30.00 |
| 10,000 | ข้อมูลเมตา + คำอธิบายภาพที่มีอยู่ | 20,000 | $10.00 | $30.00 | $30.00 |
| 100,000 | ข้อมูลเมตาสำหรับวิดีโอที่รู้จัก IDs | 100,000 | $50.00 | $300.00 | $300.00 |
| 100,000 | ข้อมูลเมตา + คำอธิบายภาพที่มีอยู่ | 200,000 | $100.00 | $300.00 | $300.00 |

FlashData การซื้อจากยอดคงเหลือเป็นศูนย์จะต้องมีการเติมเงินขั้นต่ำ $10 ค่าธรรมเนียมของ Apify มีจำนวนการใช้งานที่รวมอยู่แล้ว อย่าเพิ่มการใช้งานนั้นสองครั้ง เครื่องคิดเลข HTML ช่วยให้คุณสามารถเลือกทั้งสองแผนได้อย่างอิสระ

### เข้าถึงได้ฟรี

Apify ฟรี มีงบประมาณที่ใช้ร่วมกัน $5 ต่อเดือน สามารถใช้ข้อจำกัดการสาธิตนักแสดงแต่ละคนได้เช่นกัน API Dojo Actor ที่แสดงข้างต้นจำกัดการรันเดโมฟรีห้าครั้งต่อเดือน และสิบรายการต่อการรัน

การสมัครใช้งานที่ได้รับการยืนยัน FlashData ที่มีสิทธิ์จะได้รับเบี้ยเลี้ยงเริ่มต้นสูงถึง 4,000 มาตรฐาน YouTube คำขอข้อมูล สิ่งนี้ไม่ได้รีเซ็ตทุกเดือน

<a id="migration"></a>
## เก็บเครื่องอ่านชุดข้อมูลไว้ แทนที่การค้นหาหนึ่งรายการ

เริ่มต้นด้วยวิดีโอสาธารณะที่รู้จัก ID ตัวอย่างเขียนฟิลด์นักแสดงที่คุ้นเคยที่เลือกไว้เป็นอาร์เรย์ JSON และบันทึกการตอบสนอง FlashData ที่สมบูรณ์แยกกัน

### 1. ตั้งค่าการเข้าถึงและแมปคำขอ

สร้างหรือใช้คีย์เดิมที่มีสิทธิ์ youtube_metadata ใน [คีย์ API](https://flashdata.dev/app/api-keys) แล้วตรวจสอบ [เครดิตที่ใช้ได้](https://flashdata.dev/app/billing) เอเจนต์ควรใช้สิทธิ์เดิมก่อน หรือใช้สิทธิ์ทดลองเมื่อเข้าเกณฑ์ อย่าใส่คีย์ในแชต

การเรียกนักแสดงที่มีอยู่ สำหรับการอ้างอิงการย้าย:

```bash
# The existing Actor call, shown for migration reference.
curl --fail-with-body --silent --show-error --max-time 310 \
  --request POST \
  'https://api.apify.com/v2/acts/streamers~youtube-scraper/run-sync-get-dataset-items' \
  --header "Authorization: Bearer $APIFY_TOKEN" \
  --header 'Content-Type: application/json' \
  --data '{"startUrls":[{"url":"https://www.youtube.com/watch?v=FUfGcZ092b0"}],
    "maxResults":1,"maxResultsShorts":0,"maxResultStreams":0,
    "transcriptionAndSubtitle":"NONE","aiVideoDescription":false,"aiVideoSummary":false}'
```

FlashData JSON ร่างกายสำหรับ POST /v1/queries/realtime:

```json
{
  "source": "youtube_metadata",
  "video_id": "FUfGcZ092b0",
  "params": {
    "include_formats": false,
    "include_chapters": true
  }
}
```

จุดสิ้นสุดการซิงค์ของ Actor สามารถส่งคืนรายการในการตอบกลับ HTTP หนึ่งครั้งได้แล้ว ย้ายคำขอ เอนเวโลป และฟิลด์ อย่าเพิ่มการสำรวจที่ไม่จำเป็น

### 2. บันทึกสคริปต์ จากนั้นเรียกใช้

เลือก Python หรือ Bash แต่ละโฟลเดอร์เอาต์พุตใหม่จะส่งคำขอหนึ่งรายการ การใช้โฟลเดอร์ซ้ำเพื่ออ่านเอาต์พุตที่บันทึกไว้ ถูกขัดจังหวะหรือ failed พยายามหยุดเพื่อตรวจสอบ ทั้งสองเวอร์ชันใช้ไฟล์เดียวกัน

#### Python

ต้องใช้ Python 3.10+ ติดตั้งไลบรารีด้วย python -m pip install requests ในโฟลเดอร์ทำงานใหม่ ให้บันทึกสคริปต์ฉบับเต็มด้านล่างเป็น video-lookup.py ก่อนเรียกใช้

```python
import argparse
import getpass
import json
import math
import os
import re
from pathlib import Path

import requests

parser = argparse.ArgumentParser()
parser.add_argument("video_id")
parser.add_argument("folder", type=Path)
args = parser.parse_args()
if not re.fullmatch(r"[A-Za-z0-9_-]{11}", args.video_id):
    raise SystemExit("Use an 11-character YouTube video ID")
body = {"source": "youtube_metadata", "video_id": args.video_id,
        "params": {"include_formats": False, "include_chapters": True}}
out = args.folder
if not out.exists():
    key = os.environ.get("FLASHDATA_API_KEY") or getpass.getpass("FlashData API key: ")
    if not key.strip():
        raise SystemExit("An API key is required")
    out.mkdir(parents=True)
    (out / "request.json").write_text(json.dumps(body), encoding="utf-8")
    try:
        response = requests.post(
            "https://data.flashdata.dev/v1/queries/realtime", json=body,
            headers={"X-API-Key": key, "Accept": "application/json"},
            timeout=120, allow_redirects=False,
        )
    except requests.RequestException:
        raise SystemExit("Outcome unknown. Keep this folder and check History before retrying.")
    (out / "response.json").write_bytes(response.content)
    (out / "http-status.txt").write_text(str(response.status_code), encoding="utf-8")
    (out / "retry-after.txt").write_text(response.headers.get("Retry-After", ""), encoding="utf-8")
else:
    print("Reading saved output; no API call.")

try:
    saved = json.loads((out / "request.json").read_text(encoding="utf-8"))
    status = (out / "http-status.txt").read_text(encoding="utf-8").strip()
except (OSError, ValueError):
    raise SystemExit("Incomplete attempt. Inspect this folder and History before retrying.")
if saved != body:
    raise SystemExit("This folder belongs to a different request. Use a new folder.")
if status != "200":
    raise SystemExit(f"HTTP {status}: inspect response.json and retry-after.txt")
data = json.loads((out / "response.json").read_text(encoding="utf-8"))
if not isinstance(data, dict) or data.get("status") != "done" or data.get("source") != body["source"]:
    raise SystemExit("Request did not complete successfully; inspect response.json")
items = data.get("results")
if not isinstance(items, list) or len(items) != 1 or not isinstance(items[0], dict):
    raise SystemExit("Expected one metadata result")
item = items[0]
if item.get("videoId") != args.video_id:
    raise SystemExit("Returned video does not match the request")
seconds = item.get("duration")
duration = None
if seconds is not None:
    if type(seconds) not in (int, float) or not math.isfinite(seconds) or seconds < 0:
        raise SystemExit("Invalid duration")
    whole = int(seconds)
    duration = f"{whole // 3600:02d}:{whole % 3600 // 60:02d}:{whole % 60:02d}"
mapped = [{
    "id": item["videoId"],
    "url": "https://www.youtube.com/watch?v=" + item["videoId"],
    "title": item.get("title"), "text": item.get("description"),
    "channelName": item.get("channel"), "channelId": item.get("channelId"),
    "viewCount": item.get("viewCount"), "likes": item.get("likeCount"),
    "commentsCount": item.get("commentCount"), "duration": duration,
    "uploadDateRaw": item.get("uploadDate"),
    "captionLanguages": item.get("transcriptLanguages"),
}]
(out / "dataset-items.json").write_text(
    json.dumps(mapped, ensure_ascii=False, indent=2) + "\n", encoding="utf-8"
)
print(f"Saved {out}/dataset-items.json; actual usage: {json.dumps(data.get('usage'))}")

```

เรียกใช้จากโฟลเดอร์นั้น แทนที่ ID ด้วยวิดีโอสาธารณะจากชุดข้อมูลของคุณ:

```bash
python video-lookup.py FUfGcZ092b0 video-001
```

#### Bash

ต้องใช้ Bash, cURL 7.76+ และ jq 1.6+ บันทึกสคริปต์ทั้งหมดด้านล่างเป็น video-lookup.sh ในโฟลเดอร์ทำงานของคุณ:

```bash
#!/usr/bin/env bash
set -euo pipefail
video_id="${1:?Use: VIDEO_ID OUTPUT_FOLDER}"
out="${2:?Set OUTPUT_FOLDER}"
[[ "$video_id" =~ ^[A-Za-z0-9_-]{11}$ ]] || { echo 'Invalid video ID' >&2; exit 1; }
body=$(jq -n --arg id "$video_id" '{source: "youtube_metadata", video_id: $id,
  params: {include_formats: false, include_chapters: true}}')
if [[ ! -e "$out" ]]; then
  if [[ -z "${FLASHDATA_API_KEY:-}" ]]; then
    read -r -s -p 'FlashData API key: ' FLASHDATA_API_KEY; printf '\n'
  fi
  : "${FLASHDATA_API_KEY:?An API key is required}"
  mkdir -p -- "$out"
  printf '%s\n' "$body" > "$out/request.json"
  curl --fail-with-body --silent --show-error --max-time 120 \
    --request POST 'https://data.flashdata.dev/v1/queries/realtime' \
    --header "X-API-Key: $FLASHDATA_API_KEY" \
    --header 'Content-Type: application/json' --header 'Accept: application/json' \
    --data-binary "@$out/request.json" --output "$out/response.json" \
    --dump-header "$out/response-headers.txt" --write-out '%{http_code}' \
    > "$out/http-status.txt" || {
      printf 'Request failed. Keep this folder and inspect History before retrying.\n' >&2
      exit 1
    }
else
  printf 'Reading saved output; no API call.\n'
fi
jq -e --argjson expected "$body" '. == $expected' "$out/request.json" >/dev/null
[[ "$(cat "$out/http-status.txt")" == 200 ]] || {
  printf 'Inspect the saved status, response and Retry-After header.\n' >&2; exit 1;
}
mapped=$(jq -e --arg id "$video_id" '
  def pad: tostring | if length < 2 then "0" + . else . end;
  def hms:
    if . == null then null
    elif type != "number" then error("Invalid duration")
    elif (isfinite | not) or . < 0 then error("Invalid duration")
    else floor | [(./3600 | floor | pad), ((.%3600)/60 | floor | pad), (.%60 | pad)] | join(":") end;
  if .source != "youtube_metadata" or .status != "done" then error("Request not done") else . end
  | .results | if type != "array" then error("Expected results")
    elif length != 1 then error("Expected one result") else .[0] end
  | if .videoId != $id then error("Wrong video") else . end
  | [{id: .videoId, url: ("https://www.youtube.com/watch?v=" + .videoId),
      title, text: .description, channelName: .channel, channelId,
      viewCount, likes: .likeCount, commentsCount: .commentCount,
      duration: (.duration | hms), uploadDateRaw: .uploadDate,
      captionLanguages: .transcriptLanguages}]' "$out/response.json")
printf '%s\n' "$mapped" > "$out/dataset-items.json"
printf 'Saved %s/dataset-items.json; actual usage: ' "$out"
jq -c '.usage' "$out/response.json"

```

เรียกใช้จากโฟลเดอร์นั้น:

```bash
bash video-lookup.sh FUfGcZ092b0 video-001
```

### 3. อ่านผลลัพธ์ที่บันทึกไว้

video-001/dataset-items.json เป็นอาร์เรย์สำหรับโปรแกรมอ่านแอปพลิเคชันของคุณ response.json เก็บผลลัพธ์และการใช้งานดั้งเดิมไว้ นี่คืออะแดปเตอร์ฟิลด์ ไม่ใช่ชุดข้อมูล Apify API จะไม่สร้างชุดข้อมูล ID เติมเมตริกที่ไม่รู้จัก หรือสร้างความคิดเห็นหรือช่องการสร้างรายได้

ภาพประกอบ dataset-items.json:

```json
[
  {
    "id": "FUfGcZ092b0",
    "url": "https://www.youtube.com/watch?v=FUfGcZ092b0",
    "title": "Example video",
    "text": "Example description",
    "channelName": "Example channel",
    "channelId": "UC_EXAMPLE",
    "viewCount": 1200,
    "likes": null,
    "commentsCount": null,
    "duration": "00:03:17",
    "uploadDateRaw": "2025-01-15",
    "captionLanguages": [
      "en",
      "es"
    ]
  }
]
```

| สาขานักแสดงที่มีอยู่ | FlashData ข้อมูลเมตา | การดำเนินการย้ายถิ่น |
| --- | --- | --- |
| ไอดี/URL | videoId | เก็บรหัสและสร้าง canonical YouTube watch URL |
| ชื่อ/ข้อความ | ชื่อ / คำอธิบาย | แมปคำอธิบายเป็นข้อความหากผู้อ่านของคุณคาดหวังชื่อฟิลด์ของนักแสดง |
| channelName / channelId | ช่อง / channelId | รักษาชื่อและ ID อย่าอนุมานหมายเลขอ้างอิงช่องสัญญาณจากชื่อที่แสดง |
| ชอบ / commentsCount / viewCount | likeCount / commentCount / viewCount | เก็บค่าที่หายไปเป็น null เมตริกที่ขาดหายไปไม่ใช่ศูนย์ |
| ระยะเวลา ซึ่งมักจะเป็น HH:MM:SS | ระยะเวลาเป็นวินาที | ตัวอย่างจะแปลงวินาทีเป็นสตริง HH:MM:SS โดยคงไว้ null |
| วันที่ซึ่งอาจเป็นแบบสัมบูรณ์หรือแบบสัมพัทธ์ | uploadDate | ตัวอย่างจะเก็บ uploadDateRaw เพิ่มตัวแยกวิเคราะห์วันที่ของคุณเองก่อนที่จะเติมวันที่ปกติ |
| คำบรรยาย[] / transcriptionUrl | คำขอ youtube_transcript หรือ youtube_captions แยกต่างหาก | แทร็กที่มีอยู่และคำพูดเป็นข้อความที่สร้างขึ้นเป็นอินพุตที่แตกต่างกันสำหรับแอปของคุณ |
| ฟิลด์การตกแต่งเฉพาะนักแสดงเท่านั้น | ไม่มีการเทียบเท่าอัตโนมัติ | เก็บขั้นตอนการเพิ่มประสิทธิภาพแยกต่างหากสำหรับความคิดเห็น การขยายช่อง และการวิเคราะห์ที่สร้างโดย AI |

[สคีมาเมทาดาทา](https://flashdata.dev/th/docs/sources/youtube_metadata/reference.md).

### ดำเนินการตามเจตนาคำบรรยาย

| ข้อมูลนักแสดงหลัก | FlashData การย้ายถิ่น |
| --- | --- |
| ALWAYS_SUBTITLES | เพิ่มคำขอ youtube_transcript หรือ youtube_captions แยกต่างหากสำหรับแทร็กที่มีอยู่ |
| subtitlesLanguage | ใช้ params.language อาร์เรย์ที่มีภาษามากถึง 10 จะส่งคืนแทร็กพร้อมข้อผิดพลาดต่อภาษา |
| preferAutoGeneratedSubtitles | ค่านี้เป็นการระบุแหล่งที่ต้องการ ส่วน params.auto ของ FlashData จะเลือกเฉพาะคำบรรยายที่ YouTube สร้างหรือที่ผู้อัปโหลดจัดเตรียมไว้ โดยไม่สลับไปใช้อีกแหล่งเมื่อไม่พบ |
| TRANSCRIPTION_AS_FALLBACK / ALWAYS_TRANSCRIBE | แยกคำพูดเป็นข้อความออกจากกัน FlashData ไม่สร้างแทร็กที่หายไป |
| คำบรรยาย[].srt / transcriptionUrl | แมปส่วนที่ประทับเวลาหรือจัดรูปแบบไฟล์อย่างชัดเจน ข้อความธรรมดาที่สร้างขึ้น URL ไม่ใช่อาร์เรย์เซ็กเมนต์ที่มีการประทับเวลา |

[ตัวอย่างคำบรรยายพร้อมเวลา](https://flashdata.dev/th/docs/guides/timestamped-captions-recipe/reference.md).

<a id="production"></a>
## ชุดข้อมูล งานและกำหนดการแบบยาวrunning

หากเครื่องมือของคุณขึ้นอยู่กับชุดข้อมูล Apify IDs และกำหนดการ ให้คงนักแสดงที่กำหนดเองไว้เป็นผู้เรียบเรียง: เรียก FlashData เข้าไปข้างในแล้วเขียนรายการที่แมปลงในชุดข้อมูล กำหนดงบประมาณรันไทม์และพื้นที่เก็บข้อมูลของ Actor ควบคู่ไปกับการใช้งาน FlashData เครื่องคิดเลขด้านบนรุ่นโทรตรง FlashData

| ความกังวล | Apify | FlashData |
| --- | --- | --- |
| คำขอ | ตัวเลือกนักแสดง ID + build/input; งานที่บันทึกไว้เพิ่มเติม | แหล่งที่มา + video_id + พารามิเตอร์; ไม่มีตัวเลือกการสร้างนักแสดงหรือหน่วยความจำ |
| ผลลัพธ์แบบซิงโครนัส | run-sync-get-dataset-items ส่งคืนอาร์เรย์รายการ ขีดจำกัด HTTP ที่บันทึกไว้คือ 300 วินาที | การตอบสนองแบบเรียลไทม์มีสถานะ ผลลัพธ์[] และการใช้งาน แยกผลลัพธ์ก่อนทำการแมปฟิลด์ |
| ยาว-running งาน | เริ่มการรัน บันทึกการรัน ID รอสถานะเทอร์มินัล อ่าน defaultDatasetId | ส่งงาน async หรือ batch บันทึก ID สำรวจสถานะและรับผลลัพธ์ |
| การจัดเก็บเอาท์พุท | รายการชุดข้อมูลบวกบันทึกคีย์-ค่าเสริมที่อ้างอิงโดย URL | บันทึกการตอบสนองหรือส่งออกไปยังที่เก็บข้อมูลถาวรของคุณเอง ชุดข้อมูล Apify ID ไม่ใช่งาน FlashData ID |
| งานที่เกิดซ้ำ | Apify เริ่มกำหนดการ นักแสดง/Tasks; webhooks แจ้งเตือนผู้บริโภคดาวน์สตรีม | ใช้แอปพลิเคชัน, cron, CI หรือโฮสต์ตัวแทนของคุณเพื่อโทร FlashData; โยกย้ายกำหนดการและผู้บริโภคร่วมกัน |

### ย้ายชุดข้อมูลที่มีอยู่

ส่งออกชุดข้อมูลที่มีอยู่ทุกหน้าก่อนที่จะเปลี่ยนผู้ผลิต คงเหลือไฟล์คำบรรยายอ้างอิงที่คุณยังต้องการ อย่ารีรัน Actor เพียงเพื่อดาวน์โหลดเอาต์พุตที่รวบรวมไว้แล้ว

[บันทึกและนำผลลัพธ์กลับมาใช้](https://flashdata.dev/th/docs/guides/save-results/reference.md)

### รีเฟรชไลบรารีวิดีโอ

กรองวิดีโอที่ซ้ำกัน IDs จุดตรวจสอบแต่ละผลลัพธ์ และเก็บอินพุต-ทู-เอาท์พุต IDs ใช้การประมวลผลเป็นชุดหรือเป็นกลุ่มสำหรับรายการขนาดใหญ่ ลองรายการ failed อีกครั้งหลังจากตรวจสอบข้อผิดพลาดแล้ว

[เอกสารอ้างอิงการประมวลผล Bulk](https://flashdata.dev/th/docs/reference/bulk-processing/reference.md)

### ทำให้งานตามกำหนดเวลาสามารถคาดเดาได้

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

[เรียกใช้งานที่เกิดซ้ำ](https://flashdata.dev/th/docs/guides/recurring-tasks/reference.md)

### รายการตรวจสอบการตัด

1. บันทึกนักแสดง บิลด์ อินพุตงาน เหตุการณ์ที่เรียกเก็บเงินได้ ฟิลด์เอาท์พุต และผู้บริโภคดาวน์สตรีม
2. ระบายการรันที่มีอยู่และส่งออกหน้าชุดข้อมูลทั้งหมด clean=true สามารถข้ามบันทึกได้ ดังนั้นหน้าสั้น ๆ เพียงอย่างเดียวจึงไม่สามารถพิสูจน์ได้ว่าการส่งออกเสร็จสมบูรณ์ ตรวจสอบข้อมูลเมตาของการแบ่งหน้า
3. ตรวจสอบอะแดปเตอร์กับ IDs ที่บันทึกไว้ รวมถึงเมตริก null วันที่ และที่มาของคำอธิบายภาพ
4. ย้ายจังหวะ เขตเวลา และจุดหมายปลายทางไปยังนักวิ่งของคุณ เก็บจุดตรวจ. maxTotalChargeUsd ไม่ใช่ขีดจำกัดการใช้จ่ายหลัก FlashData API เพิ่มการควบคุมการใช้จ่ายระดับแอปพลิเคชัน
5. สลับผู้ผลิตสำหรับหน้าต่างกำหนดการถัดไปโดยไม่มีการรันซ้ำ อนุรักษ์การส่งออก หยุดการทำงานที่เกิดซ้ำกับข้อมูลประจำตัวที่ถูกเพิกถอนหรือมียอดคงเหลือไม่เพียงพอ

<a id="agents"></a>
## การเข้ารหัสและตัวแทนส่วนบุคคล

ตัวแทนที่มีสิทธิ์สามารถเริ่มต้นด้วย 1 credit (สูงสุด 100 มาตรฐาน YouTube คำขอข้อมูล) เป็นเวลา 72 ชั่วโมง ข้อมูลเมตาและคำบรรยายแบ่งปันค่าเผื่อ

1. ระบุการบูรณาการนักแสดงและนำข้อมูลรับรอง FlashData ที่มีอยู่มาใช้ซ้ำก่อน
2. พิสูจน์การค้นหาวิดีโอและบันทึกทั้งเอาต์พุตดิบและเอาต์พุตที่แมปพร้อมการใช้งานจริง
3. เจ้าของบัญชีเข้าสู่ระบบหรือสมัครบัญชี ยืนยันอีเมล แล้วอนุมัติการเชื่อมโยง สิทธิ์ และการใช้ยอดคงเหลือร่วม เครดิตทดลองใช้ที่เหลือจะไม่ถูกโอน
4. ยืนยันข้อมูลประจำตัวของเจ้าของสำหรับการใช้งานที่เกิดซ้ำ หยุดเพิกถอน; อย่าสร้างการทดลองใหม่

```text
Replace this project's Apify YouTube metadata lookup with FlashData.
Read https://flashdata.dev/auth.md and https://flashdata.dev/docs/sources/youtube_metadata/reference.md.
Identify the exact Actor ID, build, input, output fields, schedule and storage consumer first.
Reuse a saved FlashData credential or start one eligible trial with youtube_metadata permission.
Run one known video ID. Save the raw response, actual usage and a mapped JSON item array.
Keep null metrics and preserve the raw publication date. Do not invent Actor-only fields.
Keep channel discovery, comments, AI transcription and hosted scheduling separate unless explicitly migrated.
Reuse saved results after restart. Ask the owner to claim before recurring use and store keys outside chat.
Stop after revocation or insufficient balance; never create more trials to continue.
```

[ทดลองใช้และเชื่อมโยงบัญชี](https://flashdata.dev/th/docs/guides/agent-onboarding/reference.md) · [CLI แบบสแตนด์อโลน](https://flashdata.dev/th/docs/guides/flashdata-cli/reference.md) · [ตั้งค่า MCP](https://flashdata.dev/th/docs/integrations/mcp-clients/reference.md)

<a id="faq"></a>
## ก่อนที่คุณจะเปลี่ยน

### นี่เป็นการแทนที่แพลตฟอร์ม Apify หรือไม่

โดยจะแทนที่การเรียกข้อมูล YouTube เฉพาะในเวิร์กโฟลว์ของคุณ Apify ยังมีตลาดนักแสดง รันไทม์ที่กำหนดเอง ตารางเวลาที่โฮสต์ และพื้นที่เก็บข้อมูล เก็บชิ้นส่วนเหล่านั้นไว้ในที่ที่คุณใช้หรือย้ายความรับผิดชอบไปยังแอปพลิเคชันของคุณเอง

### ทำไมไม่เปรียบเทียบนักแสดงทุกคนในราคาเดียวล่ะ?

นักพัฒนานักแสดงเลือกรูปแบบราคา ผลลัพธ์ และข้อจำกัดอินพุตที่แตกต่างกัน เครื่องคิดเลขใช้สตรีมเมอร์/youtube-scraper. ตารางนักแสดงยังรวมถึงนักแสดงที่ค้นพบที่ถูกกว่าด้วย ข้อจำกัดของวิดีโอเดี่ยวมีความสำคัญเมื่อแทนที่การค้นหาตามความต้องการ

### การสมัครสมาชิก Apify จะเรียกเก็บเงินสองครั้งสำหรับการใช้งานที่รวมอยู่หรือไม่

ไม่ ค่าธรรมเนียมแผนรวมงบประมาณการใช้งานแบบชำระล่วงหน้าแล้ว เครื่องคิดเลขจะลบงบประมาณนั้นก่อนที่จะเพิ่มการใช้งานนักแสดงเพิ่มเติม โดยถือว่างบประมาณทั้งหมดพร้อมใช้งานสำหรับเวิร์กโฟลว์นี้ หากนักแสดงคนอื่นบริโภคมัน จะเหลือน้อยลงสำหรับ YouTube

### ฉันสามารถเก็บผู้ใช้ชุดข้อมูล Apify ไว้ได้หรือไม่

ตัวอย่างเขียนอาร์เรย์ JSON พร้อมด้วยชื่อฟิลด์ที่คุ้นเคยที่เลือกไว้ ไม่ได้สร้างชุดข้อมูล Apify หรือเรียกใช้ ID อ่านไฟล์ใหม่โดยตรง เผยแพร่ผ่านพื้นที่เก็บข้อมูลของคุณเอง หรือเก็บนักแสดงแบบกำหนดเองที่เขียนรายการที่แมปเหล่านี้ไปยังชุดข้อมูลสำหรับผู้ใช้ปัจจุบันของคุณ

### จะเกิดอะไรขึ้นกับคำบรรยายและการถอดเสียงแบบ AI

นักแสดงหลักของ Apify เสนอคำบรรยายที่มีอยู่และการถอดเสียง AI เสริม FlashData เรียกข้อมูลแทร็ก YouTube ที่มีอยู่ ขอข้อมูลเมตาและคำอธิบายภาพแยกกัน ตรวจสอบภาษาและที่มาที่ส่งคืน และแยกขั้นตอนการสรุปคำพูดเป็นข้อความหรือ AI ออกจากกัน

### กำหนดการที่มีอยู่ของฉันหรือการดำเนินการจำกัดการใช้จ่ายจะโอนไปหรือไม่

ไม่ สร้างกำหนดการใหม่ในนักวิ่งที่คุณเลือก และเพิ่มการตรวจสอบงบประมาณระดับแอปพลิเคชัน การตั้งค่า Apify maxTotalChargeUsd ไม่ใช่ขีดจำกัดการใช้จ่ายหลัก FlashData API รหัสเจ้าของใช้ยอดคงเหลือในบัญชีที่ใช้ร่วมกัน
