البحث والحفظ والتصدير
الفلاتر التي يشترك فيها كل بحث، والقوائم المحفوظة، وعمليات تصدير CSV، وأرقام الهواتف، والإثراء، وتكلفة كل منها.
الفلاتر
يستخدم العدّ والبحث والكشف والقوائم وعمليات التصدير والحملات جميعها الفلاتر نفسها. تعطيك قوائم الكلمات الأسماء الدقيقة للقطاعات والدول والكلمات المفتاحية والتقنيات والمسميات الوظيفية، مع عدد الأشخاص الذين يحملون كلًا منها.
| الفلتر | مثال | كيف يعمل |
|---|---|---|
q | software companies selling to restaurants | كلمات عادية يُبحث بها في الاسم والمسمى الوظيفي والشركة والوصف |
title | CFO, Finance Director | الفاصلة تعني "أو". يفهم الاختصارات. يستبعد exclude_title مسميات وظيفية |
seniority | C-Level,VP | Owner، Founder، Partner، C-Level، VP، Director (يطابق أيضًا Head of)، Manager، Senior، Entry، Intern |
departments | Finance | |
industries | Software Development | أسماء دقيقة من قائمة القطاعات؛ الخط العمودي يعني "أو" |
keywords | logistics, freight | كلمات تصف ما تفعله الشركة: اسمها ووسومها وقطاعها ووصفها. أوسع فلتر للمجالات المتخصصة. يبحث keyword_scope=people في مهارات الأشخاص أنفسهم بدلًا من ذلك، وkeyword_scope=any في الاثنين |
technologies | Shopify | ما تستخدمه الشركة |
employee_range | 11-50,51-200 | حجم الشركة |
country، state، city | Germany أو DACH | أسماء أو مناطق مثل Europe وDACH وNordics |
company_domain، company_name | stripe.com | شركة واحدة |
has_phone، has_linkedin | true | فقط الأشخاص الذين لديهم رقم هاتف أو ملف شخصي |
business_email_only | true | فقط الأشخاص الذين يكون بريدهم الإلكتروني على نطاق شركتهم الخاص. معطّل ما لم تفعّله، لذا لا تُستبعد العناوين الخاصة إلا عند الطلب |
exclude_assistants | false | مفعّل افتراضيًا. يستبعد البحث بالمسمى الوظيفي مسميات المساعدين مثل executive assistant أو assistant to. اضبطه على false للإبقاء عليها |
يذكر كل رد من العدّ والبحث والقوائم والتصدير ما طُبّق إضافة إلى فلاترك. يُظهر applied_filters الفلتر business_email_only عندما تفعّله، ويُظهر applied_defaults ما إذا استُبعدت مسميات المساعدين وأيها. تحفظ القائمة المحفوظة الاثنين، إلى جانب الطلب كما أرسلته (filters.request).
قد تتداخل المناطق. مصر ضمن Middle East وAfrica معًا، والمكسيك ضمن North America وLATAM معًا، وتُحتسب تركيا ضمن Middle East وليس Europe. يُحتسب الشخص مرة واحدة، حتى عندما تشمل دولته عدة مناطق من التي تحددها. وتعني EMEA أوروبا والشرق الأوسط وأفريقيا معًا.
القوائم المحفوظة
تحتفظ القائمة ببحث حتى تتمكن من تصديره أو إضافته إلى حملة لاحقًا.
curl -X POST "https://app.argorant.com/api/v1/lists" -H "Authorization: Bearer $ARGORANT_API_KEY" \
-H "Idempotency-Key: uk-finance-list" -H "Content-Type: application/json" \
-d '{"name":"UK finance leaders","filters":{"title":"CFO, Finance Director","country":"United Kingdom"}}'يستجيب البحث المحفوظ فورًا. تمثل snapshot_total عدد الأشخاص عندما ينتهي العدّ في الوقت المحدد؛ وإلا فتكون قيمتها null، مع count_status بقيمة pending وstatus_url. يعرض GET /api/v1/lists/{id}/fill الحالة والأعداد وprogress_percent وeta_seconds. أضف verbose=true لترى البحث المحفوظ أيضًا.
أرسل record_ids بدلًا من filters للاحتفاظ بالأشخاص الذين اخترتهم بالضبط. يعرض GET /api/v1/lists كل قوائمك، ويتنقل GET /api/v1/lists/{id}/people عبر صفحات الأشخاص في قائمة واحدة، ويضيف POST /api/v1/lists/{id}/items المزيد، ويعيد PATCH التسمية، ويحذف DELETE القائمة. ويدخل list_id مباشرة في POST /api/v1/campaigns/{id}/leads.
عمليات التصدير
تبني عملية التصدير ملف CSV في الخلفية.
curl -X POST "https://app.argorant.com/api/v1/exports" -H "Authorization: Bearer $ARGORANT_API_KEY" \
-H "Idempotency-Key: uk-finance-export" -H "Content-Type: application/json" \
-d '{"filters":{"title":"CFO, Finance Director","country":"United Kingdom"},"limit":500}'تحقق من status_url حتى تصبح قيمة status هي done، ثم نزّل الملف من download_url. يُفحص كل بريد إلكتروني أثناء بناء الملف، وتدفع رصيدًا واحدًا عن كل شخص يجتاز بريده الفحص. الأشخاص الذين صدّرتهم من قبل يُستبعدون ما لم تضبط "exclude_previously_exported": false، فلا تدفع أبدًا مرتين عن الشخص نفسه. فوق 50,000 صف تصبح عملية التصدير دفعة من الملفات؛ تحقق منها على GET /api/v1/export-batches/{batch_id}. ويصدّر POST /api/v1/lists/{id}/export قائمة محفوظة بالطريقة نفسها.
أرقام الهواتف
أضف "include_phones": true إلى عملية تصدير، أو اطلب أرقامًا لما يصل إلى 100 شخص باستخدام POST /api/v1/people/phones وrecord_ids الخاصة بهم. يكلّف رقم الهاتف 10 أرصدة، فقط عند إرجاع رقم، والأرقام التي لديك بالفعل مجانية. تأتي أرقام الهواتف مع خطة Pro. يعرض GET /api/v1/people/phones/pricing السعر وما إذا كانت خطتك تشملها.
إثراء سجل واحد
عندما يكون لديك بريد إلكتروني بالفعل، أو اسم ونطاق شركة، يملأ POST /api/v1/enrich بيانات الشخص: رصيد واحد عن كل تطابق يجتاز بريده الفحص، ولا شيء عند عدم التطابق، والشخص نفسه مرة أخرى مجاني. ونطاق الشركة وحده يعيد ملف الشركة مجانًا.
الرد على الردود
كل رد من كل حملة في صندوق وارد واحد. أجب في السلسلة نفسها، وأعد التوجيه، وصنّف الردود على أنها مهتم أو تم حجز اجتماع أو مرحلة خاصة بك في مسار المبيعات.
الحملات من البداية إلى النهاية
أنشئ الحملة، واكتب الرسائل، وأضف قائمة، واختر صناديق البريد وأطلقها. كل خطوة استدعاء واحد، ولا يُرسل شيء قبل الإطلاق.