Melo provides a comprehensive API for accessing real-time, deduplicated real estate listings and market analytics across France.
Melo provides a comprehensive API for accessing real-time, deduplicated real estate listings and market analytics across France. On Nagent, Melo is exposed as a fully-configurable analytics integration that any agent can call — 3 actions, and API key authentication. No code is required to wire Melo into your workflow — connect it once via the External Integrations panel and reuse it across every agent you build.
Agent builders use Melo to automate the kinds of tasks analytics teams previously handled manually. Concrete examples — each one is a single agent step in Nagent — include:
Every action and trigger is paired with a structured input/output schema (visible in the sections below), so when you wire Melo into Helix — our agentic agent builder — the editor knows exactly what each step expects and produces. Configure once, deploy anywhere across your Nagent agents.
Every operation an agent can call against Melo, with input parameters and output schema. Drop these into any step of an agent built in Helix.
MELO_GET_CITIESTool to retrieve a list of cities with optional filters. Use when you need to fetch available cities before processing location-specific data.
Input parameters
Page number for paginated results (must be ≥ 1).
Search keyword to filter cities.
Number of results per page (1–100).
Filter by ISO 2-letter country code (e.g., 'FR').
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MELO_LIST_SEARCHESRetrieves all property searches saved by the authenticated user from the Melo API. Use this tool to: - View all saved property searches with their filtering criteria - Check notification settings for each search - Paginate through large lists of searches - Filter searches by title or notification status - Sort searches alphabetically by title Returns search details including location filters, budget ranges, property types, and notification configurations. The API uses Hydra collection format for pagination.
Input parameters
Page number for pagination (must be >= 1, defaults to 1)
Filter searches by title (case-sensitive string match)
Sort searches by title ('asc' for ascending, 'desc' for descending)
Filter searches by notification status (true for enabled, false for disabled)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MELO_SIMULATE_WEBHOOKSimulates sending a Melo webhook event to a specified endpoint for testing webhook integrations. This tool triggers the Melo API to send a sample webhook payload (either a property match or event notification) to your specified HTTPS endpoint. Useful for testing webhook handlers before going live. The API will send realistic property data including advert details, contact information, and geographic data to your endpoint. Use this when you need to test how your webhook endpoint handles Melo notifications.
Input parameters
The target HTTPS URL where the simulated webhook event will be sent. Must use HTTPS protocol.
The type of webhook event to simulate. Valid options: 'ad.update.price' (price changes), 'ad.update.surface' (surface area changes), 'ad.update.pictures' (picture updates), 'ad.update.expired' (advert expiration), 'property.ad.create' (new property advert), 'property.ad.update' (property advert updates).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
No publicly available marketplace agent is found using this tool yet. There are 89 agents privately built on Nagent that already use Melo.
Build on Nagent
Connect Melo to any Nagent agent in minutes — no API key management, no boilerplate. Just configure and deploy.
The five questions agent builders ask before adopting a new integration.
Open the External Integrations panel inside Nagent (app.nagent.ai/externalIntegration), find Melo, and click "Connect Now." You'll authenticate with an API key — Nagent handles credential storage and refresh automatically. Once connected, Melo is available to any agent in your workspace.
No. Nagent provides no-code integration for every tool. Once Melo is connected, you configure its 3 actions directly in the agent builder UI — no API calls, no boilerplate, no schema management.
Helix — Nagent's agentic agent builder — lets you drop Melo steps into any workflow visually. Pick an action (e.g., one of those listed above), fill in the inputs (Helix knows the required vs. optional schema for each parameter), and connect it to upstream/downstream steps. Triggers run as the entry point of an agent, so when a Melo event fires, the agent kicks off automatically.
Every Melo action and trigger ships with a fully-typed schema — input parameters with name, type, required flag, and description, plus the output payload shape. The schemas are documented in the sections above. Helix uses these schemas to validate your configuration at build time and to type-check the data flowing between steps.
Yes. While Melo ships with 3 pre-built analytics actions, you can layer custom logic around them inside Helix — pre/post-processing steps, conditional branches, retries, or stitching Melo together with other connected tools. For deeper customization, talk to our team about Nagent's Agentic AI Lab — forward-deployed engineers who build Melo-based workflows tailored to your business.