API de Costco México
Datos de costco.com.mx en JSON estructurado: busca cualquier producto y recibe precio en pesos, calificación, número de reseñas y disponibilidad, abre la ficha con descripción, imágenes y especificaciones, y ubica los almacenes más cercanos. Cada consulta es un solo POST con "country": "mx".
50 créditos gratis al registrarte, suficientes para 50 búsquedas en Costco México. Sin tarjeta.
{ "data": { "country": "mx", "query": "leche", "corrected_query": null, "total_results": 109, "page": 1, "page_size": 24, "total_pages": 5, "count": 24, "results": [ { "position": 1, "product_id": "8563733", "title": "Havanna Dulce de Leche 1 kg", "english_title": null, "url": "https://www.costco.com.mx/Grocery/Grocery/Mermeladas-Mieles-y-Untables/Havanna-Dulce-de-Leche-1-kg/p/8563733", "image": "https://www.costco.com.mx/medias/sys_master/products/h6e/ha2/473050290192414.jpg", "price": 189, "price_hidden": false, "price_formatted": "$189.00", "currency": "MXN", "rating": 5, "reviews_count": 3, "availability": "in_stock", "member_only": false, "max_order_quantity": 500 }, { "position": 2, "product_id": "702315", "title": "Chicco Extractor de Leche Materna Manual", "english_title": null, "url": "https://www.costco.com.mx/Todo-para-el-Bebe/Alimentacion/Biberones-y-Accesorios/Chicco-Extractor-de-Leche-Materna-Manual/p/702315", "image": "https://www.costco.com.mx/medias/sys_master/products/h80/h30/435368398290974.jpg", "price": 629, "price_hidden": false, "price_formatted": "$629.00", "currency": "MXN", "rating": 0, "reviews_count": null, "availability": "in_stock", "member_only": false, "max_order_quantity": 500 } ] }, "response_time": 2220}Llamada en vivo al endpoint real en Costco México. 2 ejecuciones gratis; después, con tu propia key.
¿Qué es la API de Costco México de Scavio?
La API de Costco México de Scavio es una API REST que devuelve datos de costco.com.mx en JSON estructurado. Costco no tiene una API pública; los 3 endpoints POST de Scavio para México cubren búsqueda de productos con precio en pesos, la ficha de producto y el localizador de almacenes, a 1 crédito por llamada y con una sola API key.
- 3
- endpoints para Costco México, en producción
- 1
- crédito por llamada
- 24
- productos por página de forma predeterminada
Lo que puedes obtener de Costco México
Precio, calificación y disponibilidad de cada producto, su ficha completa y los almacenes cercanos.
Búsqueda con precio en pesos
POST /api/v1/costco/searchBusca en costco.com.mx y recibe 24 resultados por página, cada uno con su precio en MXN, la calificación, el número de reseñas y la disponibilidad. La respuesta trae el total real: 109 resultados en 5 páginas para "leche" el 2 de noviembre de 2026.
Ficha de producto
POST /api/v1/costco/productAbre un producto con el product_id de la búsqueda: precio, descripción, todas las imágenes, especificaciones como marca y cantidad, y las categorías en las que aparece.
Localizador de almacenes
POST /api/v1/costco/warehousesEncuentra los almacenes de Costco México más cercanos a unas coordenadas, con su warehouse_id, dirección y horarios.
Los 3 endpoints de la API de Costco México
Todas las rutas son POST, devuelven JSON y usan la misma API key. Agrega "country": "mx" al cuerpo. 1 crédito por llamada exitosa.
| Endpoint | Devuelve | Créditos |
|---|---|---|
Búsqueda/api/v1/costco/search | Productos de costco.com.mx por palabra clave: product_id, título, precio en pesos y con formato, calificación, número de reseñas, disponibilidad y si es solo para socios; con orden y paginación | 1 |
Producto/api/v1/costco/product | Un producto por product_id de una búsqueda en México: precio, descripción, todas las imágenes, especificaciones y categorías | 1 |
Localizador de almacenes/api/v1/costco/warehouses | Los almacenes de Costco más cercanos a una latitud y longitud | 1 |
Los 50 créditos gratis del registro alcanzan para 50 llamadas. Precios y disponibilidad por almacén, gasolina, cuponera, ofertas, liquidaciones, reseñas, categorías y autocompletado son solo para Costco Estados Unidos y Canadá. Ver planes
Busca en Costco México desde tu código
Una búsqueda de "leche" devuelve precio en pesos, calificación, número de reseñas y disponibilidad por producto. La respuesta de la derecha es una captura real, con sus nombres de campo.
from scavio import ScavioClient
client = ScavioClient(api_key="sk_live_your_key")
# Búsqueda en Costco México - 1 crédito, 24 productos por página
res = client.costco.search("leche", country="mx")
for item in res["data"]["results"]:
print(item["product_id"], item["price"], item["currency"], item["title"])
# Ficha de producto con un product_id de la búsqueda en México - 1 crédito
detail = client.costco.product(item_id="8563733", country="mx"){
"data": {
"country": "mx",
"query": "leche",
"corrected_query": null,
"total_results": 109,
"page": 1,
"page_size": 24,
"total_pages": 5,
"count": 24,
"results": [
{
"position": 1,
"product_id": "8563733",
"title": "Havanna Dulce de Leche 1 kg",
"english_title": null,
"url": "https://www.costco.com.mx/Grocery/Grocery/Mermeladas-Mieles-y-Untables/Havanna-Dulce-de-Leche-1-kg/p/8563733",
"image": "https://www.costco.com.mx/medias/sys_master/products/h6e/ha2/473050290192414.jpg",
"price": 189,
"price_hidden": false,
"price_formatted": "$189.00",
"currency": "MXN",
"rating": 5,
"reviews_count": 3,
"availability": "in_stock",
"member_only": false,
"max_order_quantity": 500
},
{
"position": 2,
"product_id": "702315",
"title": "Chicco Extractor de Leche Materna Manual",
"english_title": null,
"url": "https://www.costco.com.mx/Todo-para-el-Bebe/Alimentacion/Biberones-y-Accesorios/Chicco-Extractor-de-Leche-Materna-Manual/p/702315",
"image": "https://www.costco.com.mx/medias/sys_master/products/h80/h30/435368398290974.jpg",
"price": 629,
"price_hidden": false,
"price_formatted": "$629.00",
"currency": "MXN",
"rating": 0,
"reviews_count": null,
"availability": "in_stock",
"member_only": false,
"max_order_quantity": 500
}
]
},
"response_time": 2220
}¿Por qué no otra API de datos de Costco?
Costco no tiene una API pública, y las de terceros en su mayoría se quedan en el catálogo del sitio web.
Costco, y las APIs de Costco que solo cubren el catálogo
- Costco no ofrece una API pública para datos de productos, precios o inventario
- Las APIs de Costco de terceros (OpenWebNinja, Unwrangle, Piloterr, Bright Data, Oxylabs) cubren búsqueda, fichas de producto y reseñas
- Ninguna documenta precios en anaquel de varios almacenes, precios de gasolina, la cuponera ni códigos de liquidación
API de Costco de Scavio
- Búsqueda, ficha de producto y localizador de almacenes en costco.com.mx, con precios en pesos
- costco.com y costco.ca completos con la misma key: precios en almacén, disponibilidad, gasolina, cuponera y liquidaciones
- Búsqueda y producto en 6 países más de Costco, México incluido
- Una key, 50 créditos gratis al registrarte y el mismo formato JSON que todas las plataformas de Scavio
La cobertura de terceros se basa en la documentación pública de cada proveedor a octubre de 2026. Scavio devuelve solo datos públicos.
Lo que construyen los desarrolladores
Monitoreo de precios en Costco México
Consulta de forma programada los productos que te importan en costco.com.mx y guarda su precio en pesos para detectar cada cambio. El 2 de noviembre de 2026, el Havanna Dulce de Leche de 1 kg costaba $189.00 MXN.
searchCatálogo y fichas de producto
Arma o enriquece tu catálogo con la ficha de cada producto: descripción, todas las imágenes, especificaciones y categorías, tal como las publica Costco México.
search + productVisibilidad de marca en búsqueda
Cada resultado trae su posición, calificación y número de reseñas. Mide en qué lugar aparecen tus productos para cada búsqueda y cómo cambian con el orden por precio o por calificación.
searchComparación entre cadenas en México
Compara Costco México con Walmart México, HEB México, Amazon México y Mercado Libre con una sola key y respuestas JSON muy parecidas.
search + APIs de Walmart, HEB, Amazon y Mercado LibreMapas de almacenes
Muestra los almacenes de Costco más cercanos a tus usuarios a partir de sus coordenadas, con dirección y horarios.
warehousesAgentes de compras
Dale a un agente de IA Costco México como herramienta: cuánto cuesta un producto, qué opciones hay de una marca y cuál es el almacén más cercano.
MCP + RESTCómo obtener datos de Costco México en JSON
- 1
Obtén una API key
Crea una cuenta de Scavio y copia tu key desde el dashboard. Recibes 50 créditos gratis al registrarte, sin tarjeta y sin membresía de Costco.
- 2
Busca en Costco México
Envía {"query": "leche", "country": "mx"} a https://api.scavio.dev/api/v1/costco/search con un header Authorization: Bearer. Usa sort_by para ordenar y page para avanzar de página.
- 3
Abre la ficha de producto
Pasa el product_id de un resultado a /api/v1/costco/product como item_id, junto con "country": "mx". Cada respuesta trae el contenido en data, con credits_used y credits_remaining.
Preguntas frecuentes sobre la API de Costco México
¿Costco México tiene una API pública?
+
No. Costco no ofrece una API pública para datos de productos, precios o inventario. La API de Costco de Scavio llena ese hueco con endpoints POST que devuelven datos de Costco en JSON estructurado; para costco.com.mx están disponibles la búsqueda, la ficha de producto y el localizador de almacenes.
¿Qué endpoints funcionan para Costco México?
+
Búsqueda (/api/v1/costco/search), producto (/api/v1/costco/product) y almacenes (/api/v1/costco/warehouses), con "country": "mx". Los precios por almacén, la disponibilidad por almacén, los precios de gasolina, la cuponera, las ofertas, el buscador de liquidaciones, las reseñas, las categorías y el autocompletado no están disponibles para México: funcionan solo para Costco Estados Unidos y Canadá (la cuponera, solo Estados Unidos).
¿Qué filtros acepta la búsqueda en México?
+
Palabra clave, orden y paginación: query, sort_by (best_match, price_low, price_high o top_rated; newest no está disponible en México), page (1-500) y page_size (hasta 100). warehouse_id, brands, los filtros de precio y de calificación, on_sale, in_stock e in_warehouse son solo para Estados Unidos y Canadá; enviarlos con "country": "mx" devuelve un error 400.
¿En qué moneda vienen los precios?
+
En pesos mexicanos. Cada resultado trae price como número, price_formatted con el texto que muestra Costco y currency "MXN": por ejemplo, 189 y "$189.00" para el Havanna Dulce de Leche de 1 kg el 2 de noviembre de 2026.
¿Cómo obtengo el id de un producto de Costco México?
+
Del campo product_id de una búsqueda con "country": "mx", por ejemplo 8563733. Los ids son propios del sitio de cada país, así que un id de costco.com no sirve en costco.com.mx. En México el endpoint de producto recibe un item_id por llamada; item_ids, con hasta 20 productos, es solo para Estados Unidos y Canadá.
¿Qué incluye la ficha de producto?
+
Título, URL, imagen principal y todas las imágenes, precio en pesos y con formato, calificación, número de reseñas, disponibilidad, si es solo para socios, cantidad máxima por pedido, descripción, especificaciones y categorías. Para el Havanna Dulce de Leche de 1 kg devolvió 8 imágenes, las especificaciones Marca (Havanna) y Cantidad (1 kg) y dos categorías.
¿Puedo buscar almacenes de Costco en México?
+
Sí. Envía latitude y longitude con "country": "mx" a /api/v1/costco/warehouses; el parámetro zip es solo para códigos postales de Estados Unidos. limit va de 1 a 50 (10 por defecto) y la llamada cuesta 1 crédito.
¿Puedo obtener precios o existencias por almacén en México?
+
No. Los precios en almacén, la disponibilidad por almacén y el filtro warehouse_id de la búsqueda son solo para Costco Estados Unidos y Canadá. En México la API devuelve el precio en línea de costco.com.mx.
¿Cuánto cuesta la API de Costco México?
+
Búsqueda, producto y almacenes cuestan 1 crédito por llamada en México (la búsqueda en costco.com cuesta 2). Las cuentas nuevas reciben 50 créditos gratis al registrarte, sin tarjeta, y los planes pagos empiezan en US$30 al mes por 7,000 créditos.
¿Qué tan actualizados están los datos?
+
Cada solicitud lee Costco en vivo en el momento de la llamada, así que precios y disponibilidad reflejan lo que Costco muestra en ese momento. Nada sale de una copia nocturna.
¿Qué lenguajes y herramientas puedo usar?
+
Cada endpoint es un POST HTTPS normal con un cuerpo JSON, así que funciona con cualquier lenguaje. Scavio también ofrece SDKs de Python y JavaScript, un servidor MCP remoto en mcp.scavio.dev para agentes de IA y un nodo de comunidad para n8n, todo con la misma API key.
¿Qué países de Costco cubre?
+
Estados Unidos (costco.com) y Canadá (costco.ca) en todos los endpoints, salvo la cuponera, que es solo de Estados Unidos. La búsqueda, la ficha de producto y el localizador de almacenes también cubren Costco en México, Reino Unido, Australia, Japón, Corea del Sur y Taiwán, con búsqueda por palabra clave, orden y paginación.
¿Es legal usar datos de Costco México?
+
Scavio devuelve datos públicos de Costco y no accede a cuentas de socios ni a historial de pedidos. Tú eres responsable de cómo usas los datos, incluido el cumplimiento de los términos de Costco. Consulta a tu propio abogado para tu caso de uso específico.
Más de Scavio
Documentación de la API
Búsqueda, producto y almacenes con parámetros y respuestas reales.
API de Walmart México
Búsqueda y categorías de walmart.com.mx con precio en pesos.
API de HEB México
Precios en pesos, stock y promociones de heb.com.mx.
API de Mercado Libre
Publicaciones, precios, opiniones y más vendidos en México y Latinoamérica.
API de Amazon
Búsqueda, ficha de producto y ofertas de vendedores, incluido Amazon México.
Precios
Paquetes de créditos y planes, sin recargo por plataforma.
Empieza a obtener datos de Costco México hoy
50 créditos gratis al registrarte, sin tarjeta. Tu primera solicitud es un POST con una palabra clave y "country": "mx".