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

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

YouTube Suggestions API

รับคีย์ API

เรียกข้อมูล YouTube ข้อเสนอแนะให้สมบูรณ์สําหรับคําสําคัญหรือวลีที่มีภาษาและส่วนควบคุม

สร้างคำขอ

คําบรรยายหรือรหัสภาษาแนะนํา เช่น en

รหัสประเทศ 2 ตัว เช่น สหรัฐอเมริกา

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_suggestions",
    "query": "python",
    "params": {
        "language": "en",
        "region": "us",
    },
}

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 ถึง query ที่ระดับบนสุด ตัวเลือกของแหล่งอยู่ใน params. ช่องข้อมูลทางเลือกสามารถยกเลิกได้

เนื้อหาคำขอ

sourcestring / จำเป็น
กําหนดเป็น youtube_suggestions
querystring / จำเป็น
ค้นหาคํานําหน้า
1 ถึง 2,000 ตัวอักษรค่าปริยาย: ยังไม่ได้ตั้งค่า
paramsobject / ไม่บังคับ
Settings สําหรับการร้องขอนี้
ค่าปริยาย: {}
callback_urlstring · nullable / ไม่บังคับ
Async และชุดเท่านั้น สาธารณะ HTTPS เสร็จสมบูรณ์แล้ว URL บนพอร์ต 443ถึง 2,048 ตัวละคร ไม่มีเอกสารรับรองผู้ใช้หรือส่วน URL Omit, ใช้ null หรือข้อความเปล่าสําหรับไม่ให้แจ้งเตือน ในชุดนี้ กําหนดให้แต่ละคําถาม ภายนอกพม่า
ค่าปริยาย: ยังไม่ได้ตั้งค่า

ขอบเขตภาษา

params.languagestring / ไม่บังคับ
รหัสภาษา
1 ถึง 35 ตัวอักษรค่าปริยาย: "en"
รูปแบบที่ยอมรับได้^[A-Za-z0-9-]+$
params.regionstring / ไม่บังคับ
รหัสประเทศ 2 ตัว เช่น สหรัฐอเมริกา จีบี หรือ ดี.
ตรงกับ 2 ตัวอักษรค่าปริยาย: "US"
รูปแบบที่ยอมรับได้^[A-Za-z]{2}$

คำตอบ

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

results[0] เป็นชุดคําค้นที่แนะนํา ไม่ใช่วิดีโอวัตถุ มันว่างเปล่าได้ ไม่มีวีดีโอ IDs หรือ การ หมั้น นับ ว่า เป็น การ ตอบ สนอง อย่าง นี้.

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

บันทึกความสําเร็จ 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 = result  # An array of phrases, including an empty array.
print(json.dumps(output, ensure_ascii=False, indent=2))

ส่งคํานําหน้าการค้นหาเป็นการค้นหา. ภาษาและเขตอักษรต่าง ๆ ควรจะอยู่ในพารัม ค่าปริยายจะเป็น 'en' และสหรัฐอเมริกา' มันมีผลกระทบต่อบริบทที่สมบูรณ์ของอัตโนมัติ ไม่ใช่ภาพกํากับ

ใช้การค้นหาหรือขยายการค้นหาโดยใช้วลีที่แนะนํา discover วีดีโอ ข้อ เสนอ แนะ ไม่ สนับสนุน max_results หรือการค้นหาตัวกรอง

ช่องข้อมูลทั้งหมด
ช่องข้อมูลคําอธิบาย
sourcestringสิ่งที่ร้องขอมา API แหล่งข่าว
statusstringเสร็จสิ้นเมื่อการร้องขอจริง สําเร็จ
created_atstringช่วงเวลาการสร้างแบบ ISO 8601
usage.creditsnumberบัตรเครดิตตามที่ขอ จากแผนของคุณ
results[0]array<string>ข้อเสนอแนะที่เสร็จสมบูรณ์ แต่ละรายการในอาร์เรย์เป็นวลีที่ใช้ค้นหา

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

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

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_suggestions",
  "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 จํากัด

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

ไม่ มี ข้อ เสนอ แนะ ใด ๆ สําหรับ คํา กล่าว ก่อน หน้า นี้ ที่ เป็น การ ตอบ สนอง ที่ ไร้ ความ หมาย. ปรับแก้คํานําหน้า, ภาษา หรือเขตพื้นที่ที่ต้องการ; ไม่ต้องปฏิบัติต่ออาร์เรย์ว่างๆ ว่าเป็นงานที่ล้มเหลว

สําหรับการตรวจสอบสิทธิ์, ดุลยภาพ, ร้องขอ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 การใช้) รวม

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

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