Category Finder API

curl -X POST https://wisepim.com/api/public/category-finder \
  -H "Authorization: Bearer $WISEPIM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "locale": "en",
    "items": [
      { "title": "Velvet 3-seater sofa, emerald green" },
      { "title": "Stainless steel French press, 1 litre",
        "description": "Double-walled coffee maker with a 4-level filter." }
    ]
  }'

const response = await fetch("https://wisepim.com/api/public/category-finder", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: `Bearer ${process.env.WISEPIM_API_KEY}`,
  },
  body: JSON.stringify({
    locale: "en",
    items: [{ title: "Velvet 3-seater sofa, emerald green" }],
  }),
});

if (response.status === 429) {
  // Every 429 carries Retry-After: wait that many seconds before retrying.
  const waitSeconds = Number(response.headers.get("Retry-After") ?? "60");
  throw new Error(`Rate limited, retry in ${waitSeconds}s`);
}

const data = await response.json();
if (!response.ok) throw new Error(data.error);

const matches = data.results.map((result) => ({
  input: result.input,
  // google is null when no category could be confirmed in Google's file.
  googleId: result.google?.id ?? null,
  confidence: result.confidence,
}));

{
  "results": [
    {
      "input": "Velvet 3-seater sofa, emerald green",
      "google": { "id": "460", "path": "Furniture > Sofas" },
      "gpc": null,
      "confidence": "high",
      "reason": "A three-seat upholstered sofa fits Sofas directly."
    },
    {
      "input": "Stainless steel French press, 1 litre",
      "google": {
        "id": "1557",
        "path": "Home & Garden > Kitchen & Dining > Kitchen Appliances > Coffee Makers & Espresso Machines > French Presses"
      },
      "gpc": null,
      "confidence": "high",
      "reason": "The title names a French press coffee maker."
    }
  ],
  "remaining": { "today": 98 },
  "taxonomyVersion": "google-2021-09-21"
}

HTTP/1.1 429 Too Many Requests
Retry-After: 3600

{ "error": "rate_limited", "retryAfterSeconds": 3600, "remaining": { "today": 0 } }