Costco

API de búsqueda de Costco

Busca en Costco por palabra clave o número de artículo y obtén productos estructurados en JSON: precio en línea y precio original, calificación y número de reseñas, indicadores de solo para socios y de existencias, promociones y facetas. Envía warehouse_id para agregar a cada resultado el precio en almacén, el estado de existencias y el código de precio de ese almacén. Cuesta 2 créditos por solicitud en costco.com y 1 en costco.ca y en los sitios internacionales.

POST/api/v1/costco/search

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).

Body

application/json

querystringrequired

Palabras clave o un número de artículo de Costco, de 1 a 200 caracteres.

Example: olive oil

countryenum<string>default:us

Sitio de Costco. us y ca admiten todos los parámetros; uk, au, mx, jp, kr y tw admiten solo palabra clave, orden y paginación.

Example: uk

us — costco.com, Estados Unidos.
ca — costco.ca, Canadá.
uk — Reino Unido.
au — Australia.
mx — México.
jp — Japón.
kr — Corea del Sur.
tw — Taiwán.

warehouse_idstring

Número de almacén de Costco, obtenido del endpoint de almacenes. Agrega a cada resultado el precio en almacén, el estado de existencias y el código de precio de ese almacén. Omítelo para obtener solo precios en línea. Solo us y ca.

Example: 1062

sort_byenum<string>default:best_match

Orden de los resultados. Costco amplía la coincidencia con cualquier orden distinto de best_match. newest no está disponible en uk, au, mx, jp, kr ni tw.

Example: price_low

best_match — Relevancia de Costco.
price_low — Precio, el más bajo primero.
price_high — Precio, el más alto primero.
top_rated — Mejor calificación promedio primero.
newest — Productos más nuevos primero (us y ca).

brandsarray<string>

Solo estas marcas, hasta 20 nombres, p. ej. ["Kirkland Signature"]. Solo us y ca.

Example: ["Kirkland Signature"]

min_pricenumber

Precio mínimo en línea, inclusive, 0 o más. Solo us y ca.

Example: 10

max_pricenumber

Precio máximo en línea, inclusive, 0 o más. Solo us y ca.

Example: 50

min_ratingnumber

Calificación promedio mínima, de 1 a 5 estrellas. Solo us y ca.

Example: 4

on_saleboolean

Solo productos con un descuento activo. Solo us y ca.

Example: true

in_stockboolean

Oculta los productos agotados. Solo us y ca.

Example: true

in_warehouseboolean

Solo productos que se venden y tienen existencias en warehouse_id. Requiere warehouse_id.

Example: true

pageintegerdefault:1

Página de resultados, empezando en 1, de 1 a 500.

Example: 2

page_sizeintegerdefault:24

Resultados por página, de 1 a 120 (hasta 100 en uk, au, mx, jp, kr y tw).

Example: 48

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")

# warehouse_id agrega el precio en almacén y el código de precio a cada fila
results = client.costco.search("olive oil", warehouse_id="1062", page_size=5)

for item in results["data"]["results"]:
    store = item.get("warehouse") or {}
    print(item["item_number"], item["title"], item["price"], store.get("price"))

Response

"country": "us",

"query": "olive oil",

"category": null,

"redirected_to_category": null,

"corrected_query": null,

"warehouse_id": "1062",

"total_results": 106,

"page": 1,

"page_size": 5,

"total_pages": 22,

"count": 5,

"response_time": 3357

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") # warehouse_id agrega el precio en almacén y el código de precio a cada fila results = client.costco.search("olive oil", warehouse_id="1062", page_size=5) for item in results["data"]["results"]: store = item.get("warehouse") or {} print(item["item_number"], item["title"], item["price"], store.get("price"))