# Trader Joe's Search API Documentation

<p><strong>Trader Joe's Search API</strong> searches the products of traderjoes.com. Each item has the SKU, name, image, price, the sale price when the item is on sale, the unit price (price per ounce, pound or piece), the size, the country of origin, characteristics such as Organic or Kosher, tags and categories.</p><p>Use <code>page</code> and <code>per_page</code> (1 to 100) to walk the results. The answer lists <code>total_results</code>, <code>total_pages</code> and <code>has_next_page</code>. A page past the end is an empty list. Use the <code>sku</code> of an item with the product route to read ingredients and nutrition facts.</p><p>The answer has no stock status, because Trader Joe's does not publish a reliable one. Costs 1 credit per successful request. Empty results and failed requests are free.</p>

- **Documentation:** [https://scrappa.co/docs/traderjoes-api/traderjoes_search](https://scrappa.co/docs/traderjoes-api/traderjoes_search)
- **API group:** Trader Joe's API
- **Endpoint:** `GET https://scrappa.co/api/traderjoes/search`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `query` | string | Yes | Search text, 1 to 120 characters, for example hummus. |
| `page` | integer | No | One-based page number, 1 to 500 (default 1). |
| `per_page` | integer | No | Results per page, 1 to 100 (default 24). |

## Example response

```json
{
    "data": {
        "page": 1,
        "items": [
            {
                "sku": "059248",
                "url": "https://www.traderjoes.com/home/products/pdp/059248-hummus-org-8-oz",
                "name": "Organic Hummus",
                "size": "8 oz",
                "tags": [
                    "Alfresco Dining",
                    "Effortless Entertaining",
                    "Game Night",
                    "Midday Snacks",
                    "Picnic"
                ],
                "brand": "Trader Joe's",
                "image": "https://www.traderjoes.com/content/dam/trjo/products/m20404/59248.png",
                "price": 2.99,
                "images": [
                    "https://www.traderjoes.com/content/dam/trjo/products/m20404/59248.png"
                ],
                "currency": "USD",
                "position": 1,
                "size_unit": "oz",
                "categories": [
                    {
                        "name": "Food",
                        "slug": "food"
                    },
                    {
                        "name": "Dips, Sauces & Dressings",
                        "slug": "dips-sauces-dressings"
                    },
                    {
                        "name": "Dip/Spread",
                        "slug": "dip-spread"
                    }
                ],
                "created_at": "2021-08-24 00:12:35",
                "size_value": 8,
                "unit_price": 0.3738,
                "updated_at": "2026-10-27 19:17:11",
                "characteristics": [
                    "Organic",
                    "Kosher"
                ],
                "unit_price_unit": "oz",
                "country_of_origin": "U.S.A."
            },
            {
                "sku": "090642",
                "url": "https://www.traderjoes.com/home/products/pdp/090642-hummus-mediterranean",
                "name": "Mediterranean Style Hummus",
                "size": "16 oz",
                "tags": [
                    "Alfresco Dining",
                    "Cheese Board",
                    "Effortless Entertaining"
                ],
                "brand": "Trader Joe's",
                "image": "https://www.traderjoes.com/content/dam/trjo/products/m20404/90642.png",
                "price": 3.99,
                "images": [
                    "https://www.traderjoes.com/content/dam/trjo/products/m20404/90642.png"
                ],
                "currency": "USD",
                "position": 2,
                "size_unit": "oz",
                "categories": [
                    {
                        "name": "Food",
                        "slug": "food"
                    },
                    {
                        "name": "Dips, Sauces & Dressings",
                        "slug": "dips-sauces-dressings"
                    },
                    {
                        "name": "Dip/Spread",
                        "slug": "dip-spread"
                    }
                ],
                "created_at": "2021-08-23 23:50:45",
                "sale_price": 3.99,
                "size_value": 16,
                "unit_price": 0.2494,
                "updated_at": "2026-10-16 23:47:16",
                "regular_price": 4.29,
                "characteristics": [
                    "Kosher"
                ],
                "unit_price_unit": "oz",
                "country_of_origin": "Made in United States"
            },
            {
                "sku": "029911",
                "url": "https://www.traderjoes.com/home/products/pdp/029911-hummus-garlic-roasted",
                "name": "Roasted Garlic Hummus",
                "size": "8 oz",
                "tags": [
                    "Brunch All Day",
                    "Midday Snacks",
                    "Picnic"
                ],
                "brand": "Trader Joe's",
                "image": "https://www.traderjoes.com/content/dam/trjo/products/m20404/29911.png",
                "price": 2.49,
                "images": [
                    "https://www.traderjoes.com/content/dam/trjo/products/m20404/29911.png"
                ],
                "currency": "USD",
                "position": 3,
                "size_unit": "oz",
                "categories": [
                    {
                        "name": "Food",
                        "slug": "food"
                    },
                    {
                        "name": "Dips, Sauces & Dressings",
                        "slug": "dips-sauces-dressings"
                    },
                    {
                        "name": "Dip/Spread",
                        "slug": "dip-spread"
                    }
                ],
                "created_at": "2021-08-24 00:22:07",
                "size_value": 8,
                "unit_price": 0.3113,
                "updated_at": "2026-10-27 19:34:09",
                "characteristics": [
                    "Kosher"
                ],
                "unit_price_unit": "oz",
                "country_of_origin": "Product of USA"
            }
        ],
        "query": "hummus",
        "per_page": 3,
        "total_pages": 4,
        "has_next_page": true,
        "total_results": 10
    },
    "meta": {
        "credits": 1,
        "billable": true,
        "endpoint_family": "search"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A required parameter or a value is invalid. This response is not billable. |
| 503 | Upstream Unavailable | Trader Joe's could not be reached after several tries. This response is not billable. Retry shortly. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)