استدعاؤك الأول
البداية السريعة. بمفتاح API واحد تعدّ سوقًا، وتطّلع على الأشخاص، وتكشف بعضهم، وتحفظهم كقائمة، وتجهّز حملة. العدّ والاطلاع مجانيان.
تحتاج إلى مفتاح API. أنشئ مفتاحًا في app.argorant.com/profile ضمن مفاتيح API. يبدأ المفتاح بـ ag_live_ ويُعرض مرة واحدة. يحصل كل حساب جديد على فترة تجريبية مدتها 7 أيام مع 100 رصيد و300 رسالة حملة.
export ARGORANT_API_KEY=ag_live_...تحقق من المفتاح
curl "https://app.argorant.com/api/v1/account" -H "Authorization: Bearer $ARGORANT_API_KEY"ترى خطتك، وأرصدتك، وعدد الطلبات التي يمكن للمفتاح إرسالها في الدقيقة، وما تبقى من حدود اليوم.
اعدد سوقا، مجانا
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 الأسماء الدقيقة مع عدد الأشخاص الذين يحملون كلًا منها.
اطلع على المطابقين، مجانا
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.
اكشف بعض الأشخاص
هذا يستهلك أرصدة، لذا في التطبيق أو لدى الوكيل، اعرض السعر واسأل أولًا.
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 التكلفة.
احفظ البحث كقائمة
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.
جهز حملة
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 واطلب ما تريد بكلمات بسيطة.
الأدلة
أدلة خطوة بخطوة للمهام الأكثر شيوعًا مع Argorant: الاستدعاء الأول، والعثور على الأشخاص ومراسلتهم، والردود، والأرصدة، وصناديق البريد، وWebhooks.
اعثر على 200 شخص وراسلهم
من تحديد من تبيع لهم إلى حملة قيد التشغيل: ضيّق النطاق إلى نحو 200 شخص، واكتب الرسائل مع سطر شخصي، واختر صناديق البريد وأطلق الحملة بعد الموافقة.