Schemas

Search terms (1–10). Each item must be a non-empty string after trim. The server trims whitespace before searching.

Maximum products to return per term. Defaults to 1 when omitted. Note: limit is not part of the cache key; a higher later limit only returns what that cached batch stored.

One result object per input term, in the same order

The original (trimmed) search term from the request

Where the products came from for this term. Either the literal cache, or an identifier for the upstream provider that served the request.

null means every configured provider failed or none are configured; see error for details.

Matched products (may be empty on failure)

Present only when source is cache. Identifier of the upstream provider that originally fetched and stored this batch.

ISO-8601 timestamp when this batch was fetched (or when the cached batch was originally stored). Absent when source is null.

Human-readable failure reason for this term. Present when source is null. This is not an HTTP-level error — the overall response status remains 200.

Image URLs (may be empty)

Product title

Numeric price when available

ISO currency code

Product description or joined feature bullets

Shop now product URL

Human-readable error message

Always true when the process is serving requests

Whether a simple SQLite read succeeds

Whether the primary provider env vars are present (not validated live)

Whether the fallback provider env vars are present (not validated live)

Effective cache TTL in hours (CACHE_TTL_HOURS, default 24)