Ir para o conteúdo

Programadores

API pública

Gerencie fichas de ferramentas de forma programática. Os endpoints de escrita estão limitados a 60 pedidos por minuto por IP.

API de leitura para agentes de IA

Pública, anônima e somente leitura. Os endpoints retornam as ferramentas publicadas como JSON estável, limitado a 120 solicitações por 60 s por IP.

Não é necessário usar chave de API nem token Bearer. Nunca envie a chave de publicação aqui.

  • GET https://www.getsitools.com/api/public/toolsListe ou pesquise ferramentas publicadas, com paginação, ordenação e filtros por categoria ou tag.
  • GET https://www.getsitools.com/api/public/tools/{slug}Uma ferramenta por slug, incluindo capturas de tela, idiomas compatíveis e cobertura por locale.
  • GET https://www.getsitools.com/api/public/categoriesA árvore de categorias de um locale, com a contagem de ferramentas publicadas.

Exemplo

curl 'https://www.getsitools.com/api/public/tools?q=image%20editing&pageSize=5&locale=en' \
  -H 'Accept: application/json'
  • openapi.json — Definição OpenAPI 3.1
  • llms.txt — llms.txt – resumo do site para agentes de IA
  • llms-full.txt — llms-full.txt – todas as ferramentas publicadas com um resumo de uma linha

Autenticação

Envie sua chave de publicação como token Bearer em cada pedido. Salve a chave no servidor e nunca a exponha em código do lado do cliente.

Authorization: Bearer <PUBLISH_API_KEY>

Define PUBLISH_API_KEY no servidor. Se não estiver definida, a API devolve 503 em vez de aceitar escritas sem autenticação.

Limites de pedidos

Os limites aplicam-se por endereço IP e por âmbito de rota. Leitura e escrita usam baldes separados, por isso muitas leituras não esgotam a quota de escrita.

Endpoints de leitura: 120 / 60s
Endpoints de escrita: 60 / 60s

Cada resposta inclui RateLimit-Limit, RateLimit-Remaining e RateLimit-Reset. Uma resposta 429 inclui também Retry-After.

Endpoints da API

Os exemplos abaixo usam $PUBLISH_API_KEY. Substitui o marcador de id da ferramenta pelo id devolvido pelo endpoint de criação.

POST/api/v1/tools/submit-url

Enviar URL

Envie apenas uma URL. O coletor busca os dados do site, traduz e publica a ficha. Análise gratuita sem intervenção manual.

Apenas URLs HTTP/HTTPS são aceitas. Uma resposta na fila significa que a URL foi aceita na fila do coletor.

Pedido

curl -X POST 'https://www.getsitools.com/en/api/v1/tools/submit-url' \
  -H 'Authorization: Bearer $PUBLISH_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "url": "https://example.com",
    "aiOnlyConfirmed": true
  }'

Resposta

{
  "id": "submission_abc123",
  "submissionId": "submission_abc123",
  "status": "queued",
  "duplicate": false,
  "message": "URL submitted successfully. The collector will scrape and process it automatically."
}

Respostas de erro

Os erros são devolvidos em JSON com um código estável e uma mensagem legível.

Código de statusCódigoSignificado
400VALIDATION_ERRORO corpo da requisição ou os parâmetros de consulta são inválidos.
401UNAUTHORIZEDO token Bearer está em falta ou está incorreto.
404NOT_FOUNDA ferramenta pedida não existe.
422LOCALES_INCOMPLETEFaltam campos de idiomas obrigatórios, por isso a ferramenta não pode ser publicada.
429RATE_LIMITEDO limite de pedidos foi excedido. Tente novamente após a janela de Retry-After (cerca de 60 s).
503API_KEY_NOT_CONFIGUREDO servidor não tem PUBLISH_API_KEY configurado, por isso as escritas estão desativadas.