Skip to content
HALOWERK

Signalwerk

catalog sample

Sources in this order: supplied feed (Google Merchant RSS/Atom, CSV/TSV, Shopify products.json, WooCommerce Store API) or HTML with schema.org Product/ItemList; with a domain the start page, then the public Shopify /products.json or WooCommerce Store API (only when the page shows the platform), a linked product feed, JSON-LD on the start page, and finally the sitemap from robots.txt with up to the remaining fetches for product pages (at most 5 fetches per domain, robots.txt respected)..

POST https://signal.halowerk.com/v1/catalog-sample

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
urlstringNoCompany domain or page URL (https:// added when missing). Public pages only; robots.txt is respected; at most 5 fetches per domain.
htmlstringNoAlready loaded HTML of the page. Nothing is fetched in this mode. The whole request is limited to 2 MB.
base_urlstringNoURL the HTML was loaded from (required with html).
extra_pagesarrayNoOffline mode only: further pages of the same site as { url, html }.
feedstringNoFeed content (Google Merchant RSS/Atom XML, CSV/TSV with header, Shopify products.json or WooCommerce Store API JSON). Nothing is fetched in this mode.
feed_urlstringNoURL the feed was loaded from (optional with feed; used to build product links for products.json).
sample_sizeintegerNoNumber of products to return (1-20).
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "url": {
      "type": "string",
      "minLength": 3,
      "maxLength": 2048,
      "description": "Company domain or page URL (https:// added when missing). Public pages only; robots.txt is respected; at most 5 fetches per domain."
    },
    "html": {
      "type": "string",
      "minLength": 20,
      "maxLength": 1900000,
      "description": "Already loaded HTML of the page. Nothing is fetched in this mode. The whole request is limited to 2 MB."
    },
    "base_url": {
      "type": "string",
      "format": "uri",
      "maxLength": 2048,
      "description": "URL the HTML was loaded from (required with html)."
    },
    "extra_pages": {
      "type": "array",
      "maxItems": 4,
      "description": "Offline mode only: further pages of the same site as { url, html }.",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "url",
          "html"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "maxLength": 2048
          },
          "html": {
            "type": "string",
            "minLength": 20,
            "maxLength": 1900000
          }
        }
      }
    },
    "feed": {
      "type": "string",
      "minLength": 10,
      "maxLength": 1900000,
      "description": "Feed content (Google Merchant RSS/Atom XML, CSV/TSV with header, Shopify products.json or WooCommerce Store API JSON). Nothing is fetched in this mode."
    },
    "feed_url": {
      "type": "string",
      "format": "uri",
      "maxLength": 2048,
      "description": "URL the feed was loaded from (optional with feed; used to build product links for products.json)."
    },
    "sample_size": {
      "type": "integer",
      "minimum": 1,
      "maximum": 20,
      "default": 20,
      "description": "Number of products to return (1-20)."
    }
  }
}

Open original schema

Published input example

{
  "feed": "id,title,link,price,availability\n1,Tee,https://halowerk.com/ EUR,in stock\n2,Kaffee,https://halowerk.com/ EUR,out of stock\n"
}

Result & documentation

Machine-readable documentation of this hub

Source of this page: the published HALOWERK catalog. Updated: 2026-11-17 UTC.

More endpoints in this hub

All endpoints in this hub โ†’