Directorios MX

API PAYG

Consulta cobertura y busca empresas con créditos. Ideal para agentes, MCP y pipelines internos. Auth: Authorization: Bearer dmx_… o header X-Api-Key.

1. Genera tu API key

Self-serve incluye 25 créditos de prueba. Guarda la key: solo se muestra una vez.

2. Compra créditos

Stats = 1 crédito · Search = 1 crédito por resultado · /me gratis.

Starter

Ideal para probar search + stats en un piloto.

$490

1,000 créditos

Growth

Para equipos de ventas que consultan diariamente.

$2,990

10,000 créditos

Scale

Volumen para integraciones y agentes MCP.

$9,990

50,000 créditos

Packs de créditos

Stats = 1 crédito · Search = 1 crédito / hit · /me gratis. Search en modo demo devuelve firmográficos (email/tel enmascarados) — sin dump de PII sin créditos + warehouse.

PackCréditosPrecio MXN
Starter1,000$490
Growth10,000$2,990
Scale50,000$9,990

Endpoints

  • GET /api/stats — público (segment, estado, tier)
  • GET /api/stats/summary — snapshot nacional
  • GET /api/v1/stats — Bearer,1 crédito
  • GET /api/v1/search — Bearer,1 crédito / hit (firmográficos)
  • GET /api/v1/me — saldo
  • POST /api/developers/keys — mint key (self-serve 25 créditos; con x-admin-token / ADMIN_TOKEN: 100)
# Mint
curl -X POST https://directoriosb2b.mx/api/developers/keys \
  -H 'Content-Type: application/json' \
  -d '{"email":"tu@empresa.com","label":"piloto"}'

# Stats (1 crédito)
curl -H "Authorization: Bearer dmx_…" \
  "https://directoriosb2b.mx/api/v1/stats?segment=retail&tier=corporate"

# Search firmográfico
curl -H "Authorization: Bearer dmx_…" \
  "https://directoriosb2b.mx/api/v1/search?q=metal&limit=5"

# Saldo
curl -H "Authorization: Bearer dmx_…" \
  https://directoriosb2b.mx/api/v1/me

Docs: docs/payg-api.md. MCP: mcp/README.md — tools directorios_stats, directorios_search, directorios_credits.