# ALDI API: Search products

> 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.

Unofficial. Not affiliated with or endorsed by ALDI.

- Page: https://fous.com/methods/aldi.us/search-products
- Method: `aldi.us/search_products`, version 1
- Website: aldi.us
- Returns: name, brand, size, price, unit price, category, image, product link, product id
- 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 | `"eggs"` | Groceries to find, for example eggs. |
| `zip_code` | string | no |  | US ZIP code for the nearest available delivery store, for example 10001. Omit to use the site's default store. |
| `max_results` | integer | no |  | Maximum products to return, for example 20. Default 20. |

## Output

From a run on Oct 31, 2026, shortened. Its input:

```json
{
  "query": "eggs"
}
```

Its output:

```json
{
  "products": [
    {
      "name": "Simply Nature Organic Cage Free Eggs - 1 Dozen",
      "size": "24 oz",
      "brand": "simply nature",
      "price": 4.15,
      "category": "Whole Eggs",
      "currency": "USD",
      "image_link": "https://d2lnr5mha7bycj.cloudfront.net/product-image/file/large_2a475e1f-fb98-44e3-ad57-8f036752e56a.jpg",
      "product_id": "17498616",
      "unit_price": "$0.17/oz",
      "product_link": "https://www.aldi.us/store/aldi/products/17498616-simply-nature-organic-cage-free-brown-eggs-12-ct"
    },
    {
      "name": "Goldhen Large Grade A Eggs - 1 Dozen",
      "size": "12 ct",
      "brand": "goldhen",
      "price": 1.85,
      "category": "Whole Eggs",
      "currency": "USD",
      "image_link": "https://d2lnr5mha7bycj.cloudfront.net/product-image/file/large_32d401d6-6b1f-4231-ade3-19ed0ab7071b.jpg",
      "product_id": "115095",
      "unit_price": "$0.15 each",
      "product_link": "https://www.aldi.us/store/aldi/products/115095-goldhen-grade-a-large-eggs-12-ct"
    },
    {
      "name": "Goldhen Pasture Raised Large Grade A Brown Eggs - 12 Count",
      "size": "24 oz",
      "brand": "goldhen",
      "price": 3.95,
      "category": "Whole Eggs",
      "currency": "USD",
      "image_link": "https://d2lnr5mha7bycj.cloudfront.net/product-image/file/large_cd1d34ac-014d-4555-81de-76115cf16461.jpg",
      "product_id": "25319931",
      "unit_price": "$0.16/oz",
      "product_link": "https://www.aldi.us/store/aldi/products/25319931-golden-star-grade-a-pasture-raised-large-brown-eggs-12-ct"
    }
  ]
}
```

## 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":"aldi.us/search_products","input":{"query":"eggs"}}'
```

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 a gallon of whole milk at ALDI near ZIP 60614?
- Find me the cheapest shredded mozzarella options with unit prices, store near 30309
- Search aldi.us for gluten-free pasta and show the first 10 results with sizes and prices
- I need prices on organic baby spinach for the store closest to 94110
- What frozen pizza brands are available and what do they cost? Give me up to 30 results.

## Input schema

```json
{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "description": "Groceries to find, for example eggs."
    },
    "zip_code": {
      "type": "string",
      "maxLength": 5,
      "minLength": 5,
      "description": "US ZIP code for the nearest available delivery store, for example 10001. Omit to use the site's default store."
    },
    "max_results": {
      "type": "integer",
      "default": 20,
      "maximum": 60,
      "minimum": 1,
      "description": "Maximum products to return, for example 20."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "products"
  ],
  "properties": {
    "products": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "name",
          "brand",
          "size",
          "price",
          "currency",
          "unit_price",
          "category",
          "image_link",
          "product_link",
          "product_id"
        ],
        "properties": {
          "name": {
            "type": "string"
          },
          "size": {
            "type": [
              "string",
              "null"
            ]
          },
          "brand": {
            "type": [
              "string",
              "null"
            ]
          },
          "price": {
            "type": [
              "number",
              "null"
            ],
            "description": "Price in USD, or null when unavailable."
          },
          "category": {
            "type": [
              "string",
              "null"
            ]
          },
          "currency": {
            "type": "string"
          },
          "image_link": {
            "type": [
              "string",
              "null"
            ]
          },
          "product_id": {
            "type": "string"
          },
          "unit_price": {
            "type": [
              "string",
              "null"
            ],
            "description": "Displayed price per unit, if available."
          },
          "product_link": {
            "type": "string"
          }
        },
        "additionalProperties": false
      }
    }
  },
  "additionalProperties": false
}
```

## See more

- [Instacart API: Search store products](https://fous.com/methods/instacart.com/search-products.md): 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.
- [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.
- [AliExpress API: Search products](https://fous.com/methods/aliexpress.com/search-products.md): Searches AliExpress listings by product words, shipping destination, price range and sort order. Unpriced promotional cards are omitted; free shipping is marked only when the listing explicitly says so.
- [USDA API: Search foods](https://fous.com/methods/fdc.nal.usda.gov/search-foods.md): Searches USDA FoodData Central foods and branded products by food or brand name, ranked by relevance. Calories and serving sizes are null when not supplied.
- [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.
- [Kohl's API: Search products](https://fous.com/methods/kohls.com/search-products.md): Searches Kohl's products in site order and returns prices, offers, ratings and links for each result.
- [Ulta Beauty API: Search products](https://fous.com/methods/ulta.com/search-products.md): Searches Ulta Beauty products by keyword, brand, USD price range and sort order, and returns each product with its starting prices.
- [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.