Para obtener precios de Costco México con una API, envía un POST a https://api.scavio.dev/api/v1/costco/search con {"query": "cafe molido", "country": "mx"}. La respuesta trae los productos de costco.com.mx con precio en pesos, precio con formato, calificación, número de reseñas y disponibilidad, y cuesta 1 crédito por página de hasta 100 productos. Costco no tiene una API pública, así que esta es la forma directa de tener esos datos en JSON sin mantener un extractor propio.
Todas las respuestas de esta guía se capturaron el 2 de noviembre de 2026.
Lo que necesitas
- Una API key de Scavio. Al registrarte recibes 50 créditos gratis, sin tarjeta y sin membresía de Costco.
- Cualquier lenguaje que haga peticiones HTTP. Los ejemplos usan cURL y Python.
Paso 1: busca productos en costco.com.mx
Lo que cambia respecto de Costco Estados Unidos es "country": "mx". Con sort_by ordenas los resultados:
curl -X POST 'https://api.scavio.dev/api/v1/costco/search' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer sk_live_your_key' \
-d '{"query": "cafe molido", "country": "mx", "sort_by": "price_low"}'Devolvió 12 productos en 1.1 segundos, del más barato (Garat Café Espresso Molido 1.1 kg, $279.00) al más caro. Esta es la segunda fila, sin alterar ningún valor:
{
"position": 2,
"product_id": "587435",
"title": "Blasón Café Molido Espresso Gourmet 1 kg",
"english_title": null,
"url": "https://www.costco.com.mx/Grocery/Grocery/Cafe-Te-y-Endulzantes/Blason-Cafe-Molido-Espresso-Gourmet-1-kg/p/587435",
"image": "https://www.costco.com.mx/medias/sys_master/products/h59/h76/61919376801822.jpg",
"price": 309,
"price_hidden": false,
"price_formatted": "$309.00",
"currency": "MXN",
"rating": 4.9,
"reviews_count": 169,
"availability": "in_stock",
"member_only": false,
"max_order_quantity": 500
}| Campo | Qué es |
|---|---|
price | Precio en pesos como número (309 = $309.00 MXN) |
price_formatted | El texto del precio tal como lo muestra Costco |
product_id | El id del producto en costco.com.mx, para pedir la ficha |
rating, reviews_count | Calificación promedio y número de reseñas |
availability | in_stock u out_of_stock en la tienda en línea |
member_only | true si el producto es solo para socios |
sort_by acepta best_match, price_low, price_high y top_rated; newest no está disponible en México.
Paso 2: recorre todas las páginas
Cada respuesta trae total_results y total_pages. La página predeterminada es de 24 productos, pero page_size llega a 100, y eso cambia el costo de recorrer una búsqueda amplia: "leche" tenía 109 resultados, que con page_size 100 son 2 llamadas en lugar de 5.
import requests
def costco_mx(query):
page, rows = 1, []
while True:
r = requests.post(
"https://api.scavio.dev/api/v1/costco/search",
headers={"Authorization": "Bearer sk_live_your_key"},
json={"query": query, "country": "mx", "page_size": 100, "page": page},
timeout=60,
).json()["data"]
rows += r["results"]
if page >= r["total_pages"]:
return rows
page += 1
for p in costco_mx("atun"):
print(p["product_id"], p["price"], p["title"])Un detalle que conviene saber: la búsqueda de costco.com.mx es amplia. En "leche" aparecen el Havanna Dulce de Leche, extractores de leche materna y chocolates con leche, y el catálogo en línea casi no tiene productos frescos ("huevo" devolvió 2 resultados y ninguno era huevo). Filtra por título o por product_id antes de guardar.
Paso 3: maneja los productos agotados
Cuando un producto está agotado en línea, Costco no publica su precio, y la API lo refleja tal cual. En la misma búsqueda de café, la fila 12 llegó así:
{
"position": 12,
"product_id": "601380",
"title": "Kirkland Signature Café Molido de Chiapas 1 kg",
"price": null,
"price_formatted": null,
"currency": null,
"availability": "out_of_stock"
}Si llevas un historial de precios, guarda esa lectura como "sin precio publicado" y no como cero, o tus promedios se van a desplomar cada vez que algo se agote.
Paso 4: abre la ficha de producto
Para descripción, imágenes y especificaciones, pasa el product_id como item_id:
curl -X POST 'https://api.scavio.dev/api/v1/costco/product' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer sk_live_your_key' \
-d '{"item_id": "626836", "country": "mx"}'Para el Dolores Atún en Agua 10 pzas de 140 g respondió en 1.0 segundos con precio ($259.00), calificación 5 con 24 reseñas, 32 imágenes, 4 categorías (entre ellas "Precios Especiales") y estas especificaciones:
[
{"name": "Contenido Neto", "value": "10 pzas de 140 g"},
{"name": "Marca", "value": "Dolores"},
{"name": "Tipo", "value": "Atun en Agua"},
{"name": "Profundo", "value": "20"},
{"name": "Alto", "value": "25"},
{"name": "Peso", "value": "1.4"},
{"name": "Cantidad", "value": "10 piezas"}
]El campo description llega con el HTML de Costco, entidades incluidas (Atún), así que decodifícalo antes de mostrarlo. En México se pide un producto por llamada; item_ids con hasta 20 productos funciona solo en Estados Unidos y Canadá.
Paso 5: encuentra los almacenes cercanos
curl -X POST 'https://api.scavio.dev/api/v1/costco/warehouses' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer sk_live_your_key' \
-d '{"latitude": 19.4326, "longitude": -99.1332, "limit": 5, "country": "mx"}'Desde el Zócalo devolvió Lindavista (5.4 km), Polanco (7.7 km), Mixcoac (7.9 km), Satélite (13.6 km) y Arboledas (15 km). La primera fila, recortada:
{
"warehouse_id": "costcoMexicoWharehouse5312",
"name": "Lindavista",
"phone": "(55) 5747 5680",
"distance": "5.4 km",
"hours": ["dom: 10:00 AM - 08:00 PM", "lun: 10:00 AM - 08:30 PM", "sáb: 09:30 AM - 09:00 PM"],
"services": ["OPTICAL", "TIRE_CENTER", "PHARMACY", "FOOD_COURT", "HEARING_AIDS"],
"url": "https://www.costco.com.mx/store/Lindavista"
}El warehouse_id viene tal como lo publica Costco México, con su ortografía. El parámetro zip es solo para códigos postales de Estados Unidos: en México usa coordenadas.
Los endpoints que funcionan en Costco México
| Endpoint | Qué devuelve | Créditos |
|---|---|---|
/api/v1/costco/search | Productos de costco.com.mx con precio en pesos, calificación, reseñas y disponibilidad; orden y paginación | 1 |
/api/v1/costco/product | Un producto por item_id: precio, descripción, imágenes, especificaciones y categorías | 1 |
/api/v1/costco/warehouses | Almacenes cercanos a unas coordenadas, con horarios y servicios | 1 |
Los precios y la disponibilidad por almacén, la gasolina, la cuponera, las ofertas, las liquidaciones, las reseñas, las categorías y el autocompletado funcionan solo para Costco Estados Unidos y Canadá. Mandar warehouse_id, brands, filtros de precio o on_sale con "country": "mx" devuelve un error 400.
Cuánto cuesta
Cada llamada cuesta 1 crédito. En el plan Growth con pago anual (US$2 por 1,000 créditos) son US$0.002 por búsqueda de hasta 100 productos: revisar 10,000 productos al día con page_size 100 sale en unos US$0.20. Los 50 créditos gratis del registro alcanzan para 50 llamadas. Prueba la API de Costco México gratis o consulta los planes y precios.
La página de la API de Costco México tiene una prueba en vivo sin registro, y la documentación de búsqueda describe cada parámetro. Para saber cómo se compara con otras opciones, lee las mejores APIs de Costco México, y para cruzar precios con otra cadena, la misma key funciona con la API de Walmart México.
Frequently asked questions
¿Cómo saco los precios de costco.com.mx sin hacer scraping?
Con una API que ya entregue el catálogo en JSON. La API de Costco México de Scavio recibe una palabra clave y "country": "mx" y devuelve hasta 100 productos por llamada con precio en pesos, calificación, reseñas y disponibilidad, por 1 crédito. No necesitas membresía de Costco ni mantener un extractor.
¿Por qué algunos productos de Costco México llegan sin precio?
Porque están agotados en línea. En la búsqueda "cafe molido" del 2 de noviembre de 2026, el Kirkland Signature Café Molido de Chiapas de 1 kg llegó con availability "out_of_stock" y price, price_formatted y currency en null. Si guardas historial, trata esos casos como "sin precio publicado", no como precio cero.
¿Puedo ver los almacenes de Costco México con sus horarios?
Sí. El endpoint de almacenes recibe latitud y longitud con "country": "mx" y devuelve los más cercanos con dirección, teléfono, distancia, horario por día y servicios. Desde el Zócalo de la Ciudad de México, el más cercano fue Lindavista, a 5.4 km.
¿Cuánto cuesta consultar Costco México?
1 crédito por llamada de búsqueda, producto o almacenes. En el plan Growth con pago anual son unos US$0.002 por llamada, y una búsqueda puede traer hasta 100 productos. Las cuentas nuevas reciben 50 créditos gratis, sin tarjeta.