Descripción general de la REST API

La REST API le brinda acceso HTTP directo a contactos, empresas, listas, enriquecimiento, búsqueda, secuencias y webhooks. Cualquier lenguaje de programación, cualquier plataforma.

Referencia rápida

URL base: https://be.graph8.com/api/v1
Autenticación: Authorization: Bearer YOUR_API_KEY (detalles)
Formato: Solicitud/respuesta en JSON
Documentación: Swagger interactivo →

Contactos

Liste, cree, actualice y elimine contactos en su espacio de trabajo. Ver referencia →

Empresas

Liste, actualice y elimine empresas, junto con sus contactos asociados. Ver referencia →

Búsqueda

Encuentre contactos y empresas en la base de datos global de graph8, con más de 300M de registros. Ver referencia →

Enriquecimiento

Busque personas y empresas, ejecute enriquecimiento en cascada y verifique correos electrónicos. Ver referencia →

Listas

Cree listas, gestione membresías y organice contactos para campañas. Ver referencia →

Secuencias

Liste, ejecute y gestione secuencias de correo electrónico automatizadas. Ver referencia →

Engagement: Ciclo de vida de secuencias | Bandeja de entrada

GTM: Campañas GTM | Contexto GTM

Sincronización: Sincronización de audiencias | Sincronización de CRM

Público (navegador, write key): Endpoints públicos

Referencia: Precios | Paginación | Errores | Límites de velocidad

La API para desarrolladores de graph8 le permite descubrir nuevos prospectos, gestionar los datos de su CRM y enriquecer la información de contactos de forma programática, todo a través de una única REST API.

Cómo funcionan los datos en graph8

graph8 le brinda acceso a dos conjuntos de datos diferenciados. Comprender la diferencia es clave para utilizar la API de manera efectiva.

Sus datos (propios)

Estos son datos de su propiedad: contactos y empresas que residen en su espacio de trabajo de graph8. Llegaron allí mediante una de estas vías:

Guardó resultados de búsqueda del índice de datos abiertos (mediante /search/contacts/save)
Importó contactos desde un CSV o una integración de CRM
Los creó manualmente mediante la API (con POST /contacts)
Se crearon automáticamente durante flujos de trabajo de enriquecimiento o campañas

Usted tiene acceso completo de lectura y escritura sobre sus datos. Consúltelos, actualícelos, elimínelos u organícelos en listas, sin costo en créditos.

Endpoints: /contacts, /companies, /lists

Índice de datos abiertos

Esta es la base de datos B2B global de graph8: millones de contactos y empresas agregados desde múltiples proveedores de datos. Piense en ella como una guía telefónica del mundo empresarial: nombres, cargos, correos electrónicos, números de teléfono, datos de empresas y mucho más.

Puede buscar en este índice con filtros (cargo, industria, tamaño de empresa, ubicación, etc.) y guardar los resultados coincidentes en su espacio de trabajo. Una vez guardados, pasan a ser sus datos.

También puede consultar a una persona o empresa por correo electrónico, URL de LinkedIn o dominio.

Las consultas al índice de datos abiertos consumen créditos.

Endpoints: /search/contacts, /search/companies, /enrichment/lookup

El flujo de datos

El flujo de trabajo típico traslada los datos de abiertos a propios:

┌─────────────────────────────────────────────────────────────────┐
│                                                                 │
│   1. DISCOVER            2. SAVE              3. MANAGE         │
│                                                                 │
│   /search/contacts  ──►  /search/.../save  ──►  /contacts      │
│   /search/companies      (creates a list)       /companies      │
│   /enrichment/lookup                            /lists          │
│                                                                 │
│   Open data index        Moves into your        Full CRUD on    │
│   (read-only, credits)   workspace as a list    your data (free)│
│                                                                 │
│                          4. ENRICH                              │
│                          /enrichment/enrich                     │
│                          Fill missing fields                    │
│                          on your saved contacts                 │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

Cómo elegir el endpoint correcto

Quiero…	Usar	PAYG	Plataforma
Encontrar nuevos contactos que coincidan con mi ICP	`POST /search/contacts`	1 por registro devuelto	Gratuito (dentro de 5 rps)
Encontrar nuevas empresas por industria, tamaño, etc.	`POST /search/companies`	1 por registro devuelto	Gratuito (dentro de 5 rps)
Guardar resultados de búsqueda en mi espacio de trabajo	`POST /search/contacts/save`	1 por registro guardado	Gratuito (dentro de 5 rps)
Consultar a una persona por correo electrónico o LinkedIn	`POST /enrichment/lookup/person`	2 por consulta	Gratuito (dentro de 5 rps)
Consultar una empresa por dominio	`POST /enrichment/lookup/company`	2 por consulta	Gratuito (dentro de 5 rps)
Listar contactos ya guardados	`GET /contacts`	Gratuito	Gratuito
Listar empresas en mi espacio de trabajo	`GET /companies`	Gratuito	Gratuito
Gestionar mis listas	`GET /lists`	Gratuito	Gratuito
Completar correos o teléfonos faltantes en mis contactos (cascada)	`POST /enrichment/enrich`	Variable por contacto	Variable por contacto
Verificar una dirección de correo electrónico (validador interno)	`POST /enrichment/verify-email`	1 por correo	Gratuito (dentro de 5 rps)

Consulte Precios para ver el mapa completo de créditos y la comparación de planes.

URL base

https://be.graph8.com/api/v1

Todos los endpoints son relativos a esta URL base. Por ejemplo, para listar contactos:

GET https://be.graph8.com/api/v1/contacts

Inicio rápido

export API_KEY="YOUR_API_KEY"

# 1. Search the open data index for CTOs at tech companies
curl -X POST "https://be.graph8.com/api/v1/search/contacts" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "filters": [
      {"field": "job_title", "operator": "any_of", "value": ["CTO", "VP Engineering"]},
      {"field": "company_employee_count", "operator": "between", "value": [50, 500]}
    ],
    "limit": 5
  }'

# 2. Save matching contacts to a list in your workspace
curl -X POST "https://be.graph8.com/api/v1/search/contacts/save" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "filters": [
      {"field": "job_title", "operator": "any_of", "value": ["CTO", "VP Engineering"]},
      {"field": "company_employee_count", "operator": "between", "value": [50, 500]}
    ],
    "list_title": "Tech CTOs"
  }'

# 3. Query your saved contacts (free, no credits)
curl "https://be.graph8.com/api/v1/contacts?list_id=42&limit=10" \
  -H "Authorization: Bearer $API_KEY"

import requests

API_KEY = "YOUR_API_KEY"
BASE_URL = "https://be.graph8.com/api/v1"
HEADERS = {"Authorization": f"Bearer {API_KEY}"}

# 1. Search the open data index for CTOs at tech companies
results = requests.post(
    f"{BASE_URL}/search/contacts",
    headers=HEADERS,
    json={
        "filters": [
            {"field": "job_title", "operator": "any_of", "value": ["CTO", "VP Engineering"]},
            {"field": "company_employee_count", "operator": "between", "value": [50, 500]}
        ],
        "limit": 5
    }
).json()

print(f"Found {results['pagination']['total']} matches")

# 2. Save matching contacts to a list in your workspace
save = requests.post(
    f"{BASE_URL}/search/contacts/save",
    headers=HEADERS,
    json={
        "filters": [
            {"field": "job_title", "operator": "any_of", "value": ["CTO", "VP Engineering"]},
            {"field": "company_employee_count", "operator": "between", "value": [50, 500]}
        ],
        "list_title": "Tech CTOs"
    }
).json()

list_id = save["data"]["list_id"]

# 3. Query your saved contacts (free, no credits)
contacts = requests.get(
    f"{BASE_URL}/contacts",
    headers=HEADERS,
    params={"list_id": list_id, "limit": 10}
).json()

for c in contacts["data"]:
    print(f"{c['first_name']} {c['last_name']} - {c['work_email']}")

const API_KEY = "YOUR_API_KEY";
const BASE_URL = "https://be.graph8.com/api/v1";
const headers = { Authorization: `Bearer ${API_KEY}`, "Content-Type": "application/json" };

// 1. Search the open data index for CTOs at tech companies
const results = await fetch(`${BASE_URL}/search/contacts`, {
  method: "POST",
  headers,
  body: JSON.stringify({
    filters: [
      { field: "job_title", operator: "any_of", value: ["CTO", "VP Engineering"] },
      { field: "company_employee_count", operator: "between", value: [50, 500] }
    ],
    limit: 5
  }),
}).then(r => r.json());

console.log(`Found ${results.pagination.total} matches`);

// 2. Save matching contacts to a list in your workspace
const save = await fetch(`${BASE_URL}/search/contacts/save`, {
  method: "POST",
  headers,
  body: JSON.stringify({
    filters: [
      { field: "job_title", operator: "any_of", value: ["CTO", "VP Engineering"] },
      { field: "company_employee_count", operator: "between", value: [50, 500] }
    ],
    list_title: "Tech CTOs"
  }),
}).then(r => r.json());

// 3. Query your saved contacts (free, no credits)
const contacts = await fetch(
  `${BASE_URL}/contacts?list_id=${save.data.list_id}&limit=10`,
  { headers: { Authorization: `Bearer ${API_KEY}` } }
).then(r => r.json());

contacts.data.forEach(c =>
  console.log(`${c.first_name} ${c.last_name} - ${c.work_email}`)
);

Referencia de endpoints

Descubrir (datos abiertos: créditos)

Búsqueda

Encuentre contactos y empresas en la base de datos B2B global de graph8 usando filtros como cargo, industria, tamaño de empresa y ubicación. Ver referencia

Enriquecimiento

Consulte a una persona o empresa, ejecute enriquecimiento en cascada entre proveedores y verifique la entregabilidad del correo electrónico. Ver referencia

Gestionar (sus datos: gratuito)

Contactos

Liste, cree, actualice y elimine contactos en su espacio de trabajo. Ver referencia

Empresas

Liste, actualice y elimine empresas, junto con sus contactos asociados. Ver referencia

Listas

Cree listas, gestione membresías y organice contactos para campañas. Ver referencia

Referencia

Precios

Planes, costos de créditos, el paquete de API ilimitada y el comportamiento de captura automática en el CRM. Ver precios

Autenticación

Cree claves de API y autentique sus solicitudes. Comenzar

Paginación

Estructura de respuesta y patrones de paginación. Más información

Errores

Códigos de error y estrategias de manejo. Más información

Límites de velocidad

Límites de solicitudes y estrategias de reintento. Más información

Referencia interactiva de la API

Para una vista interactiva y en tiempo real de todos los endpoints, con esquemas de solicitud y respuesta, visite la documentación OpenAPI:

Abrir documentación interactiva de la API →

Puede probar los endpoints directamente desde el navegador: autentíquese con su clave de API y ejecute solicitudes en tiempo real.

Formato de respuesta

Todas las respuestas utilizan una estructura estándar:

{
  "data": { ... },
  "pagination": {
    "page": 1,
    "limit": 50,
    "total": 243,
    "has_next": true
  }
}

Las respuestas de un solo recurso incluyen data sin pagination. Consulte Paginación para más detalles.