QannasAPI

ابنِ قائمة عملاء محتملين مُتحقَّقة باستدعاء واحد

ما ستبنيه: قائمة مُتحقَّقة بأشخاص في شركات تطابق مرشحاتك، عبر سير عمل lead-list على الخادم — مُسعَّرة أولًا، ثم مُشغَّلة، ثم مُصدَّرة كـ CSV.

القسمسير العمل على الخادم
الإجراءات المستخدمةPOST /v1/data/workflows/lead-list:estimatePOST /v1/data/workflows/lead-list
الائتمانات7 لكل شخص يُعثر عليه (أسوأ الحالات)
آمن مع مفتاح الاختبارلا — يحتاج مفتاحًا فعليًا
مدة الإنجاز~15 دقيقة
المتطلباتمفتاح qk_live_ برصيد ائتماني. هذه الوصفة تلامس مصادر مدفوعة، لذا يعيد مفتاح الاختبار بيانات ثابتة بدل نتائج حية.

ما الذي يسلسله سير العمل

ثلاث خطوات تعمل لدينا لكل شخص: العثور على مرشحين يطابقون مرشحاتك، ثم العثور على عنوان البريد، ثم التحقق من ذلك العنوان. ترسل طلبًا واحدًا بدل تنسيق ثلاثة، وكل خطوة تُحاسَب فقط حين تنتج شيئًا.

list-workflows.sh
# Discover what is available to your key rather than
# trusting a list copied from a page.
curl https://api.qannasapi.com/v1/data/workflows \
  -H "Authorization: Bearer $QANNAS_API_KEY"

سعِّرها بـ dry_run

أرسل جسم سير العمل مع dry_run: true فتحصل على تفصيل الائتمان لكل خطوة دون تشغيل أي شيء. هذا هو الرقم الذي تضع ميزانيتك عليه — فهو يفترض نجاح كل خطوة لكل شخص.

quote.sh
curl -X POST https://api.qannasapi.com/v1/data/workflows/lead-list \
  -H "Authorization: Bearer $QANNAS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "inputs": {"industry": "logistics", "country": "AE"},
        "limit": 25,
        "dry_run": true
      }'

# < X-Credits-Charged: 0   # the quote is free

شغِّلها

احذف dry_run وأرسل الجسم نفسه. اضبط format على csv إن أردت ملفًا بدل JSON؛ و markdown متاح أيضًا. تحمل الاستجابة ترويسات الائتمان نفسها كأي استدعاء آخر، فتستطيع تسوية التشغيل مع العرض فورًا.

run.sh
# Same body, without dry_run. format: json | csv | markdown
curl -X POST https://api.qannasapi.com/v1/data/workflows/lead-list \
  -H "Authorization: Bearer $QANNAS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "inputs": {"industry": "logistics", "country": "AE"},
        "limit": 25,
        "format": "csv"
      }'

# < X-Credits-Charged: 138  # reconcile this against the quote

حدِّث بالفروق

اضبط track_delta في التشغيل الأول ومرِّر المؤشر المُعاد بوصفه since_cursor في التالي لتستقبل ما تغيّر فقط. لاحظ أن الفروق مرشِّح لما تستقبله، لا خصم على ما تدفعه.

delta.sh
# Run one: ask for a cursor.
curl -X POST https://api.qannasapi.com/v1/data/search/people \
  -H "Authorization: Bearer $QANNAS_API_KEY" \
  -d '{"query": "logistics AE", "track_delta": true}'

# Run two: receive only what changed.
# NOTE: delta filters what you RECEIVE. It is not a discount.
curl -X POST https://api.qannasapi.com/v1/data/search/people \
  -H "Authorization: Bearer $QANNAS_API_KEY" \
  -d '{"query": "logistics AE", "since_cursor": "cur_..."}'

الخلاصة

النمطالطريقة
التسعيرPOST /v1/data/workflows/lead-list مع dry_run: true
التشغيلالجسم نفسه، بدون dry_run
الخطوات المتسلسلةبحث ← إيجاد بريد ← تحقق، بفوترة لكل خطوة
صيغة المخرجاتformat: json | csv | markdown
التحديث التزايديtrack_delta في التشغيل الأول، ثم since_cursor
شكل التكلفةلكل شخص يُعثر عليه، لا لكل شخص مطلوب

قائمة التحقق قبل الإنتاج

  • سعِّر بـ dry_run قبل كل تشغيل مجدول، لا قبل الأول فقط.
  • ضع الميزانية على السقف؛ وسوِّ الحساب على X-Credits-Charged.
  • خزِّن مؤشر الفروق مع القائمة، لا في ذاكرة التطبيق.
  • أعد التحقق من العناوين دوريًا — قابلية التسليم تتآكل.

الخطوات التالية

شغِّل التقدير أولًا. لا يكلف شيئًا، وهو الحساب نفسه الذي سيطبقه العدّاد.