Connect an AI agent

The connector lets an AI agent search the new-construction projects listed on relmo.co, read a project's details, and request a callback or site visit on a buyer's behalf.

In this guide, "you" are the engineer connecting the agent. "The buyer" is the person the agent is helping. "The developer" is the real estate developer selling the project.

• Base URL: https://api.relmo.co
• Version: v1
• Format: JSON
• Support: support@relmo.co

There are two ways to connect. Both return the same data.

AuthenticationCopy Anchor Link

Every request sends a connector key as a bearer token:

Authorization: Bearer <connector key>

A missing or wrong key returns 401 {"error": "Unauthorized"}. To get a key, email support@relmo.co. Keep it secret and use it only from your server.

Rate limitsCopy Anchor Link

Each IP address can make 300 requests a minute. Past that, the API returns 429 {"error": "Too many requests"}. The limit is there to stop runaway loops. It is not a quota per buyer.

Data freshnessCopy Anchor Link

The API returns the last-published version of each project, not live inventory.

• salesStatus and constructionStatus say whether units are on sale and how far construction has got.
• A null price means price on request.
• Tell the buyer to confirm price and availability with the developer before paying anything.

ImagesCopy Anchor Link

Show only the image URLs the API returns: heroImageUrl on search results and the media gallery in a project's details. These are verified images of that exact project. Don't fetch images from anywhere else, and don't generate them. Web and stock images are often the wrong building or another developer's render. If heroImageUrl is null, show no image.

Recommended flowCopy Anchor Link

1. Resolve names. Call suggest to turn a place or developer name into a slug. Each locality has an ancestorPath, so search at the level the buyer meant: a parent slug covers its sub-areas. Pick the single best match rather than combining every similar name. "Bandra" must not pull in "Bandra Kurla Complex", a separate business district. Combine localities only when they share no ancestor and the buyer really wants both. For a landmark or "near X", geocode it yourself and pass lat, lng and radius_km.
2. Understand the market. For a broad question, call market_stats for counts, price range, BHK mix and amenities before listing projects.
3. Search. Call search_listings (12 results a page).
4. Get details. Call get_listing for one project.
5. Send an enquiry. Call create_enquiry to request a callback or book a site visit.

The REST API has an endpoint for each of these tools.

Before going liveCopy Anchor Link

• Your connector key is stored on your server, never in client code.
• Your agent calls suggest before filtering by a place or developer name.
• Your agent shows only images the API returns.
• Each enquiry sets platform to your agent's name and sends a new submission_id.
• You have emailed support@relmo.co before sending a test enquiry. Every enquiry creates a real lead for the developer.