بحث الشعارات عبر API
ابحث عن شعارات العلامات التجارية بكلمة مفتاحية، وضيّق النطاق بالفئة اختياريًا، وافحص الأصول المتاحة، واحصل على الملف الذي تحتاجه في سير عمل نظيف من طلب واستجابة واحدين.
لا تملك مفتاح API؟
سجّل الدخول إلى حسابك لإنشاء وإدارة مفاتيح API.
الطلب
أدخِل مصطلح بحث مطلوبًا، وضيّق النطاق بالفئة اختياريًا، ثم أرسِل طلبًا واحدًا.
الاستجابة
راجِع النتائج، وافحص الأصل المُحدَّد، ثم انسخه أو نزّله.
أرسِل طلب بحث لتحميل الشعارات المطابقة وفحص الاستجابة.
دليل التكامل
انسخ المقتطف، استبدل مفتاح API الخاص بك، ثم شغّله. يعمل مع أي عميل HTTP — أمثلة أدناه بـ cURL وJavaScript وPython.
/api/logos?search=vercel&limit=12https://www.apipick.comSearch logo metadata by required keyword and optional category filter. The response is an array of matching logo records with asset details.
searchstringمطلوبRequired keyword for case-insensitive title/slug matching. openai
categorystringاختياريRestrict search to a specific category. AI
limitnumberاختياريMaximum results to return. 1-100. 24
curl -X GET "https://www.apipick.com/api/logos?search=vercel&limit=12" \
-H "x-api-key: YOUR_API_KEY"[
{
"id": 371,
"title": "Vercel",
"categories": [
"Vercel"
],
"url": "https://vercel.com",
"assets": [
{
"kind": "logo",
"theme": "light",
"filename": "vercel.svg",
"url": "https://www.apipick.com/logo-library/vercel.svg",
"width": 76,
"height": 65,
"aspectRatio": "76:65",
"suggestedUseCases": [
"app icons",
"favicons",
"avatars",
"navigation bars",
"mobile headers"
]
},
{
"kind": "logo",
"theme": "dark",
"filename": "vercel_dark.svg",
"url": "https://www.apipick.com/logo-library/vercel_dark.svg",
"width": 76,
"height": 65,
"aspectRatio": "76:65",
"suggestedUseCases": [
"app icons",
"favicons",
"avatars",
"navigation bars",
"mobile headers"
]
}
]
}
]حدود المعدل
يُطبَّق التقييد لكل مفتاح API، بنافذة منزلقة مدتها 60 ثانية. عند بلوغ الحد تحصل على رمز 429 نظيف مع ترويسة Retry-After.
120req/min
لكل مفتاح API ولكل نقطة نهاية. نافذة منزلقة مدتها 60 ثانية.
3concurrent
الحد الأقصى للطلبات الجارية المتزامنة لكل مفتاح API.
X-RateLimit-Limitالحد الأقصى للطلبات المسموح بها في الدقيقةX-RateLimit-Remainingالطلبات المتبقية في النافذة الحاليةX-RateLimit-Resetعدد الثواني حتى إعادة ضبط النافذة الحاليةRetry-Afterعدد الثواني التي يجب انتظارها قبل إعادة المحاولة (عند 429 فقط)HTTP/1.1 429 Too Many Requests
Retry-After: 12
X-RateLimit-Limit: 120
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 12
{
"error": "rate_limit_exceeded",
"message": "Rate limit exceeded: 120 requests/minute per API key. Retry after 12s.",
"retry_after": 12
}الأسئلة الشائعة
س: ماذا تُعيد نقطة نهاية البحث؟
A: تُعيد مصفوفة مدمجة من سجلّات الشعارات بالحقول الأساسية: id وtitle وcategories وurl وassets، إضافةً إلى بيانات وصفية للأصل مثل نسبة العرض إلى الارتفاع وحالات الاستخدام المقترحة.
س: هل يمكنني سرد كتالوج الشعارات الكامل دون مصطلح بحث؟
A: لا. تتطلّب GET /api/logos معامل بحث غير فارغ. صُمّمت هذه النقطة للبحث المُوجَّه لا لتصدير المكتبة بالكامل.
س: كيف أحصل على ملف شعار؟
A: ابحث عبر GET /api/logos، ثم استخدم حقل url في كل أصل لجلب الملف أو تضمينه مباشرةً — دون الحاجة إلى استدعاء API إضافي.
س: هل هذا مخصّص لشعارات SVG فقط؟
A: لا. SVG هي الصيغة الأساسية اليوم، وتجري إضافة PNG وWebP وصيغ أصول إضافية. تُبنى استجابة البحث بالفعل حول بيانات وصفية عامة للأصول كي تتمكّن العملاء من دعم أكثر من صيغة ملف واحدة بسلاسة.