Saltar al contenido

Desarrolladores

API pública

Gestiona las fichas de herramientas por programación. Los endpoints de escritura están limitados a 60 peticiones por minuto por IP.

API de lectura para agentes de IA

Pública, anónima y de solo lectura. Devuelve en JSON estable las herramientas publicadas del sitio, con un límite de 120 solicitudes cada 60 s por IP.

No se necesita clave de API ni token Bearer. Nunca envíes aquí la clave de publicación.

  • GET https://www.getsitools.com/api/public/toolsLista o busca herramientas publicadas, con paginación, ordenación y filtros por categoría o etiqueta.
  • GET https://www.getsitools.com/api/public/tools/{slug}Una herramienta por slug, incluidas capturas, idiomas compatibles y cobertura por locale.
  • GET https://www.getsitools.com/api/public/categoriesEl árbol de categorías de un locale, con el número de herramientas publicadas.

Ejemplo

curl 'https://www.getsitools.com/api/public/tools?q=image%20editing&pageSize=5&locale=en' \
  -H 'Accept: application/json'
  • openapi.json — Definición OpenAPI 3.1
  • llms.txt — llms.txt: resumen del sitio para agentes de IA
  • llms-full.txt — llms-full.txt: todas las herramientas publicadas con un resumen de una línea

Autenticación

Envía tu clave de publicación como token Bearer en cada petición. Guarda la clave en tu servidor y nunca la expongas en código del lado del cliente.

Authorization: Bearer <PUBLISH_API_KEY>

Configura PUBLISH_API_KEY en el servidor. Si no está configurada, la API devuelve 503 en lugar de aceptar escrituras sin autenticar.

Límites de uso

Los límites se aplican por dirección IP y por ámbito de ruta. Lectura y escritura usan cubetas separadas, así que muchas lecturas no agotan el cupo de escritura.

Endpoints de lectura: 120 / 60s
Endpoints de escritura: 60 / 60s

Cada respuesta incluye RateLimit-Limit, RateLimit-Remaining y RateLimit-Reset. Una respuesta 429 también incluye Retry-After.

Rutas de API

Los ejemplos siguientes usan $PUBLISH_API_KEY. Sustituye el marcador de id de herramienta por el id que devuelve el endpoint de creación.

POST/api/v1/tools/submit-url

Enviar URL

Envía solo una URL. El sistema de recopilación obtendrá los datos del sitio, los traducirá y publicará. Revisión gratuita sin intervención manual.

Solo se admiten URL HTTP/HTTPS. Una respuesta en cola significa que la URL se aceptó en la cola de recopilación.

Petición

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
  }'

Respuesta

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

Respuestas de error

Los errores se devuelven en JSON con un código estable y un mensaje legible.

EstadoCódigoSignificado
400VALIDATION_ERROREl cuerpo de la petición o los parámetros de consulta no son válidos.
401UNAUTHORIZEDFalta el token Bearer o es incorrecto.
404NOT_FOUNDLa herramienta solicitada no existe.
422LOCALES_INCOMPLETEFaltan campos de idiomas obligatorios, así que la herramienta no puede publicarse.
429RATE_LIMITEDSe superó el límite de uso. Reinténtalo tras la ventana de Retry-After (unos 60 s).
503API_KEY_NOT_CONFIGUREDEl servidor no tiene PUBLISH_API_KEY configurado, así que las escrituras están desactivadas.