Toolorah API

Inicio rápido

Cada herramienta utiliza el endpoint indicado abajo. Envía tu clave de API como token bearer y un cuerpo JSON con input y options. Esta es la misma llamada en tres lenguajes: POST /api/v1/<tool> { input, options }

curl -X POST https://www.toolorah.com/api/v1/base64 \
  -H "Authorization: Bearer nt_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"input":"hello world","options":{"mode":"encode"}}'

const res = await fetch("https://www.toolorah.com/api/v1/base64", {
  method: "POST",
  headers: {
    "Authorization": "Bearer nt_live_xxx",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ input: "hello world", options: { mode: "encode" } }),
});
const data = await res.json();
console.log(data.result); // "aGVsbG8gd29ybGQ="

import requests

res = requests.post(
    "https://www.toolorah.com/api/v1/base64",
    headers={"Authorization": "Bearer nt_live_xxx"},
    json={"input": "hello world", "options": {"mode": "encode"}},
)
print(res.json()["result"])  # aGVsbG8gd29ybGQ=

Autenticación

Crea una clave en la página de claves de API y envíala como token bearer en cada solicitud: Obtener clave de API

Authorization: Bearer nt_live_xxxxxxxxxxxxxxxx

Las claves tienen los permisos del plan con el que fueron creadas. Trátalas como contraseñas: guárdalas en el servidor y revoca desde la página de claves cualquier clave expuesta.

Solicitudes y respuestas

Todos los endpoints usan POST y aceptan un cuerpo JSON con dos campos:

• input — el texto (o archivo base64 para herramientas PDF) que se procesará.
• options — un objeto de configuración específico de la herramienta. Es opcional y se aplican valores predeterminados razonables.

Una llamada correcta devuelve 200 con esta estructura:

{
  "tool": "base64",
  "result": "aGVsbG8gd29ybGQ=",
  "meta": { }
}

Los errores devuelven un estado distinto de 2xx con un único campo error:

{ "error": "Invalid or revoked API key." }

Límites de uso

• Pro — 1.000 llamadas/día
• Elite — 10.000 llamadas/día

Los límites se reinician a las 00:00 UTC. Cada respuesta incluye el saldo actual:

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 942

Al superar el límite, las llamadas devuelven 429 con una cabecera Retry-After. Las solicitudes mal formadas no consumen cuota.

Solicitudes por lotes

Procesa muchas entradas en una sola solicitud en lugar de hacer una llamada HTTP por elemento. Envía inputs como un array de cadenas; options se aplica a todos los elementos. Disponible en Pro (25 entradas por solicitud) y Elite (250).

curl -X POST https://www.toolorah.com/api/v1/base64/batch   -H "Authorization: Bearer nt_live_..."   -H "Content-Type: application/json"   -d '{"inputs":["hello","world"],"options":{"mode":"encode"}}'

{
  "tool": "base64",
  "count": 2,
  "succeeded": 2,
  "failed": 0,
  "results": [
    { "index": 0, "result": "aGVsbG8=" },
    { "index": 1, "result": "d29ybGQ=" }
  ]
}

Cada entrada consume una llamada de tu cuota diaria: los lotes ahorran viajes de ida y vuelta, no cuota. Un lote que superaría tu límite diario se rechaza por completo y no se procesa nada, así que nunca recibes un conjunto de resultados a medias.

Los resultados se devuelven en el mismo orden que las entradas, cada uno con su index. Una entrada errónea no descarta el resto: devuelve un campo error para ese índice mientras los demás resultados se completan. Consulta succeeded y failed en la respuesta.

Endpoints de utilidad

Dos endpoints GET para descubrir qué puedes llamar y cuánta cuota te queda. Ambos requieren la misma clave bearer.

{
  "plan": "pro",
  "daily": { "limit": 1000, "used": 42, "remaining": 958 },
  "batch": { "maxInputsPerRequest": 25 },
  "resetsAt": "2026-08-24T00:00:00.000Z"
}

Endpoints

Herramientas de texto y utilidades. Usa las options indicadas para controlar el comportamiento.

Endpoints de PDF

Las herramientas PDF trabajan con archivos. Las solicitudes llevan archivos codificados en base64 dentro del JSON y result contiene el PDF de salida en base64. Mantén la carga decodificada por debajo de unos 4 MB. WebP solo funciona en el navegador; envía PNG o JPG.

# Merge two PDFs (bash)
curl -X POST https://www.toolorah.com/api/v1/pdf-merger \
  -H "Authorization: Bearer nt_live_xxx" \
  -H "Content-Type: application/json" \
  -d "{\"files\":[\"$(base64 -w0 a.pdf)\",\"$(base64 -w0 b.pdf)\"]}" \
  | jq -r '.result' | base64 -d > merged.pdf

Errores

• 401 — clave de API ausente o no válida
• 403 — tu plan no incluye acceso a la API
• 404 — herramienta desconocida
• 422 — entrada incorrecta (por ejemplo, JSON o regex no válidos)
• 429 — límite diario alcanzado