Un administrador nuevo, una ampliación de capital, un traslado o un cambio de nombre suelen marcar el momento en que una empresa compra. La API vigila las cuentas de tu CRM, te avisa con el acto inscrito en el BORME y te da cada semana las sociedades recién constituidas. Siempre a nivel de empresa, nunca con datos personales de los administradores para hacer marketing.
| Acto en el BORME | event_type | Por qué le importa a ventas |
|---|---|---|
| Nombramientos y ceses | director_change | Un decisor nuevo revisa proveedores en sus primeros meses |
| Ampliación de capital | capital_change | Dinero recién captado es dinero a punto de gastarse |
| Cambio de domicilio social | address_change | Oficina nueva: obras, servicios, proveedores locales |
| Cambio de denominación social | name_change | Un cambio de marca reabre contratos y sistemas |
| Fusión y escisión | merger, demerger | Dos listas de proveedores pasan a ser una |
| Cambio de objeto social | object_change | Entra en una actividad nueva y necesita lo que vendes |
| Disolución, liquidación, concurso | dissolution, liquidation, insolvency | Frena la venta, protege la factura y limpia el CRM |
Fuera de España, la vigilancia avisa de cambios de nombre, domicilio y estado en el resto de países vigilados, y también de nombramientos y capital en el Reino Unido. Francia no tiene avisos.
Resuelve cada cuenta a su ficha una vez, suscríbela y guarda tu identificador del CRM como label: vuelve en cada aviso. Suscribirse no consume créditos.
import requests
BASE = 'https://api.prometiam.com/functions/v1/risk-api'
H = {'Authorization': 'Bearer rk_live_...'}
cuentas = [('A28015865', 'crm-1001'), ('A46103834', 'crm-1002')] # NIF y su id en el CRM
for nif, crm_id in cuentas:
r = requests.get(f'{BASE}/companies/search', headers=H, params={'country': 'ES', 'nif': nif})
r.raise_for_status()
hits = r.json()['data']
if hits:
requests.post(f'{BASE}/monitor', headers=H, json={
'company_id': hits[0]['id'],
'label': crm_id,
'events': ['corporate_event', 'status_change'],
'webhook_url': 'https://tu-dominio.es/hooks/prometiam',
}).raise_for_status()
Cada aviso llega firmado: la cabecera X-Prometiam-Signature lleva sha256= y el HMAC-SHA256 del cuerpo con el webhook_secret que devuelve POST /monitor. Compruébalo antes de crear la tarea para el comercial. El webhook empieza en Professional; en todos los planes los avisos se leen en GET /monitor, así que un proceso nocturno también sirve.
Antes de la primera llamada, los cambios del último año dicen más que la descripción de la empresa: GET /company-events/search?country=ES&company_number=A28015865&date_from=2025-10-01 devuelve los actos de esa cuenta, del más reciente al más antiguo, a 2 créditos por llamada. La búsqueda necesita un nombre o un NIF: es el historial de una cuenta, no un flujo de todos los actos de España.
La constitución es la primera señal: una sociedad nueva necesita banco, gestoría, seguros, software y local. founded_after lista las sociedades constituidas desde una fecha sin poner nombre, y en España puedes acotar por código de actividad (cnae, presente en una de cada cinco fichas) o por una palabra del objeto social (objeto, en la gran mayoría).
curl 'https://api.prometiam.com/functions/v1/risk-api/companies/search?country=ES&founded_after=2026-10-01&objeto=software&limit=100' \ -H 'Authorization: Bearer rk_live_...'
La vigilancia no consume créditos: el plan fija cuántas cuentas vigilas (3 en la prueba, 25 en Starter, 250 en Professional con webhooks y 2.500 en Scale). Una búsqueda de empresas cuesta 1 crédito y una de actos 2. Starter cuesta 9,99 € al mes con 1.000 créditos, Professional 29,99 € con 10.000 y Scale 99,99 € con 50.000. La prueba gratuita dura 14 días con 500 créditos: se pide una tarjeta y no se cobra nada durante la prueba.
Empieza tu prueba gratuita de 14 días · Documentación de la API
La prueba dura 14 días e incluye 500 créditos. Se pide una tarjeta, pero no se cobra nada durante la prueba; después sigue el plan Starter (9,99 € al mes) salvo que la canceles.