# Trader Joe's Search API

> Search Trader Joe's products by keyword with name, price, size, category and dietary tags, filtered by store and category.

Source: https://www.sandbase.ai/apis/trader-joes/search
API reference: https://www.sandbase.ai/apis/trader-joes/search#api

## Facts

- Provider: Trader Joe's
- Type: Data API
- Endpoint: `POST https://api.sandbase.ai/v1/api/trader-joes/search`
- Price: $0.01 per call
- Capabilities: api, trader joes, ecommerce, grocery
- Billing: pay per use from one SandBase balance; no provider account or subscription needed

## Call it

`POST https://api.sandbase.ai/v1/api/trader-joes/search` with `Authorization: Bearer $SANDBASE_API_KEY` and the parameters as a JSON body.

| Parameter | Type | Required | Allowed values |
| --- | --- | --- | --- |
| `q` | string | yes |  |
| `store_id` | string | no |  |
| `category_id` | string | no |  |
| `characteristics` | string | no |  |
| `tags` | string | no |  |
| `new_products` | string | no |  |
| `sort_by` | string | no |  |
| `page` | string | no |  |
| `json_restrictor` | string | no |  |

## FAQ

### How do I use the Trader Joe's Search API?

Send a POST request to https://api.sandbase.ai/v1/api/trader-joes/search with your SandBase API key in the Authorization header (Bearer) and the parameters as a JSON body. You can also try it in the Playground on this page without writing code.

### How much does the Trader Joe's Search API cost?

$0.01 per call, billed from your SandBase balance. You are only charged for calls you make; there is no subscription.

### What parameters does the Trader Joe's Search API accept?

Required: q (string). Optional: store_id (string), category_id (string), characteristics (string), tags (string), new_products (string) and sort_by (string) and 2 more. The Parameters table and the Playground on this page list every field.

### What does the Trader Joe's Search API return?

A JSON response returned in the same HTTP request (synchronous).

### Do I need a Trader Joe's developer account or API key?

No. Trader Joe's Search runs through SandBase, so one SandBase API key covers this endpoint and every other API and model in the catalog. You do not need to apply for Trader Joe's API access separately.

## README

### Trader Joe's Search

Search Trader Joe's products by keyword with name, price, size, category and dietary tags, filtered by store and category.

#### Request

```bash
curl -X POST "https://api.sandbase.ai/v1/api/trader-joes/search" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"q": "coffee"}'
```

The result is returned in `outputs[0].data` as structured JSON.

#### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `q` | string | Yes | Parameter defines the search query. You can use anything that you would use in a regular Trader Joe's search. |
| `store_id` | string | No | Parameter defines the Trader Joe's store to search in, so only products sold in this store are returned (e.g., `454` for Austin - Northwest). Head to the Trader Joe's stores page for a full list of store IDs. When it isn't set, or when no s |
| `category_id` | string | No | Parameter defines the category of the products (e.g., `194` for Coffee & Tea). Head to the Trader Joe's categories page for a full list of category IDs. |
| `characteristics` | string | No | Parameter defines the characteristics the products must all have. It's a comma-separated list of options (e.g., `organic,vegan`). Available options: `kosher` - Kosher `organic` - Organic `gluten_free` - Gluten Free `vegan` - Vegan `antibiot |
| `tags` | string | No | Parameter defines the tags the products must all have, from the Trader Joe's "fun tags" like Date Night or Cheese Board. It's a comma-separated list of options (e.g., `date_night,cheese_board`). Head to the Trader Joe's tags page for a full |
| `new_products` | string | No | Parameter defines whether to only show the products Trader Joe's marks as new. It can be set to `true` or `false` (default). |
| `sort_by` | string | No | Parameter defines the sorting order of the results. It defaults to relevance. Available options: `price_low_to_high` - Price Low to High `price_high_to_low` - Price High to Low `popularity` - Popularity |
| `page` | string | No | Parameter defines the page number of the results (e.g., `1` (default) is the first page of results, `2` is the 2nd page of results, etc.). Trader Joe's returns up to 15 results per page. |
| `json_restrictor` | string | No | Parameter defines the fields you want to include in the output, reducing payload size for faster response. See the JSON Restrictor documentation for more details. |

#### Pricing

$0.010 per successful call. Failed calls are not charged.