Ces API sont destinées aux réseaux de mandataires, pour une utilisation interne, notamment pour les aider à savoir dans quels endroits le potentiel de développement est le plus fort. Elles ne fournissent aucune information personnelle. Pour les niveaux d'analyses fins (intercommunalités et communes), elles ne fournissent aucune donnée relative à un réseau concurrent particulier (on n'y trouve que des données concernant la somme de tous les réseaux concurrents).
Ces API ne doivent pas servir à publier des informations en dehors des espaces internes au réseau. Autrement dit, elles ne doivent pas être utilisées pour concurrencer meilleursreseaux...
Pour démarrer, merci de demander votre identifiant et votre pass grâce à ce formulaire de contact.
URL de base : https://api.meilleursreseaux.com/requete/mandataires_nb.php
Exemple d'url : https://api.meilleursreseaux.com/requete/mandataires_nb.php?identifiant=[VOTRE_IDENTIFIANT]&pass=[VOTRE_PASS]&niveau=departements
Les valeurs possibles pour "niveau" sont :
Les valeurs possibles pour "historique_frequence" sont :
Les valeurs possibles pour "historique_colonnes" sont :
Les valeurs possibles pour "ventiler_par_reseau" sont :
Le résultat est un fichier csv qui contient :
| departement_id | Le n° du département | (non-nul seulement si niveau = "departements" ou "communes") |
| departement_nom | Le nom du département | (non-nul seulement si niveau = "departements" ou "communes") |
| ze_id | L'identifiant INSEE de la zone d'emploi | (non-nul seulement si niveau = "zes") |
| ze_nom | Le nom de la zone d'emploi | (non-nul seulement si niveau = "zes") |
| intercommunalite_id | L'identifiant INSEE de l'intercommunalité | (non-nul seulement si niveau = "intercommunalites") |
| intercommunalite_nom | Le nom de l'intercommunalité | (non-nul seulement si niveau = "intercommunalites") |
| commune_id | L'identifiant INSEE de la commune | (non-nul seulement si niveau = "communes") |
| commune_nom | Le nom de la commune | (non-nul seulement si niveau = "communes") |
| habitants_nb | Le nombre d'habitants | |
| mandataires_nb | Le nombre total de mandataires tous réseaux confondus | |
| densite | Le nombre de mandataires par 10 000 habitants | |
| reseau_id | L'identifiant du réseau | (non-nul seulement si ventiler_par_reseau = "oui") |
| reseau_nom | Le nom du réseau | (non-nul seulement si ventiler_par_reseau = "oui") |
| mandataires_nb_reseau | Le nombre total de mandataires du réseau | (si ventiler_par_reseau = "non", il s'agit toujours de votre réseau) |
| parts_marche_reseau | Le % de mandataires qui sont dans le réseau | (si ventiler_par_reseau = "non", il s'agit toujours de votre réseau) |
Si historique_frequence est différent de "aucune", les colonnes suivantes sont ajoutés pour chaque période pertinente, par exemple pour "mensuelle" :
| mandataires_nb_AAAA-MM | Le nombre total de mandataires tous réseaux confondus au mois AAAA-MM | (seulement si historique_colonnes = "toutes" ou "mandataires_nb") |
| mandataires_nb_reseau_AAAA-MM | Le nombre total de mandataires de votre réseau au mois AAAA-MM | (seulement si historique_colonnes = "toutes" ou "mandataires_nb_reseau") |
| parts_marche_reseau_AAAA-MM | Le % de mandataires qui sont dans votre réseau au mois AAAA-MM | (seulement si historique_colonnes = "toutes" ou "parts_marche_reseau") |
Le département est inconnu pour 1% des mandataires et la commune est inconnue pour environ 10% des mandataires (la zone d'emploi et l'intercommunalité sont alors aussi inconnues). Les chiffres donnés ne sont donc qu'une approximation.
L'historique commence en février 2014 mais les chiffres sont vraiment cohérents depuis septembre 2016. Avant, il y a des irrégularités :
Pour calculer les données relatives à une période, c'est la moyenne au cours de cette période qui est prise en compte, donc si on souhaite convertir une période en date, il vaut mieux prendre le milieu de la période.
Les chiffres concernant les zones d'emplois (ZE) et intercommunalités sont compilés à partir des codes communes INSEE.
Bug connu : si "niveau" est "communes", "historique_frequence" n'est pas "aucune", et "historique_colonnes" n'est pas "mandataires_nb", le script met parfois trop de temps à répondre.
URL de base : https://api.meilleursreseaux.com/requete/annonces_nb.php
Exemple d'url : https://api.meilleursreseaux.com/requete/annonces_nb.php?identifiant=[VOTRE_IDENTIFIANT]&pass=[VOTRE_PASS]&historique_frequence=annuelle&historique_colonnes=parts_marche_reseau
Les valeurs possibles pour "historique_frequence" sont :
Les valeurs possibles pour "historique_colonnes" sont :
Les résultats sont fournis au niveau national. En effet, concernant le nombre d'annonces, meilleursreseaux ne collecte que des données nationales.
Le résultat est un fichier csv qui contient :
| portail_id | L'identifiant du portail d'annonces | Liste des valeurs fournies : site_internet_propre (correspond aux annonces que chaque réseau publie sur son propre site), leboncoin, seloger, logicimmo, paruvendu, greenacres |
| annonces_nb | Le nombre total d'annonces sur ce portail tous réseaux de mandataires confondus | |
| annonces_nb_reseau | Le nombre total d'annonces sur ce portail qui proviennent de votre réseau | |
| parts_marche_reseau | Le % d'annonces sur ce portail qui viennent de votre réseau (par rapport aux annonces fournies par l'ensemble des réseaux de mandataires) |
Si historique_frequence est différent de "aucune", les colonnes suivantes sont ajoutés pour chaque période pertinente, par exemple pour "mensuelle" :
| annonces_nb_AAAA-MM | Le nombre total d'annonces tous réseaux confondus au mois AAAA-MM | (seulement si historique_colonnes = "toutes" ou "annonces_nb") |
| annonces_nb_reseau_AAAA-MM | Le nombre total d'annonces de votre réseau au mois AAAA-MM | (seulement si historique_colonnes = "toutes" ou "annonces_nb_reseau") |
| parts_marche_reseau_AAAA-MM | Le % d'annonces qui proviennent de votre réseau au mois AAAA-MM | (seulement si historique_colonnes = "toutes" ou "parts_marche_reseau") |
Maxihome n'apparaît pas dans les statistiques : pour le nombre d'annonces, certains résultats étaient faussés car couplés à Clairimmo (ce n'est pas le cas avec le nombre de mandataires).
Pour Les Porteclés, le nombre d'annonces sur seloger, logicimmo et paruvendu est inconnu.
Pour site_internet_propre (annonces que chaque réseau publie sur son propre site), l'historique remonte à novembre 2013, et les résultats sont vraiment fiables à partir d'avril 2014 :
Pour leboncoin, l'historique remonte à novembre 2013, et les résultats sont vraiment fiables à partir de février 2014 :
Pour seloger, l'historique remonte à novembre 2017, et les résultats sont vraiment fiables à partir de décembre 2017 :
Pour logicimmo, l'historique remonte à janvier 2014, et les résultats sont vraiment fiables à partir de février 2014 :
Pour paruvendu, l'historique remonte à janvier 2014, et les résultats sont vraiment fiables à partir de février 2014 :
Pour greenacres, l'historique remonte à janvier 2016.
N'hésitez pas à partager vos questions ou vos remarques par écrit ou par téléphone : 01 84 16 68 04.
Dernière mise à jour : 18/11/2020