Skip to content
HALOWERK

Signalwerk

product feed detect

With a domain the start page is read for feed candidates: <link rel=alternate> feeds with product hints, links to .xml/.csv/.tsv/.txt/.json files named like feed, export, shopping, merchant, idealo or produkt, and the public Shopify or WooCommerce product endpoints when the page shows the platform; up to 3 candidates are fetched (at most 5 fetches per domain, robots.txt respected, 6 MB per file, gzip supported). Supplied HTML lists candidates without fetching; a supplied feed is analysed.

POST https://signal.halowerk.com/v1/product-feed-detect

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).
as_ofstringNoReference date for age_days (YYYY-MM-DD, default today UTC).
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)."
    },
    "as_of": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Reference date for age_days (YYYY-MM-DD, default today UTC)."
    }
  }
}

Open original schema

Published input example

{
  "feed": "id,title,description,link,image_link,availability,price\n1,Tee,Gruener Tee,https://halowerk.com/ stock,4.50 EUR\n",
  "as_of": "2026-11-13"
}

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 โ†’