← นักพัฒนา

REST API

HTTP API แบบ JSON ที่เรียบง่าย เบื้องหลังเว็บไซต์ ขั้นตอนยืนยันตัวตนของ CLI และเซิร์ฟเวอร์ MCP

Base URL

https://xvideodownloader.org

การยืนยันตัวตน

คำขอแบบไม่ระบุตัวตนใช้ดาวน์โหลดพื้นฐานได้ภายในขีดจำกัดแบบไม่ระบุตัวตน หากต้องการบัญชีถาวร (ขีดจำกัดสูงขึ้น ประวัติการดาวน์โหลด SVIP) ให้ส่ง Authorization: Bearer <token> — รับ token ได้จากคำสั่ง auth login ของ CLI หรือโดยการลงชื่อเข้าใช้บนเว็บไซต์

ขีดจำกัดการใช้งาน

แพ็กเกจฟรี (ไม่ระบุตัวตนหรือลงทะเบียน): 2 ครั้ง/วัน สูงสุด 720p ไฟล์ละ 25MB SVIP ตลอดชีพ: ไม่จำกัดรายวัน ไม่จำกัดคุณภาพหรือขนาด นับตาม IP สำหรับคำขอแบบไม่ระบุตัวตน และนับตามบัญชีเมื่อยืนยันตัวตนแล้ว

Endpoint

POST/api/download

สร้างงานดาวน์โหลดจาก URL โพสต์ X/Twitter

GET/api/downloads/{id}

ดูสถานะและเมทาดาทาของงานดาวน์โหลด

GET/api/file/{id}

เปลี่ยนเส้นทาง 302 ไปยังไฟล์ที่ดาวน์โหลด ใส่ ?dl=1 เพื่อให้นับรวมในโควตารายวัน หากไม่ใส่จะเป็นการพรีวิวแบบอ่านอย่างเดียว

GET/api/downloads

แสดงประวัติการดาวน์โหลดของคุณ ต้องยืนยันตัวตน

DELETE/api/downloads/{id}

ลบรายการดาวน์โหลด ไม่สามารถลบงานที่กำลังทำงานอยู่

GET/api/user/usage

การใช้งานวันนี้เทียบกับขีดจำกัดรายวันของแพ็กเกจ

GET/api/user/subscription

แพ็กเกจปัจจุบัน และสถานะการสมัครสมาชิกสำหรับสมาชิกเดิม

รหัสข้อผิดพลาด

EMPTY_URLไม่ได้ระบุ URL
INVALID_URL_FORMATURL ไม่ได้ขึ้นต้นด้วย http(s)
UNSUPPORTED_HOSTรองรับเฉพาะ x.com และ twitter.com
RATE_LIMITถึงขีดจำกัดการดาวน์โหลดรายวันแล้ว
FILE_SIZE_LIMITวิดีโอมีขนาดเกินขีดจำกัดของแพ็กเกจ
VIDEO_NOT_FOUNDไม่พบวิดีโอหรือดึงวิดีโอไม่ได้
PRIVATE_TWEETโพสต์เป็นแบบส่วนตัวหรือถูกป้องกัน
GEO_BLOCKEDเนื้อหาต้นทางถูกจำกัดตามภูมิภาค

ตัวอย่าง

สร้างงานดาวน์โหลด แล้วตรวจสอบจนกว่าจะเสร็จ:

curl -X POST https://xvideodownloader.org/api/download \
  -H "Content-Type: application/json" \
  -d '{"url": "https://x.com/user/status/123456789"}'

สเปก OpenAPI

สคีมาคำขอ/การตอบกลับฉบับเต็มในรูปแบบ OpenAPI 3.0 สำหรับสร้างโค้ดหรือนำเข้าเครื่องมือ API:

/openapi.json →