curl "https://api.alura.io/v1/research/saved/lists/lst_0000000000000000000000001B/items" \
  -H "Authorization: Bearer $ALURA_API_KEY"

const res = await fetch('https://api.alura.io/v1/research/saved/lists/lst_0000000000000000000000001B/items', {
  headers: {
    Authorization: `Bearer ${process.env.ALURA_API_KEY}`,
  },
});
console.log(await res.json());

import json
import os
import urllib.request

request = urllib.request.Request(
    "https://api.alura.io/v1/research/saved/lists/lst_0000000000000000000000001B/items",
    headers={
        "Authorization": f"Bearer {os.environ['ALURA_API_KEY']}",
    },
)
with urllib.request.urlopen(request) as response:
    print(json.load(response))

{
  "object": "list",
  "data": [
    {
      "object": "research.saved_item",
      "id": "itm_00000000000000000004000001",
      "type": "product",
      "ref_id": "4524717183",
      "added_at": "2026-09-02T09:00:00.000Z",
      "status": "available",
      "data": {
        "object": "research.product",
        "id": "4524717183",
        "title": "Personalized Name Mug, Custom Coffee Mug",
        "url": "https://www.etsy.com/listing/4524717183",
        "shop": {
          "id": "48911633",
          "name": "MugCo"
        },
        "price": {
          "amount": "24.99",
          "currency": "EUR",
          "usd": "27.10"
        },
        "image_url": "https://i.etsystatic.com/48911633/r/il/0a1b2c/4524717183/il_570xN.4524717183_mug1.jpg",
        "category": {
          "id": "1062",
          "path": [
            "Home & Living",
            "Kitchen & Dining",
            "Drink & Barware",
            "Drinkware",
            "Mugs"
          ]
        },
        "sales": {
          "est_lifetime": 6400,
          "est_monthly_avg": 210,
          "est_lifetime_revenue_usd": 173440
        },
        "reviews": {
          "count": 842,
          "average": 4.9
        },
        "favorites": 3120,
        "listing_score": 86,
        "listed_at": "2023-04-02T10:11:00.000Z",
        "as_of": "2026-10-13T08:05:00.000Z"
      }
    },
    {
      "object": "research.saved_item",
      "id": "itm_00000000000000000008000001",
      "type": "shop",
      "ref_id": "48911633",
      "added_at": "2026-09-02T09:00:00.000Z",
      "status": "available",
      "data": {
        "object": "research.shop",
        "id": "48911633",
        "name": "MugCo",
        "url": "https://www.etsy.com/shop/MugCo",
        "icon_url": "https://i.etsystatic.com/iusa/0a1b2c/48911633/iusa_fullxfull.48911633_mugco.jpg",
        "country": "US",
        "category": {
          "name": "Home & Living",
          "sub_category": "Kitchen & Dining"
        },
        "sales": {
          "lifetime": 48210,
          "est_monthly_avg": 1150,
          "est_lifetime_revenue_usd": 1272700
        },
        "reviews": {
          "count": 9120,
          "average": 4.9
        },
        "catalog": {
          "active_listings": 1661
        },
        "as_of": "2026-10-13T09:47:00.000Z"
      }
    },
    {
      "object": "research.saved_item",
      "id": "itm_0000000000000000000C000001",
      "type": "keyword",
      "ref_id": "88123",
      "added_at": "2026-09-02T09:00:00.000Z",
      "status": "available",
      "data": {
        "object": "research.keyword",
        "id": "88123",
        "keyword": "personalized mug",
        "language": "en",
        "volume": {
          "etsy_monthly": 12400,
          "google_monthly": 40500
        },
        "competition": {
          "level": "high",
          "competing_listings": 182000
        },
        "trend": {
          "change_3m": 0.12,
          "change_yoy": 0.3
        },
        "market": {
          "avg_price_usd": 24.1,
          "est_avg_monthly_sales": null
        },
        "as_of": "2026-10-12T04:00:00.000Z"
      }
    },
    {
      "object": "research.saved_item",
      "id": "itm_00000000000000000004000002",
      "type": "product",
      "ref_id": "1349902215",
      "added_at": "2026-09-02T09:00:00.000Z",
      "status": "unavailable",
      "data": null
    }
  ],
  "has_more": false,
  "next_cursor": null,
  "total": {
    "value": 4,
    "relation": "eq"
  }
}

{
  "type": "https://docs.alura.io/errors/invalid_request",
  "title": "Invalid request",
  "status": 400,
  "code": "invalid_request",
  "detail": "Invalid request",
  "suggestion": "Fix the request as the detail says, then send it again.",
  "retryable": false,
  "request_id": "req_01JQ5W3H8M2N4P6R8T0V2X4Z6B"
}

{
  "type": "https://docs.alura.io/errors/unauthorized",
  "title": "Unauthorized",
  "status": 401,
  "code": "unauthorized",
  "detail": "Unauthorized",
  "suggestion": "Send a valid API key as `Authorization: Bearer alura_sk_...`.",
  "retryable": false,
  "request_id": "req_01JQ5W3H8M2N4P6R8T0V2X4Z6B"
}

{
  "type": "https://docs.alura.io/errors/credits_exhausted",
  "title": "API credits exhausted",
  "status": 402,
  "code": "credits_exhausted",
  "detail": "API credits exhausted",
  "suggestion": "Upgrade the plan or wait for the monthly reset.",
  "retryable": false,
  "request_id": "req_01JQ5W3H8M2N4P6R8T0V2X4Z6B"
}

{
  "type": "https://docs.alura.io/errors/plan_required",
  "title": "Plan required",
  "status": 403,
  "code": "plan_required",
  "detail": "Plan required",
  "suggestion": "Upgrade the workspace plan to use this operation.",
  "retryable": false,
  "request_id": "req_01JQ5W3H8M2N4P6R8T0V2X4Z6B"
}

{
  "type": "https://docs.alura.io/errors/not_found",
  "title": "Not found",
  "status": 404,
  "code": "not_found",
  "detail": "Not found",
  "suggestion": "Check the ID, or search for it first.",
  "retryable": false,
  "request_id": "req_01JQ5W3H8M2N4P6R8T0V2X4Z6B"
}

{
  "type": "https://docs.alura.io/errors/method_not_allowed",
  "title": "Method not allowed",
  "status": 405,
  "code": "method_not_allowed",
  "detail": "Method not allowed",
  "suggestion": "Use one of the methods in the Allow header.",
  "retryable": false,
  "request_id": "req_01JQ5W3H8M2N4P6R8T0V2X4Z6B"
}

{
  "type": "https://docs.alura.io/errors/rate_limited",
  "title": "Rate limited",
  "status": 429,
  "code": "rate_limited",
  "detail": "Rate limited",
  "suggestion": "Wait for Retry-After, then retry.",
  "retryable": true,
  "request_id": "req_01JQ5W3H8M2N4P6R8T0V2X4Z6B"
}

{
  "type": "https://docs.alura.io/errors/internal_error",
  "title": "Internal error",
  "status": 500,
  "code": "internal_error",
  "detail": "Internal error",
  "suggestion": "Retry; if it keeps failing, report the request_id.",
  "retryable": true,
  "request_id": "req_01JQ5W3H8M2N4P6R8T0V2X4Z6B"
}

{
  "type": "https://docs.alura.io/errors/credits_unavailable",
  "title": "API credits unavailable",
  "status": 503,
  "code": "credits_unavailable",
  "detail": "API credits unavailable",
  "suggestion": "Retry shortly.",
  "retryable": true,
  "request_id": "req_01JQ5W3H8M2N4P6R8T0V2X4Z6B"
}