ArgorantDocs

البحث والحفظ والتصدير

الفلاتر التي يشترك فيها كل بحث، والقوائم المحفوظة، وعمليات تصدير CSV، وأرقام الهواتف، والإثراء، وتكلفة كل منها.

الفلاتر

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

الفلترمثالكيف يعمل
qsoftware companies selling to restaurantsكلمات عادية يُبحث بها في الاسم والمسمى الوظيفي والشركة والوصف
titleCFO, Finance Directorالفاصلة تعني "أو". يفهم الاختصارات. يستبعد exclude_title مسميات وظيفية
seniorityC-Level,VPOwner، Founder، Partner، C-Level، VP، Director (يطابق أيضًا Head of)، Manager، Senior، Entry، Intern
departmentsFinance
industriesSoftware Developmentأسماء دقيقة من قائمة القطاعات؛ الخط العمودي يعني "أو"
keywordslogistics, freightكلمات تصف ما تفعله الشركة: اسمها ووسومها وقطاعها ووصفها. أوسع فلتر للمجالات المتخصصة. يبحث keyword_scope=people في مهارات الأشخاص أنفسهم بدلًا من ذلك، وkeyword_scope=any في الاثنين
technologiesShopifyما تستخدمه الشركة
employee_range11-50,51-200حجم الشركة
country، state، cityGermany أو DACHأسماء أو مناطق مثل Europe وDACH وNordics
company_domain، company_namestripe.comشركة واحدة
has_phone، has_linkedintrueفقط الأشخاص الذين لديهم رقم هاتف أو ملف شخصي
business_email_onlytrueفقط الأشخاص الذين يكون بريدهم الإلكتروني على نطاق شركتهم الخاص. معطّل ما لم تفعّله، لذا لا تُستبعد العناوين الخاصة إلا عند الطلب
exclude_assistantsfalseمفعّل افتراضيًا. يستبعد البحث بالمسمى الوظيفي مسميات المساعدين مثل executive assistant أو assistant to. اضبطه على false للإبقاء عليها

يذكر كل رد من العدّ والبحث والقوائم والتصدير ما طُبّق إضافة إلى فلاترك. يُظهر applied_filters الفلتر business_email_only عندما تفعّله، ويُظهر applied_defaults ما إذا استُبعدت مسميات المساعدين وأيها. تحفظ القائمة المحفوظة الاثنين، إلى جانب الطلب كما أرسلته (filters.request).

قد تتداخل المناطق. مصر ضمن Middle East وAfrica معًا، والمكسيك ضمن North America وLATAM معًا، وتُحتسب تركيا ضمن Middle East وليس Europe. يُحتسب الشخص مرة واحدة، حتى عندما تشمل دولته عدة مناطق من التي تحددها. وتعني EMEA أوروبا والشرق الأوسط وأفريقيا معًا.

القوائم المحفوظة

تحتفظ القائمة ببحث حتى تتمكن من تصديره أو إضافته إلى حملة لاحقًا.

Shell
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 في الخلفية.

Shell
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 بيانات الشخص: رصيد واحد عن كل تطابق يجتاز بريده الفحص، ولا شيء عند عدم التطابق، والشخص نفسه مرة أخرى مجاني. ونطاق الشركة وحده يعيد ملف الشركة مجانًا.

في هذه الصفحة