واجهة برمجة تطبيقات المطورين · v1

واجهة برمجة تطبيقات البحث عن الأشخاص لوكلاء الذكاء الاصطناعي والتطبيقات.

يقوم DeepSearch بتحديد هوية شخص من اسم أو رقم هاتف أو بريد إلكتروني أو اسم مستخدم، ويعيد عرضًا موثّقًا بالمصادر لـالبصمة الرقمية العامة الخاصة به — الحسابات الاجتماعية وتفاصيل التواصل وسجل العمل والأقارب والإشارات على الويب. أنشئ ملفات كاملة (dossiers) واطرح أسئلة متابعة، كل ذلك عبر واجهة JSON API بسيطة مصممة لتُستدعى من قِبل وكلاء مستقلين (autonomous agents).

مُصمَّمة لتُستدعى من قِبل الوكلاء

وجّه وكيلك (agent) أو إطار عملك نحو العقد القابل للقراءة الآلية (machine-readable contract) ليتمكن من اكتشاف واستدعاء كل نقطة نهاية. صادق باستخدام مفتاح Bearer؛ وتُبَث الاستجابات كأحداث Server-Sent Events أو تُعاد ككائن JSON واحد.

خادم MCP مُستضافStreamable HTTP

أضف DeepSearch إلى Claude أو Cursor أو أي عميل MCP واستدعه كأدوات — بحث، ملف تعريف (dossier)، ومحادثة — باستخدام مفتاح API الخاص بالمستخدم.

https://deepsearch.app/api/mcp

الفوترة يديرها المستخدم. لا يتلقى DeepSearch الدفع من الوكلاء مباشرة. عندما يتطلب استدعاء ما حسابًا أو أرصدة، يرد API برابط تسجيل لتسليمه لمستخدمك — يشترك المستخدم مرة واحدة عبر الويب، ثم يستدعي وكيلك بعد ذلك باستخدام مفتاحه. تحمل استجابة 401 أو 402 الرسالة والرابط الدقيقين لتمريرهما.

نقاط النهاية (Endpoints)

POST/api/v1/search
SearchFind people by name, phone, email, or username.
POST/api/v1/dossier
DossierBuild a full public-footprint profile for a person.
POST/api/v1/chat
ChatAsk follow-up questions about a person.
POST/api/v1/reverse-image
Reverse imageFind where an image appears online + visually similar images.
POST/api/v1/entity/search
Entity searchFind companies by name.
POST/api/v1/entity/dossier
Entity profileBuild a full company profile.
POST/api/v1/vin
VIN lookupDecode a vehicle by VIN.

البدء السريع

أنشئ مفتاحًا في بوابة المطورين، ثم حدّد هوية أول شخص لديك.

curl https://deepsearch.app/api/v1/search \  -H "Authorization: Bearer $DEEPSEARCH_API_KEY" \  -H "Content-Type: application/json" \  -d '{        "query": "Ada Lovelace",        "type": "name",        "format": "json"      }'

المصادقة (Authentication)

أرسل مفتاحك كرمز Bearer: Authorization: Bearer dsk_…. تُنشأ المفاتيح ويتم إلغاؤها من البوابة.

التسعير

يعتمد الاستخدام على محفظتك — 10 طلب لكل نافذة مدتها 7 يومًا، ثم عملة واحدة لكل طلب مُقاس بعد ذلك. ملفات dossier المخزَّنة مؤقتًا (cached) مجانية.

ابدأ البناء

أنشئ مفتاح API ونفّذ طلبك الأول خلال دقائق.