Fynvo Firmenverzeichnis

Sucht deutsche Unternehmen nach Leistung, Zertifikat, Region oder Freitext. Beantwortet Fragen wie "Wer fräst CNC-Teile aus Edelstahl im Raum Stuttgart und ist nach ISO 9001 zertifiziert?". Die Werte für leistung und zertifikat stammen aus einem festen Vokabular; ist der passende Slug unbekannt, zuerst ohne diese Filter mit q suchen und die Slugs aus den Treffern übernehmen. Ein Oberbegriff bei leistung trifft auch alle Leistungen darunter. Searches German companies by service, certificate, region or free text. Values for leistung and zertifikat come from a fixed vocabulary; if the matching slug is unknown, search with q first and take the slugs from the results. A parent term in leistung also matches all services below it.

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "Freitext über Firmenname und Kurzbeschreibung. Free text over company name and short description."
    },
    "leistung": {
      "type": "string",
      "description": "Slug einer Leistung oder eines Oberbegriffs, etwa \"cnc-fraesen\" oder \"metallbearbeitung\". Slug of a service or parent term."
    },
    "zertifikat": {
      "type": "string",
      "description": "Slug eines Zertifikats, etwa \"iso-9001\" oder \"iatf-16949\". Slug of a certificate."
    },
    "plz": {
      "type": "string",
      "description": "Fünf Ziffern für eine genaue Postleitzahl, zwei bis vier Ziffern für eine Region. Five digits for an exact postcode, two to four for a region.",
      "pattern": "^[0-9]{2,5}$"
    },
    "umkreis_km": {
      "type": "integer",
      "minimum": 1,
      "maximum": 999,
      "description": "Umkreis um plz in Kilometern. Braucht plz. Radius around plz in kilometres, requires plz."
    },
    "bundesland": {
      "type": "string",
      "description": "Eines der sechzehn Bundesländer in amtlicher Schreibweise, etwa \"Baden-Württemberg\". One of the sixteen German federal states."
    },
    "seite": {
      "type": "integer",
      "minimum": 1,
      "description": "Seitenzahl ab 1. Page number starting at 1."
    },
    "pro_seite": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "description": "Treffer je Seite, Standard 20. Results per page, default 20."
    }
  },
  "additionalProperties": false
}

Liefert das vollständige Profil eines Unternehmens: Adresse, Leistungen, Zertifikate, Registereintrag, Kontakt und zu jedem Feld die Herkunft der Angabe. Pflicht ist der Slug aus einem Suchtreffer, nicht der Firmenname. Required is the slug from a search result, not the company name. Returns the full profile of a company including address, services, certificates, register entry, contact and the provenance of every field.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "Der Slug aus einem Suchtreffer. The slug from a search result."
    }
  },
  "required": [
    "slug"
  ],
  "additionalProperties": false
}

Schickt eine Anfrage an ein Unternehmen, im Auftrag des Nutzers. Nur benutzen, wenn der Nutzer das ausdrücklich will: die Anfrage geht an ein echtes Unternehmen. Die E-Mail-Adresse muss vom Nutzer kommen, nicht erfunden sein. Pflicht ist der Slug aus einem Suchtreffer, nicht der Firmenname. Required is the slug from a search result, not the company name. Sends an enquiry to a company on behalf of the user. Only use when the user explicitly asks for it: the enquiry reaches a real company. The email address must come from the user, never be invented.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "Der Slug der Firma. The slug of the company."
    },
    "email": {
      "type": "string",
      "format": "email",
      "description": "Antwortadresse des Nutzers. The user's reply address."
    },
    "nachricht": {
      "type": "string",
      "description": "Die Anfrage, 20 bis 5000 Zeichen. The enquiry, 20 to 5000 characters."
    },
    "name": {
      "type": "string",
      "description": "Name des Absenders, freiwillig. Sender name, optional."
    },
    "firma": {
      "type": "string",
      "description": "Unternehmen des Absenders, freiwillig. Sender company, optional."
    }
  },
  "required": [
    "slug",
    "email",
    "nachricht"
  ],
  "additionalProperties": false
}