Comprobar el stock
Un producto puede verse disponible en un resultado de búsqueda y estar agotado para cuando el cliente hace clic. Esta API de disponibilidad de stock carga la página real y lee la misma señal que ve un comprador —hay existencias, agotado, quedan pocas unidades o preventa— y la devuelve como un estado claro sobre el que se puede actuar de inmediato.
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.
La distancia entre el catálogo y la realidad
Los feeds de inventario y las bases de datos internas se desactualizan en cuanto una bodega despacha la última unidad, y muchas tiendas ni siquiera exponen un conteo limpio de inventario: en su lugar muestran una insignia, el estado de un botón o una frase enterrada en el texto de la página. El endpoint stock-extract lee la página como lo haría un comprador humano, recogiendo la señal que la tienda realmente muestra en vez de asumir que un feed es confiable.
Cómo fluye una solicitud
Se llama a POST /web/stock-extract con la URL del producto, se recibe un task_id de inmediato y la tarea se resuelve de forma asíncrona. La respuesta clasifica la disponibilidad —típicamente disponible, agotado, existencias limitadas o preventa/pedido pendiente— junto con el texto de respaldo que la página ofrecía, entregado por webhook firmado o mediante un enlace firmado válido por 24 horas.
Dónde importa más comprobar la disponibilidad
Quien hace dropshipping necesita saber, antes de que un cliente ordene, que el proveedor realmente puede despachar el producto. Los sitios comparadores de precios pierden confianza en el momento en que envían compradores a un listado agotado. Los equipos de retail que lanzan una reposición quieren enterarse apenas el inventario de un competidor vuelve a aparecer. En todos los casos, el costo de revisar manualmente crece con el número de productos, mientras que una llamada a la API no.
Por qué la señal de disponibilidad no está estandarizada
A diferencia del precio, que al menos cuenta con una convención común en schema.org, el estado de stock nunca se asentó en un formato universal entre tiendas: algunas usan un valor booleano en datos estructurados, otras solo lo comunican mediante un botón de 'agregar al carrito' deshabilitado o una frase corta como 'llega en 3 semanas'. Esa inconsistencia es justamente la razón por la que renderizar la página supera a una búsqueda basada únicamente en datos estructurados para esta señal en particular.
Ejecutarla de forma programada
Como los chequeos fallidos nunca se cobran —tres reintentos antes de un error claro—, este endpoint se presta bien para consultar con frecuencia una lista de productos vigilados sin preocuparse por gastar en páginas que fallan momentáneamente al cargar. Combinado con un webhook, se puede avisar a un equipo o disparar un reabastecimiento en el instante en que el estado de stock cambia.
Qué puede hacer con ella
Alertas de reposición para compradores
Una tienda de nicho vigila la página de producto de su proveedor y avisa a su lista de espera en cuanto vuelve a mostrarse disponible.
Chequeos de confiabilidad en dropshipping
Un negocio de dropshipping verifica el stock del proveedor antes de confirmar un pedido al cliente, evitando cancelaciones después de la venta.
Exactitud en sitios comparadores
Una plataforma de comparación de precios filtra los listados que aparecen agotados para no enviar compradores a enlaces muertos.
Vigilancia de inventario de la competencia
Una marca sigue el momento en que un artículo de edición limitada se agota en un competidor para calcular el momento de su propia campaña.
Preguntas frecuentes
¿Qué tan precisa es esta api comprobar stock de un producto?
Refleja exactamente lo que la tienda muestra en ese momento a un visitante, es decir, la misma información que vería un comprador real.
¿Existe un plan gratuito para la API de disponibilidad de stock?
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.
¿Cuánto cuesta la API de disponibilidad de stock?
Cuesta 0.046 dólares por solicitud más 0.015 dólares por URL, y solo se cobran las tareas que se completan con éxito.
¿Puede detectar avisos de pocas existencias, no solo disponible o agotado?
Sí, cuando la propia página muestra un aviso de pocas unidades o cantidad limitada, ese detalle se incluye en la respuesta.
¿Puedo revisar el stock de muchos productos a la vez?
Sí, se pueden enviar varias URL de producto y cada una se procesa y factura por separado según la tarifa por URL.
¿Qué pasa si la página falla temporalmente al cargar?
La tarea reintenta automáticamente hasta tres veces antes de devolver un error claro, y nunca se cobra un intento fallido.
¿Cómo recibo el resultado de disponibilidad?
Mediante un webhook firmado, recomendado para flujos automatizados, o un enlace firmado que permanece válido durante 24 horas.
¿Funciona en páginas de preventa o pedido pendiente?
Sí, los estados de preventa y pedido pendiente se reportan como estados distintos de un simple agotado.
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/web/stock-extract \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://ejemplo.com"}'const res = await fetch("https://api.kit.forhosting.com/web/stock-extract", {
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/web/stock-extract",
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/web/stock-extract", 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/web/stock-extract", 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": "web.stock_extract",
"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.
Límites
timeout_sec | 30 |
max_crawl_pages | 25 |
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. |