> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pubrio.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Logo API

> بحث مجاني وعام عن شعارات الشركات حسب النطاق. ضمّن شعارات الشركات في CRM، أو لوحات المعلومات، أو صفحات التسويق، أو التسلسلات باستخدام رابط بسيط — دون الحاجة إلى مفتاح API.

تُعيد واجهة Pubrio Logo API شعار شركة استنادًا إلى نطاقها. بلا مفتاح API. بلا تسجيل. مجرد رابط.

```html theme={null}
<img src="https://logo.pubrio.com/pubrio.com" alt="Pubrio" />
```

<Frame>
  <img src="https://logo.pubrio.com/pubrio.com" alt="مثال على شعار Pubrio" width="120" />
</Frame>

## البدء السريع

<CodeGroup>
  ```html HTML theme={null}
  <img src="https://logo.pubrio.com/stripe.com" alt="Stripe" />
  ```

  ```bash curl theme={null}
  curl -L https://logo.pubrio.com/stripe.com -o stripe-logo.png
  ```

  ```js JavaScript theme={null}
  const logoUrl = `https://logo.pubrio.com/${domain}`;
  // استخدمه مباشرة في <img src> أو اجلب البيانات الثنائية
  ```

  ```jsx React theme={null}
  <img src={`https://logo.pubrio.com/${company.domain}`} alt={company.name} />
  ```

  ```python Python theme={null}
  import requests
  r = requests.get(f"https://logo.pubrio.com/{domain}")
  with open("logo.png", "wb") as f:
      f.write(r.content)
  ```
</CodeGroup>

## نقطة النهاية

```
GET https://logo.pubrio.com/{domain}
```

| المعامل  | الموقع | مطلوب | الوصف                                                                                         |
| -------- | ------ | ----- | --------------------------------------------------------------------------------------------- |
| `domain` | path   | ✅     | نطاق الشركة (مثل `stripe.com`، `apple.com`). بحرف `www.` أو دونه؛ يُتجاهل البروتوكول إن وُجد. |

**الاستجابة:** البيانات الثنائية لصورة الشعار، تُقدَّم مع رأس `Content-Type` المناسب.

<Note>
  لا حاجة إلى مصادقة. لا رأس `Authorization`، ولا مفتاح API، ولا روابط موقّعة. يمكنك الربط المباشر (hotlink) من `<img src>` في بيئة الإنتاج.
</Note>

## كيف تعمل

<CardGroup cols={2}>
  <Card title="البحث حسب النطاق" icon="globe">
    زوّد رابط المسار بأي نطاق شركة. تحلّل Pubrio العلامة التجارية القياسية وتُعيد شعارها من مجموعة مصادر تُحدَّث باستمرار.
  </Card>

  <Card title="التسليم عبر CDN" icon="bolt">
    تُخزَّن الشعارات مؤقتًا عند الحافة (edge). يُسخّن الطلب الأول ذاكرة التخزين المؤقت؛ وتُقدَّم الطلبات اللاحقة من أقرب نقطة حضور (POP) بزمن استجابة أقل من 100 مللي ثانية.
  </Card>

  <Card title="بلا مصادقة" icon="lock-open">
    نقطة نهاية عامة. ضمّنها مباشرة في وسوم `<img src>`، والمواقع التسويقية، وأدوات التنقيب عن العملاء، ولوحات المعلومات، أو إضافات المتصفح.
  </Card>

  <Card title="بديل ذكي عند الفشل" icon="image">
    تُعيد النطاقات غير المعروفة أو التي يتعذّر حلّها صورة بديلة محايدة بدلًا من صورة معطوبة — بحيث لا تعرض واجهتك أبدًا أيقونة أصل مفقود.
  </Card>
</CardGroup>

## أمثلة

<CardGroup cols={4}>
  <Card title="stripe.com">
    <img src="https://logo.pubrio.com/stripe.com" alt="Stripe" width="80" />
  </Card>

  <Card title="airbnb.com">
    <img src="https://logo.pubrio.com/airbnb.com" alt="Airbnb" width="80" />
  </Card>

  <Card title="shopify.com">
    <img src="https://logo.pubrio.com/shopify.com" alt="Shopify" width="80" />
  </Card>

  <Card title="github.com">
    <img src="https://logo.pubrio.com/github.com" alt="GitHub" width="80" />
  </Card>
</CardGroup>

## حالات استخدام شائعة

<CardGroup cols={2}>
  <Card title="واجهات CRM والتنقيب عن العملاء" icon="users">
    اعرض الشعارات بجانب سجلات الشركات في CRM، أو أدوات المبيعات، أو لوحات معلومات BI — دون الحاجة إلى رفع أو تخزين أو صيانة مكتبة أصول شعارات.
  </Card>

  <Card title="توقيعات البريد الإلكتروني والتسلسلات" icon="envelope">
    ضمّن شعار شركة المستلم في رسائلك الصادرة المخصّصة — تجلب كل عملية إرسال أحدث شعار من CDN.
  </Card>

  <Card title="لوحات معلومات المستثمرين وصفحات المحافظ الاستثمارية" icon="chart-line">
    اعرض شبكة شركات حسب النطاق. يعمل مع الشركات العامة والخاصة والناشئة أو الدولية غير المدرجة في مجموعات الصور المخزنية الشائعة.
  </Card>

  <Card title="صفحات التسويق ودراسات الحالة" icon="grid">
    جدران شعارات العملاء، وشبكات التكاملات، وأقسام "موثوق به من" — كلها مُغذّاة مباشرة من قائمة نطاقات.
  </Card>
</CardGroup>

## الانتقال من مزوّد شعارات آخر

إذا كانت روابط الشعارات الحالية لديك تتبع نمط `host/{domain}`، فإن التحوّل إلى Pubrio هو مجرد عملية بحث واستبدال بسطر واحد.

<CodeGroup>
  ```diff قبل / بعد theme={null}
  - <img src="https://example-logo-host.com/stripe.com" />
  + <img src="https://logo.pubrio.com/stripe.com" />
  ```

  ```js JavaScript theme={null}
  // استبدل المضيف في الدالة المساعدة الحالية لديك
  const logo = `https://logo.pubrio.com/${domain}`;
  ```
</CodeGroup>

نفس شكل الرابط، ونفس عقد الاستجابة (بيانات صورة ثنائية حسب النطاق)، ودون مصادقة — بالنسبة لمعظم قواعد الأكواد، يقتصر الانتقال على استبدال سلسلة نصية واحدة.

## الأسئلة الشائعة

<AccordionGroup>
  <Accordion title="هل أحتاج إلى مفتاح API؟">
    لا. واجهة Logo API عامة ومجانية. يمكنك الربط المباشر (hotlink) للصور من `<img src>` في HTML من جانب العميل، وصفحات التسويق، ولوحات المعلومات، والإضافات دون أي بيانات اعتماد.
  </Accordion>

  <Accordion title="ماذا يحدث إذا لم يكن للنطاق وجود أو شعار؟">
    تُعيد النطاقات غير المعروفة أو التي يتعذّر حلّها صورة بديلة محايدة بدلًا من رمز 404 — بحيث تبقى واجهتك نظيفة. إذا احتجت إلى اكتشاف حالة "لم يُعثر على شعار" برمجيًا، افحص رؤوس الاستجابة.
  </Accordion>

  <Accordion title="ما تنسيق الصورة المُعاد؟">
    تُعيد Pubrio أعلى تنسيق جودة متاح لكل علامة تجارية (عادةً PNG بخلفية شفافة). يعكس رأس `Content-Type` التنسيق الفعلي المُقدَّم.
  </Accordion>

  <Accordion title="هل توجد حدود لمعدل الطلبات؟">
    صُممت نقطة النهاية للربط المباشر داخل الصفحة والتسليم عالي الحجم عبر CDN. لا توجد حدود معدل لكل عنوان IP للاستخدام العادي عبر المتصفح. يخضع الزحف الجماعي من خادم إلى خادم لتقييد قائم على الاستخدام العادل — إذا كانت لديك حالة استخدام خلفية عالية الحجم، تواصل معنا.
  </Accordion>

  <Accordion title="هل يمكنني استخدام هذا في موقعي الإنتاجي؟">
    نعم — هذا هو حالة الاستخدام الأساسية. ضمّن `<img src="https://logo.pubrio.com/{domain}">` مباشرة. تُخزَّن الشعارات مؤقتًا عند الحافة لتسليم سريع حول العالم.
  </Accordion>

  <Accordion title="ما مدى حداثة الشعارات؟">
    تعيد Pubrio باستمرار جلب الشعارات وتحديثها من مصادر العلامات التجارية القياسية. تُحدَّث معظم الشعارات خلال أيام من أي تغيير في العلامة التجارية.
  </Accordion>

  <Accordion title="هل يتطلب هذا بقية Pubrio API؟">
    لا. واجهة Logo API خدمة مجانية مستقلة. إذا كنت تريد أيضًا إثراء بيانات الشركات، أو أعداد الموظفين، أو الإشارات، أو بيانات التواصل، راجع [مرجع API الرئيسي](/ar/api-reference/introduction).
  </Accordion>
</AccordionGroup>

## ما بعد الشعارات: واجهة Pubrio API الكاملة

واجهة Logo API أداة مجانية. إذا وجدتها مفيدة، فإن بقية منصة Pubrio تحوّل النطاق نفسه إلى ملف تعريف شركة كامل.

<CardGroup cols={2}>
  <Card title="إثراء بيانات الشركات" icon="building" href="/ar/api-reference/endpoint/companies/enrichment">
    حوّل نطاقًا إلى عدد الموظفين، والصناعة، والموقع، والبيانات التقنية، والمزيد.
  </Card>

  <Card title="استعلام الأشخاص" icon="user" href="/ar/api-reference/endpoint/people/lookup">
    اعثر على جهات اتصال موثّقة في أي شركة حسب الدور أو الأقدمية أو القسم.
  </Card>

  <Card title="المراقبات (الإشارات)" icon="bolt" href="/ar/api-reference/endpoint/monitors/monitors">
    إشارات فورية للتوظيف والأخبار والإعلانات تُسلَّم عبر Webhook.
  </Card>

  <Card title="احصل على مفتاح API" icon="key" href="https://dashboard.pubrio.com">
    خطة مجانية برصيد — دون الحاجة إلى بطاقة.
  </Card>
</CardGroup>