> ## 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 de signaux d'expansion > Lignes brutes et paginées de signaux d'expansion — les preuves datées à l'origine de l'étape de chaque entreprise, avec la source et l'URL de la preuve. ## OpenAPI ````yaml fr-openapi POST /expansions/signals/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/signals/search: post: tags: - Expansion summary: Recherche de signaux d'expansion description: >- Lignes brutes et paginées de signaux d'expansion — les preuves datées à l'origine de l'étape de chaque entreprise, avec la source et l'URL de la preuve. operationId: expansions_signals_search requestBody: required: false content: application/json: schema: type: object properties: domain_search_ids: type: array description: >- Entreprises auxquelles restreindre la recherche, par `domain_search_id`. items: type: string example: - 8f3c1b04-2e7a-4d19-9c55-6ab21f0e7d3c is_active: type: boolean description: >- Renvoie uniquement les signaux actifs (`true`) ou uniquement les signaux rétractés (`false`). Omettez pour obtenir les deux. example: true country_codes: type: array description: >- Marchés cibles auxquels restreindre la recherche, sous forme de codes ISO 3166-1 alpha-2. items: type: string example: - US - GB signal_types: allOf: - $ref: '#/components/schemas/expansion_signal_type_slugs' description: >- Types de signaux auxquels restreindre la recherche. Les valeurs inconnues ne correspondent à rien. signal_subtypes: allOf: - $ref: '#/components/schemas/expansion_signal_subtype_slugs' description: >- Sous-types de signaux auxquels restreindre la recherche. Les valeurs inconnues ne correspondent à rien. signal_strengths: allOf: - $ref: '#/components/schemas/signal_strengths' description: >- Intensités de signal auxquelles restreindre la recherche. Les valeurs inconnues ne correspondent à rien. source_types: type: array items: type: string description: >- Types de sources auxquels restreindre la recherche : `jobs`, `ads`, `linkedin`, `news`, `pubrio`. example: - jobs - ads polarities: type: array items: type: string enum: - expansion - contraction_leading - contraction_confirming - contraction_lagging description: >- Directions de signal à inclure. `expansion` marque une entrée ou une croissance ; les valeurs `contraction_*` marquent un repli. example: - expansion event_dates: $ref: '#/components/schemas/event_dates' page: $ref: '#/components/schemas/page' per_page: $ref: '#/components/schemas/per_page' responses: '200': description: Recherche de signaux d'expansion content: application/json: schema: type: object properties: metadata: type: object description: Reflet des filtres appliqués à cette requête. data: type: object description: Conteneur de résultat. properties: pagination: type: object description: >- Page, éléments par page, nombre total d'entrées et nombre total de pages. signals: type: array description: >- Les lignes de signaux correspondantes, du plus récent au plus ancien. items: type: object properties: expansion_signal_id: type: integer description: Identifiant unique de cette ligne de signal. domain_search_id: type: string format: uuid description: >- L'entreprise à laquelle ce signal appartient. Utilisez-le avec [Company Expansion Detail](/fr/api-reference/endpoint/expansions/company_lookup). country_code: type: string description: >- Marché cible dans lequel ce signal a été observé, sous forme de code ISO 3166-1 alpha-2. signal_type_slug: type: string description: >- Type de signal. L'un des 17 slugs renvoyés par [Expansion Reference](/fr/api-reference/endpoint/expansions/types). signal_subtype_slug: type: string nullable: true description: >- Sous-type plus précis, ou `null` lorsque le type n'a pas de sous-type. Environ 44 % des lignes sont à `null`. signal_strength_slug: type: string description: >- Intensité du signal : `low`, `medium`, `high` ou `very_high`. polarity: type: string description: >- Direction du signal : `expansion`, ou l'une des trois valeurs `contraction_*`. event_date: type: string format: date-time description: >- Date à laquelle l'événement sous-jacent s'est produit. À lire conjointement avec `event_date_precision`. event_date_precision: type: string description: >- Précision de `event_date` : `day`, `month`, `quarter`, `year` ou `unknown`. source_type: type: string description: >- Origine du signal. Valeurs observées : `jobs`, `ads`, `linkedin`, `news`, `pubrio`. source_record_id: type: string nullable: true description: >- Identifiant de l'enregistrement source dont le signal est dérivé, lorsqu'il en existe un. display_label: type: string description: >- Résumé du signal en une ligne, lisible par un humain. evidence_url: type: string nullable: true description: >- Lien vers la preuve à l'appui. Souvent `null` — la plupart des lignes proviennent de sources structurées plutôt que d'une page citable. metadata: type: object description: >- Détail spécifique à la source. Ses clés varient selon `source_type` — les lignes d'offres d'emploi comportent `departments`, `seniority`, `top_titles`, `active_postings` ; les lignes publicitaires comportent `advertisement_format`, `headline`, `share_pct`. extraction_confidence: type: number nullable: true description: >- Confiance du modèle pour les signaux extraits par un modèle, `null` sinon. extraction_model: type: string nullable: true description: >- Nom du modèle d'extraction, lorsqu'un modèle a été utilisé. is_active: type: boolean description: >- `true` pour les signaux actifs, `false` une fois qu'un signal a été rétracté. notes: type: string nullable: true description: Annotation en texte libre. Généralement `null`. created_at: type: string format: date-time description: Date de création de la ligne de signal. last_modified: type: string format: date-time description: >- Date de dernière mise à jour de la ligne de signal. source_published_at: type: string format: date-time nullable: true description: >- Date de publication du document source, lorsqu'elle est connue. lead_time_days: type: integer nullable: true description: >- Nombre de jours entre la publication de la source et la date de l'événement, lorsque les deux sont connues. occurs_at: type: string format: date-time nullable: true description: >- Début de la fenêtre couverte par le signal, pour les signaux s'étendant sur une période. occurs_until: type: string format: date-time nullable: true description: >- Fin de la fenêtre couverte par le signal, pour les signaux s'étendant sur une période. audit: type: object description: >- Provenance de la ligne : `profile_id` et `user_id` sont renseignés pour les signaux importés par un utilisateur, `import_id` regroupe un import en masse, et `is_backfill` marque les lignes ajoutées par un remplissage historique. properties: profile_id: type: integer nullable: true user_id: type: string format: uuid nullable: true import_id: type: string nullable: true is_backfill: type: boolean example: metadata: filters: domain_search_ids: - 8f3c1b04-2e7a-4d19-9c55-6ab21f0e7d3c country_codes: - US signal_types: - HIRE - AD data: pagination: page: 1 per_page: 25 total_entries: 2990 total_pages: 120 signals: - expansion_signal_id: 580965556 domain_search_id: 8f3c1b04-2e7a-4d19-9c55-6ab21f0e7d3c country_code: US signal_type_slug: HIRE signal_subtype_slug: country_manager signal_strength_slug: very_high polarity: expansion event_date: '2026-06-20T14:00:00.000Z' event_date_precision: day source_type: jobs source_record_id: '4224659596' display_label: Hired Country Manager evidence_url: https://www.linkedin.com/jobs/view/4224659596 metadata: city: Austin country_code: US departments: - sales seniority: - director top_titles: - Country Manager, US active_postings: 3 window_days: 90 extraction_confidence: 0.91 extraction_model: null is_active: true notes: null created_at: '2026-06-20T15:02:11.004Z' last_modified: '2026-06-20T15:02:11.004Z' source_published_at: '2026-06-19T08:00:00.000Z' lead_time_days: 1 occurs_at: null occurs_until: null audit: profile_id: null user_id: null import_id: null is_backfill: false - expansion_signal_id: 580965557 domain_search_id: 8f3c1b04-2e7a-4d19-9c55-6ab21f0e7d3c country_code: US signal_type_slug: AD signal_subtype_slug: null signal_strength_slug: low polarity: expansion event_date: '2026-06-18T08:12:25.866Z' event_date_precision: day source_type: ads source_record_id: 3569a83d-6e96-4bc9-b1a7-abbfa8f4b1ad display_label: >- Full-Stack Observability: 7 Tools Engineers Are Switching To in 2026 evidence_url: null metadata: headline: >- Full-Stack Observability: 7 Tools Engineers Are Switching To in 2026 advertisement_format: Single Image Ad source_type: linkedin share_basis: declared share_pct: null started_at: null ended_at: null extraction_confidence: null extraction_model: null is_active: true notes: null created_at: '2026-06-18T08:12:25.883Z' last_modified: '2026-06-18T08:12:25.883Z' source_published_at: null lead_time_days: null occurs_at: null occurs_until: null audit: profile_id: null user_id: null import_id: null is_backfill: false '400': $ref: '#/components/responses/general_error' '429': $ref: '#/components/responses/rate_limit_error' '500': $ref: '#/components/responses/server_error' components: schemas: 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). expansion_signal_subtype_slugs: type: array items: type: string enum: - marketing_pullback - domain_dropped - entity_dissolution - exhibiting_booth - speaking_breakout - speaking_keynote - sponsorship - key_departure - country_manager - engineering - freelancer - hiring_freeze - job_posting_removal - legal_compliance - local_employee - operations - regional_vp - remote_sales_bd - supply_chain - ip_abandoned - office_closure - partnership_terminated - product_withdrawal - regulatory_surrender - layoffs - content_decay example: - country_manager - local_employee 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. event_dates: type: array items: type: string example: - '2026-06-01' - '2026-06-30' description: >- Plage de dates de la date de l'événement du signal. La valeur maximale est le jour actuel. 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é. 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 ````