Loading...
Loading...
เชื่อมต่อกับ API ภายนอกที่ได้รับการตรวจสอบสิทธิ์ หรือใช้การขนส่ง MCP สำหรับตัวแทนและนักพัฒนาที่สร้างตามสัญญาการวิเคราะห์ของ YouTube
ลองใช้จุดสิ้นสุดที่ใช้งานอยู่ แทนที่ channel_id และ YOUR_API_KEY ด้วยค่าของคุณ:
curl -X GET "https://www.tubeanalytics.net/api/external/v1/analytics?channel_id=<channel_id>&range=28d" \
-H "Authorization: Bearer <YOUR_API_KEY>" \
-H "Accept: application/json"JavaScript
const res = await fetch("https://www.tubeanalytics.net/api/external/v1/analytics?channel_id=<id>&range=28d", {
headers: { Authorization: "Bearer <api_key>" }
});
const data = await res.json();Python
import httpx
res = httpx.get(
f"{apiBase}/analytics",
params={"channel_id": "<id>", "range": "28d"},
headers={"Authorization": "Bearer <api_key>"}
)
data = res.json()สร้างและเพิกถอนคีย์ API จากแดชบอร์ด → การตั้งค่า → คีย์ API หรือผ่านเส้นทาง GET /api/v1/keys และ POST /api/v1/keys ที่ได้รับการตรวจสอบสิทธิ์
Professional+ planเรียก API ภายนอกที่ https://www.tubeanalytics.net/api/external/v1 ด้วยโทเค็น Bearer ในส่วนหัวการอนุญาต
JSON responsesเชื่อมต่อตัวแทนกับ https://www.tubeanalytics.net/api/mcp หรือเรียกใช้ npm run mcp:stdio ในเครื่องสำหรับการขนส่ง stdio
Agent readyใช้ /openapi.json, /mcp.json และ /ai.txt เป็นแหล่งที่มาของความจริงที่เครื่องอ่านได้สำหรับการผสานรวมและเอเจนต์
Machine-readableลงชื่อเข้าใช้ ดำเนินการตามขั้นตอนการสมัครสมาชิกให้เสร็จสิ้น และเชื่อมต่อช่องจากแดชบอร์ด เส้นทางการจัดการที่ได้รับการรับรองความถูกต้องคือ GET /api/v1/channels/connect สำหรับบัญชีปัจจุบันและ POST /api/v1/channels/connect เพื่อเชื่อมต่อหรือรีเฟรชช่อง
ไปที่แดชบอร์ด → การตั้งค่า → คีย์ API และสร้างคีย์ หรือใช้เส้นทาง POST /api/v1/keys ที่ได้รับการรับรองความถูกต้อง คีย์ API มีอยู่ในแผน Professional และ Enterprise
ใช้คีย์ Bearer กับ https://www.tubeanalytics.net/api/external/v1 ตัวอย่าง: GET /analytics?channel_id=<id>&range=28d หรือ GET /videos?channel_id=<id>&limit=20
สำหรับไคลเอ็นต์ MCP ให้ชี้ไปที่ https://www.tubeanalytics.net/api/mcp บน HTTP หรือเรียกใช้ npm run mcp:stdio สำหรับการขนส่ง stdio ในเครื่อง
/api/external/v1/channels/api/external/v1/channels/:channelId/api/external/v1/analytics?channel_id=.../api/external/v1/videos?channel_id=.../api/external/v1/audience?channel_id=.../api/external/v1/competitors/api/v1/keys/api/mcpคำขอ API ภายนอกต้องมีคีย์ API ที่ถูกต้องในส่วนหัวการอนุญาตโดยใช้รูปแบบโทเค็นผู้ถือ เก็บคีย์ฝั่งเซิร์ฟเวอร์ไว้และอย่าเปิดเผยคีย์ดังกล่าวในโค้ดฝั่งไคลเอ็นต์หรือมอบให้กับการควบคุมเวอร์ชัน
หากต้องการสร้างหรือหมุนเวียนคีย์ API ให้ไปที่แดชบอร์ด → การตั้งค่า → คีย์ API คุณยังสามารถจัดการคีย์จากเซสชันที่ได้รับการตรวจสอบสิทธิ์ด้วย GET /api/v1/keys, POST /api/v1/keys และ DELETE /api/v1/keys/:keyId
Starter
1 channel · Creators validating one channel before spending more.
Professional
3 channels · Creators and small teams growing more than one channel.
Enterprise
Unlimited channels · Agencies and multi-channel teams with reporting overhead.
curl -X GET https://www.tubeanalytics.net/api/external/v1/analytics?channel_id=<channel_id>&range=28d \
-H "Authorization: Bearer YOUR_API_KEY"ตัวอย่างคำขอ API ภายนอก channel_id อาจเป็นรหัส DB ภายในหรือรหัสช่อง YouTube
การเข้าถึง API ภายนอกมีอยู่ในแผน Professional และ Enterprise คำขอจะถูกจำกัดอัตราตามระดับแผนและส่งกลับ 429 พร้อมส่วนหัวขีดจำกัดอัตราเมื่อคุณเกินขีดจำกัด
ส่วนหัวการตอบกลับที่จำกัดอัตรา
ทุกการตอบสนองจาก API ภายนอกจะมีส่วนหัวเหล่านี้ ดังนั้นลูกค้าจึงสามารถจัดการการถอยกลับในเชิงรุกได้:
X-RateLimit-LimitX-RateLimit-RemainingX-RateLimit-ResetRetry-Afterคำขอภายนอกที่ได้รับการตรวจสอบสิทธิ์จะใช้โฟลว์คีย์ Bearer API เส้นทางการจัดการเฉพาะเซสชัน เช่น /api/v1/keys และ /api/v1/channels/connect มีไว้สำหรับเซสชันแดชบอร์ดที่ลงชื่อเข้าใช้ ไม่ใช่สำหรับการเรียกคีย์ API แบบเซิร์ฟเวอร์ถึงเซิร์ฟเวอร์
API ภายนอกส่งคืนข้อผิดพลาด JSON ที่มีโครงสร้างพร้อม error.code และ error.message เส้นทางแดชบอร์ดที่ลงชื่อเข้าใช้อาจยังคงส่งคืนสตริงข้อผิดพลาดธรรมดา ดังนั้นโปรดตรวจสอบเส้นทางหรือข้อกำหนด OpenAPI เพื่อดูรูปร่างที่แน่นอน
ตัวอย่างการตอบสนองข้อผิดพลาด
{
"error": {
"code": "BAD_REQUEST",
"message": "channel_id query parameter is required"
}
}400401403404429500ตำแหน่งข้อมูล API ภายนอกส่วนใหญ่ยอมรับพารามิเตอร์การสืบค้นทั่วไปสำหรับการกรอง การแบ่งหน้า และการเรียงลำดับ
channel_idrangelimitoffsetsortดึงเกณฑ์ชี้วัดช่องทางมาสู่เครื่องมือของคุณเอง — แผนภูมิแบบฝังในพอร์ทัลภายใน รายงานลูกค้า หรือแพลตฟอร์ม BI เช่น Metabase หรือ Grafana
กำหนดเวลาการซิงค์ทุกคืนใน Google Sheets, Notion หรือคลังสินค้าของคุณโดยการเรียก API ภายนอกจากแบ็กเอนด์หรือผู้ปฏิบัติงานอัตโนมัติ
ใช้การขนส่ง MCP หรือการขนส่ง stdio ภายในเพื่อให้ตัวแทนสามารถเข้าถึงสัญญาผลิตภัณฑ์ การวิเคราะห์ และข้อมูลบัญชีเดียวกัน
รวมข้อมูล API เข้ากับโฆษณา, CRM หรือระบบการเงิน เพื่อให้ประสิทธิภาพของช่องทางสอดคล้องกับส่วนที่เหลือของคุณ
ใช้เพจเหล่านี้เพื่อย้ายจากการค้นพบจุดสิ้นสุดไปสู่การรวมการผลิตและการปรับใช้เวิร์กโฟลว์
เอกสารสำหรับนักพัฒนาจากส่วนกลาง: ไฟล์การรับรองความถูกต้อง จุดสิ้นสุด MCP และการค้นพบ
การเริ่มต้นอย่างรวดเร็วสำหรับการเรียก API ครั้งแรก การตั้งค่าการตรวจสอบสิทธิ์ และรายการตรวจสอบการเปิดตัว
เพย์โหลดเหตุการณ์และพฤติกรรมการลองใหม่อีกครั้งสำหรับการสมัครรับข้อมูลและกิจกรรมข้อมูล
ขีดจำกัดคำขอที่ทราบตามแผนและกลยุทธ์การลองใหม่อีกครั้งเพื่อการบูรณาการที่เสถียร
การอ้างอิงการใช้งานเฉพาะการบูรณาการและขอบเขตการซิงค์ข้อมูล
การเข้าถึง API มีอยู่ในแผน Professional และ Enterprise ลงทะเบียน เชื่อมต่อช่องทาง จากนั้นสร้างคีย์ API และเริ่มเรียกใช้การขนส่ง API หรือ MCP ภายนอก