Trader Joe's Search API 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.
Use page and per_page (1 to 100) to walk the results. The answer lists total_results, total_pages and has_next_page. A page past the end is an empty list. Use the sku of an item with the product route to read ingredients and nutrition facts.
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.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
1 required parameter needed before sending a request.
2 optional filters available.
string
Required
Search text, 1 to 120 characters, for example hummus.
coffee shops
integer
Optional
One-based page number, 1 to 500 (default 1).
1
integer
Optional
Results per page, 1 to 100 (default 24).
10
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"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
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
A required parameter or a value is invalid. This response is not billable.
{
"errors": {
"query": [
"A search text is required, e.g. hummus."
]
},
"message": "The request validation failed"
}Upstream Unavailable
Trader Joe's could not be reached after several tries. This response is not billable. Retry shortly.
{
"meta": {
"billable": false,
"retryable": true,
"endpoint_family": "search"
},
"error": {
"code": "UPSTREAM_UNAVAILABLE",
"message": "Trader Joe's could not be reached. Please retry shortly."
},
"success": false
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.