Quickstart

curl --fail-with-body -sS -G https://api.alura.io/v1/research/products \
  -H "Authorization: Bearer $ALURA_API_KEY" \
  --data-urlencode "q=name mug" \
  --data-urlencode "limit=3"

interface Product {
  id: string;
  title: string | null;
  price: { amount: string; currency: string; usd: string | null } | null;
  sales: { est_monthly_avg: number | null };
}

const url = new URL('https://api.alura.io/v1/research/products');
url.searchParams.set('q', 'name mug');
url.searchParams.set('limit', '3');

const res = await fetch(url, { headers: { Authorization: `Bearer ${process.env.ALURA_API_KEY}` } });
if (!res.ok) throw new Error(`${res.status}: ${await res.text()}`);
const page = (await res.json()) as { data: Product[] };

for (const product of page.data) {
  console.log(`${product.id} ${product.title}: ${product.price?.usd ?? 'unknown'} USD, about ${product.sales.est_monthly_avg ?? 'unknown'} sales a month`);
}

import json
import os
import urllib.parse
import urllib.request

query = urllib.parse.urlencode({"q": "name mug", "limit": 3})
request = urllib.request.Request(
    f"https://api.alura.io/v1/research/products?{query}",
    headers={"Authorization": f"Bearer {os.environ['ALURA_API_KEY']}"},
)
with urllib.request.urlopen(request) as response:
    page = json.load(response)

for product in page["data"]:
    usd = (product["price"] or {}).get("usd") or "unknown"
    monthly = product["sales"]["est_monthly_avg"]
    print(f"{product['id']} {product['title']}: {usd} USD, about {monthly if monthly is not None else 'unknown'} sales a month")