Respuesta rápida
¿Cómo compruebo si la API SERP de SerpCrypto funciona?
Llama a GET https://serpcrypto.com/api/v1/credits con tu clave: es gratis y responde en JSON con tus créditos restantes. Un 200 significa que la API y tu clave funcionan. Los errores 502 y 504 provienen de una búsqueda fallida y nunca se cobran. SerpCrypto publica incidencias en el changelog; no publica ninguna cifra de uptime hasta que se mida.
curl -s https://serpcrypto.com/api/v1/credits -H "Authorization: Bearer $SERPCRYPTO_API_KEY"¿Qué significa cada respuesta?
| Estado HTTP | Significado | ¿Se cobra? | Qué hacer |
|---|---|---|---|
| 200 | La API funciona; en una búsqueda, los resultados están en el cuerpo | 1 crédito por una búsqueda exitosa; la comprobación de créditos es gratuita | Nada |
401 invalid_api_key | La clave falta, es incorrecta o fue revocada | No | Copia la clave de nuevo desde el panel |
402 insufficient_credits | Tu cuenta no tiene créditos disponibles | No | Compra un pack en la página de precios |
429 concurrency_limit | Demasiadas búsquedas al mismo tiempo | No | Reduce las peticiones en paralelo o solicita un límite mayor |
502 search_failed | La búsqueda no se pudo completar | No | Reintenta tras una breve espera |
504 search_timeout | Sin respuesta a tiempo | No | Reintenta tras una breve espera |
¿El problema está de mi lado, del nuestro o del motor?
Ejecuta primero la comprobación gratuita, luego una búsqueda simple y después tu petición real. Cada paso aísla una capa.
- La llamada de créditos falla con 401: el problema es la clave. Revisa el formato del header:
Authorization: Bearer <key>, con un espacio. - La llamada de créditos funciona pero todas las búsquedas devuelven 502: la capa de recolección o el motor están fallando para todos. Espera unos minutos y reintenta; mientras tanto no se cobra nada.
- Una consulta simple funciona pero la tuya falla con 400: algún parámetro está fuera de la lista permitida. La referencia de búsqueda enumera todos los valores.
- Los resultados difieren de los de tu navegador: normalmente es por ubicación, idioma o dispositivo. Configura
gl,hl,locationydevicepara que coincidan con lo que comparas; consulta ubicaciones e idiomas.
¿Dónde se publican las incidencias y los cambios?
En el changelog. Cada entrada tiene una fecha, qué se vio afectado (un motor, un campo, el área de cliente o los pagos) y qué cambió. Un campo que se añade también aparece ahí, para que un parser pueda actualizarse antes de necesitar ese campo.
No mantenemos un sitio de estado separado, y esta página no muestra ninguna luz verde que pueda estar desactualizada. La comprobación gratuita de arriba te dice el estado real de la API para tu clave, en el momento en que preguntas.
¿Por qué no hay un porcentaje de uptime aquí?
Porque aún no hemos medido uno con un método publicado. Una cifra de uptime implica una sonda definida, un periodo definido y un fallo definido. Cuando lo tengamos, aparecerá aquí con su método y su fecha. Hasta entonces, la promesa honesta es la regla de facturación: 1 crédito = 1 consulta correcta, que devuelve una página de resultados en cualquier motor compatible. Una consulta fallida no se cobra.
¿Qué debo enviar a soporte durante una incidencia?
Escribe a [email protected] con el ID de la petición de search_metadata.id (o la hora de la petición si no hubo respuesta), el motor, el estado HTTP y el código de error. Nunca incluyas tu clave API. Respuestas por email en menos de 12 horas, 7 días a la semana, incluida la ayuda con la integración de la API. La página de contacto enumera los otros datos que aceleran una respuesta.