UrlShortener
Referencia API v1

Acorta links desde tu propio código

Crea y consulta tus links cortos sin abrir el panel. La API es REST, responde en JSON y usa códigos HTTP estándar.

URL base
https://api.urlshortener.com/v1

Tu primera solicitud en tres pasos

  1. 1

    Activa el Plan Developer

    La API no está en los planes Gratis ni Pro.

    USD 15

    al mes

    1.000

    links cortos al mes

    60

    solicitudes por minuto

    Todo lo del Plan Pro, más acceso al acortador por API con tus propias claves.

    Ver planes
  2. 2

    Crea una clave

    En el panel de la cuenta, sección API. Solo se muestra una vez.

    Clave de producciónsk_live_9f2c••••••••creada hoy
  3. 3

    Crea tu primer link corto

    Copia la solicitud, cambia la clave y ejecútala.

    cURL
    curl -X POST https://api.urlshortener.com/v1/shorten \
  -H "Authorization: Bearer sk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.example.com/very-long-url",
    "alias": "summer-promo"
  }'
    Respuesta · 200 OK
    {
  "id": "link_89f2a4",
  "short_url": "https://sho.rt/summer-promo",
  "destination": "https://www.example.com/very-long-url",
  "clicks": 0,
  "created_at": "2026-10-13T10:30:00Z"
}

Autenticación

Cada solicitud lleva tu clave secreta en el encabezado Authorization. Las claves se crean y se revocan en el panel de la cuenta.

Una clave da acceso completo a tu cuenta: no la pongas en código del navegador ni en repositorios públicos.

Encabezado Authorization
Authorization: Bearer sk_live_your_api_key

Límites de uso

El límite se cuenta por clave. Al superarlo la API responde 429 y el encabezado Retry-After indica cuántos segundos esperar.

429
HTTP/1.1 429 Too Many Requests
Retry-After: 12

Errores

Los errores devuelven un código HTTP y un cuerpo JSON con un identificador estable.

400invalid_request
Falta un parámetro o no es válido.
401invalid_key
La clave no existe o fue revocada.
403plan_required
La cuenta no tiene el Plan Developer.
404not_found
El link corto no existe.
429rate_limited
Se superó el límite de solicitudes.
403
{
  "error": "plan_required",
  "message": "API access requires the Developer Plan."
}

Crear link corto

POST/shorten

Crea un link corto para una URL de destino. Puedes elegir un alias personalizado en lugar del código corto.

Parámetros

urlstringrequerido

La URL de destino.

aliasstringopcional

Alias personalizado, por ejemplo promo-verano.

curl -X POST https://api.urlshortener.com/v1/shorten \
  -H "Authorization: Bearer sk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.example.com/very-long-url",
    "alias": "summer-promo"
  }'
Respuesta · 200 OK
{
  "id": "link_89f2a4",
  "short_url": "https://sho.rt/summer-promo",
  "destination": "https://www.example.com/very-long-url",
  "clicks": 0,
  "created_at": "2026-10-13T10:30:00Z"
}

Listar links cortos

GET/urls

Devuelve los links cortos de tu cuenta, paginados.

Parámetros

limitnumberopcional

Cantidad máxima de links cortos a devolver.

cursorstringopcional

Cursor devuelto por la solicitud anterior.

curl https://api.urlshortener.com/v1/urls?limit=20 \
  -H "Authorization: Bearer sk_live_your_api_key"
Respuesta · 200 OK
{
  "data": [
    {
      "id": "link_89f2a4",
      "short_url": "https://sho.rt/summer-promo",
      "destination": "https://www.example.com/very-long-url"
    }
  ],
  "next_cursor": null
}

Consultar un link corto

GET/urls/{id}

Devuelve un link corto y el resumen de su actividad.

Parámetros

idstringrequerido

El identificador del link corto.

curl https://api.urlshortener.com/v1/urls/link_89f2a4 \
  -H "Authorization: Bearer sk_live_your_api_key"
Respuesta · 200 OK
{
  "id": "link_89f2a4",
  "short_url": "https://sho.rt/summer-promo",
  "destination": "https://www.example.com/very-long-url",
  "clicks": 248
}