AND-/OR-Operatoren

filter_conditions ist ein einzelnes optionales Array im Anfrage-Body. Jeder Eintrag hebt einen Mehrwert-Filter vom standardmäßigen OR-Verhalten („beliebiger Treffer”) auf AND-Verhalten („alle müssen zutreffen”) an — oder umgekehrt. Nicht aufgeführte Filter behalten ihre Standardwerte.

Schema

{
  "filter_conditions": [
    { "key": "technologies", "operator": "and" },
    { "key": "verticals",    "operator": "or"  }
  ]
}

type FilterCondition = {
  /** Zu überschreibender Filtername. Siehe „Unterstützte Schlüssel" unten. */
  key: string;
  /** Groß-/Kleinschreibung wird ignoriert: "and" | "or". Standard für Arrays ist "or". */
  operator: "and" | "or";
};

type SearchRequest = {
  // …all your other filters…
  filter_conditions?: FilterCondition[];
};

key und operator sind bei jedem Eintrag erforderlich. Ein Eintrag mit nur operator wird stillschweigend ignoriert — es gibt keine globale Überschreibung.

Warum das wichtig ist

Der Standardoperator ist OR, da die meisten Prospecting-Workflows eine breite Reichweite wollen: „Personen in einem beliebigen dieser Länder”, „Unternehmen mit einem beliebigen dieser Vertical-Tags”. Für hochpräzises Targeting — „nutzt alle von Salesforce + HubSpot + Marketo” — benötigen Sie AND. Die Kosten eines Fehlers:

AND gewollt, OR erhalten: Die Antwort liefert zu viele Treffer — Sie sehen Unternehmen, die nur ein einziges Tag treffen, nicht den vollständigen Stack. Leicht zu erkennen, kostet Ergebnisqualität.
OR gewollt, AND erhalten: Die Antwort liefert zu wenige Treffer — bei Mehrwert-AND-Filtern kommen üblicherweise fast null Zeilen zurück, da reale Arrays selten jeden angefragten Wert enthalten. Leicht zu erkennen, wirkt wie eine fehlerhafte Abfrage.

Unterstützte Schlüssel

Die genaue Schlüsselmenge hängt vom aufgerufenen Endpunkt ab:

Schlüssel	`/companies/search`	`/people/search`	`/companies/advertisements/search`	`/companies/cloud_footprints/search`	Standard	Was `and` bedeutet
`technologies`	ja	ja	—	—	OR	Hat jede Technologie in der Liste
`categories`	ja	ja	—	—	OR	Mit jeder Kategorie getaggt
`verticals`	ja	ja	—	—	OR	Gehört zu jedem Vertical
`vertical_categories`	ja	ja	—	—	OR	In jeder Vertical-Kategorie
`vertical_sub_categories`	ja	ja	—	—	OR	In jeder Vertical-Unterkategorie
`keywords`	ja	ja	—	—	OR	Beschreibung enthält jedes Schlüsselwort
`social_media`	ja	ja	—	—	OR	Hat ein Profil in jedem aufgeführten Netzwerk
`advertisement_target_locations`	ja	—	—	—	OR	Anzeige richtet sich an jedes Land (Unternehmens-Endpunkt)
`job_exclude_locations`	ja	—	—	—	OR	Stellenausschreibung schließt jeden Standort aus
`target_locations`	—	—	ja	—	OR	Anzeige richtet sich an jedes Land (Anzeigen-Endpunkt)
`publisher_platforms`	—	—	ja	—	OR	Anzeige läuft auf jeder aufgeführten Plattform
`cloud_regions`	—	—	—	ja	OR	Läuft in jeder aufgeführten Cloud-Region
`cities`	—	—	—	ja	OR	Läuft in jeder aufgeführten Stadt

Ortsfilter (places, exclude_places), die übrigen exclude_*-Filter und advertisement_search_terms treffen immer auf jeden beliebigen aufgeführten Wert zu. Die Job-Suche und die News-Suche akzeptieren kein filter_conditions; ihre Listenfilter treffen immer auf jeden beliebigen aufgeführten Wert zu.

Die obigen Schlüssel spiegeln die enum-Arrays in der OpenAPI-Spezifikation wider (company_filter_conditions, people_filter_conditions, ads_filter_conditions, cloud_footprint_filter_conditions). Das Senden eines nicht unterstützten Schlüssels für einen Endpunkt wird stillschweigend ignoriert.

Rezepte

Alle Technologien (Unternehmen)
Beliebige Standorte + Ausschluss
Multi-Region-Werbekampagnen
Personen bei Multi-Stack-Unternehmen

Ziel: Unternehmen, die sowohl Salesforce als auch HubSpot nutzen — nicht nur eines von beiden.

curl -X POST https://api.pubrio.com/companies/search \
  -H "Content-Type: application/json" \
  -H "pubrio-api-key: YOUR_API_KEY" \
  -d '{
    "technologies": [10191, 121],
    "filter_conditions": [
      { "key": "technologies", "operator": "and" }
    ],
    "per_page": 25,
    "page": 1
  }'

import requests

response = requests.post(
    "https://api.pubrio.com/companies/search",
    headers={
        "Content-Type": "application/json",
        "pubrio-api-key": "YOUR_API_KEY",
    },
    json={
        "technologies": [10191, 121],
        "filter_conditions": [
            { "key": "technologies", "operator": "and" }
        ],
        "per_page": 25,
        "page": 1,
    },
)
print(response.json())

const response = await fetch("https://api.pubrio.com/companies/search", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "pubrio-api-key": "YOUR_API_KEY",
  },
  body: JSON.stringify({
    technologies: [10191, 121],
    filter_conditions: [
      { key: "technologies", operator: "and" }
    ],
    per_page: 25,
    page: 1,
  }),
});
console.log(await response.json());

Entfernen Sie den filter_conditions-Eintrag, um die Suche auf eine beliebige der beiden Technologien zu erweitern.

Ziel: Unternehmen in einem beliebigen der USA, Kanadas oder des Vereinigten Königreichs, aber nie in San Francisco.OR ist für locations bereits der Standard, also lassen wir es implizit. exclude_places übernimmt den negativen Filter unabhängig — keine Überschreibung nötig.

curl -X POST https://api.pubrio.com/companies/search \
  -H "Content-Type: application/json" \
  -H "pubrio-api-key: YOUR_API_KEY" \
  -d '{
    "locations": ["US", "CA", "GB"],
    "exclude_places": ["San Francisco"],
    "per_page": 25,
    "page": 1
  }'

import requests

response = requests.post(
    "https://api.pubrio.com/companies/search",
    headers={
        "Content-Type": "application/json",
        "pubrio-api-key": "YOUR_API_KEY",
    },
    json={
        "locations": ["US", "CA", "GB"],
        "exclude_places": ["San Francisco"],
        "per_page": 25,
        "page": 1,
    },
)
print(response.json())

const response = await fetch("https://api.pubrio.com/companies/search", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "pubrio-api-key": "YOUR_API_KEY",
  },
  body: JSON.stringify({
    locations: ["US", "CA", "GB"],
    exclude_places: ["San Francisco"],
    per_page: 25,
    page: 1,
  }),
});
console.log(await response.json());

Ziel: Anzeigen, die aktiv sowohl die EU als auch die USA anvisieren (Multi-Region-Kampagnen) — keine Ein-Markt-Anzeigen. Verwendet das dedizierte ads_filter_conditions-Schema mit dem Schlüssel target_locations.

curl -X POST https://api.pubrio.com/companies/advertisements/search \
  -H "Content-Type: application/json" \
  -H "pubrio-api-key: YOUR_API_KEY" \
  -d '{
    "target_locations": ["US", "DE", "FR"],
    "filter_conditions": [
      { "key": "target_locations", "operator": "and" }
    ],
    "start_dates": ["2026-01-01"],
    "end_dates":   ["2026-04-22"],
    "per_page": 25,
    "page": 1
  }'

import requests

response = requests.post(
    "https://api.pubrio.com/companies/advertisements/search",
    headers={
        "Content-Type": "application/json",
        "pubrio-api-key": "YOUR_API_KEY",
    },
    json={
        "target_locations": ["US", "DE", "FR"],
        "filter_conditions": [
            { "key": "target_locations", "operator": "and" }
        ],
        "start_dates": ["2026-01-01"],
        "end_dates":   ["2026-04-22"],
        "per_page": 25,
        "page": 1,
    },
)
print(response.json())

const response = await fetch("https://api.pubrio.com/companies/advertisements/search", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "pubrio-api-key": "YOUR_API_KEY",
  },
  body: JSON.stringify({
    target_locations: ["US", "DE", "FR"],
    filter_conditions: [
      { key: "target_locations", operator: "and" }
    ],
    start_dates: ["2026-01-01"],
    end_dates:   ["2026-04-22"],
    per_page: 25,
    page: 1,
  }),
});
console.log(await response.json());

Der Anzeigen-Endpunkt verwendet sein eigenes ads_filter_conditions-Schema (kleinere Schlüsselmenge: target_locations, publisher_platforms). Die auf /companies/search und /people/search überschreibbaren Schlüssel gelten hier nicht.

Ziel: Personen, die bei Unternehmen arbeiten, bei denen sowohl Salesforce als auch HubSpot installiert sind — ein klassisches CRM-Ablösungssignal. Zeigt die einheitliche Engine: derselbe technologies-Schlüssel, derselbe Operator, aber auf /people/search.

curl -X POST https://api.pubrio.com/people/search \
  -H "Content-Type: application/json" \
  -H "pubrio-api-key: YOUR_API_KEY" \
  -d '{
    "people_titles": ["RevOps", "Sales Operations"],
    "technologies": [10191, 121],
    "filter_conditions": [
      { "key": "technologies", "operator": "and" }
    ],
    "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": ["RevOps", "Sales Operations"],
        "technologies": [10191, 121],
        "filter_conditions": [
            { "key": "technologies", "operator": "and" }
        ],
        "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: ["RevOps", "Sales Operations"],
    technologies: [10191, 121],
    filter_conditions: [
      { key: "technologies", operator: "and" }
    ],
    per_page: 25,
    page: 1,
  }),
});
console.log(await response.json());

Häufige Fehler

key vergessen, nur operator gesendet

Es gibt keinen globalen „Standardoperator”-Schalter. Jeder Eintrag muss einen konkreten Filter benennen:

// Wird ignoriert — kein key
{ "filter_conditions": [{ "operator": "and" }] }

// Korrekt — überschreibt nur den technologies-Filter
{ "filter_conditions": [{ "key": "technologies", "operator": "and" }] }

Erwarten, dass sich Einträge kombinieren

Einträge sind unabhängige Überschreibungen pro Schlüssel — sie verketten sich nicht. Das Auflisten von sowohl technologies als auch verticals erzeugt keinen booleschen Ausdruck zwischen ihnen; jeder setzt lediglich den Operator seines eigenen Arrays.Die Kombination zwischen Filterschlüsseln ist immer AND (jeder Filter muss zutreffen). Sie können zwei unterschiedliche Filterdimensionen nicht über filter_conditions mit OR verknüpfen. Wenn Sie eine echte OR-Verknüpfung unterschiedlicher Filter benötigen, führen Sie zwei Anfragen aus und führen Sie die Ergebnisse clientseitig zusammen.

AND bei einem langen Array verwenden

AND verlangt, dass jeder aufgeführte Wert vorhanden ist. Bei 8+ Werten erhalten Sie fast immer null Zeilen, da reale Tagging-Daten spärlich sind. Halten Sie AND-überschriebene Arrays bei 2–4 Werten; verwenden Sie OR für explorative oder kategorienbasierte Filterung.

AND bei einem Standort- oder Ortsfilter verwenden

Standort- und Ortsfilter (locations, places sowie ihre company_- und exclude_-Formen) treffen immer auf jeden beliebigen aufgeführten Wert zu. Ein filter_conditions-Eintrag für sie wird ignoriert.

Im Zweifelsfall lassen Sie filter_conditions zunächst weg und prüfen Sie Ihre Ergebnisanzahl gegen die Erwartung. Fügen Sie Überschreibungen nur für Filter hinzu, bei denen der Standard nicht Ihrer Absicht entspricht — das hält den Anfrage-Payload kleiner und leichter zu debuggen.

Siehe auch

Filters Overview

Das mentale Modell — beginnen Sie hier, wenn filter_conditions Ihre erste Anlaufstelle ist.

People + Company Filters

Wie Sie Unternehmensfilter in /people/search einbinden, einschließlich der Schlüssel-Umbenennung.

Company Search reference

Vollständiges Anfrageschema für /companies/search (enthält company_filter_conditions).

People Search reference

Vollständiges Anfrageschema für /people/search (enthält people_filter_conditions).

Monitore

Suche

Filter

Personen

Expansion

Schema

Warum das wichtig ist

Unterstützte Schlüssel

Rezepte

Häufige Fehler

Siehe auch

Filters Overview

People + Company Filters

Company Search reference

People Search reference

​Schema

​Warum das wichtig ist

​Unterstützte Schlüssel

​Rezepte

​Häufige Fehler

​Siehe auch

Filters Overview

People + Company Filters

Company Search reference

People Search reference

Schema

Warum das wichtig ist

Unterstützte Schlüssel

Rezepte

Häufige Fehler

Siehe auch