فلاتر الأشخاص + الشركة

تقبل POST /people/search كل فلتر شركة تقبله POST /companies/search. لم تعد بحاجة إلى جلب الشركات مسبقًا، وجمع معرّفاتها، ثم تغذيتها في استعلام أشخاص ثانٍ — طلب واحد يغطي الطبقتين معًا.

عائلتا معاملات، نص طلب واحد

يُقسَّم نص طلب /people/search من الناحية المفاهيمية إلى عائلتي فلاتر. تعيشان في نفس المستوى داخل JSON، ويمكنك مزجهما بحرية.

مستوى الأشخاص
مستوى الشركة

التصفية على سمات الشخص:

المعامل	الوصف
`people_titles`	المسميات الوظيفية (نص حر أو slug)
`management_levels`	`founder`، `c_suite`، `vp`، `director`، `manager`، وغيرها
`departments`	`master_engineering_technical`، `master_sales`، وغيرها
`department_functions`	slugs الأقسام الفرعية / الوظائف
`people_locations`	رموز الدول لموقع الشخص
`people_groups`	معرّفات المجموعات المحفوظة
`peoples`	قيم `people_search_id` محددة
`linkedin_urls`	روابط LinkedIn للأشخاص
`social_media`	مقابض التواصل الاجتماعي لكل شبكة

التصفية على سمات الشركة التي يعمل بها الشخص — نفس الأسماء المستخدمة في /companies/search، مع مجموعة صغيرة من مفاتيح المواقع ذات بادئة company_:

المعامل	الوصف
`technologies`	معرّفات slug للتقنيات التي تستخدمها الشركة
`categories`	معرّفات slug للفئات
`verticals`	معرّفات slug للقطاعات
`vertical_categories`	معرّفات slug لفئات القطاع
`vertical_sub_categories`	معرّفات slug للفئات الفرعية للقطاع
`keywords`	كلمات مفتاحية نصية حرة تُطابَق مع وصف الشركة
`founded_dates`	نطاق سنة التأسيس، مثل `[2015, 2023]`
`employees`	فئات عدد الموظفين، مثل `[[100, 500], [501, 1000]]`
`revenues`	فئات الإيرادات بالدولار الأمريكي
`company_locations`	رموز الدول لمقر الشركة الرئيسي
`company_exclude_locations`	رموز الدول المستبعدة
`company_places`	أسماء المدن / المناطق المراد تضمينها
`company_exclude_places`	أسماء المدن / المناطق المراد استبعادها
`companies`	قيم `domain_search_id` محددة
`domains`	نطاقات شركات محددة
`company_linkedin_urls`	روابط LinkedIn للشركات

في المستوى الأعلى من /people/search، تحمل فلاتر مواقع وأماكن الشركة البادئة company_؛ المفاتيح المجردة locations / places غير مقبولة هناك ويُبلَّغ عنها في metadata.ignored_fields. كل ما عدا ذلك يستخدم اسم الشركة المجرد (technologies، وليس company_technologies). داخل company_filters تعمل كلتا الصيغتين.

بناء استعلام في أربع خطوات

حدّد شرط الأشخاص

من بالضبط؟ المسمى الوظيفي، الأقدمية، القسم، الدولة. أبقِ هذه الطبقة في المستوى الأعلى من نص الطلب — عادةً ما تقوم شرط الشركة بعمل الدقة.

حدّد شرط الشركة

في أي شركات يجب أن يعملوا؟ الصناعة، الحجم، سنة التأسيس، دولة المقر الرئيسي، حزمة التقنيات. جمّع هذه ضمن كائن company_filters: {...} حتى يتضح إلى أي طبقة ينتمي كل مفتاح.

اختر AND/OR لكل فلتر عبر filter_conditions

لأي فلتر متعدد القيم يحتاج دقة (مثل “يستخدم كل هذه التقنيات”)، أضف عبارة إلى filter_conditions داخل company_filters. القيم الافتراضية هي OR.

أرسل الطلب

POST /people/search. يُقبل كلا الأسلوبين، لكن company_filters: {...} أوضح للقراءة ويطابق شكل حمولة Monitors.

مثال كامل

الاستعلام: نواب رئيس الهندسة أو مدراء التقنية في شركات أمريكية متوسطة الحجم تأسست بين 2015 و2023، يعمل بها بين 100 و5000 شخص، تستخدم كلًا من Kubernetes وDocker، باستثناء الشركات التي يقع مقرها الرئيسي في سان فرانسيسكو.

curl -X POST https://api.pubrio.com/people/search \
  -H "Content-Type: application/json" \
  -H "pubrio-api-key: YOUR_API_KEY" \
  -d '{
    "people_titles": ["VP of Engineering", "CTO"],

    "company_filters": {
      "company_locations": ["US"],
      "company_exclude_places": ["San Francisco"],
      "founded_dates": [2010, 2024],
      "employees": [[100, 500], [501, 1000], [1001, 5000]],
      "technologies": ["Kubernetes", "Docker"],
      "is_enable_similarity_search": true
    },

    "per_page": 25,
    "page": 1
  }'

import requests

response = requests.post(
    "https://api.pubrio.com/people/search",
    headers={
        "Content-Type": "application/json",
        "pubrio-api-key": "YOUR_API_KEY",
    },
    json={
        "people_titles": ["VP of Engineering", "CTO"],

        "company_filters": {
            "company_locations": ["US"],
            "company_exclude_places": ["San Francisco"],
            "founded_dates": [2010, 2024],
            "employees": [[100, 500], [501, 1000], [1001, 5000]],
            "technologies": ["Kubernetes", "Docker"],
            "is_enable_similarity_search": True,
        },

        "per_page": 25,
        "page": 1,
    },
)
print(response.json())

const response = await fetch("https://api.pubrio.com/people/search", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "pubrio-api-key": "YOUR_API_KEY",
  },
  body: JSON.stringify({
    people_titles: ["VP of Engineering", "CTO"],

    company_filters: {
      company_locations: ["US"],
      company_exclude_places: ["San Francisco"],
      founded_dates: [2010, 2024],
      employees: [[100, 500], [501, 1000], [1001, 5000]],
      technologies: ["Kubernetes", "Docker"],
      is_enable_similarity_search: true,
    },

    per_page: 25,
    page: 1,
  }),
});
console.log(await response.json());

مرجع إعادة تعيين المفاتيح

في /people/search تحمل مفاتيح مواقع وأماكن الشركة البادئة company_. وهي تقابل أسماء بحث الشركات على النحو التالي:

ترسل في `/people/search`	اسم بحث الشركات
`company_locations`	`locations`
`company_exclude_locations`	`exclude_locations`
`company_places`	`places`
`company_exclude_places`	`exclude_places`
`technologies`، `verticals`، `vertical_categories`، `vertical_sub_categories`، `categories`، `keywords`، `founded_dates`، `employees`، `revenues`	الاسم نفسه

مفاتيح filter_conditions لا تأخذ البادئة أبدًا — استخدم technologies وverticals وkeywords والأسماء الأخرى المدرجة ضمن المفاتيح المدعومة. فلاتر المواقع والأماكن تطابق دائمًا أي قيمة مدرجة.

أشخاص بلا شركة

إضافة أي فلتر على مستوى الشركة يحصر النتيجة في الأشخاص الذين لديهم شركة معروفة مسجَّلة. يُستبعد الأشخاص الذين ليس لديهم شركة، حتى لو طابقوا كل فلتر على مستوى الأشخاص.

إذا انخفض بحثك إلى صفر صفوف بمجرد إضافة company_locations أو technologies، تحقق مما إذا كان الأشخاص الذين تتوقعهم مرتبطين بشركة.

يتضمن كل شخص مُعاد كائن company معبّأ كلما طُبِّق أي فلتر شركة.

أنماط شائعة

التسويق القائم على الحسابات (ABM)

استهدف قائمة ثابتة من الشركات (companies أو domains)، ثم أضف فلاتر مستوى الأشخاص لإيجاد المشترين المناسبين داخل كل واحدة منها.

{
  "people_titles": ["VP Marketing", "CMO"],
  "management_levels": ["vp", "c_suite"],
  "company_filters": {
    "companies": ["67c4696b-…", "f1e2d3c4-…", "0a9b8c7d-…"]
  }
}

اكتشاف الملف الشخصي المثالي للعميل (ICP)

صِف شكل الشركة، وليس حسابات محددة. استخدم النطاقات والقطاعات — يُعيد المحرك الأشخاص الذين يتناسبون.

{
  "people_titles": ["Head of Engineering"],
  "company_filters": {
    "verticals": [69086912],
    "company_locations": ["US", "CA"],
    "founded_dates": [2015, 2023],
    "employees": [[51, 200], [201, 500]]
  }
}

استكشاف العملاء المدفوع بالتقنية

اعثر على المشترين في الشركات التي تُشغّل حزمة تقنية محددة. AND على technologies هو التجاوز النموذجي.

{
  "people_titles": ["RevOps", "Sales Operations"],
  "departments": ["master_sales"],
  "company_filters": {
    "technologies": [10191, 121],
    "filter_conditions": [
      { "key": "technologies", "operator": "and" }
    ]
  }
}

إزاحة المنافس

اعثر على صانعي القرار في الشركات التي تستخدم منتج منافس (تقنية واحدة) لكن ليس منتجك (مستبعد عبر categories أو تمريرة فلتر منفصلة).

{
  "people_titles": ["VP Sales"],
  "management_levels": ["vp"],
  "company_filters": {
    "technologies": [287]
  }
}

ثم أعد التشغيل باستخدام technologies: [114] (معرّف وسم منتجك) وقارن الفروق من جهة العميل.

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

filter_conditions

مرجع كامل — كل مفتاح، وكل قيمة افتراضية، ووصفات AND/OR جاهزة للنسخ.

نظرة عامة على الفلاتر

النموذج الذهني وراء محرك الفلاتر الموحّد.

مرجع بحث الأشخاص

مخطط الطلب/الاستجابة الكامل لـ /people/search.

مرجع بحث الشركات

مخطط الطلب/الاستجابة الكامل لـ /companies/search.

Monitor

البحث

المرشحات

الأشخاص

التوسع

فلاتر الأشخاص + الشركة

عائلتا معاملات، نص طلب واحد

بناء استعلام في أربع خطوات

مثال كامل

مرجع إعادة تعيين المفاتيح

أشخاص بلا شركة

أنماط شائعة

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

filter_conditions

نظرة عامة على الفلاتر

مرجع بحث الأشخاص

مرجع بحث الشركات

​عائلتا معاملات، نص طلب واحد

​بناء استعلام في أربع خطوات

​مثال كامل

​مرجع إعادة تعيين المفاتيح

​أشخاص بلا شركة

​أنماط شائعة

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

filter_conditions

نظرة عامة على الفلاتر

مرجع بحث الأشخاص

مرجع بحث الشركات

عائلتا معاملات، نص طلب واحد

بناء استعلام في أربع خطوات

مثال كامل

مرجع إعادة تعيين المفاتيح

أشخاص بلا شركة

أنماط شائعة

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