> ## 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'expansion > Trouvez des entreprises s'étendant vers un ou plusieurs marchés en utilisant des filtres firmographiques et de signaux ou une requête en langage naturel, avec des explications de correspondance générées par IA en option, ancrées dans les signaux réels de chaque entreprise. ## OpenAPI ````yaml fr-openapi POST /expansions/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: /expansions/search: post: tags: - Expansion summary: Recherche d'expansion description: >- Trouvez des entreprises s'étendant vers un ou plusieurs marchés en utilisant des filtres firmographiques et de signaux ou une requête en langage naturel, avec des explications de correspondance générées par IA en option, ancrées dans les signaux réels de chaque entreprise. operationId: expansions_search requestBody: required: true content: application/json: schema: type: object properties: froms: $ref: '#/components/schemas/expansion_froms' tos: $ref: '#/components/schemas/expansion_tos' exclude_froms: $ref: '#/components/schemas/expansion_exclude_froms' exclude_tos: $ref: '#/components/schemas/expansion_exclude_tos' stages: allOf: - $ref: '#/components/schemas/expansion_stages' description: >- Les valeurs sont sensibles à la casse et ne sont **pas validées**. Une valeur non reconnue est abandonnée silencieusement plutôt que rejetée : sur `stages`, `freshness`, `scopes` et `momentum`, tout le filtre est abandonné et vous obtenez des résultats *non filtrés*, tandis que sur `signal_types` et `signal_strengths`, le filtre est appliqué et ne correspond à *rien*. Dans les deux cas, la réponse semble normale. Résolvez les slugs valides depuis [Expansion Reference](/fr/api-reference/endpoint/expansions/types) et comparez `data.pagination.total_entries` à un appel non filtré si un jeu de résultats semble incorrect. momentum: allOf: - $ref: '#/components/schemas/expansion_momentum' description: >- Trajectoire du mouvement de l'entreprise sur le marché. `advancing` gagne du terrain, `steady` se maintient, `pulling_back` couvre le repli et la contraction. N'utilisez **pas** ici les valeurs de `directions` dans [Expansion Reference](/fr/api-reference/endpoint/expansions/types). Celles-ci (`advancing`, `steady`, `retreating`, `new`) sont les valeurs de *réponse* que vous obtenez sur `stage.direction` ; seules les trois listées ci-dessus sont acceptées comme *filtre*. Envoyer `retreating` ou `new` désactive silencieusement le filtre et renvoie des résultats non filtrés. freshness: allOf: - $ref: '#/components/schemas/expansion_freshness' description: >- Les valeurs sont sensibles à la casse et ne sont **pas validées**. Une valeur non reconnue est abandonnée silencieusement plutôt que rejetée : sur `stages`, `freshness`, `scopes` et `momentum`, tout le filtre est abandonné et vous obtenez des résultats *non filtrés*, tandis que sur `signal_types` et `signal_strengths`, le filtre est appliqué et ne correspond à *rien*. Dans les deux cas, la réponse semble normale. Résolvez les slugs valides depuis [Expansion Reference](/fr/api-reference/endpoint/expansions/types) et comparez `data.pagination.total_entries` à un appel non filtré si un jeu de résultats semble incorrect. scopes: $ref: '#/components/schemas/expansion_scopes' ahead_of_pace: type: boolean example: false description: >- Limiter aux paires évoluant plus vite que le rythme typique de ce marché. signal_types: allOf: - $ref: '#/components/schemas/expansion_signal_type_slugs' description: >- Les valeurs sont sensibles à la casse et ne sont **pas validées**. Une valeur non reconnue est abandonnée silencieusement plutôt que rejetée : sur `stages`, `freshness`, `scopes` et `momentum`, tout le filtre est abandonné et vous obtenez des résultats *non filtrés*, tandis que sur `signal_types` et `signal_strengths`, le filtre est appliqué et ne correspond à *rien*. Dans les deux cas, la réponse semble normale. Résolvez les slugs valides depuis [Expansion Reference](/fr/api-reference/endpoint/expansions/types) et comparez `data.pagination.total_entries` à un appel non filtré si un jeu de résultats semble incorrect. signal_strengths: allOf: - $ref: '#/components/schemas/signal_strengths' description: >- Les valeurs sont sensibles à la casse et ne sont **pas validées**. Une valeur non reconnue est abandonnée silencieusement plutôt que rejetée : sur `stages`, `freshness`, `scopes` et `momentum`, tout le filtre est abandonné et vous obtenez des résultats *non filtrés*, tandis que sur `signal_types` et `signal_strengths`, le filtre est appliqué et ne correspond à *rien*. Dans les deux cas, la réponse semble normale. Résolvez les slugs valides depuis [Expansion Reference](/fr/api-reference/endpoint/expansions/types) et comparez `data.pagination.total_entries` à un appel non filtré si un jeu de résultats semble incorrect. min_signal_count: type: integer example: 3 description: >- Nombre minimum de signaux d'expansion qu'une entreprise doit avoir dans la fenêtre — « très active / forte empreinte ». only_contraction: $ref: '#/components/schemas/only_contraction' min_markets: type: integer example: 3 description: >- Nombre minimum de nouveaux marchés qu'une entreprise doit avoir intégrés dans la fenêtre. home_country_code: type: array items: type: string example: - SG description: >- Filtrer par pays d'origine de l'entreprise (ISO 3166-1 alpha-2). Se combine avec `froms` lorsque les deux sont fournis. industries: $ref: '#/components/schemas/industries' exclude_industries: $ref: '#/components/schemas/exclude_industries' verticals: $ref: '#/components/schemas/verticals' vertical_categories: $ref: '#/components/schemas/vertical_categories' vertical_sub_categories: $ref: '#/components/schemas/vertical_sub_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' companies: $ref: '#/components/schemas/expansion_companies' 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' advertisement_target_locations: $ref: '#/components/schemas/advertisement_target_locations' advertisement_exclude_target_locations: $ref: '#/components/schemas/advertisement_exclude_target_locations' advertisement_search_terms: $ref: '#/components/schemas/advertisement_search_terms' advertisement_start_dates: $ref: '#/components/schemas/advertisement_start_dates' advertisement_end_dates: $ref: '#/components/schemas/advertisement_end_dates' news_categories: $ref: '#/components/schemas/news_categories' news_published_dates: $ref: '#/components/schemas/published_dates' transitioned_dates: type: array items: type: string format: date example: - '2026-04-01' - '2026-06-29' description: >- Plage de dates ISO pour la fenêtre de chronologie. Par défaut sur les 90 derniers jours. Une `query` en langage naturel peut aussi définir cela à partir d'expressions calendaires (« cette année », « l'année dernière », « T2 2026 »). window_days: $ref: '#/components/schemas/window_days' query: type: string example: fintech companies expanding into the UK description: >- Requête en langage naturel que Pubrio interprète en filtres d'expansion + d'entreprise. is_explain_match: type: boolean example: true description: >- Inclut des explications générées par IA sur la raison pour laquelle chaque entreprise correspond à la recherche, ancrées dans les signaux réels de l'entreprise. Fonctionne mieux avec une requête en langage naturel. Le nombre de signaux cités et la taille du lot évoluent tous deux avec `per_page` ; les sources à fort volume (offres d'emploi, campagnes publicitaires) sont résumées sous forme de comptage sur la fenêtre (par ex. « 12 offres d'emploi ») plutôt que listées individuellement. sort_by: $ref: '#/components/schemas/expansion_sort_by' is_include_metadata: allOf: - $ref: '#/components/schemas/expansion_is_include_metadata' description: >- Renvoie la charge utile de détail complète. Le trafic par clé API est allégé par défaut : le bloc `model`, les chiffres de confiance (`stage.confidence` sur Company Expansion Detail, `confidence_score` sur `other_markets[]` et sur `markers[]` de Rankings) et les champs `established_min` / `share_of_detected` / `has_known_office` sont tous omis sauf si ceci est `true`. page: $ref: '#/components/schemas/page' per_page: $ref: '#/components/schemas/per_page' is_enable_similarity_search: type: boolean description: >- Active la correspondance en texte libre pour `verticals`, `vertical_categories`, `vertical_sub_categories` et `technologies` ; ces filtres sont abandonnés sauf si ceci est `true`. example: true anyOf: - title: From Markets required: - froms - title: To Markets required: - tos - title: Plain-language Query required: - query - title: Companies required: - companies responses: '200': description: >- Liste paginée d'entreprises s'étendant sur le(s) marché(s). `filters` reflète les critères appliqués (ou interprétés en langage naturel) ; chaque entreprise inclut un `match_summary` quand `is_explain_match` est true. content: application/json: schema: type: object properties: metadata: type: object description: >- Métadonnées de recherche : les filtres réellement appliqués, plus l'agrégat de marché (agrégat, portée géographique, principales origines/destinations/secteurs, chronologie). Les réponses par clé API n'incluent l'agrégat que lorsque `is_include_metadata` est true. properties: filters: type: object description: >- Filtres réellement appliqués (reflète une requête en langage naturel interprétée lorsque `query` a été utilisé). relaxed_filters: type: array description: >- Filtres souples abandonnés automatiquement lorsqu'une requête en langage naturel ne correspondait à rien ; null sinon. items: type: string nl_note: type: string description: >- Note lisible par un humain lorsqu'une requête en langage naturel n'exprimait aucun critère reconnaissable ; la liste est vide dans ce cas. nl_note_code: type: string description: >- Code lisible par machine pour nl_note (par ex. expansion.search.no_criteria). aggregate: type: object description: >- Agrégat au niveau du marché. Présent lorsque les métadonnées sont demandées. country_code: type: string country_codes: type: array items: type: string direction: type: string is_global: type: boolean is_multi: type: boolean transitioned_dates: type: array items: type: string top_origins: type: array items: type: object top_destinations: type: array items: type: object top_industries: type: array items: type: object timeline: type: array items: type: object data: type: object description: >- Conteneur de résultat (enveloppe de recherche standard) : la liste d'entreprises plus la pagination. properties: pagination: type: object description: Page, par page, total d'entrées et total de pages. companies: type: array description: >- La liste d'entreprises. Chaque élément porte un `stage` imbriqué ; `match_summary` est inclus lorsque `is_explain_match` est true. Les réponses par clé API incluent aussi `presence` (`level` : established | emerging | none | no_data ; `matched_rule` : office | headcount | share) et un objet `read` dont le `code` est scaling | deepening | active | establishing (null quand il n'y a pas de présence locale à lire). items: type: object example: metadata: filters: tos: - GB verticals: - Financial Services data: pagination: page: 1 per_page: 25 total_entries: 87 total_pages: 4 total_display_pages: 4 is_timeout: false companies: - expansion_id: '6845525' domain_search_id: 8f3c1b04-2e7a-4d19-9c55-6ab21f0e7d3c country_code: GB target_country_code: GB domain: example.com company_name: Example Corp home_country_code: CN industry: Consumer Electronics founded_year: 2015 employees_count: 320 stage: slug: expanding expansion_score: 0.72 scope: entering_new_market direction: advancing freshness: fresh signal_count: 27 distinct_type_count: 3 last_transition_at: '2026-06-27T14:32:10.000Z' presence: level: established local_people_count: 12 matched_rule: headcount has_known_office: true established_min: 10 share_of_detected: 0.54 read: code: establishing '400': $ref: '#/components/responses/general_error' '429': $ref: '#/components/responses/rate_limit_error' '500': $ref: '#/components/responses/server_error' components: schemas: expansion_froms: type: array items: type: string example: - US - GB description: >- Marchés d'origine (ISO 3166-1 alpha-2). D'où une entreprise se développe (FROM) — ses pays domestiques / de siège social. À utiliser seul pour trouver les entreprises se développant à partir de ces marchés ; combinez avec `tos` pour un corridor from→to spécifique. expansion_tos: type: array items: type: string example: - US - GB description: >- Marchés cibles (ISO 3166-1 alpha-2). Vers où une entreprise se développe (TO). À utiliser seul pour trouver toutes les entreprises entrant sur ces marchés ; combinez avec `froms` pour un corridor from→to spécifique. expansion_exclude_froms: type: array items: type: string example: - US - GB description: Marchés d'origine à exclure (ISO 3166-1 alpha-2). expansion_exclude_tos: type: array items: type: string example: - US - GB description: Marchés cibles à exclure (ISO 3166-1 alpha-2). expansion_stages: type: array items: type: string enum: - exploring - committing - expanding - scaling example: - committing - expanding description: >- Filtre sur une ou plusieurs étapes d'expansion. Consultez la base de connaissances Expansion Signals pour les définitions des étapes. expansion_momentum: type: array items: type: string enum: - advancing - steady - pulling_back example: - advancing - steady description: >- Trajectoire selon laquelle filtrer. Seuls `advancing`, `steady` et `pulling_back` sont acceptés ; les valeurs `directions` dans [Expansion Reference](/fr/api-reference/endpoint/expansions/types) ne concernent que la réponse. expansion_freshness: type: array items: type: string enum: - fresh - cooling - stale - cold example: - fresh - cooling description: >- Filtre selon la fraîcheur des preuves : fresh (~30j), cooling (~30-60j), stale (~60-90j), cold (>90j). expansion_scopes: type: array items: type: string enum: - entering_new_market - expanding_within_presence - established_only example: - entering_new_market description: Filtre selon l'ampleur de l'entrée sur le marché. expansion_signal_type_slugs: type: array items: type: string enum: - AD - AUDIENCE - DNS - ENTITY - EVENT - EVENT_PLUS - EXEC - HIRE - INFRA - IP - NEWS - OFFICE - PARTNER - PRODUCT - REG - SCALE - TECH example: - EXEC - HIRE description: >- Filtre sur des types de signaux spécifiques. Consultez le catalogue Signal Types dans la base de connaissances pour les définitions et les paliers (`DNS` et `INFRA` sont des signaux de palier Premier). signal_strengths: type: array items: type: string enum: - low - medium - high - very_high example: - high description: >- Filtre selon le niveau de confiance des preuves : `low`, `medium`, ou `high`. Notez que ceci est distinct du `signal_strength_slug` par signal renvoyé sur les enregistrements de signaux (qui s'échelonne de `low` à `very_high`) ; toute autre valeur ici ne correspond à rien. only_contraction: type: boolean example: false description: >- Lorsque true, ne renvoie que les expansions marquées comme contraction (entreprises en repli). industries: type: array items: type: string example: - software - financial services description: Filtre selon le nom du secteur (correspondance en texte libre). exclude_industries: type: array items: type: string example: - tobacco description: Secteurs à exclure (correspondance en texte libre). 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"]`. 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. expansion_companies: type: array items: type: string example: - stripe.com - https://www.linkedin.com/company/airbnb - b7d92a56-31f8-4c0b-ae43-19c8e5f24b70 description: >- Limite à des entreprises spécifiques via n'importe quelle combinaison de `domain_search_id`, de domaine d'entreprise, ou d'URL de profil de réseau social d'entreprise. Les domaines et URL sont résolus vers leur entreprise la mieux classée. 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. 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`. 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_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_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. 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. window_days: type: integer example: 90 description: >- Facultatif. Taille de la fenêtre glissante, en jours. Utilisée lorsqu'une plage `transitioned_dates` explicite n'est pas fournie ; si les deux sont omis, une fenêtre par défaut est utilisée. expansion_sort_by: type: string enum: - recent - expansion_score - signal_count - company_ranking example: expansion_score description: >- Ordre des résultats. Omettez pour l'ordre de pertinence par défaut : les couples corroborés en premier (2 types de signaux distincts ou plus), puis les couples à preuves répétées (3 signaux ou plus), puis le reste — les plus récemment transitionnés en premier au sein de chaque palier. `recent` — pure récence (les plus récemment transitionnés en premier). `expansion_score` — le score d'expansion le plus élevé en premier. `signal_count` — le plus grand nombre de signaux dans le couple en premier. `company_ranking` — classement global de l'entreprise selon Pubrio (plus bas signifie plus important), par ordre croissant. expansion_is_include_metadata: type: boolean example: true description: >- Les réponses par clé API sont allégées par défaut. Définissez true pour inclure le bloc `metadata` complet (agrégats, principales origines/destinations, principaux secteurs, chronologie) et le détail du modèle par entreprise. 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**. 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é. 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. 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 ````