Credenciales de la API de SerpBase

Guía para obtener tokens, claves y conexiones

SerpBase usa una API Key para identificarte. La creas desde su panel, con tu cuenta de SerpBase, en un par de minutos. El panel está en inglés, así que los nombres de botones que aparecen entre comillas más abajo son los que verás literalmente en pantalla.

Crear la API Key

Una cuenta recién creada no tiene ninguna clave todavía: no hay que buscarla por el panel, hay que crearla.

  1. 1

    Entra en https://serpbase.dev/dashboard, o pulsa el botón 'Dashboard' que hay arriba a la derecha en su web.

  2. 2

    En el menú de la izquierda pulsa 'API Keys' (es la segunda opción, justo debajo de 'Overview').

  3. 3

    Si es una cuenta nueva verás 'Active Keys (0)' y el mensaje 'No active keys'. Es lo normal: la clave todavía no existe.

  4. 4

    Pulsa el botón 'New Key', arriba a la derecha.

  5. 5

    En la ventana 'Create New API Key' escribe un nombre en el campo 'Key Name' — por ejemplo Botize, así sabrás luego para qué era — y pulsa 'Create Key'.

  6. 6

    Verás el mensaje 'Key Created Successfully' y debajo tu clave completa, que empieza por 'sk-' seguido de una larga serie de letras y números. Cópiala con el icono de copiar que hay a su lado.

  7. 7

    Importante: la clave se muestra una sola vez. SerpBase lo advierte con 'Copy your key now. It won't be shown again.'. Cópiala y guárdala ANTES de pulsar 'I've saved my key': después ya no podrás volver a verla. Si la pierdes, no pasa nada grave, pero tendrás que crear otra nueva y revocar la anterior.

Conectar la cuenta en Botize

  1. 1

    Vuelve a Botize y pega la clave en el campo 'API Key' del formulario de conexión de SerpBase. Es el único dato que se pide.

  2. 2

    No copies la clave de la lista 'Active Keys' del panel: ahí aparece enmascarada, con la forma 'sk-b9e2****************358a'. Si pegas los asteriscos la conexión fallará.

  3. 3

    Al conectar, Botize hace una búsqueda real para comprobar que la clave funciona, y esa comprobación consume 1 crédito. Es normal que después te queden 99 de los 100 iniciales: no es un error.

  4. 4

    Si todo va bien, la cuenta aparecerá en tu lista de perfiles como 'SerpBase' seguido de 5 caracteres. Ese código no lo eliges tú: sirve para distinguir unas cuentas de otras si conectas varias.

Créditos y límites

  1. 1

    Los 100 créditos gratis aparecen en el panel como 'Permanent: 100'. Los permanentes no caducan.

  2. 2

    Cada búsqueda gasta 1 crédito por página de resultados. Consultar la posición de un dominio puede gastar hasta 3 créditos si pides mirar hasta el top 30.

  3. 3

    Para recargar, usa la opción 'Credits' del menú de la izquierda, o el enlace 'Top up' del recuadro de créditos.

  4. 4

    Una cuenta nueva viene con un límite de 1 petición por segundo ('Rate Limit: 1 req/s' en el panel).

Si algo falla

  1. 1

    'Your SerpBase API key is invalid or has been revoked' — la clave está mal copiada, incompleta (los asteriscos) o la has revocado. Crea una nueva siguiendo el apartado 'Crear la API Key' y vuelve a conectar.

  2. 2

    'The API key is mandatory' — el campo se ha enviado vacío. Pega la clave y guarda otra vez.

  3. 3

    'Your SerpBase account has run out of credits' — te has quedado sin créditos. Recarga desde 'Credits' y vuelve a intentarlo. Este mensaje puede salir ya al conectar, porque la comprobación consume 1 crédito.

  4. 4

    'Could not reach SerpBase to validate the key' — SerpBase no ha respondido en ese momento. Espera unos minutos y vuelve a intentarlo.