# Precios

> Planes, costos de créditos, el paquete de API ilimitada y captura automática en CRM para la API de Desarrolladores de graph8

Source: https://docs.graph8.com/es/developers/pricing/

graph8 cuenta con dos planes de pago y un nivel gratuito. Ambos planes de pago ofrecen acceso completo a todas las superficies de la API; la diferencia está en la forma de pago.

> **Tip: Elección rápida**
> - **¿Solo está explorando o tiene bajo volumen?** Comience con **PAYG**: sin tarjeta y con 1,000 créditos gratuitos.
> - **¿Ejecuta flujos de trabajo GTM reales?** **Platform**, a $499/mes, le ofrece consultas ilimitadas al índice de graph8 con un límite de 5 rps.

---

## Comparación de planes

| | Prueba gratuita | PAYG | Platform |
|---|---|---|---|
| **Precio** | $0 | $0.05 / crédito | $499 / mes |
| **Créditos gratuitos al registrarse** | Ver más abajo | 1,000 | 2,500 |
| **Tarjeta requerida para comenzar** | No | No | No |
| **Créditos de IA incluidos / mes** | - | Pago por crédito | 75,000 |
| **Consultas al índice de graph8** | Con medición | Con medición | **Ilimitadas (5 rps)** |
| **Enriquecimiento en cascada (terceros)** | Créditos | Créditos | Créditos |
| **Auto-captura en CRM** | Desactivada | Activada (por defecto) | Activada (por defecto) |
| **Límite de solicitudes** | 5 rps | 5 rps | 5 rps |
| **Correo corporativo requerido** | Sí | Sí | Sí |
| **Ideal para** | Probar graph8 | Desarrolladores, evaluadores, bajo volumen | Equipos con flujos GTM reales |

> **Note: Valor del crédito**
> Cada crédito equivale a $0.05 en PAYG. Los 75,000 créditos de IA incluidos en el plan Platform representan un valor de ~$3,750 en PAYG, sin contar el paquete de consultas ilimitadas al índice.

---

## Nivel gratuito

Dos formas de comenzar sin costo, ambas sin tarjeta:

- **Registro PAYG**: 1,000 créditos gratuitos, sin fecha de vencimiento.
- **Prueba de Platform**: 2,500 créditos gratuitos para evaluar la experiencia completa de Platform antes de suscribirse.

Los dominios de correo personal (gmail, yahoo, outlook, etc.) están bloqueados: el registro requiere un correo corporativo.

> **Note: La auto-captura está desactivada en el nivel gratuito**
> Las llamadas a la API en el nivel gratuito son consultas sin estado: los resultados se devuelven, pero **no** se guardan en su CRM. La captura se activa automáticamente al pasar a PAYG o Platform.

---

## PAYG (Pago por uso)

El nivel de entrada. Todas las funcionalidades están disponibles: todo se controla con créditos, sin restricciones por funcionalidad.

- **$0.05 por crédito**, debitado de su saldo
- **1,000 créditos gratuitos** al registrarse, sin tarjeta
- **Acceso completo a la plataforma**: búsqueda, enriquecimiento, secuencias, campañas, copilot, intent, anuncios, voz y páginas de destino
- **Auto-captura en CRM activada**: cada contacto o empresa devuelto por la API se guarda en su CRM
- **5 solicitudes/segundo** en los endpoints de la API de datos

### Costos por operación

| Operación | Créditos |
|---|---|
| Búsqueda de persona (`/enrichment/lookup/person`) | 2, solo se cobran si hay coincidencia |
| Búsqueda de empresa (`/enrichment/lookup/company`) | 2, solo se cobran si hay coincidencia |
| Registro devuelto en búsqueda (`/search/contacts`, `/search/companies`) | 1 por registro |
| Guardar búsqueda en lista (`/search/contacts/save`, `/search/companies/save`) | 1 por registro guardado |
| Verificación de correo (`/enrichment/verify-email`) | 1 |
| Enriquecimiento en cascada (`/enrichment/enrich`) | Variable (según el proveedor) |

Ideal para: desarrolladores, evaluadores, scripts e integraciones de bajo volumen.

---

## Platform: $499/mes

Para equipos que ejecutan flujos de trabajo GTM reales en graph8.

- **2,500 créditos gratuitos al registrarse** para probar antes de suscribirse (sin tarjeta)
- **75,000 créditos de IA por mes incluidos**
- **Consultas ilimitadas al índice de datos de graph8 vía API** (con límite de 5 solicitudes/seg)
- **Auto-captura en CRM activada**: cada resultado de la API queda en su CRM como registro permanente
- Acceso completo a secuencias, campañas, copilot, intent, anuncios, voz y páginas de destino

### Qué se incluye sin costo (dentro del límite de 5 rps)

Estos endpoints están respaldados por los índices propios de graph8 (OpenSearch + ClickHouse). En el plan Platform no consumen créditos:

| Endpoint | Qué hace |
|---|---|
| `POST /api/v1/search/contacts` | Búsqueda de contactos ICP, paginada |
| `POST /api/v1/search/companies` | Búsqueda de empresas ICP, paginada |
| `GET /api/v1/contacts` | Leer sus contactos del CRM |
| `GET /api/v1/companies` | Leer sus empresas del CRM |
| `GET /api/v1/lists` | Leer sus listas |
| `GET /api/v1/deals` | Leer sus oportunidades |
| `GET /api/v1/fields` | Leer sus campos personalizados |

> **Caution: Próximamente**
> Los endpoints de búsqueda con clave de LinkedIn (`POST /api/v1/linkedin/person`, `POST /api/v1/linkedin/company`) aún no están disponibles en la API pública para desarrolladores. Por ahora, utilice `/enrichment/lookup/person` con un `linkedin_url`.

### Qué sigue consumiendo créditos

Estos endpoints invocan a proveedores externos, infraestructura real de mensajería o servicios de pago: consumen créditos en **ambos** planes, PAYG y Platform.

| Endpoint | Motivo |
|---|---|
| `POST /api/v1/enrichment/enrich` | Cascada: proveedores externos (Prospeo, Dropcontact, Cognism, etc.) |
| `POST /api/v1/sequences/{id}/contacts` | Envíos reales de mensajes (SMTP, SMS, WhatsApp) |
| `POST /api/v1/campaigns/launch` | Orquestación multicanal |
| `POST /api/v1/ads/launch` | Activadores de inversión publicitaria |
| `POST /api/v1/enrichment/lookup/person`, `/lookup/company` | 2 créditos por búsqueda, que solo se cobran si hay coincidencia |
| `POST /api/v1/enrichment/verify-email` | 1 crédito por verificación |

> **Note: Por qué "ilimitado dentro del límite de solicitudes"**
> El límite de 5 rps es por organización y aplica a todos los endpoints de la API de datos. No existe un límite mensual en los endpoints respaldados por el índice para Platform: si se mantiene por debajo de 5 rps, puede realizar tantas consultas como desee.

---

## Auto-captura en CRM

Cada contacto y empresa devuelto por la API se guarda automáticamente en su CRM. La próxima vez que consulte `GET /contacts` o abra la cuadrícula de Contactos en la aplicación, el registro estará disponible.

### Configuración predeterminada por plan

| Plan | Captura por defecto |
|---|---|
| Prueba gratuita | Desactivada |
| PAYG | Activada |
| Platform | Activada |

### Cómo aparecen los registros capturados

Los registros capturados se etiquetan para facilitar su búsqueda y auditoría:

- `source = 'api_lookup'`
- `created_via = 'api'`
- `api_endpoint` registra qué endpoint generó el registro
- `last_api_touched_at` se actualiza en cada consulta posterior

Una segunda consulta sobre la misma persona actualiza `last_api_touched_at` en lugar de crear un duplicado. La deduplicación es por organización, según el `MashupContact` / `MashupCompany` canónico.

### Cómo desactivar la captura

Puede desactivar la captura en tres niveles:

1. **Por llamada**: agregue `?capture=false` a un GET, o incluya `"capture": false` en el cuerpo JSON de un POST.
2. **Por clave de API**: configure la clave con la captura desactivada en **Configuración → API**.
3. **Para toda la organización**: desactive `auto_capture_enabled` en **Configuración de Studio → API**.

```bash
# Per-call opt-out via query string
curl "https://be.graph8.com/api/v1/enrichment/lookup/person?capture=false" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email": "jane@acme.com"}'

# Per-call opt-out via JSON body (POST)
curl -X POST "https://be.graph8.com/api/v1/enrichment/lookup/person" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email": "jane@acme.com", "capture": false}'
```

> **Caution: Próximamente**
> La auto-captura en CRM está aprobada y en proceso de implementación. El indicador de captura, la configuración por clave y el interruptor para toda la organización están documentados aquí para que pueda planificar en consecuencia, pero aún no están integrados en todos los endpoints. Hasta que la implementación esté completa, trate los resultados de búsqueda y consulta como de solo lectura y utilice [`/search/contacts/save`](https://docs.graph8.com/developers/search/#save-contacts-to-list) para persistir registros de forma explícita.

### Costo de la captura

La captura está incluida en la misma solicitud: no se aplica un doble cobro. En Platform, los registros capturados desde endpoints respaldados por el índice permanecen sin costo. En PAYG se paga el costo en créditos por registro una sola vez y el registro queda disponible.

---

## Límites de solicitudes

Todos los endpoints de la API de datos aplican un límite de **5 solicitudes/segundo por organización**, tanto en PAYG como en Platform.

- El límite es el mismo en ambos planes.
- **No existe un límite mensual** en los endpoints respaldados por el índice para Platform: "ilimitado" significa ilimitado dentro del límite de 5 rps.
- Superar el límite devuelve `429 Too Many Requests` con un encabezado `Retry-After`.

Consulte [Límites de solicitudes](https://docs.graph8.com/developers/rate-limits/) para estrategias de reintento y encabezados.

---

## Preguntas frecuentes

### ¿Necesito una tarjeta de crédito para comenzar?
No. Tanto PAYG (1,000 créditos gratuitos) como la prueba de Platform (2,500 créditos gratuitos) se inician sin tarjeta.

### ¿Por qué se requiere un correo corporativo?
graph8 es B2B: utilizamos el dominio del correo corporativo para identificar su organización y prevenir el abuso. Los proveedores de correo personal (gmail, yahoo, outlook, etc.) están bloqueados al registrarse.

### ¿El paquete ilimitado es realmente ilimitado?
Sí, dentro del límite de 5 rps. No existe un límite de volumen mensual en los endpoints respaldados por el índice para el plan Platform. El límite existe para mantener la estabilidad de la plataforma, no para medir el uso.

### ¿Qué cuenta como una llamada de enriquecimiento de "terceros"?
Todo lo que se ejecute bajo `POST /enrichment/enrich` y active la cascada a través de un proveedor externo (Prospeo, Dropcontact, Cognism, entre otros). La cascada consume créditos porque graph8 paga al proveedor por registro. Los endpoints de registro único `lookup/person` y `lookup/company` también consumen créditos en ambos planes: **2 créditos por búsqueda, que solo se cobran si hay coincidencia**.

### ¿Qué ocurre con mis datos guardados si bajo de plan?
Sus datos del CRM permanecen. Los registros capturados se mantienen en su espacio de trabajo, independientemente del plan. Solo perderá la capacidad de realizar nuevas llamadas que consuman créditos si su saldo llega a cero en PAYG.

### ¿Puedo cambiar entre PAYG y Platform?
Sí. El cambio a Platform es inmediato. El cambio de Platform a PAYG tiene efecto al final de su ciclo de facturación.

### ¿Las llamadas desde MCP y CLI se facturan de la misma manera?
Sí. El [servidor MCP](https://docs.graph8.com/developers/mcp/) y la [CLI](https://docs.graph8.com/developers/cli/) invocan internamente la misma API para desarrolladores: se aplican las mismas reglas de créditos y límites de solicitudes.

---

## Próximos pasos

- **[Autenticación](https://docs.graph8.com/developers/authentication/)**: cree una clave de API
- **[Límites de solicitudes](https://docs.graph8.com/developers/rate-limits/)**: encabezados de reintento y retroceso
- **[Búsqueda](https://docs.graph8.com/developers/search/)**: los endpoints de búsqueda respaldados por el índice
- **[Enriquecimiento](https://docs.graph8.com/developers/enrichment/)**: consulta directa vs. cascada, en detalle
