> ## 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. # Recherche d'entreprises > Recherchez dans la base de données Pubrio des entreprises correspondant aux critères spécifiés, tels que le secteur, la taille, la localisation et les technologies. ## OpenAPI ````yaml fr-openapi POST /companies/search openapi: 3.0.0 info: description: >- L'API Pubrio fournit une intelligence d'expansion de marché — des signaux en temps réel qui indiquent quand une entreprise entre sur un nouveau marché — ainsi que les données d'entreprises et de personnes qui les sous-tendent. Recherchez, consultez et enrichissez des comptes et des contacts, et abonnez-vous à des signaux de mouvement typés et datés sur plus de 200 marchés. version: 1.0.0 title: Pubrio OpenAPI termsOfService: https://pubrio.com/fr/terms-of-service contact: email: king.lai@pubrio.com name: King Lai url: https://pubrio.com/fr/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: >- Informations de profil de l'espace de travail et statistiques d'utilisation - name: Enrichment description: >- Enrichissez les fiches de personnes et d'entreprises avec des données B2B détaillées - name: Lookalike description: Trouvez des entreprises similaires à une entreprise donnée - name: Search description: >- Recherchez des personnes, des entreprises, des offres d'emploi, des actualités et des publicités à l'aide de filtres - name: Lookup description: >- Consultez des informations détaillées sur des personnes, entreprises, offres d'emploi, actualités, publicités et technologies spécifiques - name: LinkedIn description: >- Consultez les données de personnes et d'entreprises via des URL de profil LinkedIn - name: Redeem description: >- Utilisez des crédits pour débloquer les coordonnées de personnes (unitaire et par lot) - name: Channels description: >- Gérez les modèles de canaux de prospection (création, mise à jour, suppression, liste) - name: Monitor description: >- Créez et gérez des moniteurs de données avec webhooks, statistiques et traitement - name: Filters description: >- Récupérez les valeurs de filtre disponibles pour les paramètres de recherche (technologies, localisations, secteurs verticaux, etc.) - name: API Keys description: >- Listez et inspectez les journaux de requêtes API et les statistiques d'utilisation des clés API - name: Insights description: >- Informations agrégées sur les signaux des entreprises (offres d'emploi, actualités, publicités). - name: Export description: Exports de données en masse (soumis à des crédits). - name: Expansion description: >- Intelligence d'expansion de marché des entreprises : signaux, étapes, marchés et exports. externalDocs: description: >- L'API Pubrio permet de rechercher, prévisualiser et enrichir des contacts et des comptes. La base de données Pubrio fournit des données étendues de contacts B2B et de veille commerciale. url: https://docs.pubrio.com paths: /companies/search: post: tags: - Search summary: Rechercher des entreprises description: >- Recherchez dans la base de données Pubrio des entreprises correspondant aux critères spécifiés, tels que le secteur, la taille, la localisation et les technologies. 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: Réponse réussie contenant les détails de la recherche d'entreprises. content: application/json: schema: type: object properties: metadata: type: object description: >- 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: $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: >- 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. companies: type: array items: type: string format: uuid description: >- Une liste d'identifiants uniques (domain_search_id) utilisée pour les opérations de recherche d'entreprises et de personnes. domains: type: array items: type: string example: - pubrio.com description: >- 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. company_linkedin_urls: type: array items: type: string example: - https://www.linkedin.com/company/pubrio description: >- L'URL complète du profil d'entreprise LinkedIn. L'URL commence par `http` et contient `linkedin.com/company/` company_filters: type: object description: >- 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. 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: >- 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. exclude_locations: type: array items: type: string example: - CN - US - RU - CA description: >- 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. places: type: array items: type: string example: - Tokyo description: >- Noms de lieux (ville, région) utilisés pour filtrer les résultats. Accepte les noms de lieux localisés ou en anglais. exclude_places: type: array items: type: string example: - Tokyo description: >- Noms de lieux (ville, région) à exclure des résultats. Accepte les noms de lieux localisés ou en anglais. job_exclude_locations: allOf: - $ref: '#/components/schemas/exclude_locations' description: Localisations géographiques à exclure des résultats d'offres d'emploi. posted_dates: type: array items: type: string example: - '2025-01-01' - '2025-01-10' description: >- 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. people_titles: type: array items: type: string example: - sales manager - marketing manager description: >- 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`. verticals: type: array items: type: integer description: >- 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: type: array items: type: integer description: >- 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: type: array items: type: integer description: >- 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: type: array items: type: integer description: >- 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: type: array items: type: integer description: >- 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"]`. employees: type: array items: type: array items: type: string example: - - 1 - 10 - - 11 - 20 - - 10001 description: >- 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. revenues: type: array items: type: integer example: - 0 - 100000 description: Plage minimale et maximale du chiffre d'affaires de l'entreprise. founded_dates: type: array items: type: integer example: - 2018 - 2024 description: >- Plage d'années de fondation de l'entreprise. La valeur maximale de fondation est l'année en cours. keywords: type: array items: type: string example: - ecommerce - ai - fintech description: >- Une liste de mots-clés pour filtrer les entreprises par pertinence, spécialités ou descriptions. company_social_media: type: array items: type: string enum: - linkedin - facebook - instagram - tiktok - twitter - x - github - wantedly - rocketpunch example: - tiktok description: >- 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`. news_categories: type: array items: type: string example: - launches description: >- 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. published_dates: type: array items: type: string example: - '2025-01-01' - '2025-01-10' description: >- 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. advertisement_search_terms: type: array items: type: string example: - asus description: >- Mots-clés utilisés pour rechercher dans le contenu ou les titres des publicités. advertisement_target_locations: allOf: - $ref: '#/components/schemas/target_locations' description: Localisations géographiques cibles pour les publicités. advertisement_exclude_target_locations: allOf: - $ref: '#/components/schemas/exclude_target_locations' description: Localisations géographiques à exclure du ciblage publicitaire. advertisement_start_dates: type: array items: type: string format: date example: - '2025-12-25' - '2025-12-25' description: Plage de dates de début pour le filtrage des publicités. advertisement_end_dates: type: array items: type: string format: date example: - '2025-12-25' - '2025-12-25' description: Plage de dates de fin pour le filtrage des publicités. advertisement_active_dates: type: array items: type: string format: date example: - '2026-01-01' - '2026-01-31' description: >- 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). advertisement_status: type: array items: type: string enum: - currently_running - active_last_30_min example: - currently_running description: >- `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. advertisement_headlines: type: array items: type: string example: - limited time offer description: Mots-clés à rechercher dans le texte des accroches publicitaires. advertisement_platforms: type: array items: type: string enum: - linkedin - facebook - google - tiktok - apple example: - linkedin - facebook description: >- Filtre selon la bibliothèque publicitaire dont provient la publicité. En minuscules, insensible à la casse. `meta` est accepté comme alias de `facebook`. advertisement_publisher_platforms: type: array items: type: string enum: - facebook - instagram - messenger - threads - audience_network example: - facebook - instagram description: >- 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). advertisement_exclude_publisher_platforms: type: array items: type: string enum: - facebook - instagram - messenger - threads - audience_network example: - audience_network description: >- Exclut les publicités Facebook/Meta diffusées sur ces surfaces de plateforme. 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: >- Trouve les entreprises ayant au moins une publicité dans l'un de ces formats créatifs. advertisement_active_ads: type: array items: type: integer nullable: true minItems: 2 maxItems: 2 example: - 1 - null description: >- 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 ». advertisement_running_ads: type: array items: type: integer nullable: true minItems: 2 maxItems: 2 example: - 1 - null description: >- 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. advertisement_total_ads: type: array items: type: integer nullable: true minItems: 2 maxItems: 2 example: - 10 - null description: >- Nombre minimal et maximal du total des publicités jamais enregistrées pour l'entreprise, tous pays confondus. advertisement_platform_count: type: array items: type: integer nullable: true minItems: 2 maxItems: 2 example: - 2 - null description: >- Nombre minimal et maximal de plateformes publicitaires distinctes (linkedin, facebook, google, tiktok, apple) sur lesquelles l'entreprise fait activement de la publicité. advertisement_format_count: type: array items: type: integer nullable: true minItems: 2 maxItems: 2 example: - 2 - null description: >- Nombre minimal et maximal de formats créatifs publicitaires distincts que l'entreprise diffuse activement. advertisement_impressions_estimate: type: array items: type: integer nullable: true minItems: 2 maxItems: 2 example: - 1000 - null description: >- 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. advertisement_country_activity: type: object properties: country: type: string example: US description: Code pays ISO 3166-1 alpha-2 auquel limiter ce filtre. Obligatoire. rank: type: array items: type: integer nullable: true minItems: 2 maxItems: 2 example: - null - 500 description: >- Classement au sein de ce pays par volume publicitaire. 1 correspond au plus gros annonceur, et le chiffre augmente à mesure que le volume publicitaire diminue. Utilisez `[null, 500]` pour trouver les 500 plus gros annonceurs de ce pays ; utilisez `[500, null]` pour trouver tous ceux classés au 500e rang ou au-delà. percentile: type: array items: type: number nullable: true minItems: 2 maxItems: 2 example: - 90 - null description: >- Centile au sein de ce pays par volume publicitaire, de 0 à 100. Plus la valeur est élevée, plus l'annonceur dépense. Utilisez `[90, null]` pour les 10 % d'annonceurs les plus dépensiers de ce pays. volume_score: type: array items: type: number nullable: true minItems: 2 maxItems: 2 example: - 0.5 - null description: >- Le score de volume publicitaire sous-jacent, compris entre 0 et 1, à partir duquel `rank` et `percentile` sont tous deux calculés. active_ads: type: array items: type: integer nullable: true minItems: 2 maxItems: 2 example: - 1 - null description: Nombre minimal et maximal de publicités actives, limité à ce pays. running_ads: type: array items: type: integer nullable: true minItems: 2 maxItems: 2 example: - 1 - null description: >- Nombre minimal et maximal de publicités diffusées, limité à ce pays. Actuellement renseigné uniquement pour les publicités LinkedIn. total_ads: type: array items: type: integer nullable: true minItems: 2 maxItems: 2 example: - 10 - null description: Nombre minimal et maximal total de publicités, limité à ce pays. impressions: type: array items: type: integer nullable: true minItems: 2 maxItems: 2 example: - 1000 - null description: Nombre minimal et maximal estimé d'impressions, limité à ce pays. required: - country example: country: US rank: - null - 500 description: >- 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`. 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: >- La clé de filtre spécifiant à quelle propriété appliquer l'opérateur. operator: type: string enum: - or - and example: or description: >- L'opérateur logique à appliquer. Utilisez 'or' pour faire correspondre l'une des valeurs spécifiées, ou 'and' pour exiger toutes les valeurs spécifiées. description: >- 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. is_enable_similarity_search: type: boolean description: >- 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: type: number format: float example: 0.7 description: >- 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. exclude_fields: type: array items: type: string example: - emails - phones - contacts description: Liste des champs à exclure de la charge utile de la réponse. is_parameter_metadata_available: type: boolean description: >- Indique si les métadonnées de paramètres sont disponibles pour la requête. is_profile_metadata_available: type: boolean description: Indique si les métadonnées de profil sont disponibles pour la requête. per_page: type: integer example: 25 default: 25 maximum: 25 description: >- 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](/fr/api-reference/endpoint/profile/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é. page: type: integer example: 1 default: 1 description: >- 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](/fr/api-reference/endpoint/profile/profile). Le dépasser renvoie **HTTP 416**. data: type: object nullable: true description: >- Les informations de réponse dépendent du point de terminaison spécifique. target_locations: type: array items: type: string example: - TW - AE - 'NO' description: >- Filtre les publicités pour inclure celles ciblant des localisations spécifiques par code pays. Utilisez ce paramètre pour trouver les publicités diffusées dans des pays spécifiques. Se combine avec `filter_conditions` à l'aide de l'opérateur OR - la publicité doit cibler au moins l'une des localisations spécifiées. exclude_target_locations: type: array items: type: string example: - IS - GB - FR - IE - ES description: >- Filtre les publicités pour exclure celles ciblant des localisations spécifiques par code pays. Utilisez ce paramètre pour écarter les publicités diffusées dans des pays spécifiques. Lorsqu'il est spécifié dans `filter_conditions` avec l'opérateur 'or', la publicité ne doit cibler aucune des localisations exclues. responses: general_error: description: >- Requête invalide. La requête était mal formée ou contenait des paramètres invalides. Consultez le code d'erreur et le message pour plus de détails. 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: >- Limite de débit dépassée. Trop de requêtes ont été effectuées au cours d'une période donnée. Réessayez après la réinitialisation de la fenêtre de limitation de débit. 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: >- Erreur interne du serveur. Une erreur inattendue s'est produite sur le serveur. Contactez le support si l'erreur persiste. 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: >- 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](https://dashboard.pubrio.com/#/settings/). in: header ````