> ## 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. # Desglose de uso de la API > Obtén un desglose de las solicitudes a la API y los créditos consumidos dentro de un rango de fechas, agrupados tanto por clave de API individual (`by_key`) como por endpoint (`by_endpoint`). Útil para identificar las claves con mayor tráfico y los endpoints que más créditos consumen en todo el espacio de trabajo. ## OpenAPI ````yaml es-openapi POST /api_keys/usage/breakdown openapi: 3.0.0 info: description: >- La API de Pubrio ofrece inteligencia de expansión de mercado —señales en tiempo real que indican cuándo una empresa entra en un nuevo mercado— junto con los datos de empresas y personas que las respaldan. Busca, consulta y enriquece cuentas y contactos, y suscríbete a señales de movimiento tipadas y fechadas en más de 200 mercados. version: 1.0.0 title: Pubrio OpenAPI termsOfService: https://pubrio.com/es/terms-of-service contact: email: king.lai@pubrio.com name: King Lai url: https://pubrio.com/es/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: Información del perfil del espacio de trabajo y estadísticas de uso - name: Enrichment description: Enriquece registros de personas y empresas con datos B2B detallados - name: Lookalike description: Encuentra empresas similares a una empresa determinada - name: Search description: Busca personas, empresas, empleos, noticias y anuncios con filtros - name: Lookup description: >- Consulta información detallada de personas, empresas, empleos, noticias, anuncios y tecnologías específicos - name: LinkedIn description: Consulta datos de personas y empresas mediante URL de perfil de LinkedIn - name: Redeem description: >- Canjea créditos para desbloquear datos de contacto de personas (individual y por lotes) - name: Channels description: >- Gestiona plantillas de canales de contacto (crear, actualizar, eliminar, listar) - name: Monitor description: >- Crea y gestiona monitores de datos con webhooks, estadísticas y procesamiento - name: Filters description: >- Obtén los valores de filtro disponibles para los parámetros de búsqueda (tecnologías, ubicaciones, verticales, etc.) - name: API Keys description: >- Lista e inspecciona los registros de solicitudes a la API y las analíticas de uso de las claves de API - name: Insights description: >- Información agregada de señales para empresas (empleos, noticias, anuncios). - name: Export description: Exportaciones de datos masivas (sujetas a créditos). - name: Expansion description: >- Inteligencia de expansión de mercado de empresas: señales, etapas, mercados y exportaciones. externalDocs: description: >- La API de Pubrio se utiliza para buscar, previsualizar y enriquecer contactos y cuentas. La base de datos de Pubrio ofrece amplios datos de contactos B2B e inteligencia de ventas. url: https://docs.pubrio.com paths: /api_keys/usage/breakdown: post: tags: - API Keys summary: Obtener el desglose de uso de la API por clave y endpoint description: >- Obtén un desglose de las solicitudes a la API y los créditos consumidos dentro de un rango de fechas, agrupados tanto por clave de API individual (`by_key`) como por endpoint (`by_endpoint`). Útil para identificar las claves con mayor tráfico y los endpoints que más créditos consumen en todo el espacio de trabajo. operationId: api_keys_get_usage_breakdown requestBody: required: true content: application/json: schema: type: object required: - start_date - end_date properties: start_date: type: string example: '2026-05-01' description: >- Inicio del rango de fechas en formato `YYYY-MM-DD` (interpretado según la zona horaria del espacio de trabajo). end_date: type: string example: '2026-05-14' description: >- Fin del rango de fechas en formato `YYYY-MM-DD` (interpretado según la zona horaria del espacio de trabajo). keys: type: array items: type: string description: >- Lista opcional de identificadores enmascarados de claves de API (por ejemplo, `0••••••••••••••••f39`) para restringir los resultados a claves específicas. Usa los valores enmascarados que devuelve `/api_keys` o el campo `masked_authentication` de una entrada de registro. log_type_slugs: type: array items: type: string description: >- Lista opcional de slugs de tipo de registro (por ejemplo, `people_search`, `company_search`, `people_redeem`) para restringir los resultados a endpoints específicos. responses: '200': description: Respuesta correcta que contiene el desglose de uso de la API. content: application/json: schema: type: object properties: metadata: type: object properties: filters: type: object description: >- Reflejo de los filtros de la solicitud usados para generar esta respuesta, con los valores vacíos eliminados. additionalProperties: true data: type: object properties: by_key: type: array description: >- Uso agrupado por clave de API (los 100 principales, ordenados por créditos y luego por solicitudes). items: type: object properties: name: type: string description: Identificador enmascarado de la clave de API. requests: type: integer description: Número de solicitudes realizadas con esta clave. credits: type: number description: Créditos consumidos por esta clave. last_used: type: string nullable: true description: >- Marca de tiempo de la solicitud más reciente de esta clave, o `null` si no se usó nunca en el rango. percent_of_requests: type: number description: >- Proporción del total de solicitudes, en porcentaje. percent_of_credits: type: number description: Proporción del total de créditos, en porcentaje. by_endpoint: type: array description: >- Uso agrupado por endpoint (los 100 principales, ordenados por créditos y luego por solicitudes). items: type: object properties: slug: type: string nullable: true description: >- Slug del tipo de registro. `null` para solicitudes que no se corresponden con un tipo de registro facturable. name: type: string description: Nombre legible del tipo de registro. requests: type: integer credits: type: number cost_per_call: type: number description: >- Créditos promedio por solicitud para este endpoint. percent_of_requests: type: number description: >- Proporción del total de solicitudes, en porcentaje. percent_of_credits: type: number description: Proporción del total de créditos, en porcentaje. totals: type: object properties: credits: type: number requests: type: integer example: metadata: filters: start_date: '2026-04-01' end_date: '2026-05-14' data: by_key: - name: 2••••••••••••••••a37 requests: 929 credits: 42766 last_used: '2026-05-05 11:09:42.508' percent_of_requests: 17.892 percent_of_credits: 99.425 - name: 0••••••••••••••••f39 requests: 175 credits: 187 last_used: '2026-05-14 12:04:21.651' percent_of_requests: 3.37 percent_of_credits: 0.434 by_endpoint: - slug: people_redeem name: Redeem People requests: 4088 credits: 41215 cost_per_call: 10.08 percent_of_requests: 78.73 percent_of_credits: 95.82 - slug: people_search name: People Search requests: 368 credits: 1101 cost_per_call: 2.99 percent_of_requests: 7.08 percent_of_credits: 2.55 totals: credits: 43013 requests: 5192 '400': $ref: '#/components/responses/general_error' '429': $ref: '#/components/responses/rate_limit_error' '500': $ref: '#/components/responses/server_error' components: responses: general_error: description: >- Solicitud incorrecta. La solicitud estaba mal formada o contenía parámetros no válidos. Consulta el código de error y el mensaje para más detalles. 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: >- Límite de tasa excedido. Se realizaron demasiadas solicitudes en un período de tiempo determinado. Vuelve a intentarlo después de que se restablezca la ventana de límite de tasa. 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: >- Error interno del servidor. Se produjo un error inesperado en el servidor. Contacta con soporte si el error 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 token de API único que representa las acciones que realizas a través de la API, junto con los permisos y operaciones correspondientes. Puedes crearlo en la sección [Configuración](https://dashboard.pubrio.com/#/settings/). in: header ````