API de Datos de empresas
Datos a nivel de empresa, nunca personas ni datos de contacto. enrich lee el perfil de una empresa por dominio, peers lista sus pares directos y grandes competidores, search encuentra empresas a partir de una frase y brand_search busca marcas por nombre o prefijo de dominio.
Una empresa se identifica por su dominio, como stripe.com; también sirve un enlace a su web. Perfiles, pares y resultados de búsqueda vienen de conjuntos de datos distintos, así que tamaños y sectores se expresan de forma diferente entre acciones.
Disponibilidad de la plataforma
- Salud 24 h
- Normal
Últimos 30 días
Funciones disponibles
Cada acción de Datos de empresas, qué hace, su precio y su salud en las últimas 24 horas. Abre una acción para ver sus parámetros, campos de respuesta y ejemplos de código.
| Capacidad | Qué hace | Por 1.000 | Salud en 24 horas |
|---|---|---|---|
Perfil de una empresaenrich | Envía un domain y recibe la empresa que mejor coincide con name, headline, description, industry, company_type, size, founded, linkedin_url, socials, locations y match_confidence. | $10.4 por 1.000 solicitudes | Normal |
Pares y competidorespeers | Envía un domain y recibe hasta 50 pares directos y grandes competidores, cada uno con name, una description de cómo compite y peer_type. | $20 por 1.000 solicitudes | Normal |
Buscar empresassearch | Envía en keyword una frase como payment infrastructure companies in Ireland, y opcionalmente country, employees_min y employees_max, y recibe 10 empresas con dominio, descripción, sectores, sede, plantilla, ingresos estimados y rondas de financiación. | $3.19 por 1.000 solicitudes | Normal |
Buscar marcasbrand_search | Envía en keyword el nombre de una marca, un dominio o sus primeras letras y recibe hasta 10 marcas con name, domain, description, country y language. | $0.56 por 1.000 solicitudes | Normal |
Abre una capacidad para ver sus parámetros, campos de respuesta, ejemplos de código y prueba.
¿Qué acepta cada acción de Datos de empresas?
Cada respuesta enlaza una acción ejecutable con sus entradas reales. El significado y los valores permitidos pertenecen a esa acción; un nombre parecido no conserva automáticamente el mismo sentido en otra plataforma.
Las fuentes oficiales se enlazan solo para precisar el término de la plataforma indicado a su lado. No implican autorización ni respaldo y no añaden a EveryInfra funciones del sitio oficial.
| Acción | Obligatorios | Opcionales | Entrega | Límite | Por 1.000 | Campos de respuesta |
|---|---|---|---|---|---|---|
enrichPerfil de una empresa Envía un | domain | — | Entrega síncrona | — | $10.4 por 1.000 solicitudes | name · domain · headline · description · industry · company_type · size · founded · linkedin_url · socials · locations · match_confidence · platform |
peersPares y competidores Envía un | domain | — | Entrega síncrona | El catálogo declara defaultLimit = 20 y maxLimit = 50 para el límite de esta acción. Según la acción, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $20 por 1.000 solicitudes | name · description · peer_type · platform |
searchBuscar empresas Envía en | keyword | country, employees_max, employees_min | Entrega síncrona | El catálogo declara defaultLimit = 10 y maxLimit = 10 para el límite de esta acción. Según la acción, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $3.19 por 1.000 solicitudes | name · domain · description · organization_type · operating_status · industries · founded_year · hq_country_code · hq_region · hq_city · hq_street_address · hq_postal_code · employee_count · employees_min · employees_max · revenue_min_usd · revenue_max_usd · funding_total_usd · funding_round_count · funding_stage · latest_round · funding_rounds · platform |
brand_searchBuscar marcas Envía en | keyword | — | Entrega síncrona | El catálogo declara defaultLimit = 10 y maxLimit = 10 para el límite de esta acción. Según la acción, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $0.56 por 1.000 solicitudes | name · domain · description · country · language · platform |
¿Qué significan los parámetros de Datos de empresas enrich?
Envía un domain y recibe la empresa que mejor coincide con name, headline, description, industry, company_type, size, founded, linkedin_url, socials, locations y match_confidence. Nombres y descripciones se dejan como los escribe el conjunto de datos, a menudo en minúsculas.
domainObligatorio- Dominio o enlace de la web de la empresa, como
stripe.comohttps://www.notion.com/; se quitan el esquema,www.y la ruta. Lo que no sea un dominio se rechaza antes de cobrar.
¿Qué significan los parámetros de Datos de empresas peers?
Envía un domain y recibe hasta 50 pares directos y grandes competidores, cada uno con name, una description de cómo compite y peer_type. Si el conjunto de datos no conoce la empresa, no hay filas.
domainObligatorio- Dominio o enlace de la web de la empresa, como
stripe.comohttps://www.notion.com/; se quitan el esquema,www.y la ruta. Lo que no sea un dominio se rechaza antes de cobrar.
¿Qué significan los parámetros de Datos de empresas search?
Envía en keyword una frase como payment infrastructure companies in Ireland, y opcionalmente country, employees_min y employees_max, y recibe 10 empresas con dominio, descripción, sectores, sede, plantilla, ingresos estimados y rondas de financiación.
keywordObligatoriosearch: una frase que describa las empresas, hasta 500 caracteres, comopayment infrastructure companies in Ireland.brand_search: nombre de la marca, dominio o sus primeras letras, hasta 100 caracteres, comonotiononik.countryOpcional- Solo empresas con sede en este país, código de dos letras como US, GB o IE (
search).ISO: códigos de país ISO 3166 — La página oficial de ISO explica que ISO 3166-1 identifica los países con códigos de dos letras, que es lo que significan US, GB o IE en `country`. La sede de cada empresa viene de los datos devueltos, no de esta norma. · Consultada employees_maxOpcional- Plantilla máxima para
search. employees_minOpcional- Plantilla mínima para
search; cuentan las empresas cuyo rango de plantilla se solapa.
¿Qué significan los parámetros de Datos de empresas brand_search?
Envía en keyword el nombre de una marca, un dominio o sus primeras letras y recibe hasta 10 marcas con name, domain, description, country y language.
keywordObligatoriosearch: una frase que describa las empresas, hasta 500 caracteres, comopayment infrastructure companies in Ireland.brand_search: nombre de la marca, dominio o sus primeras letras, hasta 100 caracteres, comonotiononik.
Cómo usar la API de Datos de empresas
- 01Consulta el catálogo público y elige una acción de la plataforma.
- 02Envía los parámetros platform y action, junto con los campos obligatorios, a POST /api/v1/social.
- 03Procesa el resultado síncrono o consulta el identificador de trabajo cuando la acción se ejecute de forma asíncrona.
- 04Guarda los campos de la respuesta estructurada que necesita tu aplicación.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"company_data","action":"enrich","params":{"domain":"<domain>"}}'
Preguntas sobre la API de Datos de empresas
¿Cómo llamo a la API de Datos de empresas?
Envía POST /api/v1/social con platform igual a company_data, elige uno de los identificadores de acción indicados e incluye sus parámetros obligatorios.
¿Qué devuelve la API de Datos de empresas?
Devuelve JSON estructurado. Por ejemplo, el esquema de enrich incluye name, domain, headline y description. Cada acción tiene su propia lista de campos; que un campo esté declarado no garantiza que todos los registros tengan un valor.
¿Qué matiz de la documentación oficial conviene conservar al usar datos de Datos de empresas?
La página oficial de ISO explica que ISO 3166-1 identifica los países con códigos de dos letras, que es lo que significan US, GB o IE en country. La sede de cada empresa viene de los datos devueltos, no de esta norma.
¿Qué parámetros son obligatorios?
Depende de la acción. enrich requiere domain; peers requiere domain; search requiere keyword; consulta las demás acciones en la lista de funciones.
¿Las acciones de Datos de empresas responden de inmediato?
Las acciones marcadas como asíncronas devuelven un identificador de trabajo que se consulta por sondeo. Cualquier otra acción también puede ejecutarse de forma asíncrona: añade "mode": "async" al cuerpo de la solicitud para recibir el identificador de inmediato, útil para tareas lentas o límites altos.