# Termos da API

Estes termos valem para quem usa a API pública da Joonow (`/api/v1`) e o servidor MCP (`/mcp`), com ou sem chave. Eles completam os [Termos de uso](/pt-br/termos-de-uso) e a [Política de privacidade](/pt-br/politica-de-privacidade). Ao usar a API ou o MCP, você concorda com eles. Se não concordar, não use.

A API e o MCP são oferecidos por HERO TECNOLOGIA LTDA, CNPJ 23.073.946/0001-83, com sede no Brasil.

## O que a API oferece

Leitura das vagas abertas, das empresas com vagas e do Índice Joonow de Vagas, os mesmos dados que qualquer pessoa vê no site. A API não cria, altera nem apaga nada, e não entrega dados pessoais de candidatos. A documentação fica na página [Para desenvolvedores](/pt-br/desenvolvedores).

## Chaves de acesso

- A chave é grátis e é criada na sua conta, em "Desenvolvedores". Ela aparece uma única vez: guarde num lugar seguro.
- A chave é sua. Não a publique em código aberto, aplicativo ou página que outras pessoas possam ler. Se ela vazar, revogue e crie outra.
- Você responde pelo uso feito com as suas chaves.
- Sem chave, a API e o MCP também funcionam, com limites menores por endereço de IP.

## Limites de uso

- **Com chave:** 60 chamadas por minuto e 10 mil por dia (o dia vira à meia-noite UTC).
- **Sem chave:** 10 chamadas por minuto por IP na API e 30 por minuto por IP no MCP.
- Passou do limite, a resposta é 429 com o cabeçalho `Retry-After`. Os limites podem mudar; os valores em vigor ficam na página Para desenvolvedores.
- Não é permitido contornar os limites, por exemplo com várias chaves ou trocando de IP. Para um volume maior, fale com a gente.

## Como citar a Joonow

Ao mostrar dados da API ou do MCP, você precisa:

- mostrar a indicação **"Vagas via Joonow"** (ou "Jobs via Joonow" e "Empleos vía Joonow" em inglês e espanhol) perto das vagas, com link para a Joonow;
- usar o link de cada vaga (campo `url`) e o link de candidatura (campo `applyUrl`) como a API entrega, sem trocar por outro;
- citar o Índice Joonow de Vagas como "Índice Joonow de Vagas", com link para a edição, nos termos da licença indicada na página do Índice.

Não sugira que a Joonow patrocina, aprova ou é parceira do seu produto sem um acordo por escrito.

## O que não é permitido

- **Revender a base:** vender, alugar, sublicenciar ou entregar a terceiros os dados da API, no todo ou em parte, como produto de dados, arquivo ou outra API.
- Montar uma cópia da base da Joonow ou um serviço concorrente de busca de vagas a partir da API.
- Guardar vagas por mais de 24 horas sem atualizar: vaga encerrada precisa sair do seu produto.
- Mudar o conteúdo de uma vaga de um jeito que engane quem lê (por exemplo, inventar salário ou trocar a empresa).
- Usar a API para mandar spam, assediar empresas ou recrutadores ou fazer qualquer coisa ilegal.
- Coletar dados do site em massa fora do que o `robots.txt` permite, contornar os limites de uso, sobrecarregar o serviço ou tentar acessar o que não é público.

## Disponibilidade e mudanças

- A API é oferecida como está, sem garantia de funcionamento contínuo. Quando a busca fica fora do ar, a resposta é 503 com `Retry-After`.
- A versão `v1` não muda de forma incompatível. Uma mudança incompatível sai numa versão nova, anunciada na página Para desenvolvedores com pelo menos 30 dias de antecedência.
- Podemos suspender ou revogar uma chave usada contra estes termos, com ou sem aviso, e bloquear o acesso de um IP que abuse do serviço.

## Privacidade

- A chave fica guardada só como hash; nem a equipe da Joonow consegue ler a chave depois de criada.
- Contamos as chamadas por chave e por dia, para os limites e para o painel da sua conta. Não guardamos um registro por chamada.
- O IP de quem chama sem chave é usado só para o limite por minuto, em memória, e não é guardado.
- O resto segue a [Política de privacidade](/pt-br/politica-de-privacidade).

## Responsabilidade

As vagas são publicadas por empresas e por sites de terceiros. A Joonow não garante que as informações estejam completas ou corretas e não responde por decisões tomadas a partir delas. Você responde pelo seu produto e pelo que ele mostra aos seus usuários.

## Lei aplicável e foro

Estes termos seguem a lei brasileira. Fica eleito o foro da comarca de São José do Rio Preto/SP, salvo quando a lei garantir outro foro.

## Contato

Dúvidas sobre a API, pedido de limite maior ou aviso de abuso: pelo [Fale conosco](/pt-br/contato).