> ## 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 des signaux du moniteur

> Lit la page suivante d'une livraison paginée (`is_paged_delivery: true`). La fenêtre est figée à l'exécution : la page ne contient que les signaux de cette fenêtre, selon les filtres, le périmètre d'entreprises, les exclusions et la fenêtre de déduplication d'entreprises actuels du moniteur, dans l'ordre de la livraison. Chaque page est une lecture keyset bornée, facturée comme la recherche équivalente (un crédit de recherche par type de signal lu par la page ; les listes de suivi sont gratuites). La page a la forme de la charge utile du webhook.



## OpenAPI

````yaml fr-openapi POST /monitors/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:
  /monitors/signals/search:
    post:
      tags:
        - Monitor
      summary: Rechercher les signaux d'une livraison paginée
      description: >-
        Lit la page suivante d'une livraison paginée (`is_paged_delivery:
        true`). La fenêtre est figée à l'exécution : la page ne contient que les
        signaux de cette fenêtre, selon les filtres, le périmètre d'entreprises,
        les exclusions et la fenêtre de déduplication d'entreprises actuels du
        moniteur, dans l'ordre de la livraison. Chaque page est une lecture
        keyset bornée, facturée comme la recherche équivalente (un crédit de
        recherche par type de signal lu par la page ; les listes de suivi sont
        gratuites). La page a la forme de la charge utile du webhook.
      operationId: monitors_signals_search
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                page_token:
                  type: string
                  description: >-
                    `metadata.window.next_page_token` d'une livraison paginée ou
                    de la page précédente. Il porte la fenêtre figée, donc le
                    même jeton lit toujours la même plage ; `null` sur la
                    dernière page signifie que la fenêtre est terminée.
              required:
                - page_token
      responses:
        '200':
          description: >-
            La page, à la forme de la charge utile du webhook plus le même bloc
            `pagination` que renvoie toute recherche. L'enveloppe est `{
            metadata: { monitor_log_id, page_token }, data: {...} }`.
          content:
            application/json:
              schema:
                type: object
                properties:
                  metadata:
                    type: object
                    properties:
                      monitor_log_id:
                        type: string
                        format: uuid
                        description: >-
                          La livraison à laquelle appartient cette page (sa
                          ligne dans les journaux de statistiques).
                      page_token:
                        type: string
                        description: Le jeton avec lequel cette page a été lue.
                  data:
                    type: object
                    description: >-
                      Même forme que la charge utile du webhook : `monitor`,
                      `metadata`, `triggered_at`, et `signals` (unité signal) ou
                      `companies` (unité entreprise).
                    properties:
                      metadata:
                        type: object
                        properties:
                          monitor_log_id:
                            type: string
                            format: uuid
                            description: La livraison à laquelle appartient cette page.
                          total_signals:
                            type: integer
                            description: Signaux sur cette page.
                          total_companies:
                            type: integer
                            description: Entreprises sur cette page.
                          window:
                            type: object
                            properties:
                              from:
                                type: string
                                format: date-time
                                description: Début de la fenêtre (l'exécution précédente).
                              to:
                                type: string
                                format: date-time
                                description: Fin de la fenêtre (cette exécution).
                              next_page_token:
                                type: string
                                nullable: true
                                description: >-
                                  Jeton de la page suivante ; `null` sur la
                                  dernière page.
                      pagination:
                        $ref: '#/components/schemas/search_pagination'
              example:
                metadata:
                  monitor_log_id: 516b72de-79d5-400b-9bae-423a43eca98b
                  page_token: c2b1…
                data:
                  monitor:
                    monitor_id: c9cd5421-b327-4243-9cd7-8b341b3da8bd
                    name: Weekly CFO hires
                    detection_mode: signal_first
                    record_unit: signal
                  metadata:
                    monitor_log_id: 516b72de-79d5-400b-9bae-423a43eca98b
                    parent_monitor_log_id: null
                    total_signals: 25
                    total_companies: 25
                    total_people: 0
                    window:
                      from: '2026-10-10T02:09:00.000Z'
                      to: '2026-10-17T06:09:56.270Z'
                      next_page_token: eyJhbGciOi…
                  triggered_at: '2026-10-17T06:20:11.002Z'
                  signals: []
                  pagination:
                    page: 2
                    per_page: 25
                    total_entries: 395
                    total_pages: 16
                    total_display_pages: 16
                    is_timeout: false
                    is_estimated: false
        '400':
          $ref: '#/components/responses/general_error'
        '429':
          $ref: '#/components/responses/rate_limit_error'
        '500':
          $ref: '#/components/responses/server_error'
components:
  schemas:
    search_pagination:
      type: object
      description: Pagination de l'ensemble de résultats.
      properties:
        page:
          type: integer
          description: Numéro de la page actuelle.
        per_page:
          type: integer
          description: Nombre d'enregistrements par page.
        total_entries:
          type: integer
          description: >-
            Nombre total d'enregistrements correspondants. Il s'agit d'une
            estimation lorsque `is_estimated` vaut `true`.
        total_pages:
          type: integer
          description: '`total_entries` divisé par `per_page`.'
        total_display_pages:
          type: integer
          description: >-
            Nombre de pages pour ce résultat, plafonné par le
            `max_display_search_page` de votre forfait.
        is_estimated:
          type: boolean
          description: >-
            `true` lorsque `total_entries` est une estimation et non un décompte
            exact. N'utilisez pas un total estimé pour décider quand arrêter la
            pagination ; arrêtez-vous lorsqu'une page renvoie moins de lignes
            que `per_page`.
        is_timeout:
          type: boolean
          description: >-
            `true` lorsque la recherche a manqué de temps. `total_entries` ne
            compte alors que les lignes renvoyées jusque-là, et une page vide
            signifie que la recherche n'a pas abouti, et non que rien ne
            correspondait.
  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

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.