Nachbarschaftstexte und Gebietsbeschreibungen per API

Use Cases

• Listing-Texte: Erklärende Nachbarschaftstexte direkt in Immobilien-Exposés für bessere Conversion.
• SEO-Landingpages: Unique Stadtviertel-Beschreibungen für Neighborhood-Pages. Optimiert für SEO und AEO.
• Content-Skalierung: Hunderte Gebietsbeschreibungen per API statt manueller Texterstellung.

API-Workflow

1. Place anlegen: POST /places/{lon},{lat} — erstellt einen Place und gibt eine ID zurück.
2. Text generieren (sync): POST /places/{id}/texts/area-descriptions?wait=true — wartet auf Ergebnis (bis 180s).
3. Text generieren (async): Ohne ?wait=true — gibt 202 + Location-Header + Retry-After zurück. Polling bis 200.

Code-Beispiel

# 1. Place anlegen
PLACE_ID=$(curl -s -X POST "https://api.geosci.de/places/13.31103,52.51570" \
  --header "Authorization: Apikey $GEOSCI_API_KEY" | jq -r .id)

# 2. Gebietsbeschreibung generieren (sync, DE+EN)
curl -L -X POST "https://api.geosci.de/places/$PLACE_ID/texts/area-descriptions?wait=true" \
  --header "Authorization: Apikey $GEOSCI_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "languages": ["de", "en"],
    "parameters": {
      "name": "Berlin-Charlottenburg",
      "geo_level": "neighborhood"
    }
  }'

Request-Parameter