Skip to main content
POST
Rechercher des entreprises

Autorisations

pubrio-api-key
string
header
requis

Un jeton API unique qui représente les actions que vous effectuez via l'API ainsi que les autorisations et opérations correspondantes. Vous pouvez le créer dans la section Settings.

Corps

application/json
company_name
string

Filtre les résultats de recherche pour inclure un nom d'entreprise spécifique.

Si la valeur saisie pour ce paramètre ne correspond pas au nom d'une entreprise, celle-ci n'apparaîtra pas dans les résultats de recherche, même si elle correspond aux autres paramètres. Les correspondances partielles sont acceptées.

Exemple:

"pubrio"

companies
string<uuid>[]

Une liste d'identifiants uniques (domain_search_id) utilisée pour les opérations de recherche d'entreprises et de personnes.

company_groups
integer[]

Limite aux membres de ces groupes d'entreprises (ids), par exemple le source_group_id ou excluded_group_id d'un monitor ; paginé comme toute recherche.

domains
string[]

Liste de domaines d'entreprise utilisée pour les opérations de recherche d'entreprises et de personnes. Si nous recevons une URL telle que www.pubrio.com ou https://docs.pubrio.com/, le système la convertira en pubrio.com pour le traitement.

Exemple:
linkedin_urls
string[]

L'URL complète du profil d'entreprise LinkedIn. L'URL commence par http et contient linkedin.com/company/

Exemple:
company_filters
object

Objet conteneur pour les filtres au niveau de l'entreprise. Regroupement recommandé qui sépare visuellement les clés filtrant la personne (premier niveau) de celles filtrant l'entreprise. Accepte les mêmes clés que les filtres d'entreprise de premier niveau (par ex. 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, ainsi que filter_conditions). Le moteur aplatit cet objet au premier niveau avant traitement — les clés de premier niveau l'emportent en cas de conflit. Même structure utilisée par company_filters de Monitor. Consultez le guide développeur Filters Overview pour des exemples.

Exemple:
locations
string[]

Le code ISO 3166-1 alpha-2 (cca2) est utilisé pour filtrer les localisations. Consultez les points de terminaison location sous l'onglet Filters pour plus d'informations.

Exemple:
exclude_locations
string[]

Le code ISO 3166-1 alpha-2 (cca2) est utilisé pour exclure les localisations qui ne doivent pas être renvoyées. Consultez les points de terminaison location sous l'onglet Filters pour plus d'informations.

Exemple:
places
string[]

Noms de lieux (ville, région) utilisés pour filtrer les résultats. Accepte les noms de lieux localisés ou en anglais.

Exemple:
exclude_places
string[]

Noms de lieux (ville, région) à exclure des résultats. Accepte les noms de lieux localisés ou en anglais.

Exemple:
job_locations
string[]

Le code ISO 3166-1 alpha-2 (cca2) est utilisé pour filtrer les localisations. Consultez les points de terminaison location sous l'onglet Filters pour plus d'informations.

Exemple:
job_exclude_locations
string[]

Localisations géographiques à exclure des résultats d'offres d'emploi.

Exemple:
job_posted_dates
string[]

Plage de dates de la date de publication. La valeur maximale est le jour en cours. Les limites de journée suivent le fuseau horaire de votre espace de travail.

Exemple:
job_titles
string[]

Intitulés de poste associés aux personnes que vous cherchez à localiser.

Les résultats incluront également les intitulés de poste comportant une terminologie similaire, même s'ils ne correspondent pas exactement. Par exemple, une recherche pour software engineer peut renvoyer des résultats pour des personnes portant le titre senior software engineer.

Exemple:
verticals
integer[]

Une liste de vertical_id utilisée pour rechercher des entreprises dans un secteur ou une verticale spécifique. Pour trouver l'ID, appelez le point de terminaison vertical sous l'onglet Filters.

Ce filtre prend en charge is_enable_similarity_search ; une fois activé, vous pouvez saisir n'importe quel texte libre, par ex. ["AI"].

vertical_categories
integer[]

Une liste de vertical_category_id utilisée pour rechercher des entreprises dans une catégorie verticale spécifique. Pour trouver l'ID, appelez le point de terminaison vertical category sous l'onglet Filters.

Ce filtre prend en charge is_enable_similarity_search ; une fois activé, vous pouvez saisir n'importe quel texte libre, par ex. ["Information Technology"].

vertical_sub_categories
integer[]

Une liste de vertical_sub_category_id utilisée pour rechercher des entreprises dans une sous-catégorie verticale spécifique. Pour trouver l'ID, appelez le point de terminaison vertical sub category sous l'onglet Filters.

Ce filtre prend en charge is_enable_similarity_search ; une fois activé, vous pouvez saisir n'importe quel texte libre, par ex. ["Software"].

categories
integer[]

Une liste de category_id utilisée pour rechercher des catégories spécifiques de technologies utilisées par les entreprises. Pour trouver l'ID, appelez le point de terminaison category sous l'onglet Filters.

Ce filtre prend en charge is_enable_similarity_search ; une fois activé, vous pouvez saisir n'importe quel texte libre, par ex. ["CDN"].

technologies
integer[]

Une liste de tag_id utilisée pour rechercher des technologies spécifiques utilisées par les entreprises. Pour trouver l'ID, appelez le point de terminaison technology sous l'onglet Filters.

Ce filtre prend en charge is_enable_similarity_search ; une fois activé, vous pouvez saisir n'importe quel texte libre, par ex. ["Shopify"].

Un nom de produit connu de la liste des technologies correspond à ce produit et à ses propres produits ("Salesforce" correspond aussi à Salesforce Desk et Salesforce Service Cloud), jamais à des produits ressemblants ; tout autre texte correspond par similarité.

exclude_technologies
string[]

Technologies que l'entreprise ne doit pas utiliser, sous forme de tag_id ou, avec is_enable_similarity_search, de noms comme ["Shopify"]. Une entreprise sans technologie connue est conservée.

Exemple:
employees
string[][]

La plage numérique d'employés travaillant pour l'entreprise. Cela vous permet de trouver des entreprises en fonction de leur effectif. Vous pouvez ajouter plusieurs plages pour élargir vos résultats de recherche.

Consultez les points de terminaison company size sous l'onglet Filters pour plus d'informations.

Exemple:
revenues
integer[]

Plage minimale et maximale du chiffre d'affaires de l'entreprise.

Exemple:
founded_dates
integer[]

Plage d'années de fondation de l'entreprise. La valeur maximale de fondation est l'année en cours.

Exemple:
keywords
string[]

Une liste de mots-clés pour filtrer les entreprises par pertinence, spécialités ou descriptions.

Exemple:
social_media
enum<string>[]

Entreprises ayant un profil sur l'un des réseaux suivants : linkedin, facebook, instagram, tiktok, twitter, x, github, wantedly, rocketpunch. Passez en ET avec filter_conditions.

Options disponibles:
linkedin,
facebook,
instagram,
tiktok,
twitter,
x,
github,
wantedly,
rocketpunch
Exemple:
news_categories
string[]

Liste de category slugs pour rechercher des catégories d'actualités spécifiques. Pour trouver un slug, appelez le point de terminaison news categories sous l'onglet Filters.

Exemple:
news_published_dates
string[]

Plage de dates de la date de publication. La valeur maximale est le jour en cours. Les limites de journée suivent le fuseau horaire de votre espace de travail.

Exemple:
advertisement_search_terms
string[]

Mots-clés utilisés pour rechercher dans le contenu ou les titres des publicités.

Exemple:
advertisement_target_locations
string[]

Localisations géographiques cibles pour les publicités.

Exemple:
advertisement_exclude_target_locations
string[]

Localisations géographiques à exclure du ciblage publicitaire.

Exemple:
advertisement_start_dates
string<date>[]

Plage de dates de début pour le filtrage des publicités.

Exemple:
advertisement_end_dates
string<date>[]

Plage de dates de fin pour le filtrage des publicités.

Exemple:
advertisement_active_dates
string<date>[]

Trouve les publicités qui étaient diffusées à un moment quelconque de cette plage de dates (basé sur le chevauchement : inclut les publicités ayant démarré avant la plage et encore diffusées, et pas seulement celles ayant démarré à l'intérieur de celle-ci).

Exemple:
advertisement_status
enum<string>[]

currently_running : entreprises ayant de la publicité enregistrée. active_last_30_min : entreprises dont la publicité a changé au cours des 30 dernières minutes.

Options disponibles:
currently_running,
active_last_30_min
Exemple:
advertisement_headlines
string[]

Mots-clés à rechercher dans le texte des accroches publicitaires.

Exemple:
advertisement_platforms
enum<string>[]

Filtre selon la bibliothèque publicitaire dont provient la publicité. En minuscules, insensible à la casse. meta est accepté comme alias de facebook.

Options disponibles:
linkedin,
facebook,
google,
tiktok,
apple
Exemple:
advertisement_publisher_platforms
enum<string>[]

Filtre les publicités Facebook/Meta selon la surface de plateforme sur laquelle elles ont été diffusées. En minuscules et insensible à la casse. S'applique uniquement à la source facebook (les autres sources sont mono-plateforme).

Options disponibles:
facebook,
instagram,
messenger,
threads,
audience_network
Exemple:
advertisement_exclude_publisher_platforms
enum<string>[]

Exclut les publicités Facebook/Meta diffusées sur ces surfaces de plateforme.

Options disponibles:
facebook,
instagram,
messenger,
threads,
audience_network
Exemple:
advertisement_formats
enum<string>[]

Trouve les entreprises ayant au moins une publicité dans l'un de ces formats créatifs.

Options disponibles:
image,
video,
text,
carousel,
dynamic_product,
document,
message,
event,
article,
spotlight,
follow,
job,
engagement
Exemple:
advertisement_active_ads
(integer | null)[]

Nombre minimal et maximal de publicités actuellement actives de l'entreprise, tous pays confondus. Utilisez null pour une borne ouverte, par ex. [1, null] pour « au moins une publicité active ».

Required array length: 2 elements
Exemple:
advertisement_running_ads
(integer | null)[]

Nombre minimal et maximal de publicités de l'entreprise encore diffusées (sans date de fin, ou avec une date de fin dans le futur). Actuellement renseigné uniquement pour les publicités LinkedIn.

Required array length: 2 elements
Exemple:
advertisement_total_ads
(integer | null)[]

Nombre minimal et maximal du total des publicités jamais enregistrées pour l'entreprise, tous pays confondus.

Required array length: 2 elements
Exemple:
advertisement_platform_count
(integer | null)[]

Nombre minimal et maximal de plateformes publicitaires distinctes (linkedin, facebook, google, tiktok, apple) sur lesquelles l'entreprise fait activement de la publicité.

Required array length: 2 elements
Exemple:
advertisement_format_count
(integer | null)[]

Nombre minimal et maximal de formats créatifs publicitaires distincts que l'entreprise diffuse activement.

Required array length: 2 elements
Exemple:
advertisement_impressions_estimate
(integer | null)[]

Nombre minimal et maximal estimé d'impressions publicitaires, cumulé sur tous les pays. Seules les publicités disposant d'une plage d'impressions déclarée sont comptabilisées.

Required array length: 2 elements
Exemple:
advertisement_country_activity
object

Activité publicitaire pour un pays spécifique. country est obligatoire, et au moins un autre champ doit être renseigné (un pays seul ne correspond à rien). Pour un total tous pays confondus, utilisez plutôt les filtres de premier niveau advertisement_active_ads / advertisement_total_ads / advertisement_impressions_estimate.

Exemple:
sort_by
enum<string>

Ordre des résultats. Omettez ce champ pour l'ordre de pertinence par défaut. advertisement_country_rank trie selon le rang publicitaire de l'entreprise dans le pays indiqué dans advertisement_country_activity (rang 1 = plus gros annonceur de ce marché) et est ignoré si ce filtre est absent. Associez-le à is_ascending_order: false pour lister d'abord les plus petits annonceurs. Pas encore disponible : name (dans les deux sens) et relevance avec is_ascending_order: false — ces requêtes expirent. Utilisez plutôt l'ordre de pertinence par défaut, number_of_employees ou founded_year.

Options disponibles:
relevance,
name,
number_of_employees,
founded_year,
advertisement_country_rank
Exemple:

"advertisement_country_rank"

is_ascending_order
boolean

Sens de tri pour sort_by. Ascendant par défaut, ce qui pour advertisement_country_rank signifie les plus gros annonceurs en premier.

Exemple:

true

filter_conditions
object[]

Options de filtrage avancées pour les recherches d'entreprises. Spécifiez des conditions combinant des clés et des opérateurs logiques pour affiner les résultats de recherche.

Lorsqu'activé, les filtres listés ci-dessus qui prennent en charge les recherches par similarité peuvent être remplis avec du texte libre au lieu d'ID spécifiques.

similarity_score
number<float>

Utilisé conjointement avec is_enable_similarity_search. Ce nombre sert à déterminer si un slug spécifique (par ex. secteur vertical, technologie) est similaire à la saisie de l'utilisateur ; plus le nombre est élevé, plus l'exigence est stricte.

Exemple:

0.7

query
string

Recherche en langage naturel. Lorsqu'elle est fournie, Pubrio l'interprète en filtres d'entreprise ci-dessous : secteur (et secteurs à exclure), spécialité, technologie (et outils à exclure), profils sociaux, pays, région ou ville du siège, effectif, chiffre d'affaires, année de création, postes en recrutement et leur lieu, événements d'actualité comme "s'est récemment développée", publicité (plateforme, format, pays ciblé, nombre d'annonces, impressions, dates, rang dans un pays) et hébergement cloud (fournisseur, pays et villes des serveurs, nombre d'hôtes et de serveurs, au total ou dans un pays). Les valeurs reliées par "ou" correspondent à l'une d'elles ; les outils ou profils reliés par "et" ("utilise à la fois Salesforce et HubSpot") doivent tous correspondre. Les filtres explicites que vous envoyez aussi priment sur ceux interprétés. Une partie de la phrase qu'aucun filtre ne peut exprimer (par exemple l'actionnariat) est renvoyée dans metadata.unmatched_criteria au lieu d'être ignorée ; une phrase sans rien à rechercher ne renvoie aucun résultat, avec metadata.nl_no_intent: true.

Exemple:

"Food & Beverage companies in Singapore that recently expanded"

exclude_fields
string[]

Liste des champs à exclure de la charge utile de la réponse.

Exemple:
is_parameter_metadata_available
boolean

Indique si les métadonnées de paramètres sont disponibles pour la requête.

is_profile_metadata_available
boolean

Indique si les métadonnées de profil sont disponibles pour la requête.

per_page
integer
défaut:25

Enregistrements par page. Par défaut 25, ce qui constitue également le plafond sur la plupart des forfaits — la limite correspond au max_search_per_page de votre abonnement, renvoyé par Profile. Le dépasser renvoie HTTP 416 avec le code 41676 (ou 41613 pour la recherche d'entreprises et de personnes), et non un ensemble de résultats tronqué.

Plage requise: x <= 25
Exemple:

25

page
integer
défaut:1

Numéro de page, à partir de 1. Le plafond correspond au max_search_page de votre abonnement (max_company_search_page pour la recherche d'entreprises), renvoyé par Profile. Le dépasser renvoie HTTP 416.

Exemple:

1

cloud_footprint_providers
string[]

Entreprises utilisant l'un de ces fournisseurs où que ce soit. providers sans préfixe restreint les lignes ; celui-ci restreint les entreprises.

Exemple:
cloud_footprint_exclude_providers
string[]

Exclure les lignes correspondant à ces fournisseurs cloud ou d'hébergement. Limité à cette ligne d'empreinte : un fournisseur dans un pays.

Exemple:
cloud_footprint_target_locations
string[]

Entreprises présentes dans l'un de ces pays, où que ce soit dans leur empreinte.

Exemple:
cloud_footprint_exclude_target_locations
string[]

Exclure les lignes correspondant à ces codes pays où se trouve l'infrastructure.

Exemple:
cloud_footprint_cloud_regions
string[]

Ne conserver que les lignes correspondant à ces régions cloud. Limité à cette ligne d'empreinte : un fournisseur dans un pays.

Exemple:
cloud_footprint_exclude_cloud_regions
string[]

Exclure les lignes correspondant à ces régions cloud. Limité à cette ligne d'empreinte : un fournisseur dans un pays.

Exemple:
cloud_footprint_cities
string[]

Ne conserver que les lignes correspondant à ces villes. Limité à cette ligne d'empreinte : un fournisseur dans un pays.

Exemple:
cloud_footprint_exclude_cities
string[]

Exclure les lignes correspondant à ces villes. Limité à cette ligne d'empreinte : un fournisseur dans un pays.

Exemple:
cloud_footprint_first_seen_dates
(string | null)[]

Deux dates ISO 8601 (AAAA-MM-JJ) délimitant la période où l'empreinte a été vue pour la première fois. Limité à cette ligne d'empreinte : un fournisseur dans un pays.

Required array length: 2 elements
Exemple:
cloud_footprint_last_seen_dates
(string | null)[]

Deux dates ISO 8601 (AAAA-MM-JJ) délimitant la période où l'empreinte a été vue pour la dernière fois. Limité à cette ligne d'empreinte : un fournisseur dans un pays.

Required array length: 2 elements
Exemple:
cloud_footprint_is_cross_border_only
boolean

Si true, ne renvoie que les lignes hors du marché d'origine de l'entreprise. Les entreprises sans siège connu sont exclues.

Exemple:

true

cloud_footprint_host_count
(integer | null)[]

Minimum et maximum de hôtes. Utilisez null pour laisser une borne ouverte. Compté pour l'entreprise entière, tous fournisseurs et pays confondus.

Required array length: 2 elements
Exemple:
cloud_footprint_server_count
(integer | null)[]

Minimum et maximum de serveurs (IP distinctes). Utilisez null pour laisser une borne ouverte. Compté pour l'entreprise entière, tous fournisseurs et pays confondus.

Required array length: 2 elements
Exemple:
cloud_footprint_shared_server_count
(integer | null)[]

Minimum et maximum de serveurs partagés avec d'autres entreprises. Utilisez null pour laisser une borne ouverte. Compté pour l'entreprise entière, tous fournisseurs et pays confondus.

Required array length: 2 elements
Exemple:
cloud_footprint_provider_count
(integer | null)[]

Minimum et maximum de fournisseurs distincts utilisés par l'entreprise. Utilisez null pour laisser une borne ouverte. Compté pour l'entreprise entière, tous fournisseurs et pays confondus.

Required array length: 2 elements
Exemple:
cloud_footprint_country_count
(integer | null)[]

Minimum et maximum de pays où l'entreprise héberge. Utilisez null pour laisser une borne ouverte. Compté pour l'entreprise entière, tous fournisseurs et pays confondus.

Required array length: 2 elements
Exemple:
cloud_footprint_cross_border_country_count
(integer | null)[]

Minimum et maximum de pays hors du marché d'origine. Utilisez null pour laisser une borne ouverte. Compté pour l'entreprise entière, tous fournisseurs et pays confondus.

Required array length: 2 elements
Exemple:
cloud_footprint_region_count
(integer | null)[]

Minimum et maximum de régions cloud. Utilisez null pour laisser une borne ouverte. Compté pour l'entreprise entière, tous fournisseurs et pays confondus.

Required array length: 2 elements
Exemple:
cloud_footprint_city_count
(integer | null)[]

Minimum et maximum de villes. Utilisez null pour laisser une borne ouverte. Compté pour l'entreprise entière, tous fournisseurs et pays confondus.

Required array length: 2 elements
Exemple:
cloud_footprint_primary_provider
string[]

Entreprises dont le principal fournisseur est l'un de ceux-ci.

Exemple:
cloud_footprint_country_activity
object

Bornes limitées à un pays : {"country":"DE","host_count":[100,null]} trouve les entreprises exploitant plus de 100 hôtes en Allemagne précisément. Le cloud_footprint_host_count simple est le total de l'entreprise tous pays confondus ; ensemble ils ne peuvent exprimer cela. country seul est rejeté.

Réponse

Réponse réussie contenant les détails de la recherche d'entreprises.

metadata
object

Contexte de la requête : recent_search_log_identifier, les parameters et filters repris, un bloc de crédit profile optionnel, et ignored_fields (les clés du corps de requête ignorées par l'endpoint).

data
object | null

Les informations de réponse dépendent du point de terminaison spécifique.

Dernière modification le 4 septembre 2026