Provedores de dados e parceiros de API
A maioria das ferramentas do KDP123 roda inteira no seu navegador. Algumas precisam de dados ao vivo, como listas de categorias da Amazon ou frases de palavras-chave. Esses pedidos passam pelo próprio servidor do KDP123 até um provedor nomeado, e a ferramenta mostra uma linha “Dados de” dizendo quem respondeu e o que foi enviado.
Como os pedidos são tratados
- Sem conta, sem cookies. O KDP123 remove cookies e cabeçalhos de login antes de encaminhar, e descarta qualquer cookie que o provedor devolva. Os provedores nunca veem a sua sessão do KDP123, porque não existe sessão.
- Só o que a ferramenta precisa. Cada endpoint abaixo lista exatamente o que envia, por exemplo a frase que você digitou. O resto do que você informa fica no seu navegador.
- Somente leitura e com limite. Só encaminhamos requisições GET para os caminhos listados, com um limite por IP no nosso servidor e o limite diário do próprio provedor.
- Falha em silêncio. Se um provedor está fora do ar, a parte da ferramenta que depende dele some; o resto continua funcionando.
Provedores atuais
KDPTopMesma equipe do KDP123
O KDPTop rastreia diariamente as listas de mais vendidos e de lançamentos da Amazon.com em cerca de 11,000 categorias de Books e Kindle Store. Adicionado em 2026-11-10. Termos.
| Endpoint | O que devolve | Envia | Limite | Usado por |
|---|---|---|---|---|
GET /api/kdptop/placement/resolve | Categorias de um livro por ASIN, ISBN ou link da Amazon | O ASIN, ISBN ou link que você cola e o formato | 10 consultas por dia por visitante | Localizador de categorias |
GET /api/kdptop/placement/recommend | Categorias que correspondem à descrição de um livro | A descrição que você digita e o formato | 30 consultas por dia por visitante | Localizador de categorias |
GET /api/kdptop/category/{node_id} | Último retrato de uma categoria da Amazon | O número da categoria | 60 consultas por dia por visitante | Localizador de categorias |
GET /api/kdptop/keywords/suggest | Frases de busca relacionadas da biblioteca de palavras-chave do KDPTop | A frase-semente que você digita | 30 consultas por dia por visitante | Montador de palavras-chave |
GET /api/kdptop/bsr-curve | A curva de BSR para vendas que o KDPTop usa | Nada | Em cache por uma hora | BSR para vendas |
GET /api/kdptop/today | O livro novo de destaque de hoje e as contagens das listas para a página inicial | Nada | Em cache por dez minutos | Faixa “Hoje no KDP” da página inicial |
Conectar a sua API
Se você opera um serviço de dados para KDP e quer que uma ferramenta gratuita do KDP123 o use, a API precisa cumprir tudo isto:
- Funciona sem login. O visitante nunca se cadastra nem conecta uma conta para usar a ferramenta.
- Sem rastrear os nossos visitantes. Sem cookies, fingerprinting nem revenda de consultas. Enviamos só a consulta em si e um IP encaminhado para o seu limite de uso.
- Crédito e um link de saída estão bem; um paywall, não. A ferramenta mostra o seu nome e um link “Abrir em” para o seu site. A resposta principal precisa ser utilizável no KDP123.
- Grátis, e sem efeito na ordenação. Não pagamos pelos dados e os provedores não nos pagam. Fornecer dados nunca muda a ordem nem a descrição da sua própria entrada.
- Limites declarados. Informe o limite diário por visitante e o tempo de cache da resposta, para a ferramenta poder dizê-los.
- Números com fonte. Explique como os dados são coletados, numa frase que possamos mostrar ao lado.
Cada provedor ganha um caminho /api/p/<provider>/ no nosso servidor, uma entrada data/providers/<provider>.yml e uma regra de encaminhamento; os modelos estão no repositório. Envie um e-mail para hello@kdp123.com com a documentação da sua API.
Chamando o próprio KDP123
O diretório é de dados abertos: tools.json e tools.csv (CC BY 4.0). A fórmula e os parâmetros de URL de cada calculadora estão em calculators.json, então um link como /free-tools/royalty-calculator/?price=12.99&pages=300 abre um resultado preenchido.