> ## Documentation Index > Fetch the complete documentation index at: https://docs.pubrio.com/llms.txt > Use this file to discover all available pages before exploring further. # Unternehmenssuche > Durchsuchen Sie die Pubrio-Datenbank nach Unternehmen, die bestimmten Kriterien wie Branche, Größe, Standort und Technologien entsprechen. ## OpenAPI ````yaml de-openapi POST /companies/search openapi: 3.0.0 info: description: >- Die Pubrio API liefert Market-Expansion-Intelligence – Echtzeit-Signale, die anzeigen, wenn ein Unternehmen in einen neuen Markt eintritt – zusammen mit den zugrunde liegenden Unternehmens- und Personendaten. Durchsuchen, schlagen Sie nach und reichern Sie Accounts und Kontakte an, und abonnieren Sie typisierte, datierte Bewegungssignale in über 200 Märkten. version: 1.0.0 title: Pubrio OpenAPI termsOfService: https://pubrio.com/de/terms-of-service contact: email: king.lai@pubrio.com name: King Lai url: https://pubrio.com/de/get-in-touch license: name: Apache 2.0 url: http://www.apache.org/licenses/LICENSE-2.0.html servers: - url: https://api.pubrio.com security: - pubrio_api_key: [] tags: - name: Profile description: Workspace-Profilinformationen und Nutzungsstatistiken - name: Enrichment description: >- Personen- und Unternehmensdatensätze mit detaillierten B2B-Daten anreichern - name: Lookalike description: Unternehmen finden, die einem bestimmten Unternehmen ähnlich sind - name: Search description: >- Personen, Unternehmen, Stellenanzeigen, Nachrichten und Werbeanzeigen mit Filtern durchsuchen - name: Lookup description: >- Detaillierte Informationen zu bestimmten Personen, Unternehmen, Stellenanzeigen, Nachrichten, Werbeanzeigen und Technologien nachschlagen - name: LinkedIn description: Personen- und Unternehmensdaten über LinkedIn-Profil-URLs nachschlagen - name: Redeem description: >- Credits einlösen, um Kontaktdaten von Personen freizuschalten (einzeln und im Batch) - name: Channels description: >- Outreach-Kanalvorlagen verwalten (erstellen, aktualisieren, löschen, auflisten) - name: Monitor description: >- Daten-Monitore mit Webhooks, Statistiken und Verarbeitung erstellen und verwalten - name: Filters description: >- Verfügbare Filterwerte für Suchparameter abrufen (Technologien, Standorte, Branchen usw.) - name: API Keys description: >- API-Anfrageprotokolle und Nutzungsanalysen für API-Schlüssel auflisten und einsehen - name: Insights description: >- Aggregierte Signal-Insights für Unternehmen (Stellenanzeigen, Nachrichten, Werbeanzeigen). - name: Export description: Massendatenexporte (kreditpflichtig). - name: Expansion description: >- Market-Expansion-Intelligence für Unternehmen: Signale, Phasen, Märkte und Exporte. externalDocs: description: >- Die Pubrio-API dient zum Suchen, Anzeigen einer Vorschau und Anreichern von Kontakten und Accounts. Die Pubrio-Datenbank bietet umfangreiche B2B-Kontakt- und Sales-Intelligence-Daten. url: https://docs.pubrio.com paths: /companies/search: post: tags: - Search summary: Nach Unternehmen suchen description: >- Durchsuchen Sie die Pubrio-Datenbank nach Unternehmen, die bestimmten Kriterien wie Branche, Größe, Standort und Technologien entsprechen. operationId: companies_search parameters: [] requestBody: required: true content: application/json: schema: type: object properties: company_name: $ref: '#/components/schemas/company_name' companies: $ref: '#/components/schemas/companies' domains: $ref: '#/components/schemas/domains' linkedin_urls: $ref: '#/components/schemas/company_linkedin_urls' company_filters: $ref: '#/components/schemas/company_filters' locations: $ref: '#/components/schemas/locations' exclude_locations: $ref: '#/components/schemas/exclude_locations' places: $ref: '#/components/schemas/places' exclude_places: $ref: '#/components/schemas/exclude_places' job_locations: $ref: '#/components/schemas/locations' job_exclude_locations: $ref: '#/components/schemas/job_exclude_locations' job_posted_dates: $ref: '#/components/schemas/posted_dates' job_titles: $ref: '#/components/schemas/people_titles' verticals: $ref: '#/components/schemas/verticals' vertical_categories: $ref: '#/components/schemas/vertical_categories' vertical_sub_categories: $ref: '#/components/schemas/vertical_sub_categories' categories: $ref: '#/components/schemas/categories' technologies: $ref: '#/components/schemas/technologies' employees: $ref: '#/components/schemas/employees' revenues: $ref: '#/components/schemas/revenues' founded_dates: $ref: '#/components/schemas/founded_dates' keywords: $ref: '#/components/schemas/keywords' social_media: $ref: '#/components/schemas/company_social_media' news_categories: $ref: '#/components/schemas/news_categories' news_published_dates: $ref: '#/components/schemas/published_dates' advertisement_search_terms: $ref: '#/components/schemas/advertisement_search_terms' advertisement_target_locations: $ref: '#/components/schemas/advertisement_target_locations' advertisement_exclude_target_locations: $ref: '#/components/schemas/advertisement_exclude_target_locations' advertisement_start_dates: $ref: '#/components/schemas/advertisement_start_dates' advertisement_end_dates: $ref: '#/components/schemas/advertisement_end_dates' advertisement_active_dates: $ref: '#/components/schemas/advertisement_active_dates' advertisement_status: $ref: '#/components/schemas/advertisement_status' advertisement_headlines: $ref: '#/components/schemas/advertisement_headlines' advertisement_platforms: $ref: '#/components/schemas/advertisement_platforms' advertisement_publisher_platforms: $ref: '#/components/schemas/advertisement_publisher_platforms' advertisement_exclude_publisher_platforms: $ref: >- #/components/schemas/advertisement_exclude_publisher_platforms advertisement_formats: $ref: '#/components/schemas/advertisement_formats' advertisement_active_ads: $ref: '#/components/schemas/advertisement_active_ads' advertisement_running_ads: $ref: '#/components/schemas/advertisement_running_ads' advertisement_total_ads: $ref: '#/components/schemas/advertisement_total_ads' advertisement_platform_count: $ref: '#/components/schemas/advertisement_platform_count' advertisement_format_count: $ref: '#/components/schemas/advertisement_format_count' advertisement_impressions_estimate: $ref: '#/components/schemas/advertisement_impressions_estimate' advertisement_country_activity: $ref: '#/components/schemas/advertisement_country_activity' filter_conditions: $ref: '#/components/schemas/company_filter_conditions' is_enable_similarity_search: $ref: '#/components/schemas/is_enable_similarity_search' similarity_score: $ref: '#/components/schemas/similarity_score' exclude_fields: $ref: '#/components/schemas/exclude_fields' is_parameter_metadata_available: $ref: '#/components/schemas/is_parameter_metadata_available' is_profile_metadata_available: $ref: '#/components/schemas/is_profile_metadata_available' per_page: $ref: '#/components/schemas/per_page' page: $ref: '#/components/schemas/page' responses: '200': description: Erfolgreiche Antwort mit Details zur Unternehmenssuche. content: application/json: schema: type: object properties: metadata: type: object description: >- Anfragekontext: `recent_search_log_identifier`, gespiegelte `parameters` und `filters`, ein optionaler `profile`-Credit-Block sowie `ignored_fields` (Body-Schlüssel, die der Endpunkt verworfen hat). data: $ref: '#/components/schemas/data' example: data: pagination: page: 1 per_page: 25 total_entries: 45234700 total_pages: 1809388 companies: - logo_url: >- https://buckets.pubrio.com/company-logo/MjI0NDc1OTMxaWxqOXNzbmoxdHdpdHRlci5jb20=.jpg company_name: Twitter emails: - ... phones: - ... contacts: - ... founded_year: 2006 specialties: - Software Development industry: Software Development domain: twitter.com domain_search_id: 61a73da7-2efc-41a5-a252-a8a8df29925a domain_id: 224475931 linkedin_company_id: 44005587 linkedin_name: twitter is_company_url_active: true domain_ids: - 224475931 - 1758889566 - 368242865 company_keywords: - realtime information - social commerce - online shopping - classifieds - craigslist killers - e-commerce - killers - consumer internet - internet - information technology - edp services - technology - software development - microblogging - social networking - public conversation - user engagement - content sharing - advertising solutions - monetization - community building - digital wallet - ai integration - user safety company_size: 1500 youtube_url: null crunchbase_url: null linkedin_url: http://www.linkedin.com/company/twitter instagram_url: null facebook_url: http://facebook.com/twitterinc twitter_url: https://twitter.com/x github_url: null x_url: null location: United States company_ranking: null company_url: http://twitter.com saved_lists: null company_size_printed: 1,500 - ... '400': $ref: '#/components/responses/general_error' '429': $ref: '#/components/responses/rate_limit_error' '500': $ref: '#/components/responses/server_error' components: schemas: company_name: type: string example: pubrio description: >- Filtert Suchergebnisse, um einen bestimmten Unternehmensnamen einzuschließen. Stimmt der für diesen Parameter eingegebene Wert nicht mit dem Namen eines Unternehmens überein, erscheint das Unternehmen nicht in den Suchergebnissen, selbst wenn es andere Parameter erfüllt. Teilweise Übereinstimmungen werden akzeptiert. companies: type: array items: type: string format: uuid description: >- Eine Liste eindeutiger Kennungen (domain_search_id) für Unternehmens- und Personensuchvorgänge. domains: type: array items: type: string example: - pubrio.com description: >- Liste von Unternehmensdomains für Unternehmens- und Personensuchvorgänge. Erhalten wir eine URL wie `www.pubrio.com` oder `https://docs.pubrio.com/`, wandelt das System diese zur Verarbeitung in `pubrio.com` um. company_linkedin_urls: type: array items: type: string example: - https://www.linkedin.com/company/pubrio description: >- Die vollständige URL des LinkedIn-Unternehmensprofils. Die URL beginnt mit `http` und enthält `linkedin.com/company/` company_filters: type: object description: >- Wrapper-Objekt für Filter auf Unternehmensebene. Empfohlene Gruppierung, die visuell trennt, welche Schlüssel die *Person* (oberste Ebene) filtern und welche das *Unternehmen* filtern. Akzeptiert dieselben Schlüssel wie die Unternehmensfilter auf oberster Ebene (z. B. `technologies`, `verticals`, `vertical_categories`, `vertical_sub_categories`, `categories`, `keywords`, `founded_dates`, `employees`, `revenues`, `company_locations`, `company_exclude_locations`, `company_places`, `company_exclude_places`, `companies`, `domains`, `company_linkedin_urls`, `is_enable_similarity_search`, `similarity_score`, sowie `filter_conditions`). Die Engine flacht dieses Objekt vor der Verarbeitung auf die oberste Ebene ab – bei Konflikten gewinnen die Schlüssel der obersten Ebene. Dieselbe Struktur wird bei Monitor `company_filters` verwendet. Beispiele finden Sie im Entwicklerleitfaden „Filters Overview“. example: company_locations: - US technologies: - 37 - 152 founded_dates: - 2015 - 2023 filter_conditions: - key: technologies operator: and locations: type: array items: type: string example: - US - SG - CN description: >- ISO 3166-1 Alpha-2 (cca2) wird zum Filtern von Standorten verwendet. Weitere Informationen finden Sie über die Endpunkte `location` im Filters-Tab. exclude_locations: type: array items: type: string example: - CN - US - RU - CA description: >- ISO 3166-1 Alpha-2 (cca2) wird verwendet, um Standorte auszuschließen, die nicht zurückgegeben werden sollen. Weitere Informationen finden Sie über die Endpunkte `location` im Filters-Tab. places: type: array items: type: string example: - Tokyo description: >- Ortsnamen (Stadt, Region), mit denen Ergebnisse gefiltert werden. Akzeptiert lokalisierte oder englische Ortsnamen. exclude_places: type: array items: type: string example: - Tokyo description: >- Ortsnamen (Stadt, Region), die von den Ergebnissen ausgeschlossen werden. Akzeptiert lokalisierte oder englische Ortsnamen. job_exclude_locations: allOf: - $ref: '#/components/schemas/exclude_locations' description: >- Geografische Standorte, die von den Stellenanzeigen-Ergebnissen ausgeschlossen werden. posted_dates: type: array items: type: string example: - '2025-01-01' - '2025-01-10' description: >- Datumsbereich des Veröffentlichungsdatums. Der Maximalwert ist der aktuelle Tag. Tagesgrenzen richten sich nach der Zeitzone Ihres Workspace. people_titles: type: array items: type: string example: - sales manager - marketing manager description: |- Berufsbezeichnungen der Personen, die Sie finden möchten. Die Ergebnisse umfassen auch Berufsbezeichnungen mit ähnlicher Terminologie, selbst wenn diese nicht exakt übereinstimmen. Eine Suche nach `software engineer` kann beispielsweise Ergebnisse für Personen mit der Bezeichnung `senior software engineer` liefern. verticals: type: array items: type: integer description: >- Eine Liste von `vertical_id`, mit der nach Unternehmen in einer bestimmten Branche oder einem bestimmten Vertical gesucht wird. Die ID finden Sie über den Endpunkt `vertical` im Filters-Tab. Dieser Filter unterstützt `is_enable_similarity_search`; nach Aktivierung können Sie beliebigen Freitext eingeben, z. B. `["AI"]`. vertical_categories: type: array items: type: integer description: >- Eine Liste von `vertical_category_id`, mit der nach Unternehmen in einer bestimmten Vertical-Kategorie gesucht wird. Die ID finden Sie über den Endpunkt `vertical category` im Filters-Tab. Dieser Filter unterstützt `is_enable_similarity_search`; nach Aktivierung können Sie beliebigen Freitext eingeben, z. B. `["Information Technology"]`. vertical_sub_categories: type: array items: type: integer description: >- Eine Liste von `vertical_sub_category_id`, mit der nach Unternehmen in einer bestimmten Vertical-Unterkategorie gesucht wird. Die ID finden Sie über den Endpunkt `vertical sub category` im Filters-Tab. Dieser Filter unterstützt `is_enable_similarity_search`; nach Aktivierung können Sie beliebigen Freitext eingeben, z. B. `["Software"]`. categories: type: array items: type: integer description: >- Eine Liste von `category_id`, mit der nach bestimmten Technologiekategorien gesucht wird, die von Unternehmen eingesetzt werden. Die ID finden Sie über den Endpunkt `category` im Filters-Tab. Dieser Filter unterstützt `is_enable_similarity_search`; nach Aktivierung können Sie beliebigen Freitext eingeben, z. B. `["CDN"]`. technologies: type: array items: type: integer description: >- Eine Liste von `tag_id`, mit der nach bestimmten von Unternehmen eingesetzten Technologien gesucht wird. Die ID finden Sie über den Endpunkt `technology` im Filters-Tab. Dieser Filter unterstützt `is_enable_similarity_search`; nach Aktivierung können Sie beliebigen Freitext eingeben, z. B. `["Shopify"]`. employees: type: array items: type: array items: type: string example: - - 1 - 10 - - 11 - 20 - - 10001 description: >- Der Zahlenbereich der für das Unternehmen tätigen Mitarbeiter. Damit können Sie Unternehmen anhand der Mitarbeiterzahl finden. Sie können mehrere Bereiche hinzufügen, um Ihre Suchergebnisse zu erweitern. Weitere Informationen finden Sie über die Endpunkte `company size` im Filters-Tab. revenues: type: array items: type: integer example: - 0 - 100000 description: Minimal- und Maximalbereich des Unternehmensumsatzes. founded_dates: type: array items: type: integer example: - 2018 - 2024 description: >- Zeitraum der Unternehmensgründung in Jahren. Der maximale Gründungswert ist das aktuelle Jahr. keywords: type: array items: type: string example: - ecommerce - ai - fintech description: >- Eine Liste von Stichwörtern, mit der Unternehmen nach Relevanz, Spezialisierung oder Beschreibung gefiltert werden. company_social_media: type: array items: type: string enum: - linkedin - facebook - instagram - tiktok - twitter - x - github - wantedly - rocketpunch example: - tiktok description: >- Unternehmen mit einem Profil auf einer der folgenden Plattformen: `linkedin`, `facebook`, `instagram`, `tiktok`, `twitter`, `x`, `github`, `wantedly`, `rocketpunch`. Mit `filter_conditions` zu AND aufwerten. news_categories: type: array items: type: string example: - launches description: >- Liste von `category slugs` zur Suche nach bestimmten News-Kategorien. Den Slug finden Sie über den Endpunkt `news categories` im Filters-Tab. published_dates: type: array items: type: string example: - '2025-01-01' - '2025-01-10' description: >- Datumsbereich des Publikationsdatums. Der Maximalwert ist der aktuelle Tag. Tagesgrenzen richten sich nach der Zeitzone Ihres Workspace. advertisement_search_terms: type: array items: type: string example: - asus description: Stichwörter zur Suche innerhalb von Anzeigeninhalten oder -titeln. advertisement_target_locations: allOf: - $ref: '#/components/schemas/target_locations' description: Geografische Zielstandorte für Anzeigen. advertisement_exclude_target_locations: allOf: - $ref: '#/components/schemas/exclude_target_locations' description: >- Geografische Standorte, die vom Anzeigen-Targeting ausgeschlossen werden. advertisement_start_dates: type: array items: type: string format: date example: - '2025-12-25' - '2025-12-25' description: Startdatumsbereich für die Anzeigenfilterung. advertisement_end_dates: type: array items: type: string format: date example: - '2025-12-25' - '2025-12-25' description: Enddatumsbereich für die Anzeigenfilterung. advertisement_active_dates: type: array items: type: string format: date example: - '2026-01-01' - '2026-01-31' description: >- Findet Anzeigen, die irgendwann innerhalb dieses Datumsbereichs liefen (überschneidungsbasiert: schließt Anzeigen ein, die vor dem Bereich begonnen haben und noch laufen, nicht nur solche, die innerhalb des Bereichs gestartet sind). advertisement_status: type: array items: type: string enum: - currently_running - active_last_30_min example: - currently_running description: >- `currently_running`: Unternehmen mit erfasster Werbung. `active_last_30_min`: Unternehmen, deren Werbung sich in den letzten 30 Minuten geändert hat. advertisement_headlines: type: array items: type: string example: - limited time offer description: Stichwörter zur Suche im Schlagzeilentext von Anzeigen. advertisement_platforms: type: array items: type: string enum: - linkedin - facebook - google - tiktok - apple example: - linkedin - facebook description: >- Filtert danach, aus welcher Anzeigenbibliothek die Anzeige stammt. Kleinschreibung, Groß-/Kleinschreibung wird nicht unterschieden. `meta` wird als Alias für `facebook` akzeptiert. advertisement_publisher_platforms: type: array items: type: string enum: - facebook - instagram - messenger - threads - audience_network example: - facebook - instagram description: >- Filtert Facebook/Meta-Anzeigen nach der Plattformoberfläche, auf der sie ausgeliefert wurden. Kleinschreibung, Groß-/Kleinschreibung wird nicht unterschieden. Gilt nur für die Quelle `facebook` (andere Quellen sind Einzelplattform-Quellen). advertisement_exclude_publisher_platforms: type: array items: type: string enum: - facebook - instagram - messenger - threads - audience_network example: - audience_network description: >- Schließt Facebook/Meta-Anzeigen aus, die auf diesen Plattformoberflächen ausgeliefert wurden. advertisement_formats: type: array items: type: string enum: - image - video - text - carousel - dynamic_product - document - message - event - article - spotlight - follow - job - engagement example: - image - video description: >- Findet Unternehmen mit mindestens einer Anzeige in einem dieser Creative-Formate. advertisement_active_ads: type: array items: type: integer nullable: true minItems: 2 maxItems: 2 example: - 1 - null description: >- Minimale und maximale Anzahl der derzeit aktiven Anzeigen des Unternehmens, über alle Länder hinweg. Verwenden Sie `null` für eine offene Grenze, z. B. `[1, null]` für „mindestens eine aktive Anzeige“. advertisement_running_ads: type: array items: type: integer nullable: true minItems: 2 maxItems: 2 example: - 1 - null description: >- Minimale und maximale Anzahl der noch laufenden Anzeigen des Unternehmens (kein Enddatum oder ein Enddatum in der Zukunft). Derzeit nur für LinkedIn-Anzeigen befüllt. advertisement_total_ads: type: array items: type: integer nullable: true minItems: 2 maxItems: 2 example: - 10 - null description: >- Minimale und maximale Gesamtzahl der jemals erfassten Anzeigen des Unternehmens, über alle Länder hinweg. advertisement_platform_count: type: array items: type: integer nullable: true minItems: 2 maxItems: 2 example: - 2 - null description: >- Minimale und maximale Anzahl unterschiedlicher Anzeigenplattformen (linkedin, facebook, google, tiktok, apple), auf denen das Unternehmen aktiv wirbt. advertisement_format_count: type: array items: type: integer nullable: true minItems: 2 maxItems: 2 example: - 2 - null description: >- Minimale und maximale Anzahl unterschiedlicher Anzeigen-Creative-Formate, die das Unternehmen aktiv schaltet. advertisement_impressions_estimate: type: array items: type: integer nullable: true minItems: 2 maxItems: 2 example: - 1000 - null description: >- Minimal und maximal geschätzte Anzeigenimpressionen, summiert über alle Länder. Es werden nur Anzeigen mit gemeldetem Impressionsbereich gezählt. advertisement_country_activity: type: object properties: country: type: string example: US description: >- ISO-3166-1-Alpha-2-Ländercode, auf den dieser Filter beschränkt wird. Erforderlich. rank: type: array items: type: integer nullable: true minItems: 2 maxItems: 2 example: - null - 500 description: >- Rang innerhalb dieses Landes nach Anzeigenvolumen. 1 ist der größte Werbetreibende; die Zahl steigt, je geringer das Anzeigenvolumen ist. Verwenden Sie `[null, 500]`, um die 500 größten Werbetreibenden in diesem Land zu finden; verwenden Sie `[500, null]`, um alle ab Rang 500 zu finden. percentile: type: array items: type: number nullable: true minItems: 2 maxItems: 2 example: - 90 - null description: >- Perzentil innerhalb dieses Landes nach Anzeigenvolumen, 0–100. Ein höherer Wert bedeutet ein größerer Werbetreibender. Verwenden Sie `[90, null]` für die obersten 10 % der Werbetreibenden in diesem Land. volume_score: type: array items: type: number nullable: true minItems: 2 maxItems: 2 example: - 0.5 - null description: >- Der zugrunde liegende Anzeigenvolumen-Score von 0 bis 1, aus dem sowohl `rank` als auch `percentile` berechnet werden. active_ads: type: array items: type: integer nullable: true minItems: 2 maxItems: 2 example: - 1 - null description: >- Minimale und maximale Anzahl aktiver Anzeigen, beschränkt auf dieses Land. running_ads: type: array items: type: integer nullable: true minItems: 2 maxItems: 2 example: - 1 - null description: >- Minimale und maximale Anzahl laufender Anzeigen, beschränkt auf dieses Land. Derzeit nur für LinkedIn-Anzeigen befüllt. total_ads: type: array items: type: integer nullable: true minItems: 2 maxItems: 2 example: - 10 - null description: >- Minimale und maximale Gesamtzahl der Anzeigen, beschränkt auf dieses Land. impressions: type: array items: type: integer nullable: true minItems: 2 maxItems: 2 example: - 1000 - null description: >- Minimal und maximal geschätzte Impressionen, beschränkt auf dieses Land. required: - country example: country: US rank: - null - 500 description: >- Werbeaktivität für ein bestimmtes Land. `country` ist erforderlich, und mindestens ein weiteres Feld muss gesetzt sein (ein Land allein liefert keine Treffer). Für eine länderübergreifende Gesamtsumme verwenden Sie stattdessen die übergeordneten Filter `advertisement_active_ads` / `advertisement_total_ads` / `advertisement_impressions_estimate`. company_filter_conditions: type: array items: type: object properties: key: type: string enum: - keywords - verticals - vertical_categories - vertical_sub_categories - technologies - categories - advertisement_target_locations - advertisement_exclude_target_locations - advertisement_search_terms - places - exclude_places - job_exclude_locations example: keywords description: >- Der Filterschlüssel, der angibt, auf welche Eigenschaft der Operator angewendet wird. operator: type: string enum: - or - and example: or description: >- Der anzuwendende logische Operator. Verwenden Sie „or“, um einen der angegebenen Werte zu finden, oder „and“, um alle angegebenen Werte zu verlangen. description: >- Erweiterte Filteroptionen für Unternehmenssuchen. Geben Sie Bedingungen an, die Schlüssel und logische Operatoren kombinieren, um Suchergebnisse zu verfeinern. is_enable_similarity_search: type: boolean description: >- Bei Aktivierung können die oben aufgeführten Filter, die Ähnlichkeitssuchen unterstützen, anstelle bestimmter IDs mit Freitext befüllt werden. similarity_score: type: number format: float example: 0.7 description: >- Wird in Verbindung mit `is_enable_similarity_search` verwendet. Diese Zahl dient dazu, zu analysieren, ob ein bestimmter Slug (z. B. Branche, Technologie) der Nutzereingabe ähnelt; je höher die Zahl, desto strenger ist die Prüfung. exclude_fields: type: array items: type: string example: - emails - phones - contacts description: Liste der Felder, die aus dem Antwort-Payload ausgeschlossen werden. is_parameter_metadata_available: type: boolean description: Gibt an, ob Parameter-Metadaten für die Anfrage verfügbar sind. is_profile_metadata_available: type: boolean description: Gibt an, ob Profil-Metadaten für die Anfrage verfügbar sind. per_page: type: integer example: 25 default: 25 maximum: 25 description: >- Datensätze pro Seite. Standardmäßig 25, was bei den meisten Tarifen auch die Obergrenze ist — das Limit ist der `max_search_per_page`-Wert Ihres Abonnements, zurückgegeben von [Profile](/de/api-reference/endpoint/profile/profile). Bei Überschreitung wird **HTTP 416** mit dem Code `41676` (oder `41613` bei der Unternehmens- und Personensuche) zurückgegeben, keine begrenzte Ergebnismenge. page: type: integer example: 1 default: 1 description: >- Seitenzahl, beginnend bei 1. Die Obergrenze ist der `max_search_page`-Wert Ihres Abonnements (`max_company_search_page` für die Unternehmenssuche), zurückgegeben von [Profile](/de/api-reference/endpoint/profile/profile). Bei Überschreitung wird **HTTP 416** zurückgegeben. data: type: object nullable: true description: Die Antwortinformationen hängen vom jeweiligen Endpunkt ab. target_locations: type: array items: type: string example: - TW - AE - 'NO' description: >- Filtert Anzeigen, um solche einzuschließen, die auf bestimmte Standorte anhand des Ländercodes abzielen. Damit finden Sie Anzeigen, die in bestimmten Ländern geschaltet werden. Wird mit `filter_conditions` über den OR-Operator kombiniert – die Anzeige muss auf mindestens einen der angegebenen Standorte abzielen. exclude_target_locations: type: array items: type: string example: - IS - GB - FR - IE - ES description: >- Filtert Anzeigen, um solche auszuschließen, die auf bestimmte Standorte anhand des Ländercodes abzielen. Damit blenden Sie Anzeigen aus, die in bestimmten Ländern geschaltet werden. Wird in `filter_conditions` mit dem Operator „or“ angegeben, darf die Anzeige auf keinen der ausgeschlossenen Standorte abzielen. responses: general_error: description: >- Ungültige Anfrage. Die Anfrage war fehlerhaft formatiert oder enthielt ungültige Parameter. Prüfen Sie den Fehlercode und die Meldung für Details. content: application/json: schema: required: - code - message - details type: object properties: code: example: 40001 type: integer message: example: >- Errors and codes will vary depending on the scenario, please see the documentation for information. type: string details: type: object rate_limit_error: description: >- Rate-Limit überschritten. Es wurden zu viele Anfragen in einem bestimmten Zeitraum gestellt. Versuchen Sie es erneut, nachdem das Rate-Limit-Fenster zurückgesetzt wurde. content: application/json: schema: required: - error type: object properties: error: example: Request rate limit exceeded. Please wait and try again later. type: string server_error: description: >- Interner Serverfehler. Auf dem Server ist ein unerwarteter Fehler aufgetreten. Wenden Sie sich an den Support, falls der Fehler weiterhin besteht. content: application/json: schema: required: - error type: object properties: error: example: An unexpected error occurred on the server. type: string securitySchemes: pubrio_api_key: type: apiKey name: pubrio-api-key description: >- Ein eindeutiges API-Token, das die von Ihnen über die API durchgeführten Aktionen sowie die zugehörigen Berechtigungen und Vorgänge repräsentiert. Sie können es über den Bereich [Settings](https://dashboard.pubrio.com/#/settings/) erstellen. in: header ````