> ## 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. # Búsqueda de señales de expansión > Filas de señales de expansión sin procesar y paginadas: la evidencia fechada detrás de la etapa de cada empresa, con la fuente y la URL de evidencia. ## OpenAPI ````yaml es-openapi POST /expansions/signals/search 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: /expansions/signals/search: post: tags: - Expansion summary: Búsqueda de señales de expansión description: >- Filas de señales de expansión sin procesar y paginadas: la evidencia fechada detrás de la etapa de cada empresa, con la fuente y la URL de evidencia. operationId: expansions_signals_search requestBody: required: false content: application/json: schema: type: object properties: domain_search_ids: type: array description: Empresas a las que restringir, por `domain_search_id`. items: type: string example: - 8f3c1b04-2e7a-4d19-9c55-6ab21f0e7d3c is_active: type: boolean description: >- Devuelve solo señales activas (`true`) o solo las retractadas (`false`). Omite el parámetro para obtener ambas. example: true country_codes: type: array description: >- Mercados objetivo a los que restringir, como códigos ISO 3166-1 alfa-2. items: type: string example: - US - GB signal_types: allOf: - $ref: '#/components/schemas/expansion_signal_type_slugs' description: >- Tipos de señal a los que restringir. Los valores desconocidos no coinciden con nada. signal_subtypes: allOf: - $ref: '#/components/schemas/expansion_signal_subtype_slugs' description: >- Subtipos de señal a los que restringir. Los valores desconocidos no coinciden con nada. signal_strengths: allOf: - $ref: '#/components/schemas/signal_strengths' description: >- Intensidades de señal a las que restringir. Los valores desconocidos no coinciden con nada. source_types: type: array items: type: string description: >- Tipos de fuente a los que restringir: `jobs`, `ads`, `linkedin`, `news`, `pubrio`. example: - jobs - ads polarities: type: array items: type: string enum: - expansion - contraction_leading - contraction_confirming - contraction_lagging description: >- Direcciones de señal a incluir. `expansion` marca la entrada y el crecimiento; los valores `contraction_*` marcan el retroceso. example: - expansion event_dates: $ref: '#/components/schemas/event_dates' page: $ref: '#/components/schemas/page' per_page: $ref: '#/components/schemas/per_page' responses: '200': description: Búsqueda de señales de expansión content: application/json: schema: type: object properties: metadata: type: object description: Reflejo de los filtros aplicados a esta solicitud. data: type: object description: Contenedor de resultados. properties: pagination: type: object description: >- Página, elementos por página, total de entradas y total de páginas. signals: type: array description: >- Las filas de señales coincidentes, de más reciente a más antigua. items: type: object properties: expansion_signal_id: type: integer description: Identificador único de esta fila de señal. domain_search_id: type: string format: uuid description: >- La empresa a la que pertenece esta señal. Úsalo con [Company Expansion Detail](/es/api-reference/endpoint/expansions/company_lookup). country_code: type: string description: >- Mercado objetivo en el que se observó esta señal, como código ISO 3166-1 alfa-2. signal_type_slug: type: string description: >- Tipo de señal. Uno de los 17 slugs devueltos por [Expansion Reference](/es/api-reference/endpoint/expansions/types). signal_subtype_slug: type: string nullable: true description: >- Subtipo más específico, o `null` cuando el tipo no tiene subtipo. Alrededor del 44% de las filas son `null`. signal_strength_slug: type: string description: >- Intensidad de la señal: `low`, `medium`, `high` o `very_high`. polarity: type: string description: >- Dirección de la señal: `expansion`, o uno de los tres valores `contraction_*`. event_date: type: string format: date-time description: >- Cuándo ocurrió el evento subyacente. Interprétalo junto con `event_date_precision`. event_date_precision: type: string description: >- Qué tan precisa es `event_date`: `day`, `month`, `quarter`, `year` o `unknown`. source_type: type: string description: >- De dónde proviene la señal. Valores observados: `jobs`, `ads`, `linkedin`, `news`, `pubrio`. source_record_id: type: string nullable: true description: >- Identificador del registro de origen del que se derivó la señal, cuando existe uno. display_label: type: string description: >- Resumen de una línea de la señal, legible para humanos. evidence_url: type: string nullable: true description: >- Enlace a la evidencia de respaldo. Con frecuencia es `null`: la mayoría de las filas se derivan de fuentes estructuradas en lugar de una página citable. metadata: type: object description: >- Detalle específico de la fuente. Sus claves varían según `source_type`: las filas de empleo incluyen `departments`, `seniority`, `top_titles`, `active_postings`; las filas de anuncios incluyen `advertisement_format`, `headline`, `share_pct`. extraction_confidence: type: number nullable: true description: >- Confianza del modelo para señales extraídas por un modelo; en caso contrario, `null`. extraction_model: type: string nullable: true description: >- Nombre del modelo de extracción, cuando se utilizó uno. is_active: type: boolean description: >- `true` para señales activas, `false` una vez que una señal ha sido retractada. notes: type: string nullable: true description: Anotación de texto libre. Normalmente es `null`. created_at: type: string format: date-time description: Cuándo se creó la fila de señal. last_modified: type: string format: date-time description: >- Cuándo se actualizó por última vez la fila de señal. source_published_at: type: string format: date-time nullable: true description: >- Fecha y hora de publicación del documento de origen, cuando se conoce. lead_time_days: type: integer nullable: true description: >- Días transcurridos entre la publicación de la fuente y la fecha del evento, cuando ambas se conocen. occurs_at: type: string format: date-time nullable: true description: >- Inicio de la ventana que cubre la señal, para señales que abarcan un período. occurs_until: type: string format: date-time nullable: true description: >- Fin de la ventana que cubre la señal, para señales que abarcan un período. audit: type: object description: >- Procedencia de la fila: `profile_id` y `user_id` se establecen para señales importadas por el usuario, `import_id` agrupa una importación masiva, y `is_backfill` marca las filas agregadas mediante una carga retroactiva histórica. 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: >- Filtra a tipos de señal específicos. Consulta el catálogo de tipos de señal en la base de conocimientos para las definiciones y niveles (`DNS` e `INFRA` son señales de nivel 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: >- Filtra por nivel de confianza de la evidencia: `low`, `medium` o `high`. Ten en cuenta que esto es distinto del `signal_strength_slug` por señal que devuelven los registros de señales (que va de `low` a `very_high`); cualquier otro valor aquí no coincide con nada. event_dates: type: array items: type: string example: - '2026-06-01' - '2026-06-30' description: >- Intervalo de fechas del evento de la señal. El valor máximo es el día actual. page: type: integer example: 1 default: 1 description: >- Número de página, empezando en 1. El límite es el `max_search_page` de tu suscripción (`max_company_search_page` para la búsqueda de empresas), devuelto por [Perfil](/es/api-reference/endpoint/profile/profile). Superarlo devuelve **HTTP 416**. per_page: type: integer example: 25 default: 25 maximum: 25 description: >- Registros por página. Por defecto es 25, que también es el límite en la mayoría de los planes — el límite es el `max_search_per_page` de tu suscripción, devuelto por [Perfil](/es/api-reference/endpoint/profile/profile). Superarlo devuelve **HTTP 416** con el código `41676` (o `41613` en la búsqueda de empresas y personas), no un conjunto de resultados recortado. 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 ````