Find products

curl --fail-with-body -sS -G https://api.alura.io/v1/research/products \
  -H "Authorization: Bearer $ALURA_API_KEY" \
  --data-urlencode "q=mug" \
  --data-urlencode "price_max=30" \
  --data-urlencode "est_monthly_sales_min=50" \
  --data-urlencode "sort=est_monthly_sales" \
  --data-urlencode "fields=title,price.usd,sales.est_monthly_avg"

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

const url = new URL('https://api.alura.io/v1/research/products');
url.search = new URLSearchParams({
  q: 'mug',
  price_max: '30',
  est_monthly_sales_min: '50',
  sort: 'est_monthly_sales',
  fields: 'title,price.usd,sales.est_monthly_avg',
}).toString();

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[]; total: { value: number; relation: 'eq' | 'gte' } };

console.log(`${page.total.relation === 'gte' ? 'at least ' : ''}${page.total.value} products`);
for (const p of page.data) console.log(`${p.id} ${p.title}: ${p.price?.usd ?? 'unknown'} USD, ${p.sales.est_monthly_avg ?? 'unknown'} a month`);

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

query = urllib.parse.urlencode({
    "q": "mug",
    "price_max": 30,
    "est_monthly_sales_min": 50,
    "sort": "est_monthly_sales",
    "fields": "title,price.usd,sales.est_monthly_avg",
})
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)

total = page["total"]
print(f"{'at least ' if total['relation'] == 'gte' else ''}{total['value']} products")
for p in page["data"]:
    usd = (p["price"] or {}).get("usd") or "unknown"
    monthly = p["sales"]["est_monthly_avg"]
    print(f"{p['id']} {p['title']}: {usd} USD, {monthly if monthly is not None else 'unknown'} a month")

# First page; for the next one, add --data-urlencode "cursor=<next_cursor>" with the same query.
curl --fail-with-body -sS -G https://api.alura.io/v1/research/products \
  -H "Authorization: Bearer $ALURA_API_KEY" \
  --data-urlencode "q=mug" \
  --data-urlencode "limit=100"

interface Page {
  data: { id: string }[];
  has_more: boolean;
  next_cursor: string | null;
}

const ids: string[] = [];
let cursor: string | null = null;
let pages = 0;

// Stop after 5 pages: every page with results is charged.
do {
  const url = new URL('https://api.alura.io/v1/research/products');
  url.searchParams.set('q', 'mug');
  url.searchParams.set('limit', '100');
  if (cursor) url.searchParams.set('cursor', cursor);

  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 Page;
  ids.push(...page.data.map((p) => p.id));
  cursor = page.next_cursor;
  pages += 1;
} while (cursor && pages < 5);

console.log(`${ids.length} products in ${pages} pages`);

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

ids = []
cursor = None
pages = 0

# Stop after 5 pages: every page with results is charged.
while True:
    params = {"q": "mug", "limit": 100}
    if cursor:
        params["cursor"] = cursor
    request = urllib.request.Request(
        f"https://api.alura.io/v1/research/products?{urllib.parse.urlencode(params)}",
        headers={"Authorization": f"Bearer {os.environ['ALURA_API_KEY']}"},
    )
    with urllib.request.urlopen(request) as response:
        page = json.load(response)
    ids.extend(p["id"] for p in page["data"])
    cursor = page["next_cursor"]
    pages += 1
    if not cursor or pages >= 5:
        break

print(f"{len(ids)} products in {pages} pages")

curl --fail-with-body -sS https://api.alura.io/v1/research/products/4524717183/similar \
  -H "Authorization: Bearer $ALURA_API_KEY"

interface Product {
  id: string;
  title: string | null;
  shop: { id: string; name: string | null };
}

const res = await fetch('https://api.alura.io/v1/research/products/4524717183/similar', {
  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 p of page.data) console.log(`${p.id} ${p.title} (${p.shop.name})`);

import json
import os
import urllib.request

request = urllib.request.Request(
    "https://api.alura.io/v1/research/products/4524717183/similar",
    headers={"Authorization": f"Bearer {os.environ['ALURA_API_KEY']}"},
)
with urllib.request.urlopen(request) as response:
    page = json.load(response)

for p in page["data"]:
    print(f"{p['id']} {p['title']} ({p['shop']['name']})")