Public API endpoints

Complete reference for every endpoint the Haszno hosted demo serves without credentials.

Summary

Every endpoint in this table is callable against https://haszno.com without an Authorization header or any other credential. For endpoints that require credentials, see Protected endpoints.

System

GET/api/health

Returns a liveness indicator. Use this to verify that the API is reachable before making other calls.

Public Read-only

Parameters

None.

Request

curl --fail-with-body https://haszno.com/api/health

Response (200)

{"ok":true}

GET/api/geo

Returns the visitor's country code and the suggested UI language. The country is derived from request headers set by the edge network (x-vercel-ip-country or cf-ipcountry). The API server never stores or logs IP addresses.

Public Read-only

Parameters

None.

Request

curl --fail-with-body https://haszno.com/api/geo

Response (200)

{"country":"HU","lang":"hu"}

Demo catalogue data

The following endpoints return synthetic sample data. The response body includes "demo": true where applicable. partnerCount is always 0 in the demo — no real suppliers are connected.

GET/api/categories

Returns the full category taxonomy used to organise products. Each entry includes counts for the demo data set.

Public Read-only

Parameters

None.

Request

curl --fail-with-body https://haszno.com/api/categories

Response (200)

Returns an array of category objects. All 14 categories are always returned; there is no filtering or pagination.

[
  {
    "key": "auto",
    "label": "Autó, gumi és motor",
    "emoji": "🛞",
    "partnerCount": 0,
    "exampleCount": 1,
    "productCount": 100
  },
  {
    "key": "kert",
    "label": "Kert és növény",
    "emoji": "🌿",
    "partnerCount": 0,
    "exampleCount": 1,
    "productCount": 100
  }
]

Notes

• partnerCount: 0 is expected on the demo — no real suppliers are connected.
• Use the key value as the cats parameter when filtering products or stats.

GET/api/products

Returns the product catalogue with gross prices, net costs, market price comparisons, and pricing recommendations. This is the primary read endpoint for integration work.

Public Read-only

Parameters

Request

curl --fail-with-body \
  'https://haszno.com/api/products?cats=kert&shippingMarkets=HU,SK'

Response (200)

Returns an array. Each item represents one product.

recommended sub-fields

recommended.status enum

Market offer object (each slot in marketByCountry and each item in markets)

The demo returns this full object in both places. On a real instance, marketByCountry slots have no market or isCheapest field, and markets items have no fetchedAt.

{
  "id": 101,
  "category": "kert",
  "supplierId": 2,
  "sku": "DEMO-101",
  "name": "Kerti napernyő · 1. változat",
  "supplierName": "Példa-partner · Kert és növény",
  "costNet": 1121,
  "priceGross": 2190,
  "rrpGross": 2190,
  "marketMinGross": 2124,
  "marketShop": "Példa-bolt · HU",
  "stock": 0,
  "listed": true,
  "current": {"marginNet": 603, "marginPct": 35},
  "recommended": {
    "priceGross": 2090,
    "floorGross": 1590,
    "status": "versenykepes",
    "marginNet": 525,
    "marginPct": 31.9
  },
  "marketByCountry": {
    "hu": {
      "market": "hu",
      "country": "HU",
      "minGross": 2124,
      "shop": "Példa-bolt · HU",
      "url": null,
      "source": "mock",
      "fetchedAt": "2026-11-10T00:00:00.000Z",
      "isCheapest": true
    },
    "sk": {
      "market": "sk",
      "country": "SK",
      "minGross": 2650,
      "shop": "Példa-bolt · SK",
      "url": null,
      "source": "mock",
      "fetchedAt": "2026-11-10T00:00:00.000Z",
      "isCheapest": false
    },
    "eu": null
  },
  "bestMarket": null,
  "markets": [
    {"market":"hu","country":"HU","minGross":2124,"shop":"Példa-bolt · HU",
     "url":null,"source":"mock","fetchedAt":"2026-11-10T00:00:00.000Z","isCheapest":true},
    {"market":"sk","country":"SK","minGross":2650,"shop":"Példa-bolt · SK",
     "url":null,"source":"mock","fetchedAt":"2026-11-10T00:00:00.000Z","isCheapest":false}
  ]
}

Notes

• null on a price field means unknown or unavailable, not zero.
• source: "mock" on market prices means the price is not a verified live market result.
• On the public demo, current.marginPct is a fixed placeholder (35) that does not follow from the prices, while current.marginNet is computed as round(priceGross / 1.27 − costNet), always at 27 % VAT. Only recommended reflects the undercutPct, minMarginPct and vatPct parameters.
• Returns all matching products in a single array. There is no pagination on this endpoint.

GET/api/products/supplier-counts

Returns the number of products per supplier. Useful for displaying a supplier breakdown without loading the full catalogue.

Public Read-only

Parameters

On the demo, the same filtering parameters as GET /api/products: cats, supplier. A real instance ignores them and counts the listed products of every supplier.

Request

curl --fail-with-body 'https://haszno.com/api/products/supplier-counts?cats=kert'

Response (200)

Returns an array. Only suppliers with at least one matching product are included.

[
  {"id": 2, "name": "Példa-partner · Kert és növény", "count": 100}
]

GET/api/suppliers

Returns the list of suppliers configured in the shop. On the demo, returns synthetic example suppliers.

Public Read-only

Parameters

None.

Request

curl --fail-with-body https://haszno.com/api/suppliers

Response (200)

Returns an array of supplier objects.

[
  {
    "id": 1,
    "name": "Példa-partner · Autó, gumi és motor",
    "category": "auto",
    "visibility": "private",
    "network": false,
    "orderMode": "email",
    "email": null
  }
]

GET/api/stats

Returns dashboard summary numbers. These are computed across all products matching the optional filters.

Public Read-only

Parameters

Request

curl --fail-with-body https://haszno.com/api/stats

Response (200)

{"products":1400,"losing":0,"overMarket":1400,"toFix":1400,"orders":0}

Notes

• orders: 0 is expected on the demo — no real orders exist.
• overMarket: 1400 on the demo reflects that all 1 400 synthetic products are above their (synthetic) market minimum.

GET/api/settings

Returns the current pricing rule configuration for the shop.

Public Read-only

Parameters

None.

Request

curl --fail-with-body https://haszno.com/api/settings

Response (200)

{
  "undercutPct": 1,
  "minMarginPct": 10,
  "vatPct": 27,
  "shippingMarkets": ["HU"],
  "automationPaused": true,
  "demo": true
}

GET/api/impact

Returns the extra profit attributed to Haszno's repricing and new-listing engine over a configurable time window.

Public Read-only

Parameters

Request

curl --fail-with-body 'https://haszno.com/api/impact?days=30'

Response (200)

items sub-fields

{
  "days": 30,
  "from": "2026-10-13T14:08:40.424Z",
  "to": "2026-11-12T14:08:40.424Z",
  "orders": 80,
  "revenueGross": 383700,
  "profitNet": 92996,
  "arfutarImpact": 110647,
  "fromRepricing": 66658,
  "fromNewProducts": 43989,
  "lossProductsFixed": 2,
  "autoForwardedOrders": 64,
  "minutesPerOrder": 6,
  "items": [
    {
      "productId": 3,
      "name": "Ablaktörlő · 1. változat",
      "kind": "felvetel",
      "oldPriceGross": null,
      "newPriceGross": 3990,
      "unitsBeforePerDay": 0,
      "unitsAfter": 40,
      "actualProfit": 43989,
      "expectedProfit": 0,
      "impact": 43989,
      "insufficientHistory": false
    }
  ],
  "demo": true
}

GET/api/orders

Returns the last 50 orders, most recent first. The public demo returns an empty array.

Public Read-only

Parameters

None on the demo. A real instance accepts cats (comma-separated category keys) to return only orders with at least one item from those categories.

Request

curl --fail-with-body https://haszno.com/api/orders

Response (200)

Returns an array of order objects (empty on the demo), newest first. Each real order contains: id, externalId, customerName, customerEmail, address, status, supplierOrderId, trackingNumber, totalGross (HUF), events (array of {at, text}), createdAt, forwardingStartedAt, shopId, and items (array of {orderId, qty, priceGross, name, sku}).

[]

GET/api/proposals

Returns price proposals generated by the pricing engine. The public demo returns an empty array.

Public Read-only

Parameters

None on the demo. A real instance accepts status (default pending), limit (default 50, max 200) and cats.

Request

curl --fail-with-body https://haszno.com/api/proposals

Response (200)

Returns an array of proposal objects (empty on the demo). Each item: id, productId, productName, productSku, productImage, supplierName, oldPriceGross, proposedPriceGross, reason, source, status ("pending", "approved", "rejected", "rolled_back", "stale"), batchId, createdAt, decidedAt.

[]

GET/api/peers/invites

Returns the shop's outbound peer invite codes. The public demo returns an empty array.

Public Read-only

Parameters

None.

Request

curl --fail-with-body https://haszno.com/api/peers/invites

Response (200)

Returns an array of invite objects (empty on the demo). Each item: id, code, createdBy, supplierId, supplierName, expiresAt, acceptedBy, acceptedAt, revokedAt, createdAt.

[]

GET/api/peers/links

Returns established peer links between shops. The public demo returns an empty array.

Public Read-only

Parameters

None.

Request

curl --fail-with-body https://haszno.com/api/peers/links

Response (200)

Returns an array of link objects (empty on the demo). Each item: id, supplierId, partner, createdAt, supplierName, supplierCategory.

[]

GET/api/import-list

Returns the import list — products staged from the partner catalogue before they are pushed to a connected webshop.

Public Read-only

Parameters

Request

curl --fail-with-body 'https://haszno.com/api/import-list?status=varakozik'

Response (200)

Returns an array of import list items.

networkProduct sub-fields

[
  {
    "id": 1,
    "addedAt": "2026-11-10T08:00:00.000Z",
    "status": "varakozik",
    "note": null,
    "pushedProductId": null,
    "networkProduct": {
      "id": 1,
      "name": "Autós telefontartó · 1. változat",
      "imageUrl": null,
      "sku": "DEMO-1",
      "wholesaleNet": 1019,
      "rrpGross": 1990,
      "stock": 0,
      "category": "Autó, gumi és motor",
      "supplierName": "Példa-partner · Autó, gumi és motor",
      "example": true,
      "marginNet": 548,
      "marginPct": 35
    }
  }
]

Blog and market insights

The blog endpoints return real data — published market insight posts generated from aggregated (anonymised, ≥ 5 shops) trend data. No "demo": true flag is present in these responses.

GET/api/blog

Returns all published market insight posts, most recent first.

Public Read-only

Parameters

Request

curl --fail-with-body https://haszno.com/api/blog

Response (200)

Post item fields

{
  "posts": [
    {
      "id": 2,
      "slug": "2026-het45-toplista",
      "period": "het",
      "periodStart": "2026-11-02",
      "periodEnd": "2026-11-08",
      "title": "2026/45. hét — Legjobban fogyó termékek",
      "summary": "A 45. héten párásítók és LED-es világítástechnikai termékek forgalma emelkedett...",
      "publishedAt": "2026-11-09T08:00:00.000Z",
      "coverImageUrl": null
    }
  ],
  "total": 3,
  "page": 1,
  "perPage": 10
}

GET/api/blog/:slug

Returns a single published post by its slug.

Public Read-only

Path parameters

Request

curl --fail-with-body https://haszno.com/api/blog/2026-het45-toplista

Response (200)

Returns a single post object. It has no coverImageUrl, unlike the list items.

Append .md to the slug (/api/blog/2026-het45-toplista.md) to get only bodyMd, as text/markdown; charset=utf-8.

Error responses

GET/api/blog/rss.xml

Returns an RSS 2.0 feed of published posts. The response content type is application/rss+xml; charset=utf-8.

Public Read-only

Request

curl --fail-with-body https://haszno.com/api/blog/rss.xml

GET/api/blog/feed.json

Returns a JSON Feed (version 1.1) of published posts. The response content type is application/feed+json; charset=utf-8.

Public Read-only

Request

curl --fail-with-body https://haszno.com/api/blog/feed.json

Utility endpoints

GET/llms.txt

Returns the LLM-readable site summary following the llms.txt convention. Content type: text/plain.

Public Read-only

Request

curl --fail-with-body https://haszno.com/llms.txt