Preguntas frecuentes sobre la API de SE Ranking

Q Recibo un error 402 "Fondos insuficientes", pero mi dashboard muestra créditos disponibles. ¿Qué ocurre?

A Este error se devuelve con el mensaje Insufficient funds, API key is temporarily disabled. Es el problema más común entre los nuevos clientes. Normalmente significa que tu clave API aún no se ha vinculado completamente a tus créditos. Esto puede ocurrir justo después de una compra o tras un cambio de plan. Espera unos minutos y vuelve a intentarlo. Si el error persiste durante más de 10 minutos, contáctanos y nuestro equipo de soporte te ayudará a resolver el problema.

Q Recibo un error 401 Unauthenticated. ¿Qué significa?

A El error 401 es un fallo de autenticación, no un problema de créditos. La solicitud no incluía una clave API válida, por lo que el saldo de la cuenta no influye: puedes recibir un 401 incluso con el API Wallet totalmente cargado.

Qué comprobar:

• que la clave se envíe en la solicitud exactamente como aparece en el dashboard de la API, sin cortes ni espacios adicionales;
• que la clave siga existiendo: una clave eliminada o rotada deja de autenticar de inmediato;
• que estés usando el tipo de clave que espera el endpoint (consulta ¿Puedo usar la misma clave API para los endpoints de Datos y Proyectos?).

Si la clave es correcta y está vigente y sigues recibiendo un 401, contáctanos e indícanos el nombre de la clave y la hora de una solicitud fallida.

Q Recibo un error 403, pero mi API Wallet muestra créditos disponibles. ¿Qué significa?

A El error 403 significa que la cuenta no tiene acceso a la Data API en este momento, algo distinto de cuánto saldo hay en el Wallet. El acceso a la Data API proviene de una suscripción o un complemento activos; el saldo del Wallet por sí solo no cuenta para esa comprobación. Por eso una cuenta puede tener créditos y aun así recibir un rechazo.

Qué comprobar:

• si el plan o el complemento que concede el acceso a la Data API sigue activo y no ha caducado ni se ha reducido;
• si estás llamando desde una subcuenta o desde una cuenta de cliente de agencia en lugar de la cuenta principal que tiene el acceso;
• el dashboard de la API, que muestra el acceso a la Data API y el saldo del Wallet como dos cosas independientes.

Si el complemento parece activo y sigues recibiendo un 403, contáctanos y revisaremos el acceso de la cuenta.

Q ¿Puedo usar la misma clave API para los endpoints de Datos y Proyectos?

A Sí. Una sola clave API autentica solicitudes tanto para endpoints de Datos como de Proyectos. Ambos tipos de endpoints se sirven desde api.seranking.com a través del gateway de la Data API, por lo que no necesitas una clave separada para la Project API.

Q He alcanzado el límite de solicitudes mientras hacía pruebas. ¿Cómo puedo saber qué límites tiene mi plan?

A Los límites de solicitudes varían según el plan y pueden alcanzarse rápidamente al hacer pruebas a gran escala. Los límites de tu plan están indicados en la documentación. Te recomendamos revisarlos antes de ejecutar consultas masivas para ajustar la frecuencia de tus solicitudes.

Q ¿Cómo puedo saber cuántos créditos cuesta cada llamada a la API?

A El coste en créditos varía según el endpoint. Antes de ejecutar procesos grandes, revisa el coste por endpoint en la documentación para estimar el consumo. También puedes consultar el saldo de tus créditos en tiempo real desde el dashboard de la API.

Q Veo el mensaje “Tu plan no incluye créditos de la API. Actualiza tu plan o recarga tu saldo para comenzar.” ¿Qué significa?

A Significa que tu suscripción o saldo actual aún no incluye créditos de la Data API. Para empezar a hacer llamadas, actualiza a un plan que incluya créditos de la Data API o recarga el saldo de tu cuenta, y después crea o conserva tu clave API. Si crees que ya deberías tener créditos disponibles, contáctanos.

Q ¿Cómo puedo controlar el uso de mis créditos de la API y ver el coste de cada solicitud?

A Puedes consultar el saldo actual de tus créditos en cualquier momento desde el dashboard de la API, y los costes por endpoint están indicados en la documentación para que puedas estimar el consumo antes de ejecutar procesos grandes.

Q Compré saldo en mi cuenta, pero la Data API sigue mostrando "No API access". ¿Por qué?

A El saldo de una cuenta de SE Ranking financia las herramientas de pago por uso de SE Ranking (como el Agrupador de palabras clave y el Comprobador de volumen de búsqueda). No reactiva el acceso a la Data API en una cuenta cuyo período de prueba ha finalizado. La Data API requiere un plan de pago activo que incluya créditos de API o créditos de API de pago por uso exclusivos. Si tu período de prueba ha terminado, añadir saldo por sí solo no restablecerá el acceso a la Data API. Actualiza a un plan que incluya créditos de la Data API o compra créditos de API de pago por uso exclusivos. Si crees que el acceso a la API ya debería estar activo, contáctanos.

Q ¿Cómo funcionan los créditos del API Wallet (pago por uso) y en qué orden se consumen mis créditos?

A El API Wallet contiene créditos de pago por uso exclusivos para la Data API y es independiente del saldo general de tu cuenta de SE Ranking (que financia las herramientas de pago por uso como el Agrupador de palabras clave y el Comprobador de volumen de búsqueda). A diferencia de ese saldo general, los créditos del API Wallet sí dan acceso a la Data API. Una primera recarga del API Wallet puede activar la Data API aunque tu plan o tu período de prueba haya finalizado.

Dónde encontrarlo: el saldo de tu API Wallet aparece en la tarjeta principal del dashboard de la API y en una sección específica, «Wallet», donde puedes recargar, configurar la recarga automática, activar alertas de saldo bajo y consultar tu historial de transacciones. La recarga automática y las alertas de saldo bajo aparecen en la página «Wallet» como «Coming soon» y todavía no se pueden configurar.

Orden en que se consumen los créditos: primero se consumen los créditos de la API incluidos en tu plan y en cualquier paquete adicional; el saldo de tu API Wallet solo se utiliza cuando esos créditos incluidos llegan a cero.

¿Acabas de recargar pero aún no ves el acceso? Tras una compra, los créditos se aplican en segundo plano y tu saldo se actualiza tras una breve espera, por lo que el acceso puede no aparecer de inmediato. Espera un momento y actualiza el dashboard de la API. Si un saldo comprado sigue sin reflejarse, contáctanos.

Q ¿Los créditos del API Wallet caducan o se reinician cada mes?

A No. Los créditos del API Wallet se compran como una recarga puntual de pago por uso. No caducan ni se reinician al comienzo de un período de facturación: el saldo del Wallet que no uses se conserva hasta que lo gastes.

Con los créditos de la API incluidos en un plan o en un paquete adicional ocurre lo contrario: se renuevan con tu ciclo de facturación y no se acumulan. Como los créditos del plan y de los paquetes adicionales se consumen primero, normalmente solo se utiliza el saldo del Wallet cuando la asignación renovable de ese período se ha agotado.

Q ¿Qué planes y tipos de cuenta pueden recargar el API Wallet?

A No existe ninguna restricción por plan para comprar créditos del API Wallet. Las cuentas Core y Growth pueden recargar el API Wallet, y también pueden hacerlo otros planes de pago: la comprobación se aplica a la cuenta, no al nombre del plan.

La recarga no está disponible cuando:

• has iniciado sesión en una subcuenta: la compra debe realizarse desde la cuenta principal;
• la cuenta es una cuenta de cliente creada dentro de un espacio de trabajo de agencia;
• la cuenta no tiene ningún registro de suscripción asociado;
• los créditos no tendrían dónde asignarse, por ejemplo, en un plan activo que no incluye ninguna cuota de la Data API.

Si esperas poder recargar y la opción no está disponible, contáctanos y revisaremos la cuenta.

Q ¿Por qué mis créditos del API Wallet no aparecen en la respuesta de /account/subscription?

A Es el comportamiento esperado. El endpoint /account/subscription informa únicamente del estado de tu suscripción: saldo, tipo y si ha caducado. No incluye los créditos del API Wallet, por lo que una recarga del Wallet no cambiará lo que devuelve ese endpoint. En su lugar, consulta el saldo de tu API Wallet en el dashboard de la API. Si compraste créditos del Wallet y tampoco aparecen allí, contáctanos.

Q ¿Puedo eliminar, regenerar o restringir una clave API?

A Gestionas tus claves en el dashboard de la API, en la tabla de claves API.

• Eliminar: puedes eliminar una clave de la Data API desde la tabla de claves. No es posible eliminar la última clave de la Data API que te quede: crea primero una clave de reemplazo y después elimina la antigua.
• Regenerar: la clave de la Project API se puede rotar, lo que genera un valor nuevo e invalida el anterior. Actualiza todas las integraciones que la utilicen justo después de rotarla.
• Restringir: actualmente las claves API no se pueden acotar ni restringir: no existe ninguna opción para listas de IP permitidas, alcances por endpoint ni permisos por clave. Una clave se crea únicamente con un tipo y un nombre. Si crees que una clave ha quedado expuesta, elimínala o rótala en lugar de intentar limitarla.

Si necesitas revocar una clave con urgencia, contáctanos.