Tu Lugar API

Quick Start

No API key needed. Try it right now:

# Search apartments for sale in Asunción
curl "https://tulugar.com/api/v1/listings?city=Asunci%C3%B3n&listing_type=sale&property_type=apartment&limit=3"

# Get market summary
curl "https://tulugar.com/api/v1/market/summary?city=Asunci%C3%B3n"

# List all countries
curl "https://tulugar.com/api/v1/locations/countries"

Common Workflows

Chain API calls to accomplish typical tasks. This example finds apartments for sale in a specific neighborhood.

curl "https://tulugar.com/api/v1/locations/countries"
# Response: [{ "name": "Paraguay", "listing_count": 2500 }, ...]

curl "https://tulugar.com/api/v1/locations/cities?country=Paraguay"
# Response: [{ "name": "Asunción", "listing_count": 1200 }, ...]

curl "https://tulugar.com/api/v1/locations/neighborhoods?city=Asunci%C3%B3n"
# Response: [{ "name": "Villa Morra", "listing_count": 245 }, ...]

curl "https://tulugar.com/api/v1/listings?city=Asunci%C3%B3n&neighborhood=Villa+Morra&listing_type=sale&property_type=apartment&limit=10"

Response Format

{
  "data": [ ... ],
  "pagination": {
    "total": 150,
    "limit": 20,
    "offset": 0
  },
  "meta": {
    "request_id": "req_abc123",
    "timestamp": "2026-04-10T..."
  }
}

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "city is required",
    "status": 400
  },
  "meta": {
    "request_id": "req_abc123"
  }
}

Authentication

Read endpoints are public — no key required. The Agent API (write) endpoints require an OAuth 2.1 access token (authorization code + PKCE). The simplest way to get one is to add the Tu Lugar connector in Claude or another MCP client — it runs the entire flow for you. Direct integrations use the standard flow described below. Send the token as a bearer header:

Authorization: Bearer YOUR_ACCESS_TOKEN

Scopes

Authorization flow (direct integrations)

1. Fetch discovery metadata from the .well-known endpoints below.
2. Register a client via Dynamic Client Registration (RFC 7591) at POST /api/oauth/register.
3. Send the user to /api/oauth/authorize with a PKCE S256 challenge; they sign in and consent.
4. Exchange the returned code at POST /api/oauth/token for an access + refresh token.
5. Call the API with Authorization: Bearer. Refresh tokens rotate on use.

Discovery endpoints

Listings

Search, filter, and retrieve real estate listings.

Projects

Development projects (residential towers, gated communities, etc.). By default, only projects with available units are returned, sorted by verified first.

Companies

Real estate agencies and developers.

Agents

Real estate agents and professionals.

Locations

Countries, cities, and neighborhoods with listing counts.

Market Data

Aggregated market statistics and short-term rental data.

Calculators

Real-estate finance calculators — currency-agnostic and Paraguay-aware. Built for AI tool use; no auth required.

Agent API (write)

Authenticated endpoints for agents to create and manage their own listings. All write endpoints require an OAuth 2.1 bearer token with the scope shown on each row (see Authentication). Listing writes go through automated moderation before going public.

Limits & fair use