Skip to content

Costco Search Results API

Scrape Costco search results instantly with a simple API call

Last Updated: January 9, 2025

A GET request to our endpoint /api/getter/?platform="costco_search" will allow you to scrape search results from Costco.com's search engine in real-time.

Example

To scrape Costco.com's product search results for the keyword "multivitamin", you can use the following command:

1
curl 'https://data.unwrangle.com/api/getter/?platform=costco_search&search=multivitamin&api_key=API_KEY'

1
2
3
4
5
import requests

url = 'https://data.unwrangle.com/api/getter/?platform=costco_search&search=multivitamin&api_key=API_KEY'
response = requests.get(url)
print(response.json())

1
2
3
const response = await fetch('https://data.unwrangle.com/api/getter/?platform=costco_search&search=multivitamin&api_key=API_KEY')
const data = await response.json()
console.log(data)

1
2
3
4
5
6
<?php
$url = 'https://data.unwrangle.com/api/getter/?platform=costco_search&search=multivitamin&api_key=API_KEY';
$response = file_get_contents($url);
$data = json_decode($response, true);
print_r($data);
?>

1
2
3
4
5
6
require 'net/http'
require 'uri'

uri = URI.parse('https://data.unwrangle.com/api/getter/?platform=costco_search&search=multivitamin&api_key=API_KEY')
response = Net::HTTP.get(uri)
puts response

Query Parameters

As you can see in the example above, our endpoint needs the following query parameters:

Search Query

search

Required

Parameter defines the search query you want to search. You can use anything that a user may use in a regular search while shopping on Costco.com.

store_no

Optional

Costco Warehouse ID or store number. List of Costco warehouses can be found here. When present, only products available for pickup at the specified store will be returned.

page

Optional

Parameter defines the page number for which you want the results. Default value is 1.

Note

General search terms that lead to category or brand pages like 'electronics' or 'apple' will not return any results. You must use search terms that are likely to return a list of products.

Other Required Parameters

platform

Required

Parameter specifies the scraping engine you wish to invoke. In this case, the value should be costco_search.

api_key

Required

Your account's token—which can be obtained by signing up here.

Note

Be sure to replace any whitespace in the search keywords with a plus + sign. So, if you're looking to scrape search results for the keyword "ssd 1tb", please set the value of the query parameter search to "ssd+1tb".

Results

Up to 24 products can be expected in the search results response. The response will include the following attributes for each product in the search results:

Attributes Returned Data Type Information Represented
id string Internal ID of product listing
retailer_id string Retailer ID of product listing
name string Name of product listing
url string URL of product listing
thumbnail string URL of product's thumbnail image
price_reduced float Reduced price of product (if on sale)
price float Regular price of product
currency string Currency of the prices
rating float Average rating of product
total_ratings integer Total number of ratings for the product
brand string Brand of the product
model_number string/null Model number of the product
in_stock boolean Whether the product is in stock
short_description string Short description of the product
marketing_statement string Marketing statement for the product
marketing_features array Marketing features of the product
is_member_only boolean Whether the product is for members only
categories array Categories the product belongs to
max_quantity integer Maximum quantity that can be purchased
upc string Universal Product Code
product_status object Product availability status details
keywords array Associated keywords/tags
design_features string Design-specific features
cleaning_recommendation string Cleaning instructions
material object Material composition details
is_item_review_eligible boolean Whether item can be reviewed
is_item_buyable boolean Whether item can be purchased
is_item_comparable boolean Whether item can be compared

Response Example

Here's the response you can expect to receive for the request showcased above:

{
    "success": true,
    "search": "multivitamin",
    "page": 1,
    "total_results": 22,
    "no_of_pages": 1,
    "result_count": 22,
    "results": [
        {
            "id": "1733960",
            "retailer_id": "4000152313",
            "name": "VETIQ MultiVitamin Hickory Smoked Flavored Soft Chews for Adult Dogs, 240-count",
            "url": "https://www.costco.com/vetiq-multivitamin-hickory-smoked-flavored-soft-chews-for-adult-dogs,-240-count.product.4000152313.html",
            "thumbnail": "https://bfasset.costco-static.com/U447IH35/as/8mj5nwf9vrvbh7sgh2cv8nm/1733960-847__1?auto=webp&format=jpg&width=350&height=350&fit=bounds&canvas=350,350",
            "price_reduced": 29.99,
            "price": 29.99,
            "currency": "USD",
            "rating": 4.67,
            "total_ratings": 111,
            "brand": "VETIQ",
            "model_number": "93610002060",
            "in_stock": true,
            "short_description": "VETIQ MultiVitamin Hickory Smoked Flavored Soft Chews for Adult Dogs, 240-count",
            "marketing_statement": "",
            "marketing_features": [
                "240 Chews, 4 - 60 Count Bags",
                "Help Support Active Brain Function",
                "Supports and Maintains Your Dog's Immune System",
                "Supports a Healthy Digestive System",
                "Made in the USA with Globally Sourced Ingredients",
                ""
            ],
            "is_member_only": false,
            "categories": [
                "https://www.costco.com/pet-supplements.html"
            ],
            "max_quantity": 9999,
            "upc": "818145019838",
            "product_status": {
                "available_with_zero_inventory": false,
                "published": true,
                "available_with_backorder": false
            },
            "keywords": [
                "JulySavingsEvent",
                "NovM24",
                "VETIQ23NM",
                "HolidayDeals",
                "GameTimeSavingsMemorialDay",
                "MemorialOffersFiveDay"
            ],
            "design_features": null,
            "cleaning_recommendation": null,
            "material": {
                "fill": null,
                "cover": null
            },
            "is_item_review_eligible": true,
            "is_item_buyable": true,
            "is_item_comparable": true
        },
        {
            "id": "1444550",
            "retailer_id": "100138054",
            "name": "EcoDrink Complete Multivitamin Drink Mix, 30 Packets",
            "url": "https://www.costco.com/ecodrink-complete-multivitamin-drink-mix,-30-packets.product.100138054.html",
            "thumbnail": "https://bfasset.costco-static.com/U447IH35/as/8r748494wtj9cj4qqsqrgpcg/100138054-847__1?auto=webp&format=jpg&width=350&height=350&fit=bounds&canvas=350,350",
            "price_reduced": 18.99,
            "price": 22.99,
            "currency": "USD",
            "rating": 4.53,
            "total_ratings": 3919,
            "brand": "EcoDrink",
            "model_number": null,
            "in_stock": true,
            "short_description": "EcoDrink Complete Multivitamin Drink Mix, 30 Packets, Fruit Punch",
            "marketing_statement": "$4 OFF",
            "marketing_features": [
                "Antioxidants, Nutrients, Electrolytes",
                "28 Highly Absorbable Vitamins, Minerals, Nutrients",
                "100% Natural Flavors & Colors",
                "Berry, Peach Mango, Blueberry Pomegranate, Grape, Fruit Punch or Cherry Lime Flavors"
            ],
            "is_member_only": false,
            "categories": [
                "https://www.costco.com/health-beauty.html"
            ],
            "max_quantity": 15,
            "upc": "026395011698",
            "product_status": {
                "available_with_zero_inventory": false,
                "published": true,
                "available_with_backorder": false
            },
            "keywords": [
                "380376",
                "antioxidant",
                "minerals",
                "vitamin",
                "powder",
                "multi",
                "mix",
                "hydration",
                "grosm21",
                "",
                "janco22",
                "",
                "",
                "SepM23",
                "SeptemberHealth23",
                "OctoberHealth23",
                "travel1026",
                "OnlineOnly",
                "",
                "NovHealth16",
                "PharmacySavings",
                "JanM24",
                "",
                "SeptemberOnline",
                "BMASPharm0916"
            ],
            "design_features": null,
            "cleaning_recommendation": null,
            "material": {
                "fill": null,
                "cover": null
            },
            "is_item_review_eligible": true,
            "is_item_buyable": true,
            "is_item_comparable": true
        },
        {
            "id": "1744109",
            "retailer_id": "4000216860",
            "name": "Zesty Paws 8-in-1 Multivitamin Bites for Dogs, Chicken Flavor, 170-count",
            "url": "https://www.costco.com/zesty-paws-8-in-1-multivitamin-bites-for-dogs,-chicken-flavor,-170-count.product.4000216860.html",
            "thumbnail": "https://bfasset.costco-static.com/U447IH35/as/hphxm84g4gw72z9s3f5xtk/1744109-847__1?auto=webp&format=jpg&width=350&height=350&fit=bounds&canvas=350,350",
            "price_reduced": 29.99,
            "price": 39.99,
            "currency": "USD",
            "rating": 4.61,
            "total_ratings": 96,
            "brand": "Zesty Paws",
            "model_number": null,
            "in_stock": true,
            "short_description": "Zesty Paws 8-in-1 Multivitamin Bites for Dogs, Chicken Flavor, 170-count",
            "marketing_statement": "$29.99 After $10 OFF",
            "marketing_features": [
                "8 Areas of Support For Your Dog",
                "For All Ages",
                "No Artificial Flavors",
                "No Artificial Preservatives",
                "170-count Bag",
                ""
            ],
            "is_member_only": false,
            "categories": [
                "https://www.costco.com/pet-supplements.html"
            ],
            "max_quantity": 9999,
            "upc": "810030593652",
            "product_status": {
                "available_with_zero_inventory": true,
                "published": true,
                "available_with_backorder": false
            },
            "keywords": [
                "JanM24",
                "EasterOffers",
                "EasterFiveDay",
                "ZESTYPAWS25JC"
            ],
            "design_features": null,
            "cleaning_recommendation": null,
            "material": {
                "fill": null,
                "cover": null
            },
            "is_item_review_eligible": true,
            "is_item_buyable": true,
            "is_item_comparable": true
        },
        {
            "id": "942620",
            "retailer_id": "100646462",
            "name": "vitafusion Men's Multivitamin Gummies, 220 Gummies",
            "url": "https://www.costco.com/vitafusion-men's-multivitamin-gummies,-220-gummies.product.100646462.html",
            "thumbnail": "https://bfasset.costco-static.com/U447IH35/as/xnphnhrknpnjkhgxqmr56g3/942620-847__1?auto=webp&format=jpg&width=350&height=350&fit=bounds&canvas=350,350",
            "price_reduced": 13.99,
            "price": 13.99,
            "currency": "USD",
            "rating": null,
            "total_ratings": 0,
            "brand": "Vitafusion",
            "model_number": null,
            "in_stock": true,
            "short_description": "vitafusion Men's Multivitamin Gummies, 220 Gummies",
            "marketing_statement": "$3.50 OFF",
            "marketing_features": [],
            "is_member_only": false,
            "categories": [
                "https://www.costco.com/health-beauty.html"
            ],
            "max_quantity": 15,
            "upc": "27917270609",
            "product_status": {
                "available_with_zero_inventory": true,
                "published": true,
                "available_with_backorder": false
            },
            "keywords": [
                "ChurchandDwight24Nov",
                "Vitamins25Jan"
            ],
            "design_features": null,
            "cleaning_recommendation": null,
            "material": {
                "fill": null,
                "cover": null
            },
            "is_item_review_eligible": false,
            "is_item_buyable": false,
            "is_item_comparable": true
        },
        ...
        ...
        {
            "id": "1337603",
            "retailer_id": "100489207",
            "name": "vitafusion MultiVites, 260 Gummies",
            "url": "https://www.costco.com/vitafusion-multivites,-260-gummies.product.100489207.html",
            "thumbnail": "https://bfasset.costco-static.com/U447IH35/as/jh9sh47mvfvhtgnxtr2rpx/1337603-847__1?auto=webp&format=jpg&width=350&height=350&fit=bounds&canvas=350,350",
            "price_reduced": 17.99,
            "price": 17.99,
            "currency": "USD",
            "rating": 4.68,
            "total_ratings": 1605,
            "brand": "Vitafusion",
            "model_number": null,
            "in_stock": true,
            "short_description": "vitafusion MultiVites, 260 Gummies",
            "marketing_statement": "$3.50 OFF",
            "marketing_features": [
                "Natural Berry, Peach and Orange Flavors",
                "Gluten and Dairy Free",
                "No Artificial Flavors, High Fructose Corn Syrup or Synthetic FD&C Dye",
                ""
            ],
            "is_member_only": false,
            "categories": [
                "https://www.costco.com/health-beauty.html"
            ],
            "max_quantity": 15,
            "upc": "027917009711",
            "product_status": {
                "available_with_zero_inventory": false,
                "published": true,
                "available_with_backorder": false
            },
            "keywords": [
                "multi",
                "multivites",
                "multivitamin",
                "USP",
                "gummy",
                "gummies",
                "vites",
                "complete",
                "vitamin",
                "",
                "offerend613",
                "alldeals84",
                "",
                "health0822",
                "",
                "V&S22",
                "offers0114",
                "JanH&B22",
                "health1031",
                "NYHealth23",
                "Wellnessfocus",
                "StockUpGifts",
                "ChurchandDwight24Nov",
                "Vitamins25Jan"
            ],
            "design_features": null,
            "cleaning_recommendation": null,
            "material": {
                "fill": null,
                "cover": null
            },
            "is_item_review_eligible": false,
            "is_item_buyable": false,
            "is_item_comparable": true
        }
    ],
    "meta_data": {},
    "remaining_credits": 766585.5
}

Request Cost

1 credit is deducted for each successful request

Support

If you want to add a parameter to our response, or have any question or feedback, please write to us at support@unwrangle.com