# Trader Joe's API: Search products

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

Unofficial. Not affiliated with or endorsed by Trader Joe's.

- Page: https://fous.com/methods/traderjoes.com/search-products
- Method: `traderjoes.com/search_products`, version 1
- Website: traderjoes.com
- Returns: name, price, size, category, description, dietary tags, image and product links, SKU
- 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 | `"mandarin orange chicken"` | Product name or keywords to search, e.g. mandarin orange chicken. |
| `category` | string | no |  | Main catalogue category, e.g. food; any searches all products. One of "any", "food", "beverages", "flowers_and_plants", "everything_else". Default "any". |
| `max_results` | integer | no |  | Maximum products to return, e.g. 20. Default 20. |

## Output

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

```json
{
  "query": "mandarin orange chicken"
}
```

Its output:

```json
{
  "products": [
    {
      "sku": "083847",
      "name": "Sliced Rotisserie Seasoned Chicken Breast",
      "size": "7 Oz",
      "price": 4.99,
      "category": "Chicken & Turkey",
      "currency": "USD",
      "image_link": "https://www.traderjoes.com/content/dam/trjo/products/m20802/83847.png",
      "description": "When it comes to lunch, one shouldn’t have to sacrifice great flavor, convenience, or quality for the sake of speed. Thankfully, the refrigerators at your neighborhood Trader Joe’s offer plenty of options to support top-tier sandwich construction, like Trader Joe’s Rotisserie Seasoned Chicken Breast…",
      "dietary_tags": [
        "Antibiotic Free"
      ],
      "product_link": "https://www.traderjoes.com/home/products/pdp/sliced-rotisserie-seasoned-chicken-breast-083847"
    },
    {
      "sku": "084842",
      "name": "Cranberry Jalapeño Chicken Meatballs",
      "size": "12 Oz",
      "price": 4.29,
      "category": "Chicken & Turkey",
      "currency": "USD",
      "image_link": "https://www.traderjoes.com/content/dam/trjo/products/m20802/84842.png",
      "description": "An ode to a classic all-American appetizer, Trader Joe’s Cranberry Jalapeño Meatballs are sweet, savory, and a little spicy—and the perfect bite sized party snack. These Meatballs are made with all natural, minimally processed chicken thigh and breast meat from birds raised without antibiotics. The …",
      "dietary_tags": [
        "Antibiotic Free",
        "Gluten Free"
      ],
      "product_link": "https://www.traderjoes.com/home/products/pdp/cranberry-jalapeno-chicken-meatballs-084842"
    },
    {
      "sku": "084466",
      "name": "Pollo Asado Chicken Thighs",
      "size": "1 Lb",
      "price": 6.99,
      "category": "Chicken & Turkey",
      "currency": "USD",
      "image_link": "https://www.traderjoes.com/content/dam/trjo/products/m20802/84466.png",
      "description": "As the weather warms up, cooking dinner (read: heating up the kitchen) becomes exponentially less appealing—but you still need to feed your crew. What to do? Pick up some packages of Trader Joe’s Carne Asada Ranchera! Inspired by the flavorful meat offered at taco carts and meat markets across South…",
      "dietary_tags": [],
      "product_link": "https://www.traderjoes.com/home/products/pdp/pollo-asado-chicken-thighs-084466"
    }
  ]
}
```

## 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":"traderjoes.com/search_products","input":{"query":"mandarin orange chicken"}}'
```

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

- Find frozen mandarin orange chicken at Trader Joe's and show me the price and size
- Search for gluten-free snacks under the food category, return up to 10 items
- Look up almond milk in the beverages category with dietary tags
- I need organic bananas or banana products, list the top 15 matches with SKUs
- Show me any potted plants or flowers available, limited to 5 results

## Input schema

```json
{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "description": "Product name or keywords to search, e.g. mandarin orange chicken."
    },
    "category": {
      "enum": [
        "any",
        "food",
        "beverages",
        "flowers_and_plants",
        "everything_else"
      ],
      "type": "string",
      "default": "any",
      "description": "Main catalogue category, e.g. food; any searches all products."
    },
    "max_results": {
      "type": "integer",
      "default": 20,
      "maximum": 50,
      "minimum": 1,
      "description": "Maximum products to return, e.g. 20."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "products"
  ],
  "properties": {
    "products": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "name",
          "price",
          "currency",
          "size",
          "category",
          "description",
          "dietary_tags",
          "image_link",
          "product_link",
          "sku"
        ],
        "properties": {
          "sku": {
            "type": "string",
            "description": "Trader Joe's product SKU."
          },
          "name": {
            "type": "string",
            "description": "Product name."
          },
          "size": {
            "type": [
              "string",
              "null"
            ],
            "description": "Package size and unit."
          },
          "price": {
            "type": [
              "number",
              "null"
            ],
            "description": "Website reference price."
          },
          "category": {
            "type": [
              "string",
              "null"
            ],
            "description": "Product category on Trader Joe's."
          },
          "currency": {
            "type": "string",
            "description": "Price currency (USD)."
          },
          "image_link": {
            "type": [
              "string",
              "null"
            ],
            "description": "Product image link."
          },
          "description": {
            "type": [
              "string",
              "null"
            ],
            "description": "Plain-text product description."
          },
          "dietary_tags": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Product characteristic tags such as Vegan and Gluten Free."
          },
          "product_link": {
            "type": "string",
            "description": "Product page link."
          }
        }
      },
      "description": "Matching products in website order."
    }
  }
}
```

## See more

- [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.
- [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.
- [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.
- [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.
- [Chewy API: Search products](https://fous.com/methods/chewy.com/search-products.md): Search Chewy products by words, pet type, and sort order. Returns up to 72 products in Chewy's order, including listed and first-order Autoship prices when shown.
- [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.
- [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.
- [Best Buy API: Search products](https://fous.com/methods/bestbuy.com/search-products.md): Searches Best Buy US products with an optional price range, sort order and page. Prices and availability come from public listings and may vary by location.
