ArgorantDocs

اعثر على بريد إلكتروني واحد

أدخل اسم الشخص ونطاق شركته، واحصل على بريد العمل الخاص به. شخص واحد في كل مرة أو حتى 10,000 شخص، من API أو سطر الأوامر أو الذكاء الاصطناعي لديك أو التطبيق.

يأخذ الباحث عن البريد الإلكتروني الاسم الأول واسم العائلة ونطاق الشركة، ويعيد بريد العمل الخاص بالشخص. يعمل بالطريقة نفسها في التطبيق (الباحث عن البريد الإلكتروني في الشريط الجانبي)، وفي REST API، وسطر الأوامر، وأدوات MCP.

كم يكلف

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

ما الذي عادstatusالسعر
تم العثور عليه وتأكيدهvalidرصيد واحد
نطاق الشركة يقبل كل عنوان، لذا لا يمكن تأكيد أي عنوان. تحصل على العنوان الأرجح، مع confirmed: falsecatch_allرصيد واحد
لم يُعثر على شيءnot_found0.25 رصيد
مدخلات غير صحيحة، أو نطاق بلا بريد إلكتروني، أو خادم بريد تعذّر الوصول إليه الآن400، no_mail_domain، retry_laterمجاني

يأتي ربع الرصيد من رصيد صغير مدفوع مسبقًا. أول عملية بحث لا تجد شيئًا تأخذ رصيدًا واحدًا وتحتفظ بـ 0.75 للعمليات الثلاث التالية. يعرض GET /api/v1/email-finder/pricing الأسعار ورصيدك وحدودك.

تعامل مع عناوين catch_all على أنها تخمين جيد. أرسل إليها بأعداد أصغر وراقب حالات الارتداد.

شخص واحد

Shell
curl -X POST "https://app.argorant.com/api/v1/email-finder/find" \
  -H "Authorization: Bearer $ARGORANT_API_KEY" -H "Idempotency-Key: find-jane-doe-acme" \
  -H "Content-Type: application/json" \
  -d '{"first_name": "Jane", "last_name": "Doe", "domain": "acme.com"}'
JSON
{ "status": "valid", "email": "jane.doe@acme.com", "confirmed": true, "confidence": 95, "credits_charged": 1,
  "message": "Found and confirmed jane.doe@acme.com. 1 credit charged." }

تُحتسب تكلفة كل استدعاء حسب نتيجته. لا تكرر عملية بحث لم تجد شيئًا؛ صحّح الاسم أو النطاق أولًا. يعمل الاسم الكامل أيضًا: {"name": "Dr. Jane Doe", "domain": "acme.com"}.

عدة أشخاص

أرسل حتى 10,000 شخص في rows أو كنص CSV، مع حد للإنفاق:

Shell
curl -X POST "https://app.argorant.com/api/v1/email-finder/jobs" \
  -H "Authorization: Bearer $ARGORANT_API_KEY" -H "Idempotency-Key: q4-accounts-finder" \
  -H "Content-Type: application/json" \
  -d '{"name": "Q4 accounts", "max_credits": 100, "rows": [{"first_name": "Jane", "last_name": "Doe", "domain": "acme.com", "ref": "crm-1042"}]}'

يحتوي الرد على job_id وmaximum_charge، وهو أقصى ما قد تكلّفه القائمة. تحقق من المهمة كل 30 ثانية تقريبًا باستخدام GET /api/v1/email-finder/jobs/{job_id} واقرأ الصفوف من .../results، أو كلها دفعة واحدة من .../results?format=csv.

تتوقف القائمة مؤقتًا بدلًا من أن تفشل:

paused_reasonما الذي حدثما الذي تفعله
spend_limitبلغت حد max_credits الذي وضعتهاستأنف بحد أعلى
insufficient_creditsنفدت أرصدة الحسابأضف أرصدة، ثم استأنف
daily_limitتم بلوغ الحد اليومي لعمليات البحثلا شيء؛ تستمر بعد منتصف الليل بتوقيت UTC
miss_rateمعظم عمليات البحث لم تجد شيئًا، لذا تباطأتلا شيء؛ تستمر. تحقق من الأسماء والنطاقات

استأنف باستخدام POST .../resume (ويمكنك إضافة {"max_credits": 150}) وأوقف باستخدام POST .../cancel. الصفوف التي لم يُبحث عنها لا تُحتسب تكلفتها أبدًا.

أعمدة CSV المقبولة هي first_name وlast_name (أو name أو full_name)، وdomain (أو company_domain أو website)، وعمود اختياري id أو ref يعود مع النتيجة.

الحدود

لكل حساب 30 عملية بحث فردية في الدقيقة و2,000 عملية بحث في اليوم. الحساب الذي لا تكاد عمليات بحثه تجد شيئًا يُبطَّأ إلى 20 عملية في الساعة لفترة، ولا تزيد تكلفته أبدًا. فوق هذه الحدود تحصل على 429 مع finder_rate_limit أو finder_daily_limit أو finder_miss_rate_throttle.

الحساب الذي ليس لديه خطة ولا أرصدة من باقة يجد حتى 10 عناوين بريد إلكتروني جديدة في اليوم، تُحتسب مع عمليات الكشف والتصدير. بعد ذلك تحصل على 429 daily_limit_reached.

من الطرفية

Shell
npx argorant find "Jane Doe" --domain acme.com
npx argorant find --file people.csv -o found.csv --max-credits 100
npx argorant find status <job_id>
npx argorant find pricing

من مساعد ذكاء اصطناعي

يحتوي خادم MCP على argorant_find_email لشخص واحد وargorant_find_emails لقائمة (مع حد إنفاق يجب أن تحدده)، إضافة إلى argorant_find_emails_status وargorant_manage_find_emails. راجع الأدوات.

في هذه الصفحة