--- title: "Trader Joe's API: JSON data, 3 endpoints, 1 credit per call" description: "Trader Joe's API for product search, product details by SKU and categories: prices, unit prices, sizes and tags as JSON. 1 credit per successful call." url: https://perceptlayer.com/apis/trader-joes --- [APIs](https://perceptlayer.com/apis) / [Marketplaces](https://perceptlayer.com/verticals/marketplaces) / Trader Joe's 1 credit per call 3 endpoints 20 datapoints # Trader Joe's API Trader Joe's API for product search, product details by SKU and categories: prices, unit prices, sizes and tags as JSON. 1 credit per successful call. [Get a free API key](https://perceptlayer.com/signup) Run it below Trader Joe's GET /v1/trader-joes/search?query=hummus ``` { "success": true, "data": { "query": "hummus", "page": 1, "per_page": 24, "total_results": 10, "total_pages": 1, "has_next_page": false, "items": [ { "sku": "059248", "name": "Organic Hummus", "brand": "Trader Joe's", "url": "https://www.traderjoes.com/home/products/pdp/059248-hummus-org-8-oz", "image": "https://www.traderjoes.com/content/dam/trjo/products/m20404/59248.png", "images": [ "https://www.traderjoes.com/content/dam/trjo/products/m20404/59248.png" ], "price": 2.99, "currency": "USD", "unit_price": 0.3738, "unit_price_unit": "oz", "size": "8 oz", "size_value": 8, "size_unit": "oz", "country_of_origin": "U.S.A.", "characteristics": [ "Organic", "Kosher" ], "tags": [ "Alfresco Dining", "Effortless Entertaining", "Game Night" ], "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", "updated_at": "2026-11-07 20:40:09", "position": 1 }, { "sku": "090642", "name": "Mediterranean Style Hummus", "brand": "Trader Joe's", "url": "https://www.traderjoes.com/home/products/pdp/090642-hummus-mediterranean", "image": "https://www.traderjoes.com/content/dam/trjo/products/m20404/90642.png", "images": [ "https://www.traderjoes.com/content/dam/trjo/products/m20404/90642.png" ], "price": 4.29, "currency": "USD", "unit_price": 0.2681, "unit_price_unit": "oz", "size": "16 oz", "size_value": 16, "size_unit": "oz", "country_of_origin": "Made in United States", "characteristics": [ "Kosher" ], "tags": [ "Alfresco Dining", "Cheese Board", "Effortless Entertaining" ], "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", "updated_at": "2026-11-07 20:48:16", "position": 2 }, { "sku": "029911", "name": "Roasted Garlic Hummus", "brand": "Trader Joe's", "url": "https://www.traderjoes.com/home/products/pdp/029911-hummus-garlic-roasted", "image": "https://www.traderjoes.com/content/dam/trjo/products/m20404/29911.png", "images": [ "https://www.traderjoes.com/content/dam/trjo/products/m20404/29911.png" ], "price": 2.49, "currency": "USD", "unit_price": 0.3113, "unit_price_unit": "oz", "size": "8 oz", "size_value": 8, "size_unit": "oz", "country_of_origin": "Product of USA", "characteristics": [ "Kosher" ], "tags": [ "Brunch All Day", "Midday Snacks", "Picnic" ], "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", "updated_at": "2026-11-07 20:41:08", "position": 3 } ] }, "meta": { "endpoint_family": "search", "request_id": "req_af4ae9cc6ab04f31876b7128d75f90cf", "credits_charged": 1, "credits_remaining": 1907 } } ``` 200 OK JSON X-Credits-Used: 1 Recorded from our API and shortened. Sample data ## What one call returns A recorded run of `search`: the fields and shapes you will get, shortened to 3 items. | # | sku string | name string | brand string | url url | image url | images string\[\] | price number | currency string | unit\_price number | unit\_price\_unit string | size string | size\_value integer | size\_unit string | country\_of\_origin string | characteristics string\[\] | tags string\[\] | categories object\[\] | created\_at string | updated\_at string | position integer | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 1 | 059248 | Organic Hummus | Trader Joe's | https://www.traderjoes.com/home/products/pdp/059248-hummus-org-8-oz | https://www.traderjoes.com/content/dam/trjo/products/m20404/59248.png | \[1 item\] | 2.99 | USD | 0.3738 | oz | 8 oz | 8 | oz | U.S.A. | \[2 items\] | \[3 items\] | \[3 items\] | 2021-08-24 00:12:35 | 2026-11-07 20:40:09 | 1 | | 2 | 090642 | Mediterranean Style Hummus | Trader Joe's | https://www.traderjoes.com/home/products/pdp/090642-hummus-mediterranean | https://www.traderjoes.com/content/dam/trjo/products/m20404/90642.png | \[1 item\] | 4.29 | USD | 0.2681 | oz | 16 oz | 16 | oz | Made in United States | \[1 item\] | \[3 items\] | \[3 items\] | 2021-08-23 23:50:45 | 2026-11-07 20:48:16 | 2 | | 3 | 029911 | Roasted Garlic Hummus | Trader Joe's | https://www.traderjoes.com/home/products/pdp/029911-hummus-garlic-roasted | https://www.traderjoes.com/content/dam/trjo/products/m20404/29911.png | \[1 item\] | 2.49 | USD | 0.3113 | oz | 8 oz | 8 | oz | Product of USA | \[1 item\] | \[3 items\] | \[3 items\] | 2021-08-24 00:22:07 | 2026-11-07 20:41:08 | 3 | Recorded from our API · 3 items shown · 20 datapoints per item GET /v1/trader-joes/search?query=hummus 20 datapoints ### Identity - sku string - name string - brand string ### Contact - url url ### Location - country\_of\_origin string ### Reputation - image url - images string\[\] ### Price - price number - currency string - unit\_price number - unit\_price\_unit string ### Other - size string - size\_value integer - size\_unit string - characteristics string\[\] - tags string\[\] - categories object\[\] - created\_at string - updated\_at string - position integer Playground ## Run this API cURL shell ``` curl "https://api.perceptlayer.com/v1/trader-joes/search?query=hummus" \ -H "X-API-Key: $API_KEY" ``` Trader Joe's · 3 endpoints ## Endpoints Every endpoint takes the same key. Open one for its parameters and an example request. | Endpoint | Required parameters | Cost | | --- | --- | --- | | [GET `/v1/trader-joes/categories`](https://perceptlayer.com/apis/trader-joes/categories) | none | 1 credit | | [GET `/v1/trader-joes/product`](https://perceptlayer.com/apis/trader-joes/product) | none +2 optional | 1 credit | | [GET `/v1/trader-joes/search`](https://perceptlayer.com/apis/trader-joes/search) | `query` +2 optional | 1 credit | Overview ## About the Trader Joe's API ## What you can get The Trader Joe's API returns Trader Joe's product data as JSON through 3 endpoints. - **Search:** `search` takes a `query`, with `page` and `per_page`. - **Products:** `product` takes a `sku` or a product `url`. - **Categories:** `categories` takes no parameters. The recorded search for "hummus" returns `query`, `page`, `per_page`, `total_results` (10 in that recording), `total_pages`, `has_next_page` and `items`. Each item has `sku`, `name`, `brand`, `url`, `images`, `price`, `currency`, `unit_price`, `unit_price_unit`, `size`, `country_of_origin`, `characteristics`, `tags`, `categories`, `created_at`, `updated_at` and `position`. ## How a call works Search, then look up: `GET /v1/trader-joes/search?query=hummus` with your key in the `X-API-Key` header returns each product's `sku`, such as 059248; `product` takes that `sku`. Every successful call costs 1 credit; failed calls cost nothing. Marketplaces JSON REST MCP ### More marketplaces APIs [About You](https://perceptlayer.com/apis/about-you) [adidas](https://perceptlayer.com/apis/adidas) [AliExpress](https://perceptlayer.com/apis/aliexpress) [Allegro](https://perceptlayer.com/apis/allegro) [Amazon](https://perceptlayer.com/apis/amazon) [ASOS](https://perceptlayer.com/apis/asos) [Billiger.de](https://perceptlayer.com/apis/billiger) [bol.com](https://perceptlayer.com/apis/bol) [Chrono24](https://perceptlayer.com/apis/chrono24) [Costco](https://perceptlayer.com/apis/costco) [Craigslist](https://perceptlayer.com/apis/craigslist) [DBA](https://perceptlayer.com/apis/dba) Use cases ### Track Trader Joe's prices for a product list `Use the Trader Joe's API to track Trader Joe's prices for a product list` ### Compare unit prices across sizes and products `Use the Trader Joe's API to compare unit prices across sizes and products` ### Watch for new products with \`created\_at\` `` Use the Trader Joe's API to watch for new products with `created_at` `` ### Build a product catalogue by category with \`categories\` `` Use the Trader Joe's API to build a product catalogue by category with `categories` `` FAQ ## Questions **How much does the Trader Joe's API cost?** Each successful call costs one credit. New accounts get free credits to start, and credit packs bring the price down as you scale. **Do I need a Trader Joe's account?** No. You call this Trader Joe's API with your Perceptlayer key in the \`X-API-Key\` header, with no Trader Joe's login. **What format are responses in?** Every endpoint returns JSON, with no HTML parsing on your side. **Should I build a Trader Joe's scraper instead?** You can, but a Trader Joe's scraper is code you maintain: page changes break it, requests get blocked, and Trader Joe's's terms govern how you collect data. The Trader Joe's API gives you 3 endpoints of named JSON fields for 1 credit per successful call, and failed calls cost nothing. A scraper makes sense only for data these endpoints don't return, so check the response in the playground on this page first. ## Try the Trader Joe's API with 100 free credits No credit card. Failed calls are never billed. [Get a free API key](https://perceptlayer.com/signup) [Read the docs](https://docs.perceptlayer.com)