Autenticación
Claves de API, la URL base, qué permite cada scope de clave y cómo inician sesión los agentes de IA sin clave.
URL base
https://app.argorant.com/api/v1Claves de API
Inicia sesión en app.argorant.com/profile y crea una clave en Claves de API. Las claves empiezan por ag_live_ y se muestran una sola vez. Ponle a cada clave el nombre de lo que la usa, como zapier, ci o laptop, para poder revocar una sin romper las demás.
Envía la clave en cada llamada:
curl "https://app.argorant.com/api/v1/account" \
-H "Authorization: Bearer $ARGORANT_API_KEY"La respuesta te dice en nombre de quién actúa la clave, tu plan, tus créditos, cuántas solicitudes por minuto puede enviar la clave y lo que queda de los límites de hoy. Haz esta llamada antes de un trabajo grande.
Las claves de API funcionan durante la prueba de 7 días y en todos los planes. La herramienta de línea de comandos lee la misma clave desde npx argorant login o desde la variable ARGORANT_API_KEY.
Scopes
Una clave creada en la app tiene todos los scopes de abajo. Una clave más limitada recibe 403 con el código scope_missing cuando llama a algo fuera de sus scopes.
| Scope | Permite | Puede costar |
|---|---|---|
argorant:read_counts | Recuentos, listas de términos, la cuenta, leer campañas, la bandeja de entrada, los buzones y los webhooks | Nada |
argorant:search_segments | Vistas previas enmascaradas de personas y empresas | Nada |
argorant:manage_lists | Listas, campañas, lanzamientos, responder a respuestas, estados, buzones, la lista de bloqueo, webhooks, pedidos de buzones | Los pedidos de buzones cuestan dinero, tras un sí |
argorant:unlock_contacts | Desbloqueos, números de teléfono, enriquecimiento de personas, el buscador de correos | Créditos |
argorant:create_exports | Exportaciones y exportaciones de listas | Créditos |
argorant:verify_emails | Verificar tus propias listas | Créditos, medio crédito por verificación nueva |
Los agentes de IA inician sesión, nunca ven la clave
Los clientes MCP como Claude y ChatGPT se conectan a https://mcp.argorant.com/mcp e inician sesión con OAuth 2.1 (código de autorización con PKCE). Actúan en nombre de tu cuenta con los scopes que apruebas, y tu clave de API nunca acaba en un chat. Consulta Conectar un cliente.
Permisos dentro de un espacio de trabajo
Una clave actúa como la persona que la creó. Propietarios y miembros solo ven su propio espacio de trabajo. Algunas acciones, como pedir buzones, son del propietario del espacio de trabajo; un miembro recibe 403 con un mensaje claro que lo indica. Los elementos de otros espacios de trabajo siempre responden 404 not_found, igual que los elementos que no existen.
Introducción
Qué hace la API de Argorant, qué es gratis, qué cuesta créditos y cómo encajan la API, la herramienta de línea de comandos y el servidor MCP.
Errores y límites
La forma única de los errores, todos los códigos de error, el id de solicitud, los límites de solicitudes por plan, los límites de búsquedas y recuentos, los límites diarios, las páginas y los reintentos seguros.