# Trader Joe's Product API Documentation

<p><strong>Trader Joe's Product API</strong> returns one product by <code>sku</code> or by the <code>url</code> 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.</p><p>Send either <code>sku</code> or <code>url</code>. 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.</p>

- **Documentation:** [https://scrappa.co/docs/traderjoes-api/traderjoes_product](https://scrappa.co/docs/traderjoes-api/traderjoes_product)
- **API group:** Trader Joe's API
- **Endpoint:** `GET https://scrappa.co/api/traderjoes/product`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `sku` | string | No | Product SKU, 5 to 6 digits as returned by search, for example 059248. Send sku or url. |
| `url` | string | No | 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 response

```json
{
    "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

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A required parameter or a value is invalid. This response is not billable. |
| 404 | Not Found | No product has this sku. This response is not billable. |
| 503 | Upstream Unavailable | Trader Joe's could not be reached after several tries. This response is not billable. Retry shortly. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)
