Skip to content
Scrappa Get API key
Trader Joe's API 1 credit/request

Trader Joe's Product API Documentation

GET https://scrappa.co/api/traderjoes/product

Trader Joe's Product API returns one product by sku or by the url of its product page. The answer has everything from search plus the description, the serving suggestion, the images, the ingredients as a list and as text, allergens when Trader Joe's lists them, and the full nutrition panel with serving size, calories and each nutrient with amount and percent of daily value.

Send either sku or url. The sku is the 5 or 6 digit number from search, with leading zeros. An unknown sku answers 404 and is free. Costs 1 credit per successful request. Failed requests are free.

Trader Joe's Product API Documentation 1 credit/request

Endpoint

Request preview
GET
https://scrappa.co/api/traderjoes/product
Auth header
x-api-key
Cost
1 credit/request
Response preview
200 OK
{
    "data": {
        "product": {
            "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"
            ],
...

Parameters

Start with the required fields, then add optional filters only when your use case needs them.

Runnable path

This endpoint has no required query parameters.

2 optional filters available.

sku string Optional

Product SKU, 5 to 6 digits as returned by search, for example 059248. Send sku or url.

Example value example
url string Optional
Open example

Product page URL on traderjoes.com, for example https://www.traderjoes.com/home/products/pdp/059248-hummus-org-8-oz. Send sku or url.

Example value https://example.com/product

Response Schema

Example response fields are illustrative; inspect the JSON before integrating.

Example response fields

Scan these fields before integrating.

data meta success
JSON Response
200 OK
{
    "data": {
        "product": {
            "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",
                "https://www.traderjoes.com/content/dam/trjo/context-images/59248-organic-hummus-pdp.jpg"
            ],
            "currency": "USD",
            "nutrition": [
                {
                    "calories": 80,
                    "nutrients": [
                        {
                            "name": "Total Fat",
                            "amount": "6g",
                            "percent_daily_value": 8
                        },
                        {
                            "name": "Saturated Fat",
                            "amount": "1g",
                            "percent_daily_value": 5
                        },
                        {
                            "name": "Trans Fat",
                            "amount": "0g"
                        },
                        {
                            "name": "Cholesterol",
                            "amount": "0mg",
                            "percent_daily_value": 0
                        }
                    ],
                    "serving_size": "2 Tbsp. (28g)",
                    "servings_per_container": "Serves about 8"
                }
            ],
            "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",
            "description": "Hummus, simply meaning \u201cchickpeas\u201d in Arabic, is a staple of the Trader Joe\u2019s fresh dip refrigerators. While we love to toy with the classic chickpea-based spread and make funky, creative additions, n...",
            "ingredients": [
                "ORGANIC FRESH STEAMED CHICKPEAS",
                "WATER",
                "ORGANIC SESAME TAHINI",
                "BLEND OF OILS (ORGANIC SUNFLOWER OIL, ORGANIC EXTRA VIRGIN OILIVE OIL)",
                "SEA SALT",
                "ORGANIC GARLIC",
                "CITRIC ACID",
                "ORGANIC CUMIN",
                "ORGANIC GUAR GUM"
            ],
            "characteristics": [
                "Organic",
                "Kosher"
            ],
            "unit_price_unit": "oz",
            "description_html": "<p>Hummus, simply meaning \u201cchickpeas\u201d in Arabic, is a staple of the Trader Joe\u2019s fresh dip refrigerators. While we love to toy with the classic chickpea-based spread and make funky, creative additions...",
            "ingredients_text": "ORGANIC FRESH STEAMED CHICKPEAS, WATER, ORGANIC SESAME TAHINI, BLEND OF OILS (ORGANIC SUNFLOWER OIL, ORGANIC EXTRA VIRGIN OILIVE OIL), SEA SALT, ORGANIC GARLIC, CITRIC ACID, ORGANIC CUMIN, ORGANIC GUAR GUM",
            "country_of_origin": "U.S.A.",
            "serving_suggestion": "served alongside TJ's Falafel"
        }
    },
    "meta": {
        "credits": 1,
        "billable": true,
        "endpoint_family": "product"
    },
    "success": true
}

Errors

Handle these documented responses before retrying or showing customer-facing failures.

422

Validation Error

A required parameter or a value is invalid. This response is not billable.

{
    "errors": {
        "sku": [
            "A sku or a url is required, e.g. sku=059248."
        ]
    },
    "message": "The request validation failed"
}
404

Not Found

No product has this sku. This response is not billable.

{
    "meta": {
        "billable": false,
        "retryable": false,
        "endpoint_family": "product"
    },
    "error": {
        "code": "NOT_FOUND",
        "message": "The requested product was not found."
    },
    "success": false
}
503

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": "product"
    },
    "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.