QannasAPI

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

→ qannasapi.com

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

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. 1. أنشئ مفتاحًاأنشئ مساحة عمل، وتحقّق من بريدك الإلكتروني، ثم أنشئ مفتاح qk_live_ أو qk_test_. يحمل كل طلب الترويسة Authorization: Bearer.
  2. 2. قدّر التكلفة مجانًايعيد POST /v1/data/{action}:estimate تكلفة الائتمانات للاستدعاء الذي توشك على تنفيذه دون خصم أي شيء.
  3. 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 إلى جانب مجموعات الوصفات، مولَّدة من المواصفة نفسها فلا يمكن أن تنحرف عنها.

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

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

اقرأ مرجع واجهة APIOpenAPI 3.1

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

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

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

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

01

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

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

02

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

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

03

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

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

04

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

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

05

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

اربط عميل MCP

06

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

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

كتب الوصفات

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

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

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

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

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

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

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

تقييم مجاني

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

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

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

سجل الأسعار العلني

أسعار الائتمانات لكل إجراء

هذه هي الأسعار العامة القياسية لكل إجراء المعروضة على الموقع. تُحتسب الإجراءات المسعّرة لكل نتيجة عن كل نتيجة مُعادة؛ ويُحتسب ما عداها لكل استدعاء. لا نتيجة = لا رسوم، دائمًا. تعرض البوابة السعر الدقيق المطبّق على مساحة عملك، وقد يختلف إذا كان لديك تسعير مخصّص.

جهات الاتصال والإثراء

  • Email findfind_email5 cr
  • Email verifyverify_email1 cr
  • Phone findfind_phone10 cr
  • Person enrichenrich_person3 cr
  • Company enrichenrich_company3 cr
  • Reverse lookupreverse_lookup1 cr
  • People searchsearch_people1 cr / نتيجة
  • Company searchsearch_companies1 cr / نتيجة
  • Lead searchsearch_leads1 cr / نتيجة
  • Company employees searchsearch_company_employees1 cr / نتيجة
  • Lookalike searchsearch_lookalikes1 cr
  • Competitor followerscompetitor_followers1 cr / نتيجة

Dubizzle / الإعلانات المبوّبة في الشرق الأوسط وشمال أفريقيا

  • Classifieds listing searchlistings_search2 cr
  • Listing detailslisting_details2 cr
  • Agent listingsagent_listings2 cr
  • Listing phone reveallisting_phone15 cr

SERP وتحسين محركات البحث

  • SERP (Google results)serp1 cr
  • Keywordskeywords1 cr
  • Backlinksbacklinks1 cr
  • Trendstrends1 cr
  • Ads searchads_search1 cr
  • Ads detailsads_details1 cr

الخرائط والبيانات المحلية

  • Maps placesmaps_places1 cr
  • Maps reviewsmaps_reviews1 cr

استخبارات المواقع

  • Website intelligencewebsite_intelligence1 cr
  • Tech stackwebsite_tech_stack1 cr
  • Website contactswebsite_contacts1 cr
  • Social linkswebsite_social_links1 cr
  • Domain resolvewebsite_resolve1 cr
  • Tracking pixelswebsite_pixels1 cr
  • Page scrapewebsite_scrape1 cr
  • Sitemapwebsite_sitemap1 cr
  • Meta tagswebsite_meta_tags1 cr
  • JSON-LDwebsite_json_ld1 cr
  • Traffic snapshotwebsite_traffic1 cr

وسائل التواصل والمنشورات والإشارات

  • Posts searchposts_search1 cr
  • Posts & activitiesposts_activities1 cr
  • Funding roundsfunding1 cr
  • Signal: funding eventssignals_funding_events1 cr
  • Signal: headcount growthsignals_headcount_growth1 cr
  • Signal: job changessignals_job_changes1 cr

YouTube

  • YouTube searchyoutube_search1 cr
  • YouTube videoyoutube_video1 cr
  • YouTube channelyoutube_channel1 cr
  • Channel videosyoutube_channel_videos1 cr

الوظائف والذكاء الاصطناعي

  • Job searchsearch_jobs1 cr
  • AI enrichai_enrich1 cr
  • AI personalityai_personality1 cr

الكتالوج المباشر: GET /v1/meta/actions · تقديرات تكلفة كل استدعاء: POST /v1/data/{action}:estimate · الأداء الفعلي لكل إجراء: GET /v1/meta/hit-rates

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

الموثوقية

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

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

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

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

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

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

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

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

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

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