ArgorantDocs

استدعاؤك الأول

البداية السريعة. بمفتاح API واحد تعدّ سوقًا، وتطّلع على الأشخاص، وتكشف بعضهم، وتحفظهم كقائمة، وتجهّز حملة. العدّ والاطلاع مجانيان.

تحتاج إلى مفتاح API. أنشئ مفتاحًا في app.argorant.com/profile ضمن مفاتيح API. يبدأ المفتاح بـ ag_live_ ويُعرض مرة واحدة. يحصل كل حساب جديد على فترة تجريبية مدتها 7 أيام مع 100 رصيد و300 رسالة حملة.

Shell
export ARGORANT_API_KEY=ag_live_...

تحقق من المفتاح

Shell
curl "https://app.argorant.com/api/v1/account" -H "Authorization: Bearer $ARGORANT_API_KEY"

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

اعدد سوقا، مجانا

Shell
curl -G "https://app.argorant.com/api/v1/people/count" \
  -H "Authorization: Bearer $ARGORANT_API_KEY" \
  --data-urlencode "title=CFO" --data-urlencode "country=Germany" --data-urlencode "employee_range=51-200"
# {"count": 4210}

لست متأكدًا من الكلمات التي تستخدمها؟ يعطيك GET /api/v1/lookups/industries?q=soft وGET /api/v1/lookups/titles?q=head of الأسماء الدقيقة مع عدد الأشخاص الذين يحملون كلًا منها.

اطلع على المطابقين، مجانا

Shell
curl -G "https://app.argorant.com/api/v1/people/search" \
  -H "Authorization: Bearer $ARGORANT_API_KEY" \
  --data-urlencode "title=CFO" --data-urlencode "country=Germany" --data-urlencode "employee_range=51-200" --data-urlencode "limit=10"

يعرض كل صف الدور والشركة والمكان، مع اختصار الاسم إلى الأحرف الأولى ودون بيانات اتصال. ولكل صف record_id.

اكشف بعض الأشخاص

هذا يستهلك أرصدة، لذا في التطبيق أو لدى الوكيل، اعرض السعر واسأل أولًا.

Shell
curl -X POST "https://app.argorant.com/api/v1/people/reveal" \
  -H "Authorization: Bearer $ARGORANT_API_KEY" \
  -H "Idempotency-Key: first-reveal-1" \
  -H "Content-Type: application/json" \
  -d '{"title":"CFO","country":"Germany","employee_range":"51-200","limit":5}'

يُفحص كل بريد إلكتروني مباشرة قبل أن تحصل عليه. تدفع رصيدًا واحدًا عن كل شخص يجتاز بريده الفحص، ولا شيء عن الباقين. يوضح credits_charged التكلفة.

احفظ البحث كقائمة

Shell
curl -X POST "https://app.argorant.com/api/v1/lists" \
  -H "Authorization: Bearer $ARGORANT_API_KEY" \
  -H "Idempotency-Key: first-list-1" \
  -H "Content-Type: application/json" \
  -d '{"name":"CFOs Germany 51-200","filters":{"title":"CFO","country":"Germany","employee_range":"51-200"}}'

الحفظ مجاني ولا يكشف أحدًا. احتفظ بـ list_id.

جهز حملة

Shell
curl -X POST "https://app.argorant.com/api/v1/campaigns" \
  -H "Authorization: Bearer $ARGORANT_API_KEY" -H "Idempotency-Key: first-campaign-1" \
  -H "Content-Type: application/json" -d '{"name":"CFOs Germany Q4","daily_limit":40}'

تبدأ الحملة كمسودة. لا يُرسل شيء حتى تطلقها. يعرض دليل اعثر على 200 شخص وراسلهم بقية الخطوات: الرسائل، والأشخاص، وصناديق البريد، والإطلاق.

الخطوات نفسها في الطرفية: npx argorant count، وnpx argorant search، وnpx argorant reveal، وnpx argorant list create، وnpx argorant campaigns create. في Claude أو ChatGPT، اربط https://mcp.argorant.com/mcp واطلب ما تريد بكلمات بسيطة.

في هذه الصفحة