Skip to content
HALOWERK

Signalwerk

competitor density

Selects OpenStreetMap businesses of a category preset (bakery, pharmacy, hairdresser ) or a single OSM tag within a radius of 100–5000 m around coordinates, a postcode centroid or a geocoded address, from the dated Germany extract (Geofabrik, ODbL) or from elements you pass. Computes count, density per km² of the search circle, nearest and median distance, counts in distance rings, the share of chain branches (brand tag) and the most frequent brands. Your own business can be excluded by OSM id.

POST https://signal.halowerk.com/v1/competitor-density

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
latnumberNoLatitude (WGS84) in Germany.
lonnumberNoLongitude (WGS84) in Germany.
addressstringNoPostal address in Germany, geocoded with Nominatim (1 request/s policy, cached).
plzstringNoGerman postcode; its area centroid is used (OSM postcode polygons, daten/H02).
categorystringNoBusiness category preset (mapped to OSM tags).
osm_tagstringNoAlternative: one OSM tag such as shop=bakery.
radius_mintegerNo
exclude_osmstringNoOwn business to exclude, e.g. node/123.
osm_elementsarrayNoOptional: OSM elements in Overpass JSON format (type, id, lat/lon or center, tags) to analyse instead of the built-in extract.
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "lat": {
      "type": "number",
      "minimum": 47,
      "maximum": 55.2,
      "description": "Latitude (WGS84) in Germany."
    },
    "lon": {
      "type": "number",
      "minimum": 5.5,
      "maximum": 15.5,
      "description": "Longitude (WGS84) in Germany."
    },
    "address": {
      "type": "string",
      "minLength": 5,
      "maxLength": 200,
      "description": "Postal address in Germany, geocoded with Nominatim (1 request/s policy, cached)."
    },
    "plz": {
      "type": "string",
      "pattern": "^\\d{5}$",
      "description": "German postcode; its area centroid is used (OSM postcode polygons, daten/H02)."
    },
    "category": {
      "type": "string",
      "enum": [
        "bakery",
        "butcher",
        "supermarket",
        "convenience",
        "pharmacy",
        "hairdresser",
        "beauty",
        "florist",
        "optician",
        "hearing_aids",
        "bicycle_shop",
        "car_repair",
        "car_dealer",
        "fuel",
        "restaurant",
        "cafe",
        "fast_food",
        "bar",
        "ice_cream",
        "doctor",
        "dentist",
        "physiotherapist",
        "veterinary",
        "bank",
        "post_office",
        "hotel",
        "fitness",
        "driving_school",
        "electrician",
        "plumber",
        "carpenter",
        "painter",
        "roofer",
        "tailor",
        "laundry",
        "funeral",
        "insurance",
        "estate_agent",
        "tax_advisor",
        "lawyer",
        "shoes",
        "clothes",
        "electronics",
        "hardware",
        "chemist",
        "beverages",
        "books",
        "toys",
        "furniture",
        "pet",
        "jewelry",
        "travel_agency"
      ],
      "description": "Business category preset (mapped to OSM tags)."
    },
    "osm_tag": {
      "type": "string",
      "pattern": "^(shop|craft|amenity|healthcare|office|tourism|leisure)=[a-z0-9_;:-]{1,40}$",
      "description": "Alternative: one OSM tag such as shop=bakery."
    },
    "radius_m": {
      "type": "integer",
      "minimum": 100,
      "maximum": 5000,
      "default": 1000
    },
    "exclude_osm": {
      "type": "string",
      "pattern": "^(node|way)/\\d{1,12}$",
      "description": "Own business to exclude, e.g. node/123."
    },
    "osm_elements": {
      "type": "array",
      "maxItems": 3000,
      "description": "Optional: OSM elements in Overpass JSON format (type, id, lat/lon or center, tags) to analyse instead of the built-in extract.",
      "items": {
        "type": "object",
        "required": [
          "type",
          "id",
          "tags"
        ],
        "properties": {
          "type": {
            "enum": [
              "node",
              "way",
              "relation"
            ]
          },
          "id": {
            "type": "integer"
          },
          "lat": {
            "type": "number"
          },
          "lon": {
            "type": "number"
          },
          "center": {
            "type": "object",
            "properties": {
              "lat": {
                "type": "number"
              },
              "lon": {
                "type": "number"
              }
            }
          },
          "tags": {
            "type": "object"
          }
        }
      }
    }
  }
}

Open original schema

Published input example

{
  "lat": 52.2105,
  "lon": 7.0236,
  "category": "bakery",
  "radius_m": 1000
}

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 →