API

A API devolve os seus próprios dados e nada além disso: os cadastros da sua conta, o desempenho deles, as avaliações que as pessoas deixaram neles e os concorrentes que você colocou em monitoramento. É uma API de leitura. Tudo o que altera dados acontece no painel, então uma chave vazada pode copiar os seus números, mas não pode editar o seu cadastro, não pode gastar dinheiro e não pode tocar na conta de mais ninguém.

Ela é gratuita, como todo o resto aqui. Toda conta pode gerar uma chave no painel.

A chave

Crie a chave no seu painel, na aba Listing tools, no bloco chamado Exports and API access. Ela se parece com sl_ seguido de 48 caracteres hexadecimais, e o painel mostra a data em que foi emitida.

Uma chave por conta. Ao clicar em New key, uma nova é emitida e a chave anterior para de funcionar naquele instante. Não há período de carência nem uma segunda chave em paralelo, então troque quando estiver pronto para atualizar tudo o que a usa.

Gere uma nova se ela foi parar em um repositório público, em um documento compartilhado, em um navegador ou em um serviço que você deixou de usar. A rotação leva um clique e não custa nada.

Revogue-a excluindo-a no mesmo bloco. A conta continua funcionando, só o acesso à API para.

Trate a chave como uma senha. Guarde-a em um servidor, em uma variável de ambiente ou em um cofre de segredos, nunca em código de front end: tudo o que está em um navegador pode ser lido por quem abrir a página. Não enviamos cabeçalhos CORS nesses endpoints de propósito, para que uma página de navegador em outro domínio não consiga chamá-los com a sua chave.

Como chamar

Toda requisição leva a chave no cabeçalho Authorization. O endereço base é https://saasledge.com/api/v1.

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

As respostas são JSON com "ok": true. Os erros mantêm o mesmo formato, com "ok": false e um código curto legível por máquina.

O limite é de 120 requisições por minuto por chave. É folgado para uma exportação noturna e apertado para um laço que esqueceu de parar.

GET /api/v1/me

A conta por trás da chave e os limites contra os quais todo o resto é contado. Use como verificação de funcionamento.

{
  "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

Os seus cadastros com tudo o que está publicado neles: estado, categoria, modelo de preços, planos, número de capturas de tela, número de avaliações e nota média. Cada item traz url_on_saasledge, o endereço público do cadastro.

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

GET /api/v1/stats

Visualizações dos seus cadastros e cliques até o seu site, agrupados por dia.

Dias sem eventos não são devolvidos. Os totais são calculados para você em totals, inclusive a taxa de cliques em porcentagem.

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

GET /api/v1/reviews

Avaliações publicadas nos seus cadastros, com as suas respostas e as datas. without_reply conta as que ainda esperam uma resposta, que é o número que vale a pena monitorar com alerta.

Os endereços de e-mail de quem avaliou nunca são devolvidos. Eles são coletados para que possamos conferir uma avaliação, não para receberem mensagens.

GET /api/v1/watches

Os concorrentes da sua lista de monitoramento: preço de entrada agora e antes da última mudança, número de planos, indicadores de plano gratuito e de teste, nota, número de avaliações e o histórico de preços dentro do período. A mesma resposta traz mine, o preço de entrada e o número de planos dos seus próprios cadastros no ar, de modo que uma comparação exige uma requisição e não duas.

O que a API não vai fazer

Ela não vai mostrar dados privados de outro fornecedor, não vai gravar nada e não vai exportar o catálogo inteiro. A cópia em massa do catálogo não é algo que vendemos e não é algo que a chave abre.

Dúvidas, ou um caso de uso que precise de um campo que ainda não devolvemos: escreva para [email protected] e diga o que você está construindo.