غرفة المحرّكات

مفتاح واحد. الكتالوج بأكمله. وإيصال مع كل استجابة.

QannasAPI هي واجهة API الموحّدة لبيانات الويب العامة العاملة خلف المهام الجاهزة على صفحتنا الرئيسية. طلب POST واحد، ورمز Bearer واحد، ومغلّف JSON واحد — الأشخاص والشركات وجهات الاتصال والمواقع ونتائج SERP والإعلانات والخرائط والإعلانات المبوّبة في الخليج. قدّر أي استدعاء مجانًا، وادفع فقط مقابل النتائج، واقرأ الرسوم الدقيقة من ترويسات الاستجابة.

احصل على مفتاح API الخاص بك اقرأ مرجع واجهة API

ائتمانات مجانية لمرة واحدة · مفاتيح qk_test_ لا تخصم أبدًا · غياب النتيجة يعيد data: null ويخصم 0

لست مطوّرًا؟ المهام الجاهزة على صفحتنا الرئيسية تستخدم نقاط النهاية نفسها — دون الحاجة إلى أي شيفرة.

نظرة عامة

ما تحصل عليه خلف مفتاح واحد

البنية التحتية التي كان على فريق البيانات أن يبنيها ويصونها بنفسه — متوفرة أصلًا خلف رمز Bearer نفسه.

مفتاح واحد، فاتورة واحدة، مخطط واحد

يعيد كل إجراء المغلّف نفسه: { status, request_id, data }. الشيفرة التي تكتبها لاستدعائك الأول تستمر في العمل عند استدعائك العشرة آلاف.

فوترة عند النجاح فقط

الاستدعاء الذي لا يعيد أي نتيجة يكون HTTP 200 مع data: null والترويسة X-Credits-Charged: 0. أعطال المصادر الخارجية لا تُحتسب أبدًا ويمكن إعادة محاولتها بأمان.

تقديرات مجانية لكل شيء

يقدّم POST /v1/data/{action}:estimate عرض سعر بتكلفة الائتمانات دون خصم أي شيء. وتقبل مسارات سير العمل أيضًا dry_run: true.

سير عمل من جانب الخادم

ست مهام متسلسلة تعمل من جانبنا بفوترة عند النجاح فقط لكل خطوة — استدعاء واحد بدلًا من خمسة، ولا تدفع إلا مقابل الخطوات التي أنتجت بيانات.

البدء السريع

استدعاؤك الأول في ثلاث خطوات

لا بروكسيات لتدويرها، ولا متصفحات بلا واجهة لمراقبتها، ولا محلّلات لإصلاحها.

1. أنشئ مفتاحًاأنشئ مساحة عمل، وتحقّق من بريدك الإلكتروني، ثم أنشئ مفتاح qk_live_ أو qk_test_. يحمل كل طلب الترويسة Authorization: Bearer.
2. قدّر التكلفة مجانًايعيد POST /v1/data/{action}:estimate تكلفة الائتمانات للاستدعاء الذي توشك على تنفيذه دون خصم أي شيء.
3. نفّذ الاستدعاءالمغلّف نفسه في كل مرة. اقرأ X-Credits-Charged وX-Credits-Balance من ترويسات الاستجابة لتعرف تكلفته بالضبط.

estimate-then-call.sh

# 1 — what will this cost? (free)
curl -X POST https://api.qannasapi.com/v1/data/contacts/find-email:estimate \
  -H "Authorization: Bearer $QANNAS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "Jane Doe, Acme Logistics"}'

# 2 — run it. Same envelope, every time.
curl -X POST https://api.qannasapi.com/v1/data/contacts/find-email \
  -H "Authorization: Bearer $QANNAS_API_KEY" \
  -d '{"query": "Jane Doe, Acme Logistics"}'

# < 200 OK
# < X-Credits-Charged: 5
# < X-Credits-Balance: 95
# {"status":"OK","request_id":"...","data":{...}}

مفاتيح qk_test_ لا تخصم أي ائتمانات وتخضع لحصة تقييم مساحة العمل. السلاسل التي تلمس مصدرًا مدفوعًا تعيد بيانات تجريبية ثابتة؛ أما السلاسل المعتمدة كليًا على الطرف الأول فقد تعيد بيانات حية.

MCP والوكلاء

خادم MCP مستضاف، محدد النطاق وللقراءة فقط

الكتالوج نفسه، متاح لوكلاء الذكاء الاصطناعي عبر Streamable HTTP JSON-RPC 2.0 — بما في ذلك مسارات سير العمل الستة، ولكل منها عرض سعر مجاني عبر dry_run.

نقطة النهاية

POSThttps://api.qannasapi.com/mcp

Streamable HTTP · JSON-RPC 2.0 · 34 tools · 13 read-only scopes

34 أداة محددة النطاق

28 أداة للبيانات والاستخدام إلى جانب أدوات سير العمل الست. استدعِ tools/list لاكتشاف المجموعة الحالية المتاحة لرمزك بدلًا من الاعتماد على قائمة منسوخة.

قراءة فقط بحكم التصميم

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

رموز بمبدأ الرفض الافتراضي

تُعرض رموز qm_ مرة واحدة فقط، وتُخزَّن كبصمة SHA-256، ويصدرها مالكو مساحة العمل ومديروها، وتُلغى فورًا (يفشل الطلب التالي مباشرة).

تقارير التكلفة داخل الاستجابة

تحمل نتيجة كل أداة _credits_charged و_credits_balance، ليتمكن الوكيل من إخبار المستخدم بتكلفة الاستدعاء دون طلب ثانٍ.

المصادقة: اقرأ هذا قبل التخطيط لأي تكامل

تقبل نقطة نهاية MCP حاليًا رمز Bearer ثابتًا — لا يوجد OAuth بعد، وإن كان على خارطة الطريق. يعني ذلك عمليًا أن أي عميل يوفّر حقل ترويسة مخصصة يمكنه الاتصال اليوم، بينما أدلة الموصلات المستضافة التي تشترط تسجيل الدخول عبر OAuth لا تستطيع ذلك بعد. ولا نعلن دعم أي عميل بالاسم حتى يجتاز اختبار الدخان الخاص بنا في بيئة التجهيز.

فجوات معروفة — مذكورة عمدًا

مؤشرات Delta (أي since_cursor / track_delta) متاحة عبر REST فقط ولا تُمرَّر عبر أدوات MCP.
جهات الاتصال الموثّقة بالإجماع وإعلانات المبوّبات وإشارات التوظيف متاحة عبر REST فقط. وتصل إليها مسارات عمل الوكلاء عبر وصفة، لا عبر استدعاء أداة.
استدعاءات MCP تخصم ائتمانات حقيقية دائمًا — لا توجد بيئة اختبار لمفاتيح الاختبار على مسار رموز qm_.

أي عميل MCP تقبل إعداداته عنوان URL مع ترويسة مخصصة يمكنه الاتصال: اسم الترويسة Authorization، وقيمتها Bearer متبوعة برمزك. وتُنشر إعدادات جاهزة للنسخ واللصق لكل عميل فور اجتيازه اختبار الدخان الخاص بنا.

حِزم SDK والأدوات

ولّد عميلًا، أو اكتفِ بقراءة المواصفة

مستند OpenAPI 3.1 هو العقد؛ وكل ما عداه يُولَّد منه.

OpenAPI 3.1

المواصفة العامة الكاملة، مستضافة على هذا الموقع وآمنة لتوجيه أي مولّد شيفرة إليها.

مرجع تفاعلي

كل نقطة نهاية ومخطط ومثال، بصورة قابلة للتصفح — مع متون الطلبات التي سترسلها فعلًا.

مجموعات Postman

مجموعة واجهة API إلى جانب مجموعات الوصفات، مولَّدة من المواصفة نفسها فلا يمكن أن تنحرف عنها.

محوّلات الأتمتة

العُقد والموصلات لمنصات الأتمتة الشائعة جاهزة؛ وإدراجها في المتاجر قيد التنفيذ.

اقرأ مرجع واجهة API OpenAPI 3.1

الوصفات العملية

وصفات مُفصّلة بحساب ائتمانات حقيقي

تعرض كل وصفة التقدير وتسلسل الاستدعاءات والتكلفة الفعلية.

قدِّر قبل أن تستدعي

احصل على التكلفة الائتمانية الدقيقة لأي إجراء قبل تشغيله، مجانًا.

اقرأ ترويسات الائتمان

دقِّق كل خصم مباشرةً من الاستجابة، دون تسوية في آخر الشهر.

تعامل مع عدم العثور وإعادة المحاولة

ميِّز بين «لم يُعثر عليه» و«فشل»، وأعد المحاولة فقط لما يصح إعادته.

ابنِ قائمة عملاء محتملين

ابحث، اعثر على البريد، تحقق منه — استدعاء واحد بدل ثلاثة، بفوترة لكل خطوة.

نظِّف قائمة بريد

تحقق من قائمة دفعةً واحدة واستعد تقرير تآكل، دون بناء طابور بنفسك.

اربط عميل MCP

وجِّه وكيلًا إلى خادم MCP المُستضاف ودعه يسعِّر عمله أولًا.

مؤشرات Delta ترشّح ما تستلمه ولا تخفّض سعره. والفحص الذي لا يعيد جديدًا لا يخصم شيئًا، لأنه لم يُعثر على شيء.

كتب الوصفات

الأسعار والقياس

يمكنك تدقيق كل خصم من الاستجابة نفسها

ائتمانات، وأسعار علنية لكل إجراء، وثلاث ترويسات تخبرك بالضبط أين تقف.

ترويسات مع كل استدعاء بيانات

X-Credits-Charged وX-Credits-Balance وX-Price-Book. لا تسوية في نهاية الشهر، ولا تخمين.

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

تُحتسب عمليات البحث عن كل جهة اتصال يُعثر عليها، لا عن كل محاولة. البحث الأكبر يكلف أكثر لأنه يعيد أكثر.

تقييم مجاني

منحة ائتمانات لمرة واحدة عند التسجيل، إلى جانب مفاتيح qk_test_ التي لا تخصم أبدًا وتخضع لحصة مساحة العمل.

الكميات الكبيرة والمؤسسات

سجلات أسعار مخصّصة، وفئات أعلى لحدود معدل الطلبات، وسقوف إنفاق معتمدة للفرق العاملة على نطاق واسع.

اطّلع على الخطط وسجل الأسعار الكامل

الموثوقية

احكموا علينا بأرقامنا

معدلات إصابة منشورة

يعيد GET /v1/public/hit-rates إحصاءات مجهولة الهوية ومحمية بتجميع الشرائح عن عدد المرات التي نعيد فيها بيانات فعلًا. دون الحاجة إلى مفتاح.

التقديرات لا تكلف شيئًا

اطلب عرض سعر لأي إجراء أو سير عمل قبل تشغيله، كلما شئت، بصفر ائتمانات.

إخفاقات صادقة

السلسلة غير الموجَّهة تعيد 501 not_implemented بدلًا من نتيجة فارغة تبدو معقولة — وأخطاء المصادر الخارجية لا تُحتسب أبدًا.

ابدأ بتقدير مجاني.

أنشئ مفتاحًا، واطلب عرض سعر لاستدعاء، واطّلع على العقد كاملًا بنفسك قبل أن تنفق ائتمانًا واحدًا.

احصل على مفتاح API الخاص بك اقرأ مرجع واجهة API