MCP de HG Insights (versión preliminar)

El servidor MCP de HG Insights proporciona a los agentes de inteligencia artificial acceso unificado y en tiempo real a datos, señales y inteligencia contextual B2B de alta calidad para impulsar flujos de trabajo automatizados, enriquecimiento y go-to-toma de decisiones del mercado.

Este conector está disponible en los siguientes productos y regiones:

Service	Class	Regions
Copilot Studio	Premium	Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD)
Aplicaciones lógicas	Estándar	Todas las regiones de Logic Apps excepto las siguientes: - regiones de Azure Government - Regiones de Azure China - Departamento de Defensa de EE. UU. (DoD)
Power Apps	Premium	Todas las regiones de Power Apps excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD)
Power Automate	Premium	Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD)

Contacto
Name	Información de HG
URL	https://phoenix.hginsights.com
Correo electrónico	[email protected]

Metadatos del conector
Publicador	Información de HG
Sitio web	https://phoenix.hginsights.com/docs
Directiva de privacidad	https://hginsights.com/privacy-page/
Categories	IA; Business Intelligence

{\rtf1\ansi\ansicpg1252\cocoartf2870 \cocoatextscaling0\cocoaplatform0{\fonttbl\f0\fswiss\fcharset0 Helvetica;} {\colortbl;\red255\green255\blue255;} {*\expandedcolortbl;;;} \margl1440\margr1440\vieww34360\viewh20320\viewkind0 \pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\pardirnatural\partightenfactor0

\f0\fs24 \cf0 # HG Insights Connect

HG Insights Connect proporciona a los agentes de inteligencia artificial acceso unificado y en tiempo real a datos B2B de HG Insights, señales e inteligencia contextual para admitir flujos de trabajo automatizados, enriquecimiento y go-to-market decision-decision.
\

Publisher\

Información de HG
\

Connector\

Información de HG
\

Solución\

Información de HG
\

Archivos de solución incluidos\

HGInsights_1_0_0_1_managed.zip\

Solución administrada que contiene el conector personalizado de HG Insights.
\

HGInsights_1_0_0_2_managed.zip\

Solución administrada que contiene el conector personalizado de HG Insights y el flujo de trabajo de validación.
\

Flujo de trabajo de validación\

El flujo de trabajo de validación incluido consta de:
\

Desencadenador manual\
Finalizar control

Este flujo de trabajo de validación se incluye únicamente para Microsoft validación de la certificación del conector.
\

Punto de conexión de MCP\

Punto de conexión de OpenAPI de MCP de producción:

https://phoenix.hginsights.com/api/powerautomate/mcp-openapi.json\ \

Autenticación\

El conector usa la autenticación de clave de API a través del x-api-key encabezado .
\

Vínculos legales\

Términos de servicio\

https://hginsights.com/terms-of-service/\ \

Directiva de privacidad\

https://hginsights.com/privacy-page/\ \

Documentación\

https://phoenix.hginsights.com/docs\ \

Soporte técnico\

[email protected]
\

Versión\

1.0.0
\

Notas\

HG Insights Connect es un conector de Protocolo de contexto de modelo (MCP) que proporciona a los agentes de INTELIGENCIA ARTIFICIAL acceso al contexto empresarial de HG Insights, la inteligencia firmográfica, la inteligencia tecnológica y las conclusiones B2B relacionadas.

Las exportaciones de soluciones administradas incluidas contienen:
\

Exportación solo de conector (HGInsights_1_0_0_1_managed.zip)\
Un conector más la exportación del flujo de trabajo de validación (HGInsights_1_0_0_2_managed.zip)

Estos artefactos se proporcionan de acuerdo con Microsoft requisitos de envío de certificación.

La especificación MCP OpenAPI se ha actualizado para abordar Microsoft comentarios de certificación, entre los que se incluyen:
\

Título del conector actualizado a HG Insights Connect\
Resumen de operaciones de MCP actualizado a HG Insights Connect\
Descripción de la operación requerida agregada al punto de /mcp conexión\
Esquema de respuesta agregado a la respuesta HTTP 200\
Categoría de metadatos del conector actualizada a AI}

Creación de una conexión

El conector admite los siguientes tipos de autenticación:


Predeterminado	Parámetros para crear una conexión.	Todas las regiones	No se puede compartir

Predeterminado

Aplicable: Todas las regiones

Parámetros para crear una conexión.

Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.

Name	Type	Descripción	Obligatorio
Clave de API	securestring	La clave de API de esta API	True

Limitaciones

Nombre	Llamadas	Período de renovación
Llamadas API por conexión	100	60 segundos

Acciones

Buscar archivos de SEC texto completo	Busque contenido de archivo sec para ver términos o frases específicos. Admite operadores booleanos (AND, OR, NOT), caracteres comodín (), y coincidencia exacta de frases ("entre comillas"). Use para buscar archivos que mencionen temas, riesgos o eventos específicos. EJEMPLOS DE CONSULTA: "debilidad material" - Buscar frase exacta ciberseguridad Y incumplimiento: ambos términos necesarios layoff - Coincidencia de caracteres comodín (desaso, despido, etc.) "va a preocuparse" O "duda sustancial" - Cualquiera de las frases adquisición NO fusión: término de exclusión CASOS DE USO COMUNES: Supervisión de riesgos: "debilidad material", "preocupación en marcha" Incidentes cibernéticos: "incidente de ciberseguridad", "vulneración de datos" Actividad de M&A: adquisición, fusión, "cambio de control" Reestructuración: despido*, "reducción de la mano de obra", reestructuración Cambios de liderazgo: "director ejecutivo", "junta directiva"
Buscar contactos en una empresa	Busque contactos en una empresa por título, antigüedad y ubicación. Admite proveedores de Apollo y ZoomInfo (seleccionados automáticamente en función de la configuración de la organización). Devuelve información de contacto básica (nombre, título, LinkedIn). GRATIS: no usa créditos. REGLAS IMPORTANTES: 1) Combine TODAS las variaciones de título en una llamada mediante matrices (por ejemplo, personTitles: ['VP Marketing', 'CMO', 'Head of Marketing']). 2) NO realice llamadas independientes para cada título: use una búsqueda con todos los títulos combinados. 3) Si una búsqueda devuelve 0 resultados, STOP - no vuelva a intentar con variaciones de título diferentes. Informe de "no se encontraron coincidencias" al usuario. 4) Número máximo de 2 búsquedas por solicitud de usuario (búsqueda inicial + paginación opcional). Use contact_enrich para obtener correo electrónico o teléfono para obtener las mejores coincidencias.
Buscar contratos federales	Buscar USAspending.gov para obtener premios de contratos federales de Estados Unidos. Filtre por agencia, código NAICS, código PSC, palabras clave, intervalo de valores de contrato, intervalo de fechas y tipo de reserva para pequeñas empresas. Devuelve los detalles del contrato, incluidos el destinatario, el importe de la obligación y la ubicación del rendimiento. Requiere que se configure la integración de SAM.gov (Data.gov).
Buscar empresas por tema de intención	Busque empresas que muestren la intención de un tema, proveedor o producto. Devuelve señales de intención de comprador combinadas de HG + TrustRadius con intensidad de señal (0-100), niveles de intención, fases de recorrido del comprador y tipos de contexto. Use list_intent_topics para detectar primero los temas disponibles.
Buscar oportunidades federales	Buscar SAM.gov para solicitudes federales abiertas (RFP, RFQs, solicitudes previas, orígenes buscados). Filtre por palabras clave, código NAICS, código PSC, agencia, tipo de reserva, fecha de publicación y fecha límite de respuesta. Devuelve los detalles de la oportunidad, incluidos el título, la agencia, la fecha límite y el vínculo de SAM.gov directo. Requiere que se configure la integración de SAM.gov (Data.gov).
Enriquecer un contacto con correo electrónico y teléfono	Enriquecer contactos con detalles completos: correo electrónico, teléfono, perfiles sociales, historial de empleo. Admite proveedores de Apollo y ZoomInfo (seleccionados automáticamente en función de la configuración de la organización). USA CRÉDITOS. Use contact_search primero para buscar contactos (gratis) y luego enriquecer las mejores coincidencias. Acepta el identificador de contacto (más preciso), el nombre + la empresa o hasta 25 contactos para el enriquecimiento masivo. Especifique el proveedor para establecer como destino el mismo proveedor usado en la búsqueda.
Enumerar atributos de producto	Buscar o enumerar atributos de producto del catálogo oficial de HG Insights. Los atributos del producto describen características tecnológicas como el modelo de implementación (basado en la nube, local), licencias (código abierto, empresa) y otras características. Use el parámetro "query" para fuzzy-search atributos por nombre (recomendado). IMPORTANTE: Al filtrar por atributos de producto, use siempre esta herramienta para buscar el nombre exacto del atributo, nunca adivinar o aproximarse.
Enumerar categorías de productos	Buscar o enumerar categorías de productos del catálogo oficial de HG Insights. Devuelve la estructura de categorías jerárquica con identificadores, nombres y árboles de categoría. Use el parámetro "query" para las categorías de búsqueda aproximada por nombre (recomendado). Use "parentId" para navegar por la jerarquía de categorías. IMPORTANTE: Al filtrar tecnologías de la empresa por categoría, use siempre esta herramienta para buscar el nombre exacto de la categoría, nunca adivinar o aproximarse.
Obtención de la sección de presentación de SEC	Extraiga secciones específicas de las presentaciones SEC 10-K, 10-Q o 8-K. Devuelve texto limpio optimizado para el análisis. GUÍA DE ASIGNACIÓN DE SECCIONES: Para preguntas sobre: 10-K INFORMES ANUALES: Información general de la empresa, productos, mercados, estrategia → "1" (Negocio) Riesgos, desafíos, incertidumbres, amenazas → "1A" (factores de riesgo) Discusión sobre el rendimiento financiero, tendencias → "7" (MD&A) Pago ejecutivo, opciones de acciones, bonos → "11" (Compensación ejecutiva) Miembros del consejo, equipo directivo → "10" (Directores y Oficiales) Cuestiones legales, demandas, litigios → "3" (procedimientos legales) Propiedades, instalaciones, bienes raíces → "2" (Propiedades) 10-Q INFORMES TRIMESTRALES: Análisis trimestral de rendimiento → "part1item2" (MD&A) Se han actualizado los factores de riesgo → "part2item1a" (factores de riesgo) Estados financieros trimestrales → "part1item1" (Estados Financieros) EVENTOS ACTUALES DE 8 K: Cambios de director general/director financiero, salidas ejecutivas → "5.02" (Cambios oficiales) Anuncios de ganancias, resultados trimestrales → "2.02" (Resultados de operaciones) Actividad de M&A, adquisiciones, desintegros → "2.01" (Adquisición/Disposición) Infracciones de ciberseguridad, incidentes → "1.05" (incidente de ciberseguridad) Nuevos contratos, asociaciones importantes → "1.01" (Acuerdo material) Terminación del contrato → "1.02" (Terminación del Contrato) Solicitudes de quiebra → "1.03" (Quiebra) Cambios de auditor → "4.01" (Cambios contables) Avisos de deslistación de existencias → "3.01" (Aviso de deslistación)
Obtención del gasto de TI de la empresa	Recupere los datos de gasto de TI de HGInsights para una empresa específica. Proporcione un dominio de empresa (por ejemplo, "cisco.com") o un identificador de empresa de HG Insights (hg_id, por ejemplo, "0FF69D9F596504A1FF4FF5B16FF"). Si se proporcionan ambos, hg_id tiene prioridad. Devuelve importes de gasto detallados por categoría y geografía, con formato de moneda y jerarquías de categorías para la inteligencia de ventas y el análisis de mercado.
Obtener company Firmographics	Recupere información empresarial completa sobre empresas como el sector, el recuento de empleados, los ingresos, la ubicación y las tecnologías. Proporcione un dominio de empresa (por ejemplo, "cisco.com") o un identificador de empresa (hg_id) de HG Insights. Si se proporcionan ambos, hg_id tiene prioridad.
Obtener información del proveedor	Busque proveedores de tecnología desde el catálogo de HG Insights. Cuando se proporciona vendorName, realiza una búsqueda aproximada y devuelve proveedores coincidentes con sus identificadores de producto: use estos identificadores con los parámetros productIds o vendorIds de company_technographic para comprobar si una empresa usa las tecnologías de ese proveedor. Cuando se omite vendorName, devuelve el catálogo de proveedores completo para la detección. SUGERENCIA: Para comprobar si una empresa usa un proveedor específico, llame primero a esta herramienta para obtener el identificador del proveedor y, a continuación, llame a company_technographic con el parámetro vendorIds.
Obtener oportunidades federales de la compañía	Busque solicitudes federales abiertas en las que una empresa específica sea el contratista titular o un licitador probable en función de sus códigos NAICS y la cartera de contratos existente. Resuelve la empresa a través de SAM.gov y, a continuación, busca oportunidades de coincidencia. Requiere que se configure la integración de SAM.gov (Data.gov).
Obtener relaciones federales de la compañía	Mostrar relaciones de primo/subcontratista para una empresa de datos federales subbaward. Revela qué empresas tienen equipos potenciales en ofertas gubernamentales, incluidos los recuentos de contratos y los valores totales de subaward. Datos procedentes de USAspending.gov registros subbaward. Requiere que se configure la integración de SAM.gov (Data.gov).
Obtener resumen de investigación de la empresa	Investigación completa de la empresa que agrega señales firmográficas, tecnográficas, gastos de TI, gasto en la nube, señales de intención, contratos y señales operativas en un único panel interactivo. Proporcione un dominio de empresa (por ejemplo, "cisco.com") o un identificador de empresa (hg_id) de HG Insights. Requiere menos llamadas API que consultar cada herramienta individualmente.
Obtener serie temporal de instalación de la empresa	Obtener datos de series temporales de intensidad de instalación para el uso de la tecnología de una empresa. Devuelve valores de intensidad mensuales (escala de 0 a 100) para cada producto a lo largo del tiempo. Use para responder a preguntas de tendencia como "¿Cómo ha cambiado el uso de Snowflake de Cisco en los últimos 2 años?". Filtre por productos, proveedores o categorías. Cada producto incluye current_intensity, intensity_momentum (positivo = crecimiento) y is_active estado. Los productos se ordenan por intensidad actual (descendente) cuando no se aplica ningún filtro. Los resultados vacíos significan que no se encontraron productos coincidentes para los filtros especificados.
Obtener señales de intención del comprador de la empresa	Obtenga una visión general general de las señales de intención para una empresa específica. Proporcione un dominio de empresa (por ejemplo, "cisco.com") o un identificador de empresa (hg_id) de HG Insights. Devuelve los principales temas de intención por puntuación con datos de intención de compradores de HG combinados + TrustRadius, como: puntuaciones de temas, niveles de intención, fases de recorrido del comprador, disposiciones de contexto para la inteligencia competitiva (por ejemplo, señales de desplazamiento) y actividades de comprador TrustRadius. Use vendor_name para la inteligencia competitiva (por ejemplo, "¿Es prudente mirar a los competidores de Snowflake?"). NOTA: Para consultas específicas del tema (por ejemplo, "¿Caterpillar muestra la intención para Siemens Teamcenter?"), use intent_category con el topic_name en su lugar, company_intent devuelve los temas principales por puntuación y puede perder temas específicos para empresas con muchas señales activas.
Obtener señales operativas de la empresa	Recupere las señales operativas de la empresa combinando atributos derivados de menciones (work_model, cloud_posture, esg_commitment, iot_posture, network_modernization, automation_stage) y atributos de madurez de GenAI (ai_trajectory, cloud_depth, genai_readiness, intent_adoption_gap). Proporcione un dominio de empresa (por ejemplo, "cisco.com") o un identificador de empresa (hg_id) de HG Insights.
Obtener tecnografías de la empresa	FLUJO DE TRABAJO REQUERIDO: siga estos pasos antes de llamar a esta herramienta: Para comprobar un proveedor o producto ESPECÍFICO: llame a get_vendor_information primero → pase los vendorIds/productIds devueltos aquí. Para filtrar por categoría: llame a list_product_categories primero → pase aquí el nombre exacto de la categoría. Para una pila técnica sin filtrar completa: llame a esta herramienta directamente sin filtros. Si se omite el paso 1 o 2, se pierden los resultados (por ejemplo, Snowflake se encuentra en "Administración de bases de datos", no en "Almacenamiento de datos"). Obtener datos tecnográficos (uso de tecnología) para una empresa por dominio. Devuelve las tecnologías instaladas con productId (numérico), proveedor, intensidad de uso y fechas de comprobación. Use los valores productId de los resultados al llamar a company_fai para búsquedas precisas. Filtre por "categorías" para el filtrado basado en categorías o por "vendorIds"/"productIds" para el filtrado exacto de proveedores o productos (preferido para búsquedas de proveedores específicas). Las solicitudes sin filtrar de gran tamaño se pueden truncar. Límite predeterminado: 50. Los resultados vacíos significan que no se encontraron datos para los filtros especificados; no diga que la herramienta carece de funcionalidad. Proporcione un dominio de empresa (por ejemplo, "cisco.com") o un identificador de empresa (hg_id) de HG Insights. Si se proporcionan ambos, hg_id tiene prioridad.
Temas de intención de lista	Temas de búsqueda o de intención de lista del catálogo oficial de HG Insights. Los temas de intención representan señales de compra y áreas de investigación que indican qué tecnologías están investigando o planeando comprar activamente las empresas. Use el parámetro "query" para fuzzy-search topics por nombre (recomendado para evitar resultados abrumadores). Use 'category' para filtrar por categoría de tema. IMPORTANTE: Al recomendar temas de intención, use siempre esta herramienta para buscar identificadores y nombres de temas reales, nunca adivinarlos ni fabricarlos.

Buscar archivos de SEC texto completo

Id. de la operación:: SecFullTextSearch

Busque contenido de archivo sec para ver términos o frases específicos. Admite operadores booleanos (AND, OR, NOT), caracteres comodín (*), y coincidencia exacta de frases ("entre comillas"). Use para buscar archivos que mencionen temas, riesgos o eventos específicos.

EJEMPLOS DE CONSULTA:

"debilidad material" - Buscar frase exacta
ciberseguridad Y incumplimiento: ambos términos necesarios
layoff* - Coincidencia de caracteres comodín (desaso, despido, etc.)
"va a preocuparse" O "duda sustancial" - Cualquiera de las frases
adquisición NO fusión: término de exclusión

CASOS DE USO COMUNES:

Supervisión de riesgos: "debilidad material", "preocupación en marcha"
Incidentes cibernéticos: "incidente de ciberseguridad", "vulneración de datos"
Actividad de M&A: adquisición, fusión, "cambio de control"
Reestructuración: despido*, "reducción de la mano de obra", reestructuración
Cambios de liderazgo: "director ejecutivo", "junta directiva"

Parámetros

Nombre	Clave	Requerido	Tipo	Description
query	query	True	string
filingTypes	filingTypes		array of string	Límite a tipos de formulario específicos (por ejemplo, ["10-K", "8-K"])
tickers	tickers		array of string	Límite de tics específicos de la empresa
startDate	startDate		string	Fecha de inicio (AAAA-MM-DD). El valor predeterminado es hace 30 días.
fecha de finalización	endDate		string	Fecha de finalización (AAAA-MM-DD). El valor predeterminado es hoy.
limit	limit		number	Resultados máximos (máximo 100)

Devoluciones

Body: SecFullTextSearchResponse

Buscar contactos en una empresa

Id. de la operación:: ContactSearch

Busque contactos en una empresa por título, antigüedad y ubicación. Admite proveedores de Apollo y ZoomInfo (seleccionados automáticamente en función de la configuración de la organización). Devuelve información de contacto básica (nombre, título, LinkedIn). GRATIS: no usa créditos. REGLAS IMPORTANTES: 1) Combine TODAS las variaciones de título en una llamada mediante matrices (por ejemplo, personTitles: ['VP Marketing', 'CMO', 'Head of Marketing']). 2) NO realice llamadas independientes para cada título: use una búsqueda con todos los títulos combinados. 3) Si una búsqueda devuelve 0 resultados, STOP - no vuelva a intentar con variaciones de título diferentes. Informe de "no se encontraron coincidencias" al usuario. 4) Número máximo de 2 búsquedas por solicitud de usuario (búsqueda inicial + paginación opcional). Use contact_enrich para obtener correo electrónico o teléfono para obtener las mejores coincidencias.

Parámetros

Nombre	Clave	Tipo	Description
companyDomain	companyDomain	string
companyName	companyName	string	Nombre de la empresa para la búsqueda aproximada (por ejemplo, "Salesforce"). Use companyDomain siempre que sea posible.
personTitles	personTitles	array of string	Títulos de trabajo para filtrar por (por ejemplo, ["VP Marketing", "Head of Marketing"]). Admite varios títulos.
personSeniorities	personSeniorities	array of string	Niveles de antigüedad: propietario, fundador, c_suite, partner, vp, head, director, gerente, senior, entrada, internado
personLocations	personLocations	array of string	Ubicaciones de personas (por ejemplo, ["California, EE. UU.", "New York, US"])
organizationLocations	organizationLocations	array of string	Filtrar por ubicación de la sede central de la empresa
organizationNumEmployeesRanges	organizationNumEmployeesRanges	array of string	Intervalos de recuento de empleados (por ejemplo, ["1,10", "11,50", "51,200"])
contactEmailStatus	contactEmailStatus	array of string	Filtrar por estado de correo electrónico: comprobado, no comprobado, likely_to_engage, no disponible
página	page	integer	Número de página para la paginación (valor predeterminado: 1)
perPage	perPage	integer	Resultados por página (valor predeterminado: 25, máximo: 100)
provider	provider	string	Póngase en contacto con el proveedor de datos para usarlo. Use "auto" para la selección automática, "apollo" para Apollo o "zoominfo" para ZoomInfo.

Devoluciones

Body: ContactSearchResponse

Buscar contratos federales

Id. de la operación:: SearchFederalContracts

Buscar USAspending.gov para obtener premios de contratos federales de Estados Unidos. Filtre por agencia, código NAICS, código PSC, palabras clave, intervalo de valores de contrato, intervalo de fechas y tipo de reserva para pequeñas empresas. Devuelve los detalles del contrato, incluidos el destinatario, el importe de la obligación y la ubicación del rendimiento. Requiere que se configure la integración de SAM.gov (Data.gov).

Parámetros

Nombre	Clave	Tipo	Description
recipientName	recipientName	string	Nombre de la compañía o destinatario para buscar (coincidencia parcial)
recipientUei	recipientUei	string	Identificador exacto de entidad única (UEI) del destinatario
awardingAgency	awardingAgency	string	Adjudicación del nombre de la agencia, por ejemplo, "Departamento de Defensa"
naicsCode	naicsCode	string	Código NAICS para filtrar por, por ejemplo, "541512" para el diseño de sistemas informáticos
pscCode	pscCode	string	Código de producto o servicio para filtrar por, por ejemplo, "D310" para los servicios de TI
palabras clave	keywords	string	Palabras clave para buscar en descripciones del contrato
minAmount	minAmount	number	Importe mínimo de la obligación del contrato en USD
maxAmount	maxAmount	number	Importe máximo de la obligación del contrato en USD
startDateAfter	startDateAfter	string	Solo los contratos que comienzan después de esta fecha (formato ISO, por ejemplo, "2024-01-01")
startDateBefore	startDateBefore	string	Solo los contratos que comienzan antes de esta fecha (formato ISO)
setAsideType	setAsideType	string	Código de tipo de reserva para pequeñas empresas (por ejemplo, "SBA" para pequeñas empresas)
limit	limit	number	Número máximo de resultados que se van a devolver (1-100, valor predeterminado: 50)
offset	offset	number	Número de resultados que se omitirán para la paginación (valor predeterminado: 0)
ordenarPor	sortBy	string	Ordenar los resultados por "amount" o "date" (valor predeterminado: "amount")
sortOrder	sortOrder	string	Criterio de ordenación: "asc" o "desc" (valor predeterminado: "desc")

Devoluciones

Body: SearchFederalContractsResponse

Buscar empresas por tema de intención

Id. de la operación:: IntentCategory

Busque empresas que muestren la intención de un tema, proveedor o producto. Devuelve señales de intención de comprador combinadas de HG + TrustRadius con intensidad de señal (0-100), niveles de intención, fases de recorrido del comprador y tipos de contexto. Use list_intent_topics para detectar primero los temas disponibles.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
topic_name	topic_name	True	string	Tema o categoría para buscar empresas que muestren la intención (por ejemplo, "Siemens Teamcenter", "cloud security", "ERP"). Servidor con coincidencia aproximada. REQUIRED: use list_intent_topics para detectar temas disponibles.
vendor_name	vendor_name		string	Filtre por nombre de proveedor (por ejemplo, "Snowflake, Inc."). Limita los resultados a las señales de intención relacionadas con este proveedor.
product_name	product_name		string	Filtre por nombre de producto (por ejemplo, "Salesforce Sales Cloud"). Limita los resultados a las señales de intención relacionadas con este producto.
intent_level	intent_level		string	Filtre por nivel de intención.
buyers_journey	buyers_journey		string	Filtre por fase de recorrido del comprador.
context_type	context_type		string	Filtre por tipo de contexto (por ejemplo, "Espacio en blanco", "Expansión", "Desplazamiento").
source	source		string	Filtre por origen de datos. Omita incluir señales HG y TrustRadius.
start_date	start_date		string	Fecha de inicio en formato aaaa-MM-DD. El valor predeterminado es hace 30 días.
end_date	end_date		string	Fecha de finalización en formato aaaa-MM-DD. El valor predeterminado es hoy.
maxResults	maxResults		integer	Número máximo de empresas a devolver (1-200, valor predeterminado 50). Se usa en el modo de intención.
señal	signal		string	Filtre por categoría de señal. Activa el modo de búsqueda de actividad. Valores: comparación (ver comparación, hacer clic en Comparaciones), precios (ver precios del producto), investigación (ver lista de productos, ver categoría), evaluación (ver revisión, ver opiniones y clasificaciones).
products	products		array of string	Matriz de nombres de producto con lógica AND: devuelve solo empresas o eventos que coinciden con TODOS los productos (por ejemplo, ["Databricks", "Snowflake Platform"]). Activa el modo de búsqueda de actividad.
employees_range	employees_range		string	Filtro de intervalo de empleados (por ejemplo, "10,000+", "1,001-5,000", "201-500").
country_codes	country_codes		array of string	Filtro de código de país ISO (por ejemplo, ["US", "GB"]).
category_name	category_name		string	Filtre por nombre de categoría de producto.
agrupar por	group_by		string	"company" para los datos agregados de la empresa, omita para eventos individuales sin procesar con direcciones URL de evidencia. Activa el modo de búsqueda de actividad.
limit	limit		integer	Límite de paginación (1-200). Invalida maxResults cuando se proporciona. Se usa en ambos modos.
offset	offset		integer	Desplazamiento de paginación (valor predeterminado 0). Se usa en ambos modos.

Devoluciones

El modo de intención devuelve contexto, empresas o paginación. El modo de búsqueda de actividad devuelve empresas (group_by=company) o eventos (modo sin procesar) con paginación.

Body: IntentCategoryResponse

Buscar oportunidades federales

Id. de la operación:: SearchGovOpportunities

Buscar SAM.gov para solicitudes federales abiertas (RFP, RFQs, solicitudes previas, orígenes buscados). Filtre por palabras clave, código NAICS, código PSC, agencia, tipo de reserva, fecha de publicación y fecha límite de respuesta. Devuelve los detalles de la oportunidad, incluidos el título, la agencia, la fecha límite y el vínculo de SAM.gov directo. Requiere que se configure la integración de SAM.gov (Data.gov).

Parámetros

Nombre	Clave	Tipo	Description
palabras clave	keywords	string	Palabras clave para buscar en títulos de oportunidad
naicsCode	naicsCode	string	Código NAICS para filtrar por, por ejemplo, "541512" para el diseño de sistemas informáticos
pscCode	pscCode	string	Código de clasificación de producto/servicio
agencia	agency	string	Nombre de la agencia de adjudicación
setAsideType	setAsideType	string	Tipo de reserva para pequeñas empresas
postedAfter	postedAfter	string	Solo oportunidades publicadas después de esta fecha (formato ISO, por ejemplo, "2025-01-01")
postedBefore	postedBefore	string	Solo las oportunidades publicadas antes de esta fecha (formato ISO)
responseDeadlineAfter	responseDeadlineAfter	string	Solo oportunidades con fecha límite de respuesta después de esta fecha (formato ISO)
responseDeadlineBefore	responseDeadlineBefore	string	Solo oportunidades con fecha límite de respuesta antes de esta fecha (formato ISO)
opportunityType	opportunityType	string	Tipo de oportunidad para buscar
activeOnly	activeOnly	boolean	Mostrar solo oportunidades activas o abiertas (valor predeterminado: true)
limit	limit	number	Número máximo de resultados que se van a devolver (1-100, valor predeterminado: 25)
offset	offset	number	Número de resultados que se omitirán para la paginación (valor predeterminado: 0)

Devoluciones

Body: SearchGovOpportunitiesResponse

Enriquecer un contacto con correo electrónico y teléfono

Id. de la operación:: ContactEnrich

Enriquecer contactos con detalles completos: correo electrónico, teléfono, perfiles sociales, historial de empleo. Admite proveedores de Apollo y ZoomInfo (seleccionados automáticamente en función de la configuración de la organización). USA CRÉDITOS. Use contact_search primero para buscar contactos (gratis) y luego enriquecer las mejores coincidencias. Acepta el identificador de contacto (más preciso), el nombre + la empresa o hasta 25 contactos para el enriquecimiento masivo. Especifique el proveedor para establecer como destino el mismo proveedor usado en la búsqueda.

Parámetros

Nombre	Clave	Tipo	Description
contactId	contactId	string	Identificador de contacto de los resultados de contact_search. Método más preciso.
firstName	firstName	string
lastName	lastName	string
email	email	email	Dirección de correo electrónico del contacto (si se conoce)
companyDomain	companyDomain	string
companyName	companyName	string	Nombre del empleador actual
linkedinUrl	linkedinUrl	uri	LinkedIn dirección URL del perfil para buscar coincidencias
id	id	string	Identificador de contacto (de contact_search resultados)
firstName	firstName	string	Nombre del contacto
lastName	lastName	string	Apellidos del contacto
email	email	email	Correo electrónico del contacto (si se conoce)
companyDomain	companyDomain	string	Dominio actual del empleador (por ejemplo, "salesforce.com")
companyName	companyName	string	Nombre del empleador actual
linkedinUrl	linkedinUrl	uri	dirección URL del perfil de LinkedIn
revealEmail	revealEmail	boolean	Indica si se deben revelar direcciones de correo electrónico (valor predeterminado: true)
revealPhone	revealPhone	boolean	Indica si se deben revelar números de teléfono (valor predeterminado: true)
provider	provider	string	Póngase en contacto con el proveedor de datos para usarlo. Use "auto" para la selección automática, "apollo" para Apollo o "zoominfo" para ZoomInfo.

Devoluciones

Body: ContactEnrichResponse

Enumerar atributos de producto

Id. de la operación:: ListProductAttributes

Buscar o enumerar atributos de producto del catálogo oficial de HG Insights. Los atributos del producto describen características tecnológicas como el modelo de implementación (basado en la nube, local), licencias (código abierto, empresa) y otras características. Use el parámetro "query" para fuzzy-search atributos por nombre (recomendado). IMPORTANTE: Al filtrar por atributos de producto, use siempre esta herramienta para buscar el nombre exacto del atributo, nunca adivinar o aproximarse.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
query	query		string	Consulta de búsqueda aproximada para filtrar atributos por nombre (por ejemplo, "nube", "código abierto"). Devuelve las coincidencias más relevantes ordenadas por puntuación de relevancia.
limit	limit		number	Número máximo de resultados que se van a devolver. El valor predeterminado es 50 cuando se proporciona una consulta o todos los resultados cuando no se usan filtros.

Devoluciones

Body: ListProductAttributesResponse

Enumerar categorías de productos

Id. de la operación:: ListProductCategories

Buscar o enumerar categorías de productos del catálogo oficial de HG Insights. Devuelve la estructura de categorías jerárquica con identificadores, nombres y árboles de categoría. Use el parámetro "query" para las categorías de búsqueda aproximada por nombre (recomendado). Use "parentId" para navegar por la jerarquía de categorías. IMPORTANTE: Al filtrar tecnologías de la empresa por categoría, use siempre esta herramienta para buscar el nombre exacto de la categoría, nunca adivinar o aproximarse.

Parámetros

Nombre	Clave	Tipo	Description
query	query	string	Consulta de búsqueda aproximada para filtrar categorías por nombre (por ejemplo, "seguridad", "nube"). Devuelve las coincidencias más relevantes ordenadas por puntuación de relevancia.
parentId	parentId	string	Filtre para devolver solo elementos secundarios de este identificador de categoría principal. Use para navegar por la jerarquía.
limit	limit	number	Número máximo de resultados que se van a devolver. El valor predeterminado es 50 cuando se proporciona la consulta o parentId, o todos los resultados cuando no se usan filtros.

Devoluciones

Body: ListProductCategoriesResponse

Obtención de la sección de presentación de SEC

Id. de la operación:: SecFilingSection

Extraiga secciones específicas de las presentaciones SEC 10-K, 10-Q o 8-K. Devuelve texto limpio optimizado para el análisis.

GUÍA DE ASIGNACIÓN DE SECCIONES: Para preguntas sobre:

10-K INFORMES ANUALES:

Información general de la empresa, productos, mercados, estrategia → "1" (Negocio)
Riesgos, desafíos, incertidumbres, amenazas → "1A" (factores de riesgo)
Discusión sobre el rendimiento financiero, tendencias → "7" (MD&A)
Pago ejecutivo, opciones de acciones, bonos → "11" (Compensación ejecutiva)
Miembros del consejo, equipo directivo → "10" (Directores y Oficiales)
Cuestiones legales, demandas, litigios → "3" (procedimientos legales)
Propiedades, instalaciones, bienes raíces → "2" (Propiedades)

10-Q INFORMES TRIMESTRALES:

Análisis trimestral de rendimiento → "part1item2" (MD&A)
Se han actualizado los factores de riesgo → "part2item1a" (factores de riesgo)
Estados financieros trimestrales → "part1item1" (Estados Financieros)

EVENTOS ACTUALES DE 8 K:

Cambios de director general/director financiero, salidas ejecutivas → "5.02" (Cambios oficiales)
Anuncios de ganancias, resultados trimestrales → "2.02" (Resultados de operaciones)
Actividad de M&A, adquisiciones, desintegros → "2.01" (Adquisición/Disposición)
Infracciones de ciberseguridad, incidentes → "1.05" (incidente de ciberseguridad)
Nuevos contratos, asociaciones importantes → "1.01" (Acuerdo material)
Terminación del contrato → "1.02" (Terminación del Contrato)
Solicitudes de quiebra → "1.03" (Quiebra)
Cambios de auditor → "4.01" (Cambios contables)
Avisos de deslistación de existencias → "3.01" (Aviso de deslistación)

Parámetros

Nombre	Clave	Requerido	Tipo	Description
companyTicker	companyTicker	True	string
filingType	filingType	True	string
section	section	True	string
fiscalYear	fiscalYear		number	Año fiscal (por ejemplo, 2024). El valor predeterminado es la presentación más reciente.
fiscalQuarter	fiscalQuarter		number	Trimestre fiscal (1-4) para presentaciones de 10 Q
outputFormat	outputFormat		string	Formato de salida. El texto está limpio y optimizado para el análisis de LLM.

Devoluciones

Body: SecFilingSectionResponse

Obtención del gasto de TI de la empresa

Id. de la operación:: CompanySpend

Recupere los datos de gasto de TI de HGInsights para una empresa específica. Proporcione un dominio de empresa (por ejemplo, "cisco.com") o un identificador de empresa de HG Insights (hg_id, por ejemplo, "0FF69D9F596504A1FF4FF5B16FF"). Si se proporcionan ambos, hg_id tiene prioridad. Devuelve importes de gasto detallados por categoría y geografía, con formato de moneda y jerarquías de categorías para la inteligencia de ventas y el análisis de mercado.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
companyDomain	companyDomain	True	string
hg_id	hg_id		string	Identificador de empresa de HG Insights (32 caracteres alfanuméricos, por ejemplo, "0FF69D9F596504A1FF4FF5B16FF"). Cuando se proporciona, esto invalida companyDomain. Obtenga de un resultado de company_search anterior.
spendCategory	spendCategory		string	Categoría de gasto opcional para filtrar los resultados. Si no se proporciona, devuelve todas las categorías de gasto. Use la coincidencia aproximada en los nombres de categoría (por ejemplo, "Seguridad", "Software", "Nube").

Devoluciones

Body: CompanySpendResponse

Obtener company Firmographics

Id. de la operación:: CompanyFirmographic

Recupere información empresarial completa sobre empresas como el sector, el recuento de empleados, los ingresos, la ubicación y las tecnologías. Proporcione un dominio de empresa (por ejemplo, "cisco.com") o un identificador de empresa (hg_id) de HG Insights. Si se proporcionan ambos, hg_id tiene prioridad.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
companyDomain	companyDomain	True	string
hg_id	hg_id		string	Identificador de empresa de HG Insights (32 caracteres alfanuméricos). Cuando se proporciona, esto invalida companyDomain. Obtenga de un resultado de company_search anterior.
provider	provider		string	Proveedor que se va a usar para la búsqueda de datos. Use "auto" para la selección automática o especifique una clave de proveedor.

Devoluciones

Body: CompanyFirmographicResponse

Obtener información del proveedor

Id. de la operación:: GetVendorInformation

Busque proveedores de tecnología desde el catálogo de HG Insights. Cuando se proporciona vendorName, realiza una búsqueda aproximada y devuelve proveedores coincidentes con sus identificadores de producto: use estos identificadores con los parámetros productIds o vendorIds de company_technographic para comprobar si una empresa usa las tecnologías de ese proveedor. Cuando se omite vendorName, devuelve el catálogo de proveedores completo para la detección. SUGERENCIA: Para comprobar si una empresa usa un proveedor específico, llame primero a esta herramienta para obtener el identificador del proveedor y, a continuación, llame a company_technographic con el parámetro vendorIds.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
vendorName	vendorName		string	Nombre del proveedor que se va a buscar (con coincidencia aproximada). Ejemplo: "Anthropic", "OpenAI", "Salesforce". Cuando se proporciona, devuelve proveedores coincidentes con sus productos. Cuando se omite, devuelve todos los proveedores.

Devoluciones

Body: GetVendorInformationResponse

Obtener oportunidades federales de la compañía

Id. de la operación:: CompanyGovOpportunities

Busque solicitudes federales abiertas en las que una empresa específica sea el contratista titular o un licitador probable en función de sus códigos NAICS y la cartera de contratos existente. Resuelve la empresa a través de SAM.gov y, a continuación, busca oportunidades de coincidencia. Requiere que se configure la integración de SAM.gov (Data.gov).

Parámetros

Nombre	Clave	Requerido	Tipo	Description
companyDomain	companyDomain	True	string	Dominio de empresa que se va a buscar (por ejemplo, "boozallen.com")
includeIncumbentOnly	includeIncumbentOnly		boolean	Mostrar solo las oportunidades en las que la empresa es la titular (valor predeterminado: false)
daysUntilDeadline	daysUntilDeadline		number	Filtrar por fecha límite (por ejemplo, 90 = oportunidades de cierre en los próximos 90 días)
limit	limit		number	Número máximo de oportunidades para devolver (1-50, valor predeterminado: 25)

Devoluciones

Body: CompanyGovOpportunitiesResponse

Obtener relaciones federales de la compañía

Id. de la operación:: CompanyGovRelationships

Mostrar relaciones de primo/subcontratista para una empresa de datos federales subbaward. Revela qué empresas tienen equipos potenciales en ofertas gubernamentales, incluidos los recuentos de contratos y los valores totales de subaward. Datos procedentes de USAspending.gov registros subbaward. Requiere que se configure la integración de SAM.gov (Data.gov).

Parámetros

Nombre	Clave	Requerido	Tipo	Description
companyDomain	companyDomain	True	string	Dominio de empresa que se va a buscar (por ejemplo, "palantir.com")
relationshipType	relationshipType		string	Tipo de relaciones que se van a mostrar: "prime" (empresa como prime), "sub" (compañía como sub) o "ambos" (valor predeterminado)
minAmount	minAmount		number	Valor mínimo de subbaward que se va a incluir
fiscalYearStart	fiscalYearStart		number	Inicio del año fiscal para la búsqueda (valor predeterminado: año actual - 5)
limit	limit		number	Número máximo de relaciones por dirección (1-100, valor predeterminado: 50)

Devoluciones

Body: CompanyGovRelationshipsResponse

Obtener resumen de investigación de la empresa

Id. de la operación:: CompanyResearch

Investigación completa de la empresa que agrega señales firmográficas, tecnográficas, gastos de TI, gasto en la nube, señales de intención, contratos y señales operativas en un único panel interactivo. Proporcione un dominio de empresa (por ejemplo, "cisco.com") o un identificador de empresa (hg_id) de HG Insights. Requiere menos llamadas API que consultar cada herramienta individualmente.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
companyDomain	companyDomain		string	Dominio de empresa que se va a buscar (por ejemplo, "cisco.com"). No incluya el protocolo (http/https). Se debe proporcionar al menos uno de companyDomain o hg_id.
hg_id	hg_id		string	Identificador de empresa de HG Insights (32 caracteres alfanuméricos). Cuando se proporciona, esto invalida companyDomain. Se debe proporcionar al menos uno de companyDomain o hg_id.

Devoluciones

Body: CompanyResearchResponse

Obtener serie temporal de instalación de la empresa

Id. de la operación:: CompanyInstallTimeSeries

Obtener datos de series temporales de intensidad de instalación para el uso de la tecnología de una empresa. Devuelve valores de intensidad mensuales (escala de 0 a 100) para cada producto a lo largo del tiempo. Use para responder a preguntas de tendencia como "¿Cómo ha cambiado el uso de Snowflake de Cisco en los últimos 2 años?". Filtre por productos, proveedores o categorías. Cada producto incluye current_intensity, intensity_momentum (positivo = crecimiento) y is_active estado. Los productos se ordenan por intensidad actual (descendente) cuando no se aplica ningún filtro. Los resultados vacíos significan que no se encontraron productos coincidentes para los filtros especificados.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
companyDomain	companyDomain	True	string
products	products		array of string	Filtre por nombres de producto específicos (por ejemplo, ['Snowflake Platform', 'Databricks']).
productIds	productIds		array of string	Filtre por identificadores de producto.
vendors	vendors		array of string	Filtre por nombre del proveedor. Devuelve todos los productos de ese proveedor (por ejemplo, ['Amazon', 'Microsoft']).
categories	categories		array of string	Filtre por nombre de categoría (por ejemplo, ['Infraestructura en la nube', 'Seguridad']).
timeRange (Rango de tiempo)	timeRange		string	Intervalo de tiempo de la serie. Opciones: last_6_months, last_12_months, last_24_months, last_36_months. Valor predeterminado: last_24_months.
maxProducts	maxProducts		integer	Número máximo de productos que se van a devolver (1-50, valor predeterminado 10).

Devoluciones

Body: CompanyInstallTimeSeriesResponse

Obtener señales de intención del comprador de la empresa

Id. de la operación:: CompanyIntent

Obtenga una visión general general de las señales de intención para una empresa específica. Proporcione un dominio de empresa (por ejemplo, "cisco.com") o un identificador de empresa (hg_id) de HG Insights. Devuelve los principales temas de intención por puntuación con datos de intención de compradores de HG combinados + TrustRadius, como: puntuaciones de temas, niveles de intención, fases de recorrido del comprador, disposiciones de contexto para la inteligencia competitiva (por ejemplo, señales de desplazamiento) y actividades de comprador TrustRadius. Use vendor_name para la inteligencia competitiva (por ejemplo, "¿Es prudente mirar a los competidores de Snowflake?"). NOTA: Para consultas específicas del tema (por ejemplo, "¿Caterpillar muestra la intención para Siemens Teamcenter?"), use intent_category con el topic_name en su lugar, company_intent devuelve los temas principales por puntuación y puede perder temas específicos para empresas con muchas señales activas.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
companyDomain	companyDomain	True	string
hg_id	hg_id		string	Identificador de empresa de HG Insights (32 caracteres alfanuméricos). Cuando se proporciona, esto invalida companyDomain. Obtenga de un resultado de company_search anterior.
vendor_name	vendor_name		string	Filtre por nombre de proveedor para la inteligencia competitiva (por ejemplo, "Snowflake, Inc."). Muestra señales de desplazamiento y disposición del contexto.
product_name	product_name		string	Filtre por nombre de producto (por ejemplo, "Salesforce Sales Cloud"). Limita los resultados a las señales de intención relacionadas con este producto.
intent_level	intent_level		string	Filtre por nivel de intención.
buyers_journey	buyers_journey		string	Filtre por etapa de recorrido del comprador (por ejemplo, "Investigación", "Evaluación", "Compra").
context_type	context_type		string	Filtre por tipo de contexto (por ejemplo, "Espacio en blanco", "Expansión", "Desplazamiento", "Complementario").
source	source		string	Filtre por origen de datos. Omita incluir señales HG y TrustRadius.
start_date	start_date		string	Fecha de inicio en formato aaaa-MM-DD. El valor predeterminado es hace 30 días.
end_date	end_date		string	Fecha de finalización en formato aaaa-MM-DD. El valor predeterminado es hoy.
señal	signal		string	Filtre por categoría de señal. Activa el modo de búsqueda de actividad. Valores: comparación (ver comparación, hacer clic en Comparaciones), precios (ver precios del producto), investigación (ver lista de productos, ver categoría), evaluación (ver revisión, ver opiniones y clasificaciones).
products	products		array of string	Matriz de nombres de producto con lógica AND: devuelve solo empresas o eventos que coinciden con TODOS los productos (por ejemplo, ["Databricks", "Snowflake Platform"]). Activa el modo de búsqueda de actividad. Distinto de product_name que filtra el punto de conexión de intención.
employees_range	employees_range		string	Filtro de intervalo de empleados (por ejemplo, "10,000+", "1,001-5,000", "201-500").
country_codes	country_codes		array of string	Filtro de código de país ISO (por ejemplo, ["US", "GB"]).
category_name	category_name		string	Filtre por nombre de categoría de producto.
agrupar por	group_by		string	"company" para los datos agregados de la empresa, omita para eventos individuales sin procesar con direcciones URL de evidencia. Activa el modo de búsqueda de actividad.
limit	limit		integer	Límite de paginación (1-200). Se usa en los modos de búsqueda de intenciones y actividades.
offset	offset		integer	Desplazamiento de paginación (valor predeterminado 0). Se usa en los modos de búsqueda de intenciones y actividades.

Devoluciones

El modo de intención devuelve company/window/summary/topics/activities. El modo de búsqueda de actividad devuelve empresas (group_by=company) o eventos (modo sin procesar) con paginación.

Body: CompanyIntentResponse

Obtener señales operativas de la empresa

Id. de la operación:: CompanyOperatingSignals

Recupere las señales operativas de la empresa combinando atributos derivados de menciones (work_model, cloud_posture, esg_commitment, iot_posture, network_modernization, automation_stage) y atributos de madurez de GenAI (ai_trajectory, cloud_depth, genai_readiness, intent_adoption_gap). Proporcione un dominio de empresa (por ejemplo, "cisco.com") o un identificador de empresa (hg_id) de HG Insights.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
companyDomain	companyDomain	True	string
hg_id	hg_id		string	Identificador de empresa de HG Insights (32 caracteres alfanuméricos). Cuando se proporciona, esto invalida companyDomain.

Devoluciones

Body: CompanyOperatingSignalsResponse

Obtener tecnografías de la empresa

Id. de la operación:: CompanyTechnographic

FLUJO DE TRABAJO REQUERIDO: siga estos pasos antes de llamar a esta herramienta:

Para comprobar un proveedor o producto ESPECÍFICO: llame a get_vendor_information primero → pase los vendorIds/productIds devueltos aquí.
Para filtrar por categoría: llame a list_product_categories primero → pase aquí el nombre exacto de la categoría.
Para una pila técnica sin filtrar completa: llame a esta herramienta directamente sin filtros. Si se omite el paso 1 o 2, se pierden los resultados (por ejemplo, Snowflake se encuentra en "Administración de bases de datos", no en "Almacenamiento de datos").

Obtener datos tecnográficos (uso de tecnología) para una empresa por dominio. Devuelve las tecnologías instaladas con productId (numérico), proveedor, intensidad de uso y fechas de comprobación. Use los valores productId de los resultados al llamar a company_fai para búsquedas precisas. Filtre por "categorías" para el filtrado basado en categorías o por "vendorIds"/"productIds" para el filtrado exacto de proveedores o productos (preferido para búsquedas de proveedores específicas). Las solicitudes sin filtrar de gran tamaño se pueden truncar. Límite predeterminado: 50. Los resultados vacíos significan que no se encontraron datos para los filtros especificados; no diga que la herramienta carece de funcionalidad. Proporcione un dominio de empresa (por ejemplo, "cisco.com") o un identificador de empresa (hg_id) de HG Insights. Si se proporcionan ambos, hg_id tiene prioridad.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
companyDomain	companyDomain	True	string
hg_id	hg_id		string	Identificador de empresa de HG Insights (32 caracteres alfanuméricos). Cuando se proporciona, esto invalida companyDomain. Obtenga de un resultado de company_search anterior.
categories	categories		array of string	Filtre por categorías de tecnología (aproximadamente coincide). IMPORTANTE: Use list_product_categories para buscar nombres de categoría exactos antes de filtrar. Deje vacío para todas las categorías.
productIds	productIds		array of integer	Filtre por identificadores exactos de producto de HG Insights (que se pasan directamente a la API). Obtenga identificadores de get_vendor_information o del campo productId de los resultados de la company_technographic anterior.
vendorIds	vendorIds		array of integer	Filtre por identificadores exactos de proveedor de HG Insights (que se pasan directamente a la API). Obtenga identificadores de get_vendor_information. Ejemplo: get_vendor_information(vendorName: "Anthropic") devuelve vendorId y, a continuación, páselo aquí.
sort	sort		string	Ordene los resultados por intensidad de uso (alta a baja) o la última fecha comprobada (primero más reciente).
maxResults	maxResults		number	Número máximo de resultados que se van a devolver (1-500, valor predeterminado 50). Use "categories", "productIds" o "vendorIds" para filtrar los resultados centrados en lugar de solicitar grandes conjuntos de resultados.
provider	provider		string	Proveedor de datos que se va a usar. Use "auto" para la selección automática o especifique el nombre del proveedor.

Devoluciones

Body: CompanyTechnographicResponse

Temas de intención de lista

Id. de la operación:: ListIntentTopics

Temas de búsqueda o de intención de lista del catálogo oficial de HG Insights. Los temas de intención representan señales de compra y áreas de investigación que indican qué tecnologías están investigando o planeando comprar activamente las empresas. Use el parámetro "query" para fuzzy-search topics por nombre (recomendado para evitar resultados abrumadores). Use 'category' para filtrar por categoría de tema. IMPORTANTE: Al recomendar temas de intención, use siempre esta herramienta para buscar identificadores y nombres de temas reales, nunca adivinarlos ni fabricarlos.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
query	query	True	string	Consulta de búsqueda aproximada para filtrar temas de intención por nombre (por ejemplo, "seguridad en la nube", "ERP"). Devuelve las coincidencias más relevantes ordenadas por puntuación de relevancia. Use un término amplio como "tecnología" o "seguridad" para examinar secciones grandes del catálogo.
category	category		string	Filtre los temas de intención por categoría (por ejemplo, "Tecnología", "Negocio"). No distingue entre mayúsculas y minúsculas.
is_tech	is_tech		boolean	Filtre solo a temas de intención relacionados con la tecnología cuando sea true.
limit	limit		number	Número máximo de resultados que se van a devolver (valor predeterminado 50). Establezca más para recuperar más coincidencias.

Devoluciones

Body: ListIntentTopicsResponse

Definiciones

ListProductCategoriesResponse

Nombre	Ruta de acceso	Tipo	Description
count	count	number	Número de categorías de productos devueltas
totalAvailable	totalAvailable	number	Número total de categorías del catálogo (antes del filtrado)
categories	categories	array of object	Lista de información de categorías de productos
id	categories.id	string	Identificador de categoría único
name	categories.name	string	Nombre de la categoría
parentId	categories.parentId	string	Identificador de categoría principal, omitido para las categorías raíz
nameTree	categories.nameTree	array of string	Ruta de acceso de categoría jerárquica de raíz a esta categoría

GetVendorInformationResponse

Nombre	Ruta de acceso	Tipo	Description
count	count	number	Número total de proveedores devueltos
vendors	vendors	array of object	Lista de información del proveedor
id	vendors.id	number	Identificador de proveedor único (use con company_technographic parámetro vendorIds)
name	vendors.name	string	Nombre de proveedor
matchScore	vendors.matchScore	number	Coincidencia de confianza (0-1). 1.0 = coincidencia exacta, 0,9 = subcadena/casi exacta, <0,9 = aproximada. Solo está presente en los resultados de búsqueda vendorName.
products	vendors.products	array of object	Productos ofrecidos por este proveedor (solo se incluyen cuando se usa la búsqueda vendorName)
id	vendors.products.id	number	Id. de producto (use con company_technographic parámetro productIds)
name	vendors.products.name	string	Nombre del producto
categoryId	vendors.products.categoryId	string	Id. de categoría del producto

ListProductAttributesResponse

Nombre	Ruta de acceso	Tipo	Description
count	count	number	Número de atributos de producto devueltos
totalAvailable	totalAvailable	number	Número total de atributos del catálogo (antes de filtrar)
attributes	attributes	array of object	Lista de información de atributos de producto
id	attributes.id	string	Identificador de atributo único
name	attributes.name	string	Nombre del atributo
description	attributes.description	string	Descripción de lo que significa este atributo

ListIntentTopicsResponse

Nombre	Ruta de acceso	Tipo	Description
count	count	number	Número de temas de intención devueltos
totalAvailable	totalAvailable	number	Número total de temas de intención que coinciden con la consulta
topics	topics	array of object	Lista de información del tema de intención
id	topics.id	string	Identificador de tema de intención única
name	topics.name	string	Nombre del tema de intención
category	topics.category	string	Categoría de tema
is_tech_related	topics.is_tech_related	boolean	Si se trata de un tema relacionado con la tecnología
signal_count	topics.signal_count	number	Número de señales observadas para este tema

CompanyFirmographicResponse

Nombre	Ruta de acceso	Tipo	Description
domain	domain	string	Dominio de la empresa que se ha consultado
name	name	string	El nombre de la empresa
industria	industry	string	Sector o sector de la empresa
employeeCount	employeeCount	string	Número de empleados (intervalo o número exacto)
ingresos	revenue	string	Ingresos anuales (si están disponibles)
city	location.city	string	Ciudad
state	location.state	string	Estado o provincia
country	location.country	string	País
postalCode	location.postalCode	string	Código postal o postal
continente	location.continent	string	Continent
subcontinente	location.subcontinent	string	Subcontinente
geopolítica	location.geopolitical	string	Región geopolítica
description	description	string	Descripción de la empresa
sitio web	website	string	Dirección URL del sitio web de la empresa
foundedYear	foundedYear	number	Año en el que se fundó la compañía
companyType	companyType	string	Tipo de empresa (público, privado, etc.)
linkedin	socialMedia.linkedin	string	dirección URL de la página de LinkedIn empresa
Twitter	socialMedia.twitter	string	Dirección URL del perfil de empresa de Twitter/X
FACEBOOK (en inglés)	socialMedia.facebook	string	Dirección URL de la página de la empresa de Facebook
tecnologías	technologies	array of string	Tecnologías usadas por la empresa
código	industryCodes.naics.code	string	Código NAICS
name	industryCodes.naics.name	string	Nombre NAICS
codes	industryCodes.sic.codes	array of string	Códigos SIC
names	industryCodes.sic.names	array of string	Nombres de SIC
fortune500	rankings.fortune500	number	Clasificación fortune 500 (null si no se clasifica)
forbes2000	rankings.forbes2000	number	Clasificación de Forbes 2000 (null si no está clasificada)
itSpend	itSpend	number	Información de gastos de TI
companyLevel	companyLevel	string	Nivel de empresa/estructura organizativa
customerData	customerData	object	Datos específicos del cliente enriquecidos de Snowflake (solo presentes cuando se configura el enriquecimiento de Snowflake)
provider	metadata.provider	string	Qué proveedor devolvió estos datos
confidence	metadata.confidence	number	Puntuación de confianza de los datos (0-1)
lastActualizado	metadata.lastUpdated	string	Cuando estos datos se actualizaron por última vez

CompanyTechnographicResponse

Nombre	Ruta de acceso	Tipo	Description
companyId	companyId	string	Identificador único de la empresa
companyDomain	companyDomain	string	Dominio de la empresa que se ha consultado
products	products	array of object	Lista de tecnologías y productos usados por la empresa
productId	products.productId	integer	Identificador único del producto.
Nombre del producto	products.productName	string	Nombre del producto tecnológico
vendorName	products.vendorName	string	Nombre del proveedor de tecnología
productAttributes	products.productAttributes	array of string	Atributos o categorías del producto
productLocations	products.productLocations	number	Número de ubicaciones de productos
categoryId	products.categoryId	string	Identificador de categoría
categoryName	products.categoryName	string	Nombre de categoría de tecnología
categoryNameTree	products.categoryNameTree	array of string	Jerarquía de categoría
firstVerifiedDate	products.firstVerifiedDate	string	Fecha en la que se comprobó por primera vez la tecnología
lastVerifiedDate	products.lastVerifiedDate	string	Fecha en la que se comprobó por última vez el uso de la tecnología
uso de datos	products.intensity	number	Nivel de intensidad de uso
productDescription	products.productDescription	string	Descripción del producto
countryCode	products.countryCode	string	Código de país
installDate	products.installDate	string	Fecha de instalación
totalCount	totalCount	number	Número total de tecnologías encontradas
categories	categories	array of object	Categorías de tecnologías encontradas
items	categories	object
lastActualizado	lastUpdated	string	Cuándo se actualizaron los datos por última vez
truncatedFrom	_truncation.truncatedFrom	number	Número original de productos antes del truncamiento
returnedCount	_truncation.returnedCount	number	Número de productos devueltos después del truncamiento
nota	_truncation.note	string	Instrucciones para recuperar resultados más específicos

CompanySpendResponse

Nombre	Ruta de acceso	Tipo	Description
companyId	companyId	string	Identificador de la empresa de HGInsights
companyDomain	companyDomain	string	Dominio de la empresa que se ha consultado
totalSpend	totalSpend	string	Gasto total de TI con formato de moneda (por ejemplo, "$1,234,567")
totalSpendAmount	totalSpendAmount	number	Gasto total de TI como un valor numérico
spendByCategory	spendByCategory	array of object	Desglose del gasto por categoría
categoryId	spendByCategory.categoryId	string	Identificador de categoría
categoryName	spendByCategory.categoryName	string	Nombre de categoría mostrado
categoryTree	spendByCategory.categoryTree	array of string	Ruta de acceso de categoría jerárquica
totalSpend	spendByCategory.totalSpend	string	Gasto de categoría con formato de moneda
totalSpendAmount	spendByCategory.totalSpendAmount	number	Gasto de categoría como valor numérico
spendByCountry	spendByCategory.spendByCountry	array of object	Desglose geográfico del gasto
countryCode	spendByCategory.spendByCountry.countryCode	string	Código de país ISO
countryName	spendByCategory.spendByCountry.countryName	string	Nombre del país
region	spendByCategory.spendByCountry.region	string	Región geográfica
gastar	spendByCategory.spendByCountry.spend	string	Gasto con formato de moneda
spendAmount	spendByCategory.spendByCountry.spendAmount	number	Gasto como valor numérico
categoriesFound	categoriesFound	number	Número de categorías de gasto encontradas
countriesFound	countriesFound	number	Número de países con datos de gasto

CompanyResearchResponse

Nombre	Ruta de acceso	Tipo	Description
companyName	header.companyName	string
domain	header.domain	string
industria	header.industry	string
employeeCount	header.employeeCount	string
ingresos	header.revenue	string
location	header.location	object
sitio web	header.website	string
foundedYear	header.foundedYear	number
companyType	header.companyType	string
itSpend	keyMetrics.itSpend	number
fortune500Rank	keyMetrics.fortune500Rank	number
forbes2000Rank	keyMetrics.forbes2000Rank	number
topTechCategories	keyMetrics.topTechCategories	array of string
firmographic	firmographic	object	Datos firmográficos
technographic	technographic	object	Datos tecnográficos (20 productos principales)
gastar	spend	object	Datos de gasto de TI (15 categorías principales)
cloudSpend	cloudSpend	object	Datos de gasto en la nube (principales 10 proveedores)
intención	intent	object	Señales de intención (top 20)
contratos	contracts	object	Datos del contrato
operatingSignals	operatingSignals	object	Señales de funcionamiento

CompanyOperatingSignalsResponse

Nombre	Ruta de acceso	Tipo	Description
nombre_de_empresa	company_name	string	Nombre de la empresa de HG Insights v2
company_domain	company_domain	string	Dominio de empresa consultado
organization_id	organization_id	string	Identificador de organización de HG
data_available	mentions.data_available	boolean	Si se encontraron atributos derivados de menciones
no_data_reason	mentions.no_data_reason	string	Motivo por el que las menciones a los datos no están disponibles
stage	mentions.work_model.stage	string	Etiqueta de fase de categorías derivada
uso de datos	mentions.work_model.intensity	number	Suma de todas las intensidades de señal que contribuyen
last_verified_at	mentions.work_model.last_verified_at	string	Fecha de comprobación más reciente
signals	mentions.work_model.signals	object	Desglose de las densidades de menciones individuales por producto o palabra clave
stage	mentions.cloud_posture.stage	string	Etiqueta de fase de categorías derivada
uso de datos	mentions.cloud_posture.intensity	number	Suma de todas las intensidades de señal que contribuyen
last_verified_at	mentions.cloud_posture.last_verified_at	string	Fecha de comprobación más reciente
signals	mentions.cloud_posture.signals	object	Desglose de las densidades de menciones individuales por producto o palabra clave
stage	mentions.esg_commitment.stage	string	Etiqueta de fase de categorías derivada
uso de datos	mentions.esg_commitment.intensity	number	Suma de todas las intensidades de señal que contribuyen
last_verified_at	mentions.esg_commitment.last_verified_at	string	Fecha de comprobación más reciente
signals	mentions.esg_commitment.signals	object	Desglose de las densidades de menciones individuales por producto o palabra clave
stage	mentions.iot_posture.stage	string	Etiqueta de fase de categorías derivada
uso de datos	mentions.iot_posture.intensity	number	Suma de todas las intensidades de señal que contribuyen
last_verified_at	mentions.iot_posture.last_verified_at	string	Fecha de comprobación más reciente
signals	mentions.iot_posture.signals	object	Desglose de las densidades de menciones individuales por producto o palabra clave
stage	mentions.network_modernization.stage	string	Etiqueta de fase de categorías derivada
uso de datos	mentions.network_modernization.intensity	number	Suma de todas las intensidades de señal que contribuyen
last_verified_at	mentions.network_modernization.last_verified_at	string	Fecha de comprobación más reciente
signals	mentions.network_modernization.signals	object	Desglose de las densidades de menciones individuales por producto o palabra clave
stage	mentions.automation_stage.stage	string	Etiqueta de fase de categorías derivada
uso de datos	mentions.automation_stage.intensity	number	Suma de todas las intensidades de señal que contribuyen
last_verified_at	mentions.automation_stage.last_verified_at	string	Fecha de comprobación más reciente
signals	mentions.automation_stage.signals	object	Desglose de las densidades de menciones individuales por producto o palabra clave
data_available	genai_maturity.data_available	boolean	Si se encontraron datos de madurez de GenAI
no_data_reason	genai_maturity.no_data_reason	string	Motivo por el que los datos de madurez de GenAI no están disponibles
stage	genai_maturity.ai_trajectory.stage	string	Clasificación de fases de trayectoria de IA
uso de datos	genai_maturity.ai_trajectory.intensity	number	Puntuación de intensidad (0-100)
ai_maturity_score	genai_maturity.ai_trajectory.signals.ai_maturity_score	number
ai_maturity_6m_delta	genai_maturity.ai_trajectory.signals.ai_maturity_6m_delta	number
stage	genai_maturity.cloud_depth.stage	string	Clasificación de la fase de profundidad de la nube
uso de datos	genai_maturity.cloud_depth.intensity	number	Puntuación de intensidad (0-100)
gcp_intensity	genai_maturity.cloud_depth.signals.gcp_intensity	number
aws_intensity	genai_maturity.cloud_depth.signals.aws_intensity	number
azure_intensity	genai_maturity.cloud_depth.signals.azure_intensity	number
stage	genai_maturity.genai_readiness.stage	string	Clasificación de fases de preparación de GenAI
uso de datos	genai_maturity.genai_readiness.intensity	number	Puntuación de intensidad (0-100)
genai_intent_score	genai_maturity.genai_readiness.signals.genai_intent_score	number
ai_product_use	genai_maturity.genai_readiness.signals.ai_product_use	boolean
data_maturity_score	genai_maturity.genai_readiness.signals.data_maturity_score	number
stage	genai_maturity.intent_adoption_gap.stage	string	Clasificación de la fase de brecha de adopción de intenciones
uso de datos	genai_maturity.intent_adoption_gap.intensity	number	Puntuación de intensidad (0-100)
genai_intent_score	genai_maturity.intent_adoption_gap.signals.genai_intent_score	number
ai_product_use	genai_maturity.intent_adoption_gap.signals.ai_product_use	boolean
ai_maturity_score	genai_maturity.intent_adoption_gap.signals.ai_maturity_score	number

CompanyInstallTimeSeriesResponse

Nombre	Ruta de acceso	Tipo	Description
organization_id	organization.organization_id	string	Identificador de organización resuelto
organization_name	organization.organization_name	string	Nombre para mostrar de la organización
match_confidence	organization.match_confidence	number	Confianza de la coincidencia de dominio (0.0-1.0)
start_date	time_range.start_date	string	Fecha de inicio (formatoYYYY-MM)
end_date	time_range.end_date	string	Fecha de finalización ( formatoYYYY-MM)
granularidad	time_range.granularity	string
products	products	array of object	Productos con sus datos de serie temporal
product_id	products.product_id	string
product_name	products.product_name	string
vendor_name	products.vendor_name	string
category	products.category	string
is_active	products.is_active	boolean	Si el producto se comprobó en los últimos 90 días
current_intensity	products.current_intensity	number	Intensidad actual (escala de 0 a 100)
intensity_momentum	products.intensity_momentum	number	Flotación de impulso: significa un crecimiento positivo, negativo significa disminución
data_points	products.data_points	array of object
date	products.data_points.date	string	formato de YYYY-MM
uso de datos	products.data_points.intensity	number	Intensidad de ese mes, null si no hay datos
credits_consumed	credits_consumed	number	Créditos consumidos (3 por producto devuelto)

CompanyIntentResponse

El modo de intención devuelve company/window/summary/topics/activities. El modo de búsqueda de actividad devuelve empresas (group_by=company) o eventos (modo sin procesar) con paginación.

Nombre	Ruta de acceso	Tipo	Description
company_id	company.company_id	string
nombre_de_empresa	company.company_name	string
domain	company.domain	string
start	window.start	string
end	window.end	string
total_active_topics	summary.total_active_topics	number
high_intent_topics	summary.high_intent_topics	number
top_context_types	summary.top_context_types	object	Recuentos de tipos de contexto
Fuentes	summary.sources	object	Recuentos de señales por origen
latest_signal_date	summary.latest_signal_date	string
topics	topics	array of object	Detalles de la intención por tema (modo de intención)
topic_id	topics.topic_id	string
topic_name	topics.topic_name	string
puntuación	topics.score	number	Puntuación de intención (0-100)
intent_level	topics.intent_level	string
buyers_journey	topics.buyers_journey	string
context_types	topics.context_types	array of string
context_dispositions	topics.context_dispositions	array of string
vendor_names	topics.vendor_names	array of string
product_names	topics.product_names	array of string
tendencia	topics.trend	number
last_seen_at	topics.last_seen_at	string
source	topics.source	string
activities	activities	array of object	Actividades de comprador trustRadius (modo de intención)
activity_type	activities.activity_type	string
activity_label	activities.activity_label	string
products	activities.products	array of string
vendors	activities.vendors	array of string
activity_date	activities.activity_date	string
daily_views	activities.daily_views	number
intent_signal_url	activities.intent_signal_url	string
empresas	companies	array of object	Empresas que coinciden con la consulta de búsqueda de actividad (devuelta cuando group_by='company')
company_id	companies.company_id	string
nombre_de_empresa	companies.company_name	string
domain	companies.domain	string
employees_range	companies.employees_range	string
event_count	companies.event_count	number
total_views	companies.total_views	number
last_activity_date	companies.last_activity_date	string
products_compared	companies.products_compared	array of string
vendors	companies.vendors	array of string
signals	companies.signals	array of string
activity_labels	companies.activity_labels	array of string
events	events	array of object	Eventos de actividad individuales con direcciones URL de evidencia (que se devuelven cuando se omite group_by)
activity_date	events.activity_date	string
activity_type	events.activity_type	string
activity_label	events.activity_label	string
señal	events.signal	string
daily_views	events.daily_views	number
product_names	events.product_names	array of string
vendor_names	events.vendor_names	array of string
category_name_trees	events.category_name_trees	array of string
intent_signal_url	events.intent_signal_url	string
company_id	events.company_id	string
nombre_de_empresa	events.company_name	string
domain	events.domain	string
total	pagination.total	number
limit	pagination.limit	number
offset	pagination.offset	number
has_more	pagination.has_more	boolean

IntentCategoryResponse

El modo de intención devuelve contexto, empresas o paginación. El modo de búsqueda de actividad devuelve empresas (group_by=company) o eventos (modo sin procesar) con paginación.

Nombre	Ruta de acceso	Tipo	Description
start	context.date_range.start	string
end	context.date_range.end	string
source	context.source	string	Orígenes de datos consultados
topic_id	context.topic_resolved.topic_id	string
topic_name	context.topic_resolved.topic_name	string
generated_at	context.generated_at	string
empresas	companies	array of object	Modo de intención: empresas con intensidad de señal. Modo de búsqueda de actividad (group_by=empresa): empresas con recuentos de eventos.
company_id	companies.company_id	string
nombre_de_empresa	companies.company_name	string
domain	companies.domain	string
signal_strength	companies.signal_strength	number	Intensidad de señal de intención 0-100 (modo de intención)
intent_level	companies.intent_level	string	Alto, Medio o Bajo (modo de intención)
buyers_journey	companies.buyers_journey	string
context_types	companies.context_types	array of string
topics_matched	companies.topics_matched	array of string
last_seen_at	companies.last_seen_at	string
source	companies.source	string
employees_range	companies.employees_range	string	Modo de búsqueda de actividad
event_count	companies.event_count	number	Modo de búsqueda de actividad
total_views	companies.total_views	number	Modo de búsqueda de actividad
last_activity_date	companies.last_activity_date	string	Modo de búsqueda de actividad
products_compared	companies.products_compared	array of string	Modo de búsqueda de actividad
vendors	companies.vendors	array of string	Modo de búsqueda de actividad
signals	companies.signals	array of string	Modo de búsqueda de actividad
events	events	array of object	Eventos de actividad individuales con direcciones URL de evidencia (que se devuelven cuando se omite group_by)
activity_date	events.activity_date	string
activity_type	events.activity_type	string
activity_label	events.activity_label	string
señal	events.signal	string
daily_views	events.daily_views	number
product_names	events.product_names	array of string
vendor_names	events.vendor_names	array of string
category_name_trees	events.category_name_trees	array of string
intent_signal_url	events.intent_signal_url	string
company_id	events.company_id	string
nombre_de_empresa	events.company_name	string
domain	events.domain	string
total	pagination.total	number
limit	pagination.limit	number
offset	pagination.offset	number
has_more	pagination.has_more	boolean

ContactSearchResponse

Nombre	Ruta de acceso	Tipo	Description
contacts	contacts	array of object	Lista de contactos encontrados
id	contacts.id	string	Id. de contacto (use para el enriquecimiento con el mismo proveedor)
firstName	contacts.firstName	string	Nombre
lastName	contacts.lastName	string	Apellido
name	contacts.name	string	Nombre completo
title	contacts.title	string	Título del puesto
antigüedad	contacts.seniority	string	Nivel de antigüedad
linkedinUrl	contacts.linkedinUrl	string	dirección URL del perfil de LinkedIn
id	contacts.organization.id	string	Id. de organización
name	contacts.organization.name	string	Nombre de la compañía
domain	contacts.organization.domain	string	Dominio de empresa
industria	contacts.organization.industry	string	Industria
employeeCount	contacts.organization.employeeCount	number	Número de empleados
location	contacts.organization.location	string	Ubicación de la empresa
city	contacts.city	string	Ciudad
state	contacts.state	string	Estado o región
country	contacts.country	string	País
página	pagination.page	number	Número de página actual
perPage	pagination.perPage	number	Resultados por página
totalResults	pagination.totalResults	number	Número total de contactos coincidentes
hasMore	pagination.hasMore	boolean	Si hay más resultados disponibles
searchCriteria	metadata.searchCriteria	object	Criterios de búsqueda usados
Propina	metadata.tip	string	Sugerencia de uso
provider	metadata.provider	string	Proveedor de datos de contacto usado (por ejemplo, apollo, zoominfo)
usedProvider	metadata.usedProvider	string	Qué proveedor ha cumplido esta solicitud
availableProviders	metadata.availableProviders	array of string	Proveedores configurados para la organización
Advertencias	metadata.warnings	array of string	Advertencias sobre parámetros omitido

ContactEnrichResponse

Nombre	Ruta de acceso	Tipo	Description
id	contact.id	string	ID de contacto
firstName	contact.firstName	string	Nombre
lastName	contact.lastName	string	Apellido
name	contact.name	string	Nombre completo
title	contact.title	string	Título del puesto
antigüedad	contact.seniority	string	Nivel de antigüedad
email	contact.email	string	Dirección de correo electrónico (si se revela)
emailStatus	contact.emailStatus	string	Estado de comprobación de correo electrónico
personalEmails	contact.personalEmails	array of string	Direcciones de correo electrónico personales
phone	contact.phone	string	Número de teléfono principal
teléfono móvil	contact.mobilePhone	string	Número de teléfono móvil
corporatePhone	contact.corporatePhone	string	Número de teléfono corporativo
linkedinUrl	contact.linkedinUrl	string	dirección URL del perfil de LinkedIn
twitterUrl	contact.twitterUrl	string	Dirección URL del perfil de Twitter/X
facebookUrl	contact.facebookUrl	string	Dirección URL del perfil de Facebook
githubUrl	contact.githubUrl	string	dirección URL del perfil de GitHub
id	contact.organization.id	string	Id. de organización
name	contact.organization.name	string	Nombre de la compañía
domain	contact.organization.domain	string	Dominio de empresa
industria	contact.organization.industry	string	Industria
employeeCount	contact.organization.employeeCount	number	Número de empleados
ingresos	contact.organization.revenue	number	Ingresos anuales
location	contact.organization.location	string	Ubicación de la empresa
linkedinUrl	contact.organization.linkedinUrl	string	Dirección URL de LinkedIn de empresa
sitio web	contact.organization.website	string	Sitio web de la empresa
employmentHistory	contact.employmentHistory	array of object	Historial de empleo
organizationName	contact.employmentHistory.organizationName	string
title	contact.employmentHistory.title	string
startDate	contact.employmentHistory.startDate	string
fecha de finalización	contact.employmentHistory.endDate	string
isCurrent	contact.employmentHistory.isCurrent	boolean
city	contact.city	string	Ciudad
state	contact.state	string	Estado o región
country	contact.country	string	País
contacts	contacts	array of object	Contactos enriquecidos (enriquecimiento masivo)
id	contacts.id	string	ID de contacto
firstName	contacts.firstName	string	Nombre
lastName	contacts.lastName	string	Apellido
name	contacts.name	string	Nombre completo
title	contacts.title	string	Título del puesto
antigüedad	contacts.seniority	string	Nivel de antigüedad
email	contacts.email	string	Dirección de correo electrónico (si se revela)
emailStatus	contacts.emailStatus	string	Estado de comprobación de correo electrónico
personalEmails	contacts.personalEmails	array of string	Direcciones de correo electrónico personales
phone	contacts.phone	string	Número de teléfono principal
teléfono móvil	contacts.mobilePhone	string	Número de teléfono móvil
corporatePhone	contacts.corporatePhone	string	Número de teléfono corporativo
linkedinUrl	contacts.linkedinUrl	string	dirección URL del perfil de LinkedIn
twitterUrl	contacts.twitterUrl	string	Dirección URL del perfil de Twitter/X
facebookUrl	contacts.facebookUrl	string	Dirección URL del perfil de Facebook
githubUrl	contacts.githubUrl	string	dirección URL del perfil de GitHub
id	contacts.organization.id	string	Id. de organización
name	contacts.organization.name	string	Nombre de la compañía
domain	contacts.organization.domain	string	Dominio de empresa
industria	contacts.organization.industry	string	Industria
employeeCount	contacts.organization.employeeCount	number	Número de empleados
ingresos	contacts.organization.revenue	number	Ingresos anuales
location	contacts.organization.location	string	Ubicación de la empresa
linkedinUrl	contacts.organization.linkedinUrl	string	Dirección URL de LinkedIn de empresa
sitio web	contacts.organization.website	string	Sitio web de la empresa
employmentHistory	contacts.employmentHistory	array of object	Historial de empleo
organizationName	contacts.employmentHistory.organizationName	string
title	contacts.employmentHistory.title	string
startDate	contacts.employmentHistory.startDate	string
fecha de finalización	contacts.employmentHistory.endDate	string
isCurrent	contacts.employmentHistory.isCurrent	boolean
city	contacts.city	string	Ciudad
state	contacts.state	string	Estado o región
country	contacts.country	string	País
creditUsed	metadata.creditsUsed	number	Número de créditos consumidos
matchConfidence	metadata.matchConfidence	string	Coincidencia del nivel de confianza
enrichedAt	metadata.enrichedAt	string	Marca de tiempo ISO del enriquecimiento
noMatchReason	metadata.noMatchReason	string	Motivo por el que no se encontró ningún contacto coincidente
enrichmentType	metadata.enrichmentType	string	Tipo de enriquecimiento realizado
provider	metadata.provider	string	Proveedor de datos de contacto usado (por ejemplo, apollo, zoominfo)
usedProvider	metadata.usedProvider	string	Qué proveedor ha cumplido esta solicitud
availableProviders	metadata.availableProviders	array of string	Proveedores configurados para la organización

SecFilingSectionResponse

Nombre	Ruta de acceso	Tipo	Description
companyName	companyName	string	Nombre completo de la empresa de la presentación
teletipo	ticker	string	Símbolo del ticker de stock
cik	cik	string	Clave de índice central de SEC
filingType	filingType	string	Tipo de presentación de SEC
filingDate	filingDate	string	Fecha en que se envió la presentación a SEC
periodOfReport	periodOfReport	string	Período cubierto por la presentación
section	section	string	Código de sección extraído
sectionLabel	sectionLabel	string	Nombre de sección legible para personas
contenido	content	string	Contenido de sección extraído
contentFormat	contentFormat	string	Formato del contenido
filingUrl	filingUrl	string	Dirección URL a la presentación original de sec
wordCount	wordCount	number	Word recuento del contenido extraído
accessionNumber	metadata.accessionNumber	string	Número de adhesión de la SEC para la presentación
fiscalYear	metadata.fiscalYear	number	Año fiscal de la presentación
fiscalQuarter	metadata.fiscalQuarter	number	Trimestre fiscal (para presentaciones de 10 Q)

SecFullTextSearchResponse

Nombre	Ruta de acceso	Tipo	Description
total	total	number	Número total de presentaciones coincidentes
query	query	string	Consulta de búsqueda que se ejecutó
Limaduras	filings	array of object	Matriz de archivos coincidentes
accessionNumber	filings.accessionNumber	string	Número de adhesión de SEC
formType	filings.formType	string	Tipo de presentación de SEC (10-K, 10-Q, 8-K, etc.)
filedAt	filings.filedAt	string	Fecha de presentación
companyName	filings.companyName	string	Nombre de la compañía
teletipo	filings.ticker	string	Símbolo del ticker de stock
cik	filings.cik	string	Clave de índice central de SEC
filingUrl	filings.filingUrl	string	Dirección URL a la presentación de sec
description	filings.description	string	Descripción de la presentación
filingTypes	searchParams.filingTypes	array of string
tickers	searchParams.tickers	array of string
startDate	searchParams.startDate	string
fecha de finalización	searchParams.endDate	string
limit	searchParams.limit	number

SearchFederalContractsResponse

Nombre	Ruta de acceso	Tipo	Description
totalCount	totalCount	number	Total de contratos coincidentes
contratos	contracts	array of object	Lista de adjudicaciones de contratos federales que coinciden con los criterios de búsqueda
awardId	contracts.awardId	string
recipientName	contracts.recipientName	string
recipientUei	contracts.recipientUei	string
awardingAgency	contracts.awardingAgency	string
awardingSubAgency	contracts.awardingSubAgency	string
totalObligation	contracts.totalObligation	number
totalObligationFormatted	contracts.totalObligationFormatted	string
startDate	contracts.startDate	string
fecha de finalización	contracts.endDate	string
tipoDeContrato	contracts.contractType	string
naicsCode	contracts.naicsCode	string
naicsDescription	contracts.naicsDescription	string
pscCode	contracts.pscCode	string
pscDescription	contracts.pscDescription	string
setAsideType	contracts.setAsideType	string
city	contracts.placeOfPerformance.city	string
state	contracts.placeOfPerformance.state	string
country	contracts.placeOfPerformance.country	string
description	contracts.description	string
hasMore	hasMore	boolean	Si hay más resultados disponibles

SearchGovOpportunitiesResponse

Nombre	Ruta de acceso	Tipo	Description
totalCount	totalCount	number	Total de oportunidades de coincidencia
Oportunidades	opportunities	array of object	Lista de oportunidades/solicitudes federales que coinciden con los criterios de búsqueda
opportunityId	opportunities.opportunityId	string
title	opportunities.title	string
solicitationNumber	opportunities.solicitationNumber	string
agencia	opportunities.agency	string
subAgency	opportunities.subAgency	string
postedDate	opportunities.postedDate	string
responseDeadline	opportunities.responseDeadline	string
daysUntilDeadline	opportunities.daysUntilDeadline	number
type	opportunities.type	string
setAsideType	opportunities.setAsideType	string
naicsCode	opportunities.naicsCode	string
classificationCode	opportunities.classificationCode	string
city	opportunities.placeOfPerformance.city	string
state	opportunities.placeOfPerformance.state	string
country	opportunities.placeOfPerformance.country	string
description	opportunities.description	string
link	opportunities.link	string
hasMore	hasMore	boolean	Si hay más resultados disponibles

CompanyGovOpportunitiesResponse

Nombre	Ruta de acceso	Tipo	Description
companyName	companyName	string	Nombre de empresa resuelto de SAM.gov
companyDomain	companyDomain	string	Dominio de empresa que se ha buscado
uei	samEntity.uei	string
cageCode	samEntity.cageCode	string
legalBusinessName	samEntity.legalBusinessName	string
Oportunidades	opportunities	array of object	Coincidencia de oportunidades federales con estado titular
opportunityId	opportunities.opportunityId	string
title	opportunities.title	string
agencia	opportunities.agency	string
responseDeadline	opportunities.responseDeadline	string
daysUntilDeadline	opportunities.daysUntilDeadline	number
incumbentStatus	opportunities.incumbentStatus	string
matchReason	opportunities.matchReason	string
link	opportunities.link	string
totalOpportunities	totalOpportunities	number	Número total de oportunidades de coincidencia

CompanyGovRelationshipsResponse

Nombre	Ruta de acceso	Tipo	Description
companyName	companyName	string	Nombre de empresa resuelto de SAM.gov
companyDomain	companyDomain	string	Dominio de empresa que se ha buscado
uei	samEntity.uei	string
cageCode	samEntity.cageCode	string
legalBusinessName	samEntity.legalBusinessName	string
totalValue	asSubcontractor.totalValue	number
totalValueFormatted	asSubcontractor.totalValueFormatted	string
primeContractors	asSubcontractor.primeContractors	array of object
nombre del socio	asSubcontractor.primeContractors.partnerName	string
contractCount	asSubcontractor.primeContractors.contractCount	number
totalValue	asSubcontractor.primeContractors.totalValue	number
totalValueFormatted	asSubcontractor.primeContractors.totalValueFormatted	string
agencias	asSubcontractor.primeContractors.agencies	array of string
totalValue	asPrimeContractor.totalValue	number
totalValueFormatted	asPrimeContractor.totalValueFormatted	string
subcontratistas	asPrimeContractor.subcontractors	array of object
nombre del socio	asPrimeContractor.subcontractors.partnerName	string
contractCount	asPrimeContractor.subcontractors.contractCount	number
totalValue	asPrimeContractor.subcontractors.totalValue	number
totalValueFormatted	asPrimeContractor.subcontractors.totalValueFormatted	string
agencias	asPrimeContractor.subcontractors.agencies	array of string