> ## 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. # Canjear personas - Individual > Gasta créditos para desbloquear los datos de contacto completos (correo electrónico, teléfono) de una persona específica. ## OpenAPI ````yaml es-openapi POST /redeem/people 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: /redeem/people: post: tags: - Redeem summary: Canjear los datos de contacto de una persona description: >- Gasta créditos para desbloquear los datos de contacto completos (correo electrónico, teléfono) de una persona específica. operationId: redeem_people parameters: [] requestBody: required: true content: application/json: schema: type: object properties: people_search_id: $ref: '#/components/schemas/people_search_id' linkedin_url: $ref: '#/components/schemas/people_linkedin_url' people_contact_types: $ref: '#/components/schemas/people_contact_types' anyOf: - title: ID de búsqueda de personas required: - people_search_id - people_contact_types - title: URL de LinkedIn required: - linkedin_url - people_contact_types responses: '200': description: Respuesta exitosa que contiene los detalles del canje de personas. content: application/json: schema: type: object properties: data: allOf: - $ref: '#/components/schemas/data' properties: peoples: type: array description: >- Las personas canjeadas. `emails` y `phones` son `null` —no `[]`— cuando no se encuentra nada para esa persona, así que compruébalo antes de iterar. `total_credit_cost` refleja solo las coincidencias exitosas y es `0` cuando no se canjeó nada; el coste aumenta según cuántos tipos de contacto solicites. items: type: object example: data: profile: credit: 450376 topup_credit: 235237 total_credit_cost: 45 peoples: - people_search_id: e37ccf38-ea8f-422e-9874-cb23b15e8fe4 emails: - value: example@gmail.com type: email-personal status: null - value: example@pubrio.com type: email-work status: Verified phones: - value: '+1123456789' type: phone status: null '400': $ref: '#/components/responses/general_error' '429': $ref: '#/components/responses/rate_limit_error' '500': $ref: '#/components/responses/server_error' components: schemas: people_search_id: type: string format: uuid description: Identificador único para la operación de búsqueda de personas. people_linkedin_url: type: string example: http://www.linkedin.com/in/king-lai-605382b7 description: >- La URL completa del perfil de LinkedIn del usuario. La URL debe empezar por `http` y contener `linkedin.com/in/` o `linkedin.com/pub/` people_contact_types: type: array items: type: string enum: - email-work - email-personal - phone example: - email-work - email-personal - phone description: >- Qué datos de contacto canjear. Usa exactamente `email-work`, `email-personal` y/o `phone` — resuelve la lista actualizada desde el endpoint `people contact type` en la pestaña Filters. **Los valores no reconocidos no se rechazan.** Un error tipográfico como `work_email` devuelve HTTP 200 con `emails: null`, `phones: null` y `total_credit_cost: 0` — idéntico a una persona que realmente no tiene datos de contacto. Si los canjes parecen estar universalmente vacíos, comprueba primero estos slugs. data: type: object nullable: true description: La información de la respuesta depende del endpoint específico. 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 ````