People + Company Filters - Pubrio Documentation

POST /people/search akzeptiert jeden Unternehmensfilter, den auch POST /companies/search akzeptiert. Sie müssen Unternehmen nicht mehr vorab abrufen, deren IDs sammeln und in eine zweite Personenabfrage einspeisen — eine Anfrage deckt beide Ebenen ab.

Zwei Parameterfamilien, ein Body

Ein /people/search-Anfrage-Body gliedert sich konzeptionell in zwei Filterfamilien. Sie liegen auf derselben Ebene im JSON, und Sie können sie beliebig mischen.

Personenebene
Unternehmensebene

Filtern nach Attributen der Person:

Parameter	Beschreibung
`people_titles`	Jobtitel (Freitext oder Slug)
`management_levels`	`founder`, `c_suite`, `vp`, `director`, `manager`, …
`departments`	`master_engineering_technical`, `master_sales`, …
`department_functions`	Unterabteilungs-/Funktions-Slugs
`people_locations`	Ländercodes für den Standort der Person
`people_groups`	Gespeicherte Gruppen-IDs
`peoples`	Bestimmte `people_search_id`-Werte
`linkedin_urls`	LinkedIn-URLs der Person
`social_media`	Social-Media-Handles je Netzwerk

Filtern nach Attributen des Unternehmens, bei dem die Person arbeitet — dieselben Namen wie bei /companies/search, mit einer kleinen Menge company_-präfixierter Standortschlüssel:

Parameter	Beschreibung
`technologies`	Vom Unternehmen genutzte Technologie-Slug-IDs
`categories`	Kategorie-Slug-IDs
`verticals`	Vertical-Slug-IDs
`vertical_categories`	Vertical-Kategorie-Slug-IDs
`vertical_sub_categories`	Vertical-Unterkategorie-Slug-IDs
`keywords`	Freitext-Schlüsselwörter, abgeglichen mit der Unternehmensbeschreibung
`founded_dates`	Gründungsjahr-Bereich, z. B. `[2015, 2023]`
`employees`	Mitarbeiter-Buckets, z. B. `[[100, 500], [501, 1000]]`
`revenues`	Umsatz-Buckets in USD
`company_locations`	Ländercodes für den Unternehmenssitz
`company_exclude_locations`	Auszuschließende Ländercodes
`company_places`	Einzuschließende Stadt-/Regionsnamen
`company_exclude_places`	Auszuschließende Stadt-/Regionsnamen
`companies`	Bestimmte `domain_search_id`-Werte
`domains`	Bestimmte Unternehmensdomains
`company_linkedin_urls`	LinkedIn-URLs des Unternehmens

Auf der obersten Ebene von /people/search tragen die Standort- und Ortsfilter des Unternehmens ein company_-Präfix; die bloßen Schlüssel locations / places werden dort nicht akzeptiert und in metadata.ignored_fields gemeldet. Alles andere verwendet den bloßen Unternehmensnamen (technologies, nicht company_technologies). Innerhalb von company_filters funktionieren beide Schreibweisen.

Eine Abfrage in vier Schritten aufbauen

Das Personenprädikat festlegen

Wer, genau? Titel, Senioritätsstufe, Abteilung, Land. Halten Sie diese Ebene auf der obersten Ebene des Bodys — das Unternehmensprädikat übernimmt üblicherweise die Präzisionsarbeit.

Das Unternehmensprädikat festlegen

Bei welchen Unternehmen müssen sie arbeiten? Branche, Größe, Gründungsjahr, Sitzland, Technologie-Stack. Gruppieren Sie diese unter einem company_filters: {...}-Objekt, damit klar ist, zu welcher Ebene jeder Schlüssel gehört.

AND/OR pro Filter über filter_conditions wählen

Für jeden Mehrwert-Filter, der Präzision erfordert (z. B. „nutzt alle dieser Technologien”), fügen Sie einen Eintrag zu filter_conditions innerhalb von company_filters hinzu. Standardwerte sind OR.

Die Anfrage senden

POST /people/search. Beide Stile werden akzeptiert, aber company_filters: {...} liest sich klarer und entspricht der Monitore-Payload-Form.

Vollständiges Beispiel

Die Abfrage: VPs of Engineering oder CTOs bei US-amerikanischen Mid-Market-Unternehmen, gegründet zwischen 2015 und 2023, mit 100–5.000 Mitarbeitenden, die sowohl Kubernetes als auch Docker nutzen, aber ohne Unternehmen mit Sitz in San Francisco.

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());

Referenz zur Schlüssel-Umbenennung

Bei /people/search tragen die Standort- und Ortsschlüssel des Unternehmens ein company_-Präfix. Sie entsprechen den Namen der Unternehmenssuche wie folgt:

Sie senden bei `/people/search`	Name in der Unternehmenssuche
`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`	gleicher Name

filter_conditions-Schlüssel tragen nie das Präfix — verwenden Sie technologies, verticals, keywords und die übrigen Namen, die unter Unterstützte Schlüssel aufgeführt sind. Standort- und Ortsfilter treffen immer auf jeden beliebigen aufgeführten Wert zu.

Personen ohne Unternehmen

Das Hinzufügen jedes Unternehmensfilters beschränkt das Ergebnis auf Personen mit einem erkannten hinterlegten Unternehmen. Personen ohne ein solches werden ausgeschlossen, selbst wenn sie jeden Personenfilter erfüllen.

Wenn Ihre Suche auf null Zeilen fällt, sobald Sie company_locations oder technologies hinzufügen, prüfen Sie, ob mit den erwarteten Personen ein Unternehmen verknüpft ist.

Jede zurückgegebene Person enthält ein befülltes company-Objekt, sobald ein Unternehmensfilter angewendet wurde.

Gängige Muster

Account-Based Marketing (ABM)

Zielen Sie auf eine feste Unternehmensliste (companies oder domains) ab und fügen Sie dann Personenfilter hinzu, um die richtigen Käufer in jedem einzelnen zu finden.

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

Ideal Customer Profile (ICP) Discovery

Beschreiben Sie die Unternehmensform, nicht konkrete Accounts. Verwenden Sie Bereiche und Verticals — die Engine liefert die passenden Personen.

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

Technologiegetriebenes Prospecting

Finden Sie Käufer bei Unternehmen mit einem bestimmten Stack. AND auf technologies ist die typische Überschreibung.

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

Wettbewerbsablösung

Finden Sie Entscheidungsträger bei Unternehmen, die das Produkt eines Wettbewerbers nutzen (eine Technologie), aber nicht Ihres (ausgeschlossen über categories oder einen separaten Filterdurchlauf).

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

Führen Sie den Aufruf dann erneut mit technologies: [114] (der Tag-ID Ihres Produkts) aus und vergleichen Sie clientseitig.

Nächste Schritte

filter_conditions

Vollständige Referenz — jeder Schlüssel, jeder Standard, kopierbare AND-/OR-Rezepte.

Filters Overview

Das mentale Modell hinter der einheitlichen Filter-Engine.

People Search reference

Vollständiges Anfrage-/Antwortschema für /people/search.

Company Search reference

Vollständiges Anfrage-/Antwortschema für /companies/search.

​Zwei Parameterfamilien, ein Body

​Eine Abfrage in vier Schritten aufbauen

​Vollständiges Beispiel

​Referenz zur Schlüssel-Umbenennung

​Personen ohne Unternehmen

​Gängige Muster

​Nächste Schritte

filter_conditions

Filters Overview

People Search reference

Company Search reference

Zwei Parameterfamilien, ein Body

Eine Abfrage in vier Schritten aufbauen

Vollständiges Beispiel

Referenz zur Schlüssel-Umbenennung

Personen ohne Unternehmen

Gängige Muster

Nächste Schritte