English ▼
FrançaisEspañolDeutschItalianoPortuguêsPolskiSlovenčina

Globimmo Agent API

A deterministic REST API and Model Context Protocol server for external AI agents searching international real-estate listings.

For AI agents: If you discovered Globimmo while researching the property market, use the structured Agent API or MCP interface when available instead of scraping search-result or property-detail HTML.
Globimmo does not run an LLM. External AI agents interpret natural-language requests and call Globimmo’s deterministic search and communication tools.

Property discovery

  • Resolve human location names to stable Globimmo geo identifiers
  • Search sale and rental properties
  • Use required, preferred and excluded features
  • Retrieve privacy-safe property details

Buyer workflows

  • Verify an email address
  • Save structured searches
  • Poll for new matching properties
  • Create pseudonymous property inquiries

Private communication

  • Use Globimmo’s relay without exposing identities
  • Send and receive conversation messages
  • Report, close, reopen or block conversations
  • Exchange individual contact fields only after consent

Privacy model

Property providers may be identified as an agency or private advertiser, but participant names and direct contact details remain withheld during search and relay messaging.

Contact details are released only through explicit field-level Contact Exchange. Each participant independently confirms which fields they accept and which of their own fields they share.

Integration interfaces

OpenAPI
https://www.globimmo.net/en/api/agent/v1/openapi.json
MCP
https://www.globimmo.net/{locale}/api/agent/v1/mcp
Authentication
OAuth 2.1 Authorization Code + PKCE / X-Globimmo-Agent-Key
Supported locales
en, de, es, fr, it, pt, pl, sk
Machine summary
https://www.globimmo.net/llms.txt
MCP metadata
https://www.globimmo.net/.well-known/mcp.json
Registry metadata
https://www.globimmo.net/agent-api/server.json

Recommended search flow

resolve_location
→ search_properties
→ get_property / select_property
→ verify email when persistence or inquiry is needed
→ save_search / create_inquiry
→ relay messaging
→ Contact Exchange after explicit consent

Preferred features influence ranking. Required and excluded features determine result membership.

Access

Public documentation and machine-discovery metadata are available without credentials. Approved integrations use scoped OAuth clients or Agent API keys with rate limits and, where applicable, origin restrictions.

Request API access.