Développer avec Matchai

Les professionnels de l'immobilier publient sur Matchai leurs inscriptions, leur site Web (un site Matchai) et un profil d'une page (une Page Matchai). Tout ce qu'ils publient peut être lu par un logiciel, et cette partie fonctionne dès aujourd'hui, sans compte, sans clé d'API et sans approbation.

L'étape suivante consiste à laisser un logiciel travailler dans le compte d'un professionnel, avec sa permission : tenir ses inscriptions à jour, ajouter ses prospects, réserver ses visites. Cette partie est prévue. Cette section documente les deux, et indique ce qui n'est pas encore offert.

Ce qui est offert aujourd'huiCopier le lien de cette section

Le fichier OpenAPI à /openapi.json décrit ces points de terminaison publics en lecture seule, et rien d'autre. L'API prévue a son propre contrat, décrit plus bas.

EssayerCopier le lien de cette section

Cette requête cherche parmi toutes les inscriptions publiées sur Matchai et renvoie jusqu'à 10 résultats en JSON :

curl "https://matchai.co/ask?query=3+bedroom+condo+in+Laval+under+600k"

La page Recherche d'inscriptions explique la requête, la réponse et les limites.

Règles de base des interfaces publiquesCopier le lien de cette section

• Public et en lecture seule. Rien ici ne modifie de données, et rien n'est lié à un compte d'utilisateur.
• Données publiées seulement. Les inscriptions, les sites et les pages qu'un professionnel n'a pas publiés ne sont jamais renvoyés. Les numéros de téléphone et les adresses courriel n'apparaissent que là où le professionnel a choisi de les publier sur sa carte professionnelle.
• Limites d'utilisation équitable. Chaque point de terminaison public limite le nombre de requêtes qu'un même appelant peut faire par minute. Les limites sont réunies sur une seule page.
• Les résultats ne sont pas à vendre. Les résultats sont classés selon leur pertinence pour la requête et selon la date de la dernière mise à jour de l'inscription. Aucun courtier ne peut payer pour changer l'ordre ou pour y figurer.
• Renvoyez à la source. Quand vous affichez une inscription, faites un lien vers sa page d'inscription. Cette page est la source du prix, du statut et des détails à jour.

Ce qui est prévuCopier le lien de cette section

L'API Matchai permet à une application d'agir pour un seul compte Matchai : lire et modifier ses inscriptions, gérer ses contacts, envoyer des messages, réserver des visites, classer des documents et être avisée des changements. Elle peut faire ce que le titulaire du compte peut faire dans Matchai, selon les mêmes règles et les mêmes permissions, et rien de plus. Rien de tout cela n'est encore ouvert. Les pages ci-dessous décrivent comment elle fonctionnera, pour que vous puissiez planifier.

Quatre règles encadrent le tout :

• Un identifiant de connexion, un compte. Une clé ou un jeton n'atteint jamais les données d'un autre compte. Une application qui sert trois professionnels détient trois connexions.
• Les actions finales demandent d'abord. L'envoi, la publication, le paiement et la suppression attendent l'approbation du titulaire du compte, à moins qu'il ait choisi Autorisé pour votre application.
• Les lectures publiques restent gratuites. Lire ce qu'un professionnel a déjà publié ne demande aucune connexion. Connecter une application à un compte est un connecteur Matchai payant, et une application connectée seulement au compte de son propre développeur est en mode test gratuit.
• L'énergie est un état, jamais un nombre. Les actions qui utilisent l'IA ou qui envoient des messages texte dépensent de l'Énergie Matchai, comme dans l'application.

Commencez par le démarrage rapide, puis lisez la page Authentification.

À qui s'adresse cette sectionCopier le lien de cette section

• Les développeurs qui travaillent avec des assistants IA. Connectez le serveur MCP à votre propre assistant ou script, ou appelez directement la recherche d'inscriptions. Les deux fonctionnent dès aujourd'hui.
• Les créateurs de sites Web. Si vous hébergez le site Web d'un courtier sur Matchai, chaque page lisible par l'IA y est déjà. Quand l'API ouvrira, vous pourrez lire les inscriptions d'un courtier, envoyer les prospects de son site Web dans ses contacts Matchai, réserver des visites selon ses vraies disponibilités et être avisé des changements par webhooks. Un courtier connecte son compte à votre produit avec Se connecter avec Matchai.
• Les courtiers et les équipes qui créent leurs propres outils par script. Utilisez une clé d'API pour travailler avec votre propre compte depuis votre propre code.
• Les personnes qui veulent que leur propre assistant connaisse les inscriptions Matchai. Ajoutez le serveur MCP à Claude ou à ChatGPT en quelques minutes. Les étapes se trouvent dans le guide du serveur MCP.