API | SAASLEDGE

La API devuelve sus propios datos y nada más: las fichas de su cuenta, cómo han rendido, las reseñas que la gente dejó en ellas y los competidores que tiene en seguimiento. Es una API de solo lectura. Todo lo que modifica datos se hace en el panel, de modo que una clave filtrada puede copiar sus cifras, pero no puede editar su ficha, no puede gastar dinero y no puede tocar la cuenta de nadie más.

Es gratuita, como todo lo demás aquí. Cada cuenta puede emitir una clave desde el panel.

La clave

Cree la clave en su panel, en la pestaña Herramientas de fichas, en el bloque llamado Exportaciones y acceso a la API. Tiene el aspecto de sl_ seguido de 48 caracteres hexadecimales, y el panel muestra la fecha en que se emitió.

Una clave por cuenta. Al pulsar Nueva clave se emite una nueva y la anterior deja de funcionar en ese momento. No hay periodo de gracia ni una segunda clave en paralelo, así que cámbiela cuando esté preparado para actualizar lo que la usa.

Rótela si acabó en un repositorio público, un documento compartido, un navegador o un servicio que dejó de usar. Rotarla lleva un clic y no cuesta nada.

Revóquela eliminándola en el mismo bloque. La cuenta sigue funcionando, solo se detiene el acceso a la API.

Trate la clave como una contraseña. Guárdela en un servidor, en una variable de entorno o en un almacén de secretos, nunca en código de front end: todo lo que está en un navegador lo puede leer quien abra la página. A propósito, no enviamos cabeceras CORS en estos endpoints, de modo que una página de otro dominio no puede llamarlos con su clave desde el navegador.

Cómo llamarla

Cada petición lleva la clave en la cabecera Authorization. La dirección base es https://saasledge.com/api/v1.

curl -H "Authorization: Bearer sl_your_key" \
  https://saasledge.com/api/v1/me

Las respuestas son JSON con "ok": true. Los errores mantienen la misma forma con "ok": false y un código breve legible por máquina.

Estado	Código	Qué significa
401	`unauthorized`	Sin clave, una clave mal formada o una clave que ya no existe
402	`plan_required`	La clave es real, pero la cuenta no está en Studio
429	`rate`	Más de 120 peticiones en un minuto con esta clave

El límite es de 120 peticiones por minuto y por clave. Es generoso para una exportación nocturna y justo para un bucle que se olvidó de detenerse.

GET /api/v1/me

La cuenta que hay detrás de la clave y los límites con los que se cuenta todo lo demás. Úsela como comprobación de estado.

{
  "ok": true,
  "account": {
    "email": "[email protected]",
    "products": 3,
    "since": "2026-08-13"
  },
  "key": { "issued_at": "2026-08-14 09:12:33" },
  "limits": {
    "products": 25,
    "watches": 25
  },
  "rate": { "limit": 120, "per": "minute" }
}

GET /api/v1/products

Sus fichas con todo lo publicado en ellas: estado, categoría, modelo de precios, planes, número de capturas de pantalla, número de reseñas y valoración media. Cada elemento incluye url_on_saasledge, la dirección pública de la ficha.

curl -H "Authorization: Bearer sl_your_key" \
  https://saasledge.com/api/v1/products

GET /api/v1/stats

Visitas a sus fichas y clics hacia su sitio web, agrupados por día.

Parámetro	Valor por defecto	Notas
`days`	30	De 1 a 365
`product`	todos	El slug de una ficha, por ejemplo `wave`
`format`	json	`csv` devuelve un archivo con las columnas `product,day,views,clicks`

Los días sin eventos no se devuelven. Los totales se calculan por usted en totals, incluida la tasa de clics como porcentaje.

curl -H "Authorization: Bearer sl_your_key" \
  "https://saasledge.com/api/v1/stats?days=90&format=csv" -o stats.csv

GET /api/v1/reviews

Reseñas publicadas en sus fichas, con sus respuestas y las fechas. without_reply cuenta las que siguen esperando respuesta, que es la cifra sobre la que conviene configurar una alerta.

Parámetro	Valor por defecto	Notas
`days`	90	De 1 a 365
`product`	todos	El slug de una ficha

Las direcciones de correo de quienes escriben las reseñas nunca se devuelven. Se recogen para que podamos comprobar una reseña, no para enviarles correo.

GET /api/v1/watches

Los competidores de su lista de seguimiento: precio de entrada actual y anterior al último cambio, número de planes, indicadores de plan gratuito y de prueba, valoración, número de reseñas y el historial de precios dentro del periodo. La misma respuesta incluye mine, el precio de entrada y el número de planes de sus propias fichas activas, de modo que una comparación necesita una petición en lugar de dos.

Parámetro	Valor por defecto	Notas
`days`	90	De 1 a 365, se aplica al historial de precios

Lo que la API no hará

No mostrará datos privados de otro proveedor, no escribirá nada y no exportará todo el catálogo. La copia masiva del catálogo no es algo que vendamos ni algo que la clave abra.

Preguntas, o un caso de uso que necesite un campo que todavía no devolvemos: escriba a [email protected] e indique qué está creando.