# Instacart API: Search store products > Searches a named Instacart store's guest-visible grocery products for a US ZIP code. Prices are in USD and can differ from in-store prices; stock estimates can change. Unofficial. Not affiliated with or endorsed by Instacart. - Page: https://fous.com/methods/instacart.com/search-products - Method: `instacart.com/search_products`, version 1 - Website: instacart.com - Returns: store, product name, brand, size, price, original price, unit price, stock, image, link - Effect: read (it gets data and changes nothing) - Sign-in: none needed - Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free - Verified: Nov 2, 2026 ## Inputs | Field | Type | Required | In the run below | Description | |---|---|---|---|---| | `query` | string | yes | `"milk"` | The grocery product to search for, for example oat milk. | | `store` | string | yes | `"Safeway"` | Store name, for example Safeway or Costco. | | `zip_code` | string | yes | `"94103"` | Five-digit US delivery ZIP code, for example 94103. | | `max_results` | integer | no | `60` | Most products to return, for example 20. Default 20. | ## Output From a run on Oct 31, 2026, shortened. Its input: ```json { "query": "milk", "store": "Safeway", "zip_code": "94103", "max_results": 60 } ``` Its output: ```json { "store": "Safeway", "products": [ { "size": "128 fl oz", "brand": "Lucerne", "price": 7.99, "currency": "USD", "in_stock": true, "image_link": "https://d2lnr5mha7bycj.cloudfront.net/product-image/file/large_1f0daedf-f4a0-4eb8-a54c-de3656820f43.png", "unit_price": "$0.06/fl oz", "product_link": "https://www.instacart.com/products/7079-lucerne-dairy-farms-milk-128-oz?retailerSlug=safeway", "product_name": "Lucerne Whole Milk", "original_price": null }, { "size": "128 fl oz", "brand": "Lucerne", "price": 7.99, "currency": "USD", "in_stock": true, "image_link": "https://d2lnr5mha7bycj.cloudfront.net/product-image/file/large_f29919c4-6586-4af3-9136-71ca6b5a2a2f.png", "unit_price": "$0.06/fl oz", "product_link": "https://www.instacart.com/products/7069-lucerne-milk-reduced-fat-2-milkfat-128-oz?retailerSlug=safeway", "product_name": "Lucerne Milk, Reduced Fat, 2% Milkfat", "original_price": null }, { "size": "64 fl oz", "brand": "Clover Sonoma", "price": 7.99, "currency": "USD", "in_stock": true, "image_link": "https://d2lnr5mha7bycj.cloudfront.net/product-image/file/large_8290e590-df0a-401e-aee3-f5bb422e4b1b.png", "unit_price": "$0.12/fl oz", "product_link": "https://www.instacart.com/products/3371015-clover-sonoma-organic-uht-whole-milk-half-gallon-64-oz?retailerSlug=safeway", "product_name": "Clover Sonoma Pasture-Raised Organic Whole Milk Vitamin D Ultra-Pasteurized Half Gallon", "original_price": null } ] } ``` ## Run it From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output: ```bash curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"instacart.com/search_products","input":{"query":"milk","store":"Safeway","zip_code":"94103","max_results":60}}' ``` From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`. ## Ask your agent - How much is Greek yogurt at Safeway for delivery to 94103? Show me brands, sizes, and prices. - Find oat milk at Costco near ZIP 98052 on Instacart, top 10 results with unit prices and whether they're in stock. - I'm in 60614 — what does Whole Foods have for sourdough bread right now? Include any sale prices vs original. - Check Instacart for ground coffee at Kroger delivering to 45202, up to 30 items, and list price per ounce. - Compare frozen pizza options at Aldi for zip 30309 — brand, size, current price, and links to each product. ## Input schema ```json { "type": "object", "required": [ "query", "zip_code", "store" ], "properties": { "query": { "type": "string", "minLength": 1, "description": "The grocery product to search for, for example oat milk." }, "store": { "type": "string", "minLength": 1, "description": "Store name, for example Safeway or Costco." }, "zip_code": { "type": "string", "maxLength": 5, "minLength": 5, "description": "Five-digit US delivery ZIP code, for example 94103." }, "max_results": { "type": "integer", "default": 20, "maximum": 60, "minimum": 1, "description": "Most products to return, for example 20." } } } ``` ## Output schema ```json { "type": "object", "required": [ "store", "products" ], "properties": { "store": { "type": "string", "description": "Store used for the search." }, "products": { "type": "array", "items": { "type": "object", "required": [ "product_name", "brand", "size", "price", "currency", "original_price", "unit_price", "in_stock", "image_link", "product_link" ], "properties": { "size": { "type": [ "string", "null" ] }, "brand": { "type": [ "string", "null" ] }, "price": { "type": [ "number", "null" ] }, "currency": { "type": "string" }, "in_stock": { "type": "boolean" }, "image_link": { "type": [ "string", "null" ] }, "unit_price": { "type": [ "string", "null" ] }, "product_link": { "type": "string" }, "product_name": { "type": "string" }, "original_price": { "type": [ "number", "null" ] } } } } } } ``` ## See more - [ALDI API: Search products](https://fous.com/methods/aldi.us/search-products.md): Search ALDI US groceries in site order with prices for the selected store. Prices and availability vary by store; related search results may follow direct matches. - [Trader Joe's API: Search products](https://fous.com/methods/traderjoes.com/search-products.md): Searches Trader Joe's public product catalogue by name or keywords, optionally within a main category. Prices are website reference prices and may vary by store. - [Target API: Search products](https://fous.com/methods/target.com/search-products.md): Searches Target products and returns prices, ratings, photos and product links. Prices can vary by store, so you can give a ZIP code for local pricing. - [Zara API: Search products](https://fous.com/methods/zara.com/search-products.md): Searches a country's English Zara store for products, with current prices, colours, images and product links. The all section excludes non-Zara brands. - [IKEA API: Search products](https://fous.com/methods/ikea.com/search-products.md): Searches IKEA products in a chosen country and returns current prices, details, photos and reviews in IKEA's result order. - [Macy's API: Search products](https://fous.com/methods/macys.com/search-products.md): Searches Macy's products in the site's order with optional USD price bounds, sale-only results and sorting. Prices for products with a range use the lowest shown price. - [Lowe's API: Get product details](https://fous.com/methods/lowes.com/get-product.md): Finds a Lowe's product by name, item number or product link and returns its details, price, specifications, images and availability at the nearest store for a ZIP code (or the site's default store). - [Target API: Check store stock](https://fous.com/methods/target.com/check-store-stock.md): Checks a Target product's stock and pickup, drive-up and same-day delivery availability at the stores nearest a US ZIP code.