> ## 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.

# Utilisation quotidienne de l'API

> Récupérez une répartition quotidienne des requêtes API et des crédits consommés par l'espace de travail sur une plage de dates. La réponse inclut une série chronologique par jour ainsi qu'une série empilée par point de terminaison, adaptée à la création de graphiques d'utilisation.



## OpenAPI

````yaml fr-openapi POST /api_keys/usage/daily
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:
  /api_keys/usage/daily:
    post:
      tags:
        - API Keys
      summary: Obtenir la série chronologique quotidienne d'utilisation de l'API
      description: >-
        Récupérez une répartition quotidienne des requêtes API et des crédits
        consommés par l'espace de travail sur une plage de dates. La réponse
        inclut une série chronologique par jour ainsi qu'une série empilée par
        point de terminaison, adaptée à la création de graphiques d'utilisation.
      operationId: api_keys_get_usage_daily
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - start_date
                - end_date
              properties:
                start_date:
                  type: string
                  example: '2026-05-01'
                  description: >-
                    Début de la plage de dates au format `YYYY-MM-DD`
                    (interprété dans le fuseau horaire de l'espace de travail).
                end_date:
                  type: string
                  example: '2026-05-14'
                  description: >-
                    Fin de la plage de dates au format `YYYY-MM-DD` (interprétée
                    dans le fuseau horaire de l'espace de travail).
                keys:
                  type: array
                  items:
                    type: string
                  description: >-
                    Liste facultative d'identifiants de clé API masqués (par
                    exemple `0••••••••••••••••f39`) pour restreindre les
                    résultats à des clés spécifiques. Utilisez les valeurs
                    masquées renvoyées par `/api_keys` ou par le champ
                    `masked_authentication` d'une entrée de journal.
                log_type_slugs:
                  type: array
                  items:
                    type: string
                  description: >-
                    Liste facultative de slugs de type de journal (par exemple
                    `people_search`, `company_search`, `people_redeem`) pour
                    restreindre les résultats à des points de terminaison
                    spécifiques.
      responses:
        '200':
          description: >-
            Réponse réussie contenant une série chronologique quotidienne
            d'utilisation.
          content:
            application/json:
              schema:
                type: object
                properties:
                  metadata:
                    type: object
                    properties:
                      filters:
                        type: object
                        description: >-
                          Reprise des filtres de requête utilisés pour produire
                          cette réponse, les valeurs vides étant supprimées.
                        additionalProperties: true
                  data:
                    type: object
                    properties:
                      series:
                        type: array
                        description: >-
                          Totaux quotidiens sur l'ensemble des points de
                          terminaison, triés par date croissante.
                        items:
                          type: object
                          properties:
                            date:
                              type: string
                              description: Jour au format `YYYY-MM-DD`.
                            credits:
                              type: number
                              description: Crédits consommés ce jour-là.
                            requests:
                              type: integer
                              description: Nombre de requêtes API ce jour-là.
                      by_log_type:
                        type: array
                        description: >-
                          Série empilée par point de terminaison, triée par
                          crédits puis par requêtes (ordre décroissant).
                        items:
                          type: object
                          properties:
                            slug:
                              type: string
                              description: >-
                                Slug du type de journal. `__unknown__` indique
                                des requêtes non associées à un type de journal
                                facturable.
                            name:
                              type: string
                              description: Nom lisible du type de journal.
                            totals:
                              type: object
                              properties:
                                credits:
                                  type: number
                                requests:
                                  type: integer
                            series:
                              type: array
                              items:
                                type: object
                                properties:
                                  date:
                                    type: string
                                  credits:
                                    type: number
                                  requests:
                                    type: integer
                      totals:
                        type: object
                        properties:
                          credits:
                            type: number
                          requests:
                            type: integer
              example:
                metadata:
                  filters:
                    start_date: '2026-05-01'
                    end_date: '2026-05-14'
                data:
                  series:
                    - date: '2026-05-01'
                      credits: 26352
                      requests: 2827
                    - date: '2026-05-05'
                      credits: 798
                      requests: 402
                    - date: '2026-05-11'
                      credits: 187
                      requests: 187
                  by_log_type:
                    - slug: people_redeem
                      name: Redeem People
                      totals:
                        credits: 40835
                        requests: 4083
                      series:
                        - date: '2026-05-01'
                          credits: 26140
                          requests: 2614
                        - date: '2026-05-11'
                          credits: 185
                          requests: 15
                    - slug: people_search
                      name: People Search
                      totals:
                        credits: 633
                        requests: 212
                      series:
                        - date: '2026-05-05'
                          credits: 594
                          requests: 199
                  totals:
                    credits: 41892
                    requests: 4896
        '400':
          $ref: '#/components/responses/general_error'
        '429':
          $ref: '#/components/responses/rate_limit_error'
        '500':
          $ref: '#/components/responses/server_error'
components:
  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

````