Platform

Casafari es la plataforma de inteligencia de datos inmobiliarios nativa para agentes de IA. El índice inmobiliario más completo de Europa: un grafo inmobiliario limpio y deduplicado de propiedades residenciales y comerciales, en venta y alquiler, en 16 países.El índice inmobiliario más completo de Europa: un grafo inmobiliario limpio y deduplicado.

Cómo se construye el grafo

Claro AI · REST API

Search commercial plots (Germany)

POSThttps://platform.casafari.com/v1/claro/plots/search
Germany, commercial plotsAPI key19 parameters

Send Authorization: Bearer $CASAFARI_API_KEY: a platform API key or OAuth access token, metered in platform tokens; see platform sign-in and Claro AI. On the platform this is POST https://platform.casafari.com/v1/claro/plots/search; POST /v1/plots/search is Claro's own path, which the platform adds /claro to. The platform forwards the call to Claro unchanged: Claro's Claro-Version header and its error bodies ({"error":{"code","message"}}, with rate_limited and quota_reached on a 429) pass through.

Over MCP: search_plots (equivalent). MCP and REST compared.

Description

Find plots of land for sale or rent in Germany for a commercial building, from Casafari's property graph. Plots only, never premises: counts and results come from a separate set, one result per plot however many agencies advertise it (the others in also_listed_by). Criteria are data: Länder (regions), municipalities, postcodes, plot type, operation, plot area, sale price and price per m², keywords in the property's own words, and commercial_use, how far the property's own text says a commercial building can go on the plot. Levels: zoned_commercial (GE, GI, MK, MU stated), zoned_mixed_or_special (MI, SO, MD stated: check the plan), commercial_use_stated (commercial use stated as allowed or suitable, no class: read the quote), building_land_use_not_stated, residential_only_stated, zoned_leisure_special (SO for recreation), not_building_land_stated, not_stated. The default is the first three; send "all" or any list to widen it. Each result gives its level with the quote it rests on and, for a stated class, zoning_source (a Flächennutzungsplan is not binding), the facts read from the text (zoning class, serviced, B-Plan, §34/§35, building permit, GRZ, GFZ), an excerpt and the agency (agency.name) with its own page as agency.listing_url, null when it has none (never a property portal's page). Keywords are read in each plot's own text: a plot matches only where a sentence states the words without denying them ("KEIN Erbbaurecht!" is no match for Erbbaurecht), and each result gives that sentence per keyword in keyword_matches (evidence, and the words as written in matched); exclude_keywords leaves out a plot that states any of its words, never one that only denies them. The level is what the property's text says, not a zoning check; coordinates are approximate.

Cuerpo de la solicitud

Tipo de contenido application/json. Obligatorio. Tipo: object.

criteriaobject
Criteria as data, every field optional (leave out or send {} for all plots): regions, municipalities, zipcodes, plot_types, operation, plot_area_min, plot_area_max, sale_price_min, sale_price_max, sale_price_m2_max, commercial_use, serviced, keywords, exclude_keywords.
14 properties
regionsstring[]
Länder by name or slug: "Bayern", "nordrhein-westfalen".
municipalitiesstring[]
Towns or cities as the property's data names them: "München", "Leipzig".
zipcodesstring[]
Postcodes or their first digits: "80331", "04".
plot_typesstring[]
building_plot (Grundstück) or rural_plot (agricultural, forest and other land).
building_plot rural_plot
operationstring
For sale, for rent, or either (default either).
sale rent either
plot_area_minnumber
m²; a plot that states no area is out.
plot_area_maxnumber
m²; largest plot area.
sale_price_minnumber
EUR total.
sale_price_maxnumber
EUR total; a plot that states no price is out.
sale_price_m2_maxnumber
EUR per m² of plot area.
commercial_usestring | string[]
Levels to keep; default zoned_commercial, zoned_mixed_or_special, commercial_use_stated.
servicedboolean
true: drop plots whose text says they are not serviced (unerschlossen); plots that do not say stay.
keywordsstring[]
Words or phrases the property's text must state, all of them, as whole words: "Gleisanschluss", "Erbbaurecht". A mention the text denies (kein, keine, nicht, ohne, nie, weder before it; nicht, nie, nein, ausgeschlossen right after) does not count; the sentence that states each is in keyword_matches.
exclude_keywordsstring[]
Leave out plots whose text states any of these. A plot that only denies one stays: exclude "Erbbaurecht" keeps a plot saying "kein Erbbaurecht".
limitinteger
Results per page.
1–50predeterminado 20
offsetinteger
Results to skip, for the next page.
≥ 0valor predeterminado 0
sortstring
commercial_use: strongest commercial-use level first; newest: latest on the market; price_asc: lowest sale price; area_desc: largest plot; price_m2_asc: lowest sale price per m².
commercial_use newest price_asc area_desc price_m2_asc
default "commercial_use"
langstring
Idioma del texto que genera la respuesta (títulos, notas, etiquetas, motivos, mensajes de error): en (predeterminado) o de (alemán). Los nombres de lugares, nombres de agencias, títulos de propiedades y citas del texto propio de un anuncio permanecen tal como están escritos.
en de
por defecto "en"

Ejemplo de solicitud

Solo marcadores de posición: reemplace el token y los valores por los suyos.

curl
curl -X POST "https://platform.casafari.com/v1/claro/plots/search" \
  -H "Authorization: Bearer $CASAFARI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "criteria": {
    "regions": [
      "<regions>"
    ]
  }
}'

Respuestas

200 Search commercial plots (Germany)

Sin cuerpo.

Ejemplo de la descripción de la API
JSON
{
  "scope": "plots",
  "country": "de",
  "count": 1,
  "returned": 1,
  "offset": 0,
  "criteria": {
    "regions": [
      "bayern"
    ],
    "plot_area_min": 2000,
    "keywords": [
      "Gleisanschluss"
    ]
  },
  "note": "Plots only, never premises.",
  "results": [
    {
      "id": "pm_Qw7rT2xLmN8bV4cZ1aYs0e",
      "title": "Gewerbegrundstück im Gewerbegebiet Nord",
      "plot_type": "building_plot",
      "country": "de",
      "region": "Bayern",
      "municipality": "Ingolstadt",
      "zipcode": "85055",
      "location_precision": "approximate",
      "coordinates": {
        "lat": 48.79,
        "lon": 11.45,
        "precision": "approximate"
      },
      "for_sale": true,
      "for_rent": false,
      "sale_eur": 1200000,
      "rent_eur_month": null,
      "plot_area_m2": 6000,
      "sale_eur_per_m2": 200,
      "commercial_use": {
        "level": "zoned_commercial",
        "meaning": "The plot's text states a commercial zoning class: GE, GI, MK or MU (Gewerbe-, Industrie-, Kerngebiet, urbanes Gebiet).",
        "evidence": "Das Grundstück liegt im Gewerbegebiet (GE)",
        "facts_read": true
      },
      "facts_from_text": {
        "zoning_class": "GE",
        "serviced": true
      },
      "excerpt": "Voll erschlossenes Gewerbegrundstück, ca. 6.000 m², direkte Anbindung an die A9.",
      "agency": {
        "name": "Muster Immobilien",
        "listing_url": "https://muster-immobilien.de/expose/1"
      },
      "agency_links": [
        {
          "name": "Muster Immobilien",
          "listing_url": "https://muster-immobilien.de/expose/1"
        }
      ],
      "keyword_matches": [
        {
          "keyword": "Gleisanschluss",
          "evidence": "Das Grundstück hat einen eigenen Gleisanschluss.",
          "matched": "Gleisanschluss"
        }
      ]
    }
  ]
}

400 Solicitud no válida

Tipo: object.

Mostrar la estructura de la respuesta (3 campos)
errorobject
2 propiedades
codestringobligatorio
messagestringobligatorio

401 Clave faltante o no válida

Tipo: object.

Mostrar la estructura de la respuesta (3 campos)
errorobject
2 propiedades
codestringobligatorio
messagestringobligatorio

403 Sin acceso

Tipo: object.

Mostrar la estructura de la respuesta (3 campos)
errorobject
2 propiedades
codestringobligatorio
messagestringobligatorio

429 Límite de peticiones alcanzado

Tipo: object.

Mostrar la estructura de la respuesta (3 campos)
errorobject
2 propiedades
codestringobligatorio
messagestringobligatorio

Consejo: añada .md a cualquier URL para leerla como Markdown.