بحث الفيديو

آخر تحديث July 20, 2026

نتائج بحث الفيديو بصيغة JSON.

TEXT

GET /v1/videos

يتطلّب مفتاح API صالحًا، وعضويّة نشطة، وائتمان API متاحًا.

معاملات الاستعلام

الاسم	النوع	مطلوب	الافتراضي	الوصف
`q`	string	نعم	—	استعلام البحث.
`safe`	string	لا	`on`	مستوى البحث الآمن: `off` أو `on`.
`gl`	string	لا	(تلقائي)	رمز منطقة/بلد من حرفين (مثل `us`، `gb`).
`hl`	string	لا	(تلقائي)	رمز لغة من حرفين (مثل `en`، `de`).
`time`	string	لا	`any`	مرشّح الحداثة: `any` أو `hour` أو `day` أو `week` أو `month` أو `year`.
`num`	integer	لا	(افتراضي المزوّد)	عدد النتائج المطلوب. يُقصّ إلى 5–100 (خارج النطاق ← 20).

الاستجابة

JSON

{
  "query": "how to make pasta",
  "kind": "video",
  "results": [
    {
      "title": "Perfect Fresh Pasta in 10 Minutes",
      "url": "https://video.example.com/watch?v=abc123",
      "description": "A quick guide to homemade pasta…",
      "thumbnail": "https://video.example.com/abc123/thumb.jpg",
      "price": null,
      "meta": "Example Kitchen",
      "extra": "10:32"
    }
  ]
}

الحقل	النوع	الوصف
`query`	string	الاستعلام الذي نُفِّذ.
`kind`	string	دائمًا `video` لهذه نقطة النهاية.
`results[].title`	string	عنوان الفيديو.
`results[].url`	string	عنوان URL للفيديو / لصفحة المشاهدة.
`results[].description`	string \| null	الوصف، عند توفّره.
`results[].thumbnail`	string \| null	عنوان URL للصورة المصغّرة.
`results[].meta`	string \| null	القناة / المصدر.
`results[].extra`	string \| null	المدّة، عند توفّرها.
`results[].price`	string \| null	لا يُستخدم للفيديو.

أمثلة

cURL

curl -G "https://api.suede.io/v1/videos" \
  -H "Authorization: Bearer $SUEDE_API_KEY" \
  --data-urlencode "q=how to make pasta"

using var http = new HttpClient();
http.DefaultRequestHeaders.Authorization =
    new("Bearer", Environment.GetEnvironmentVariable("SUEDE_API_KEY"));
var url = "https://api.suede.io/v1/videos?q=" + Uri.EscapeDataString("how to make pasta");
Console.WriteLine(await http.GetStringAsync(url));

JavaScript

const res = await fetch(
  "https://api.suede.io/v1/videos?q=" + encodeURIComponent("how to make pasta"),
  { headers: { Authorization: `Bearer ${process.env.SUEDE_API_KEY}` } },
);
const data = await res.json();
for (const r of data.results) console.log(`${r.title} [${r.extra}] — ${r.meta}`);