الهوية والتحقق

واجهة API لبيانات العلامة التجارية

أكمل بيانات علامة شركة بطلب واحد. أرسل نطاقًا أو رمز سهم أو ISIN أو اسم شركة لتحصل على الاسم والوصف والحسابات الاجتماعية المعلنة وشعار مربع وآخر عريض كروابط صور، إضافةً إلى ألوان العلامة المستخرجة من الشعار نفسه، وكل ذلك مع مصدره ووقت فحصه.

عرض الوثائق استكشف جميع واجهات API

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

GET /v1/brand

طلب مثال

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/brand?domain=stripe.com"

مثال الرد 200 OK

{
  "query": { "type": "domain", "value": "stripe.com", "exchange": null },
  "status": "present",
  "domain": "stripe.com",
  "name": { "status": "present", "value": "Stripe", "provenance": { "source": "website", "method": "declared_organization_name" } },
  "logo": {
    "status": "present",
    "value": { "url": "https://domscan.net/v1/logo/stripe.com", "
...

طلب مثال GET /v1/brand

الميزات الرئيسية 4

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

رموز حالة HTTP 200 / 304 / 400 / 401 / 402 / 429

Category الهوية والتحقق

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

الميزات الرئيسية 4

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

يستخدمه أشخاص في هذه الشركات

إشارات ثقة قبل التكامل

توفر الوثائق الواضحة والطلبات الموثقة وتفاصيل الاعتمادية المرئية طريقة أسهل لتقييم DomScan قبل الإطلاق.

مباشر حالة الخدمة

تحقق من حالة الخدمة المباشرة واستجابات الفشل الموثقة قبل التكامل.

OpenAPI ملفات API

روابط OpenAPI وSwagger وPostman وCLI وSDK وMCP متاحة بنقرة واحدة.

مفاتيح API وصول محمي

تستخدم نقاط النهاية الموثقة مفاتيح API مع تكاليف رصيد واضحة قبل الاستدعاء.

1,000 أرصدة مجانية

ابدأ مع 1,000 رصيد مجاني كل شهر. تحتاج إلى المزيد؟ اختر خطة شهرية أو اشترِ باقة لمرة واحدة.

ما الذي تساعدك هذه الواجهة على إطلاقه

استخدم هذه الصفحة كملخص إنتاج: نقاط النهاية، الأمثلة، شكل الاستجابة، وأجزاء سير العمل اللازمة لربط DomScan بمنتجك.

سير عمل المنتج

ادمج فحوصات النطاقات، معلومات DNS، إشارات المخاطر أو الإثراء داخل الإعداد، البحث والأدوات الداخلية.

أتمتة المحللين

استبدل عمليات البحث اليدوية المتكررة بمهام مجدولة وتنبيهات وخطوات تحقيق قابلة للإعادة.

بيانات JSON نظيفة

استخدم حقولًا متوقعة، رموز حالة موثقة وتكاليف ائتمان بدلًا من كشط صفحات المزودين.

أدوات الذكاء الاصطناعي والعمليات

زوّد الوكلاء ولوحات المعلومات ودفاتر SOAR وCRMs عبر OpenAPI أو SDK أو Postman أو MCP.

سير عمل التكامل

مسار بسيط من أول طلب إلى استخدام إنتاجي قابل للتكرار.

المصادقة مرة واحدة

أرسل مفتاح API مع الترويسة الموثقة وحافظ على اتساق الطلبات عبر الخدمات.

الاستعلام باستخدام الأمثلة

ابدأ من أمثلة curl وHTTP ثم اربط المعلمات بكود تطبيقك.

التشغيل والمراقبة

استخدم رموز الحالة وتكاليف الاعتمادات وحقول الاستجابة لبناء إعادة المحاولة والسجلات والتنبيهات.

عدة المطور

انتقل من هذه الصفحة إلى وثائق قابلة للقراءة آليًا، مجموعات طلبات، SDKs أو أدوات للوكلاء.

مخطط OpenAPI

أنشئ عملاء أو افحص شكل كل طلب واستجابة.

مجموعة Postman

استورد طلبات جاهزة للاختبار اليدوي وتسليم الفريق.

SDKs وCLI

استخدم حزمًا مصانة وسير عمل سطر الأوامر بدل كتابة boilerplate.

تكامل MCP

اعرض ذكاء النطاقات لوكلاء الذكاء الاصطناعي وسير عمل المساعدين الداخليين.

خريطة المعلمات والاستجابة

راجع المدخلات وحقول الإخراج ورموز الحالة قبل توصيل نقطة النهاية بعميلك.

معلمات الطلب

المعامل

domaintickerexchangeisinname

حقول الاستجابة

مثال الرد

queryquery.typequery.valuequery.exchangestatusdomainnamename.statusname.valuename.provenancename.provenance.sourcename.provenance.method

تغطية الحالة

رموز حالة HTTP

200304400401402429

نقاط النهاية

GET /v1/brand

الرصيد: 3المصادقة: المصادقة مطلوبة

إشارات ثقة قبل التكامل

توفر الوثائق الواضحة والطلبات الموثقة وتفاصيل الاعتمادية المرئية طريقة أسهل لتقييم DomScan قبل الإطلاق.

مباشر حالة الخدمة

تحقق من حالة الخدمة المباشرة واستجابات الفشل الموثقة قبل التكامل.

OpenAPI ملفات API

روابط OpenAPI وSwagger وPostman وCLI وSDK وMCP متاحة بنقرة واحدة.

مفاتيح API وصول محمي

تستخدم نقاط النهاية الموثقة مفاتيح API مع تكاليف رصيد واضحة قبل الاستدعاء.

1,000 أرصدة مجانية

ابدأ مع 1,000 رصيد مجاني كل شهر. تحتاج إلى المزيد؟ اختر خطة شهرية أو اشترِ باقة لمرة واحدة.

الميزات الرئيسية

ألوان مستخرجة من الشعار

تُستخرج اللوحة اللونية من بكسلات الشعار بعد فك ترميزه، مع استبعاد المناطق الشفافة والخلفيات أحادية اللون، بصيغ hex وRGB وOKLCH. أما theme_color الذي يعلنه الموقع فيُعرض بشكل منفصل.

شعارات مربعة وعريضة

احصل على رمز العلامة المربع، وعلى شعارها العريض للترويسة أو الشعار النصي عندما ينشره الموقع. يُنزَّل كلاهما ويُفكّ ترميزهما قبل إعادتهما.

غير معروف لا يعني غير موجود أبدًا

يوضح كل حقل ما إذا كانت القيمة موجودة أو غير موجودة أو غير معروفة. الموقع الذي يحجب الطلب أو تنتهي مهلته يعطي حقولًا غير معروفة وليست فارغة، ورمز السهم الذي يطابق عدة شركات يعيد المرشحين بدلًا من التخمين.

تنبيهات عند تغيّر العلامة التجارية

راقب نطاق علامة تجارية باشتراك تنبيهات العلامة التجارية، واستقبل brand.updated على webhook الخاص بك عندما تتغير شعاراتها أو ألوانها أو اسمها أو حساباتها الاجتماعية.

طلب مثال

GET /v1/brand?domain=stripe.com bash

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/brand?domain=stripe.com"

مثال الرد

200 OK json

{
  "query": { "type": "domain", "value": "stripe.com", "exchange": null },
  "status": "present",
  "domain": "stripe.com",
  "name": { "status": "present", "value": "Stripe", "provenance": { "source": "website", "method": "declared_organization_name" } },
  "logo": {
    "status": "present",
    "value": { "url": "https://domscan.net/v1/logo/stripe.com", "source": "touch_icon", "verification": "decoded", "native_width": 180, "native_height": 180 }
  },
  "wide_logo": {
    "status": "present",
    "value": { "url": "https://domscan.net/v1/logo/stripe.com?variant=wide", "source": "logo_image", "aspect_ratio": 2.4 }
  },
  "colors": {
    "status": "present",
    "value": {
      "from": "logo",
      "dominant": { "hex": "#635bff", "rgb": { "r": 99, "g": 91, "b": 255 }, "oklch": { "css": "oklch(57.84% 0.2346 278.29)" }, "share": 0.8712 },
      "background": null
    },
    "provenance": { "source": "logo_pixels", "method": "quantized_palette" }
  },
  "theme_color": { "status": "present", "value": { "declared": "#635BFF" }, "provenance": { "source": "website", "method": "meta_theme_color" } },
  "socials": { "status": "present", "value": [{ "platform": "x", "url": "https://x.com/stripe", "declared_by": "same_as" }] },
  "checked_at": "2026-11-02T10:00:00.000Z"
}

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

كم رصيدًا يكلّف البحث عن علامة تجارية؟

ثلاثة أرصدة لكل طلب، بما في ذلك الإجابات بغير موجود وغير معروف. تُسترد قيمة الطلبات غير الصالحة وعمليات البحث التي تفشل لأن بيانات الشركات الخاصة بـ DomScan غير متاحة. يكلّف كل رابط صورة شعار في الاستجابة رصيدًا واحدًا عند طلبه.

هل يمكنني تخزين بيانات العلامة التجارية؟

نعم. يمكنك تخزين النتائج والشعارات مؤقتًا وحفظها في أنظمتك الخاصة. تتضمن الاستجابات ETag ورؤوس تخزين مؤقت لتتمكن من إعادة التحقق من النسخ المحفوظة. تبقى الشعارات والأسماء علامات تجارية لأصحابها.

من أين تأتي ألوان العلامة التجارية؟

من بكسلات الشعار بعد فك ترميزه. تُجمَّع الألوان المتشابهة ويُستبعد الشفاف والخلفية أحادية اللون، ويعطي الشعار نفسه اللوحة نفسها دائمًا. أما theme_color الذي يعلنه الموقع فهو حقل منفصل.

هل يمكنني البحث عن علامة تجارية برمز السهم؟

نعم. أرسل ticker، مع exchange اختياريًا، أو isin أو name بدلًا من domain. لا يُستخدم النطاق إلا عند تطابق شركة واحدة بالضبط؛ وإلا تكون الإجابة غير معروف مع السبب والمرشحين.

الأدوات والموارد ذات الصلة

رموز حالة HTTP

هذه هي رموز حالة HTTP التي ينبغي التعامل معها، لتتمكن من التمييز بين الاستجابات الناجحة ومشكلات المصادقة والأرصدة وحدود المعدل والبيانات المفقودة وأعطال المصدر.

OK 200

نجح الطلب

HTTP 304 304

طلب غير صالح 400

معلمات غير صالحة

غير مصرح 401

مفتاح API أو الجلسة مفقود أو غير صالح.

الدفع مطلوب 402

لا توجد أرصدة كافية لتنفيذ هذا الطلب.

طلبات كثيرة جداً 429

تم تجاوز حد المعدل

ابحث عن علامة تجارية

ابدأ مجاناً عرض الوثائق