APIs / Marketplaces / Trader Joe's

1 credit per call3 endpoints20 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.

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

#skustringnamestringbrandstringurlurlimageurlimagesstring[]pricenumbercurrencystringunit_pricenumberunit_price_unitstringsizestringsize_valueintegersize_unitstringcountry_of_originstringcharacteristicsstring[]tagsstring[]categoriesobject[]created_atstringupdated_atstringpositioninteger
1059248Organic HummusTrader Joe'shttps://www.traderjoes.com/home/products/pdp/059248-hummus-org-8-ozhttps://www.traderjoes.com/content/dam/trjo/products/m20404/59248.png[1 item]2.99USD0.3738oz8 oz8ozU.S.A.[2 items][3 items][3 items]2021-08-24 00:12:352026-11-07 20:40:091
2090642Mediterranean Style HummusTrader Joe'shttps://www.traderjoes.com/home/products/pdp/090642-hummus-mediterraneanhttps://www.traderjoes.com/content/dam/trjo/products/m20404/90642.png[1 item]4.29USD0.2681oz16 oz16ozMade in United States[1 item][3 items][3 items]2021-08-23 23:50:452026-11-07 20:48:162
3029911Roasted Garlic HummusTrader Joe'shttps://www.traderjoes.com/home/products/pdp/029911-hummus-garlic-roastedhttps://www.traderjoes.com/content/dam/trjo/products/m20404/29911.png[1 item]2.49USD0.3113oz8 oz8ozProduct of USA[1 item][3 items][3 items]2021-08-24 00:22:072026-11-07 20:41:083

Recorded from our API · 3 items shown · 20 datapoints per itemGET /v1/trader-joes/search?query=hummus

20 datapoints

Identity

  • skustring
  • namestring
  • brandstring

Contact

  • urlurl

Location

  • country_of_originstring

Reputation

  • imageurl
  • imagesstring[]

Price

  • pricenumber
  • currencystring
  • unit_pricenumber
  • unit_price_unitstring

Other

  • sizestring
  • size_valueinteger
  • size_unitstring
  • characteristicsstring[]
  • tagsstring[]
  • categoriesobject[]
  • created_atstring
  • updated_atstring
  • positioninteger

Playground

Run this API

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

EndpointRequired parametersCost
GET/v1/trader-joes/categories
none
1 credit
GET/v1/trader-joes/product
none+2 optional
1 credit
GET/v1/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.

MarketplacesJSONRESTMCP

More marketplaces APIs

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.