Auditar alt text
Una imagen sin alt text es invisible para un lector de pantalla e invisible para un índice de búsqueda de imágenes, lo que la convierte en un problema de dos frentes escondido a plena vista en la mayoría de los sitios. Este endpoint recorre un conjunto de URLs, encuentra cada imagen con alt text faltante, vacío o de relleno, y redacta un sustituto específico y preciso para cada una.
Ejecútela online
Ejecute esto en nuestros servidores con su cuenta. Las herramientas gratuitas corren en su navegador; esta cobra de su saldo del KIT según el precio de arriba.
A quién le pasa esto y por qué
El alt text se omite constantemente: un desarrollador agrega un componente de imagen sin la propiedad correspondiente, un campo del CMS queda vacío porque nadie lo hizo obligatorio, o una importación masiva de productos trae mil imágenes con el nombre del archivo como única descripción. Rara vez se detecta en una revisión editorial normal porque el texto es invisible en la página renderizada: quien revisa la página no tiene motivo para notar que falta a menos que active un lector de pantalla o abra el código HTML.
Cómo funciona la auditoría y la reescritura
Para cada URL enviada, la tarea carga la página, identifica cada elemento de imagen y clasifica su atributo alt actual como faltante, vacío, decorativo o ya adecuado. Para las imágenes que necesitan uno, analiza la imagen en sí junto con su contexto cercano (el pie de foto, el encabezado próximo, el nombre del producto si se trata de una ficha de comercio electrónico) y redacta un alt text que describe lo que realmente aparece en la imagen en vez de una etiqueta genérica, de modo que el resultado sea útil para la tecnología de asistencia y relevante para la búsqueda de imágenes.
Una breve nota sobre por qué esto importa más allá del cumplimiento
El alt text formó parte de la especificación de HTML desde sus primeras versiones, pensado originalmente solo para describir una imagen cuando no podía cargar en una conexión lenta. Su papel se amplió a medida que los lectores de pantalla se volvieron la forma principal en que muchas personas navegan la web y a medida que la búsqueda de imágenes creció como canal de descubrimiento propio, así que lo que empezó como respaldo para imágenes rotas hoy es infraestructura central tanto para la accesibilidad como para la visibilidad.
Trabajar sobre muchas páginas a la vez
Como el precio se cobra por URL además de la tarifa base por solicitud, la auditoría escala desde revisar una sola landing page hasta un barrido completo del sitio: envía la lista de URLs una vez, y cada una se analiza y reescribe de forma independiente, con resultados agrupados para que vea exactamente qué páginas y qué imágenes cambiaron.
Cómo llegan los resultados
La tarea es asíncrona: envía la lista de URLs y recibe un task_id de inmediato, y luego recibe la auditoría completa y el alt text sugerido por su webhook o por un enlace firmado válido durante 24 horas cuando el análisis termina. Una URL que no se puede cargar tras tres intentos falla con un error específico, y esa URL no se cobra.
Qué puede hacer con ella
Proyectos de remediación de accesibilidad
Escanear todo un sitio para encontrar cada imagen sin alt text como primer paso concreto de un esfuerzo de cumplimiento de accesibilidad.
Limpieza de catálogos de comercio electrónico
Reescribir alt text genérico basado en nombres de archivo en miles de imágenes de producto con descripciones que realmente reflejen cada artículo.
Control de calidad de contenido antes del lanzamiento
Auditar un sitio nuevo o una plantilla rediseñada antes de publicarla para detectar imágenes que salieron sin alt text durante el desarrollo.
Mejora de SEO de imágenes
Identificar páginas donde el alt text faltante o vago probablemente limita la visibilidad en los resultados de búsqueda de imágenes, y sustituirlo por descripciones precisas.
Preguntas frecuentes
¿Qué encuentra exactamente esta api para comprobar alt text?
Identifica cada imagen de una página con alt text faltante, vacío o de relleno, y distingue esas de las imágenes correctamente marcadas como decorativas.
¿Solo señala los problemas o también redacta el texto sustituto?
Ambas cosas: audita el estado actual de cada imagen y genera alt text específico y contextual para cada una que lo necesite, listo para usarse directamente.
¿Cómo decide qué escribir en el alt text?
Analiza el contenido de la imagen junto con su contexto cercano, como pies de foto, encabezados próximos o nombres de producto, para que la descripción sea específica y no genérica.
¿Sabe distinguir las imágenes que deben tener alt vacío a propósito?
Sí, las imágenes puramente decorativas que usan correctamente alt vacío se reconocen y se dejan tal cual, sin marcarlas como error.
¿Hay un plan gratuito para revisiones pequeñas?
No hay capa gratuita: las capas gratis se abusan y ralentizan a todos. El acceso funciona con un saldo prepago de ForHosting KIT: se recarga desde $10.00 (no caduca) y cada solicitud se cobra a su precio publicado, así que una llamada sin saldo devuelve HTTP 402. Sin suscripción, sin tokens ni créditos inventados, y una tarea fallida no se cobra.
¿Cómo se calcula el precio para una auditoría de sitio completo?
Una base de $0.066 por solicitud más $0.0585 por cada URL analizada, así que auditar 20 páginas cuesta $0.066 más $1.18.
¿Cómo obtengo los resultados de la auditoría?
Mediante un webhook firmado cuando el análisis termina, o un enlace firmado válido por 24 horas.
¿Qué pasa si una URL del lote no carga?
Reintenta automáticamente hasta tres veces; si sigue fallando, esa URL específica devuelve un error claro y no se cobra, mientras el resto del lote se completa con normalidad.
Para desarrolladores — acceso por API
Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.
Endpoint de API
¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, y pronto desde nuestra app, el email y Telegram.
Llámela desde su stack
curl -X POST https://api.kit.forhosting.com/seo/alt-text-audit \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://ejemplo.com"}'const res = await fetch("https://api.kit.forhosting.com/seo/alt-text-audit", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"url": "https://ejemplo.com"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/seo/alt-text-audit",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"url": "https://ejemplo.com"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/seo/alt-text-audit", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"url":"https://ejemplo.com"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"url":"https://ejemplo.com"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/seo/alt-text-audit", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Ejemplo de solicitud
{
"url": "https://ejemplo.com"
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "seo.alt_text_audit",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.
Precio
Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.
Errores
| HTTP | Código | Significado |
|---|---|---|
401 | unauthorized | API key ausente o inválida. |
402 | insufficient_balance | El saldo no cubre el precio de la tarea. |
404 | unknown_type | El tipo de tarea no existe. |
429 | rate_limited | Demasiadas peticiones. Use el webhook en vez de sondear. |
422 | task_failed | La tarea falló tras 3 reintentos. No se cobra. |