Entreprises, agences et sociétés civiles
4 opérations servies.
Agences actives et parts de marché d'une commune
/api/v1/communes/{insee}/agencesLes agences actives dans une commune, mois par mois, d'après les annonces relevées par Pillr : enseigne, SIREN, mandats pris, mandats exclusifs, durée médiane en ligne, part des annonces baissées et part de marché de chaque agence, avec la part du leader et l'indice de concentration (HHI) de la commune. Par défaut le dernier mois calculé ; « mois » pour un mois donné, « depuis » pour tous les mois à partir d'un mois (24 mois au plus). Rien n'est masqué : un mois à peu de mandats est servi avec le drapeau peu_d_observations. Aucune agence relevée : 404 ressource_absente, rien n'est débité.
- Coût
- 3 crédits par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Portée
- entreprises
- Outil MCP
- agences_commune
- Bac à sable
- Oui, sans débit, sur un jeu figé
- Mémoire
- 6 h
- Délai
- 5 s
Paramètres
inseetexteobligatoireCode INSEE de la commune ou de l'arrondissement (5 caractères, 2A ou 2B pour la Corse).
moistexteUn mois donné (AAAA-MM).
depuistexteTous les mois à partir de celui-ci (AAAA-MM), 24 au plus.
Exemple d'appel
curl https://pillr.fr/api/v1/communes/{insee}/agences \
-H "Authorization: Bearer $PILLR_CLE"Réponse
inseetextepar_moisliste d'objetsUn bloc par mois, le plus récent d'abord.
Afficher les 7 champsMasquer
moistexteMois (AAAA-MM).
agencesliste d'objetsLes agences actives dans le mois, de la plus présente à la moins présente.
Afficher les 8 champsMasquer
enseignetexteEnseigne de l'agence telle que les annonces la publient.
sirentexte ou nullSIREN de l'agence, rapproché par Sirene ; null s'il n'a pas été trouvé.
mandatsentierAnnonces entrées dans le mois (mandats pris).
exclusifsentierDont mandats exclusifs.
part_exclusifs_pctnombre ou nullPart des mandats exclusifs, en %.
part_marche_pctnombre ou nullPart des mandats de la commune dans le mois, en % (mandats de l'agence sur tous les mandats de la commune).
duree_mediane_jnombre ou nullDurée médiane en ligne des annonces de l'agence, en jours.
part_baisses_pctnombre ou nullPart des annonces de l'agence dont le prix a baissé, en %.
n_agencesentiermandats_totalentier ou nullMandats pris dans la commune ce mois (signaux communaux) ; à défaut, la somme des mandats des agences.
part_leader_pctnombre ou nullPart de marché de l'agence la plus présente, en % (signaux communaux).
hhinombre ou nullIndice de concentration de Herfindahl-Hirschman des mandats, de 0 (marché éclaté) à 1 (une seule agence).
qualiteobjetCe qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.
Afficher les 7 champsMasquer
nentier ou nullNombre d'observations derrière la valeur ; null si sans objet.
0 au moins
provenancetexte ou nullmesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.
Valeurs :
mesure,estimeincertitudeobjet ou nullIncertitude de la valeur : fourchette et demi-largeur.
Afficher les 3 champsMasquer
demi_largeur_pctnombre ou nullDemi-largeur de la fourchette, en % de la valeur.
basnombre ou nullhautnombre ou null
drapeauxliste de textesCe qui doit faire lire la valeur avec prudence ; vide si rien.
Valeurs :
prix_atypique,surface_atypique,vente_en_bloc,doublon_probable,date_estimee,peu_d_observations,valeur_imputee,rattachement_incertain,donnee_anciennemethodetexte ou nullMéthode de calcul ou de rattachement, en clair.
donnees_dutexte ou nullDate de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).
sourcetexteSource publique ou moteur Pillr, en clair.
donnees_dutexte ou nullDate du calcul des agrégats (horodatage ISO 8601).
creditsobjetCrédits débités par cet appel (réservés, pour une tâche en cours), et crédits encore utilisables ce mois avant la coupure : crédits offerts, crédits inclus du mois et crédits facturables sous le plafond de dépense (null si inconnus ou en bac à sable).
Afficher les 2 champsMasquer
debitesentier0 au moins
restantsentier ou null
Erreurs possibles
- 400parametres_invalidesUn paramètre manque ou ne passe pas son contrôle ; le détail est donné champ par champ
- 401cle_absenteL'en-tête Authorization manque
- 401cle_invalideLa clé est inconnue, révoquée ou expirée
- 403organisation_suspendueL'organisation de la clé n'est pas active
- 403portee_insuffisanteLa clé ou l'accès de l'organisation n'ouvre pas cette opération
- 403hors_bac_a_sableUne clé pk_test_ demande une entrée hors du jeu figé de l'opération
- 402credits_insuffisantsLes crédits ne suffisent plus pour cet appel
- 429plafond_cleLe plafond mensuel de crédits de la clé est atteint
- 429quota_minuteLe débit par minute de l'organisation est atteint
- 503charge_globaleL'API est momentanément surchargée, tous clients confondus ; rien n'est débité
- 504delai_depasseLe calcul dépasse le délai de l'opération ; rien n'est débité
- 503service_indisponibleL'API est momentanément indisponible
- 500erreur_interneUne erreur de notre côté ; rien n'est servi ni débité
Une ressource absente répond par un code de la famille des ressources absentes, propre à l'opération, sans débit.
Agences et réseaux immobiliers
/api/v1/agences/api/v1/agences/{siren}La fiche d'une agence immobilière par son SIREN, ou les agences d'un lieu (commune, code postal, département), d'une enseigne ou d'un réseau. Pour chacune : dénomination, enseigne, sigle, catégorie juridique, APE, établissements Sirene (SIRET, adresse, effectif, création, siège), agences des portails rattachées au SIREN avec leur enseigne ou réseau, domaines web, coordonnées professionnelles avec leur origine, mandats du dernier mois par commune, annonces en ligne, et les 20 derniers avis BODACC. Seules les adresses électroniques publiées par l'agence sont servies, jamais une adresse construite par motif. Aucune agence : 404 ressource_absente, rien n'est débité.
- Coût
- 2 crédits par élément rendu
- Accès
- À l'usage ou avec l'abonnement Data
- Portée
- entreprises
- Outil MCP
- agences
- Bac à sable
- Oui, sans débit, sur un jeu figé
- Mémoire
- 6 h
- Délai
- 15 s
Paramètres de /api/v1/agences
inseetexteAgences dont un établissement est dans cette commune.
cptexteAgences dont un établissement a ce code postal.
departementtexteAgences dont un établissement est dans ce département.
enseignetexteEnseigne ou dénomination contenant ce texte (sans tenir compte de la casse).
de 2 à 80 caractères
reseautexteRéseau ou franchise contenant ce texte (Century 21, Laforêt...), lu sur les portails.
de 2 à 80 caractères
limiteentierNombre d'éléments par page (50 au plus).
de 1 à 50 ; par défaut 10
curseurtexteCurseur opaque rendu par la page précédente (curseur_suivant), à repasser tel quel.
de 1 à 1 024 caractères
Paramètres de /api/v1/agences/{siren}
sirentexteobligatoireNuméro SIREN de l'entreprise (9 chiffres, sans espace).
Exemple d'appel
curl https://pillr.fr/api/v1/agences \
-H "Authorization: Bearer $PILLR_CLE"Réponse
donneesliste d'objetsLes agences trouvées, par SIREN croissant.
Afficher les 16 champsMasquer
sirentextedenominationtexte ou nullDénomination de l'unité légale (ou nom d'usage d'un entrepreneur individuel immatriculé).
enseignetexte ou nullsigletexte ou nullcategorie_juridiquetexte ou nullCatégorie juridique (code Insee).
apetexte ou nullActivité principale (code APE).
entrepreneur_individuelbooléen ou nullVrai pour un entrepreneur individuel immatriculé, servi comme professionnel.
diffusion_partiellebooléenVrai si l'unité est en diffusion partielle Sirene : son adresse n'est pas servie.
etablissementsliste d'objetsAfficher les 9 champsMasquer
sirettextesiegebooléen ou nulladressetexte ou nullNuméro et voie de l'établissement ; null pour une unité en diffusion partielle.
code_postaltexte ou nullcommunetexte ou nullinseetexte ou nulltranche_effectiftexte ou nullTranche d'effectif salarié (code Sirene).
cree_letexte ou nullactifbooléen ou nullFaux pour un établissement fermé (état administratif F).
reseauxliste d'objetsAgences des portails rattachées au SIREN, avec leur enseigne ou réseau.
Afficher les 8 champsMasquer
enseignetexte ou nullEnseigne ou réseau de franchise (Century 21, Laforêt...) ; null si l'agence n'en a pas.
nom_commercialtexte ou nullNom commercial publié sur le portail.
identifiant_portailtextecommune_principaletexte ou nulldepartement_principaltexte ou nullnb_annoncesentier ou nullrapprochementtexte ou nullComment l'agence du portail a été rapprochée de son SIREN.
calcule_letexte ou null
domainesliste d'objetsAfficher les 4 champsMasquer
domainetextegenretexte ou nullpropre : site de l'agence ; heberge : site hébergé en marque blanche par un éditeur (le sous-domaine est l'agence).
sourcetexte ou nullobservationsentier ou null
contacts_proobjet ou nullCoordonnées professionnelles de l'agence ; null si aucune n'est connue.
Afficher les 5 champsMasquer
telephonetexte ou nullTéléphone professionnel publié ; null s'il est inconnu ou retiré.
emailtexte ou nullAdresse électronique PUBLIÉE par le professionnel (annonce, site, mentions légales) ; jamais une adresse construite par motif.
sitetexte ou nullSite web (domaine) ; null s'il est inconnu.
originetexte ou nullOù l'adresse électronique a été lue : published (publiée par le professionnel), desc_extracted (lue dans une annonce), site_legal (mentions légales du site).
retireesbooléenVrai si le professionnel s'est opposé à nos envois : aucune coordonnée n'est alors servie.
activiteobjetAfficher les 7 champsMasquer
moistexte ou nullDernier mois calculé des mandats (AAAA-MM).
mandatsentier ou nullMandats pris dans le mois, toutes communes.
exclusifsentier ou nullcommunesliste d'objetsLes mandats du mois, par commune et par enseigne.
Afficher les 6 champsMasquer
inseetexteenseignetextemandatsentierexclusifsentierduree_mediane_jnombre ou nullpart_baisses_pctnombre ou null
annonces_activesentier ou nullAnnonces en ligne rattachées au SIREN.
annonces_par_communeliste d'objetsAnnonces en ligne par commune.
Afficher les 3 champsMasquer
communetexte ou nullcode_postaltexte ou nullnb_annoncesentier ou null
qualiteobjetCe qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.
Afficher les 7 champsMasquer
nentier ou nullNombre d'observations derrière la valeur ; null si sans objet.
0 au moins
provenancetexte ou nullmesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.
Valeurs :
mesure,estimeincertitudeobjet ou nullIncertitude de la valeur : fourchette et demi-largeur.
Afficher les 3 champsMasquer
demi_largeur_pctnombre ou nullDemi-largeur de la fourchette, en % de la valeur.
basnombre ou nullhautnombre ou null
drapeauxliste de textesCe qui doit faire lire la valeur avec prudence ; vide si rien.
Valeurs :
prix_atypique,surface_atypique,vente_en_bloc,doublon_probable,date_estimee,peu_d_observations,valeur_imputee,rattachement_incertain,donnee_anciennemethodetexte ou nullMéthode de calcul ou de rattachement, en clair.
donnees_dutexte ou nullDate de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).
sourcetexteSource publique ou moteur Pillr, en clair.
avis_bodaccliste d'objetsLes 20 derniers avis BODACC du SIREN au plus (tous : /entreprises/{siren}).
Afficher les 17 champsMasquer
idtexteIdentifiant de l'avis au BODACC.
datetexte ou nullDate de parution (AAAA-MM-JJ).
familletexte ou nullFamille d'avis (code de la source : creation, modification, radiation, collective, vente, dpc...).
famille_libelletexte ou nulltypetexte ou nullType d'avis (avis initial, rectificatif, annulation).
numero_annoncetexte ou nullparutiontexte ou nullNuméro de parution du BODACC.
tribunaltexte ou nullvilletexte ou nullcptexte ou nulldepartementtexte ou nulldenominationtexte ou nullDénomination de la personne morale visée par l'avis ; null pour un avis qui porte sur une personne physique.
sirensliste de textesSIREN cités par l'avis ; vide pour une personne physique.
porte_sur_personne_physiquebooléen ou nullVrai si l'avis porte sur une personne physique : son identité, son registre et ses textes ne sont pas servis.
contenuobjetLe contenu structuré de l'avis, tel que publié, en JSON.
Afficher les 11 champsMasquer
personnesvaleurContenu de l'avis tel que publié au BODACC, en JSON, personnes physiques réduites à leur qualité.
etablissementsvaleurContenu de l'avis tel que publié au BODACC, en JSON, personnes physiques réduites à leur qualité.
jugementvaleurContenu de l'avis tel que publié au BODACC, en JSON, personnes physiques réduites à leur qualité.
actevaleurContenu de l'avis tel que publié au BODACC, en JSON, personnes physiques réduites à leur qualité.
modifications_generalesvaleurContenu de l'avis tel que publié au BODACC, en JSON, personnes physiques réduites à leur qualité.
radiation_rcsvaleurContenu de l'avis tel que publié au BODACC, en JSON, personnes physiques réduites à leur qualité.
depotvaleurContenu de l'avis tel que publié au BODACC, en JSON, personnes physiques réduites à leur qualité.
diversvaleurContenu de l'avis tel que publié au BODACC, en JSON, personnes physiques réduites à leur qualité.
precedents_proprietairesvaleurContenu de l'avis tel que publié au BODACC, en JSON, personnes physiques réduites à leur qualité.
precedents_exploitantsvaleurContenu de l'avis tel que publié au BODACC, en JSON, personnes physiques réduites à leur qualité.
avis_precedentvaleurContenu de l'avis tel que publié au BODACC, en JSON, personnes physiques réduites à leur qualité.
lientexte ou nullLien de l'avis sur bodacc.fr ; null pour un avis qui porte sur une personne physique.
charge_letexte ou nullDate de chargement de l'avis dans le lac de Pillr (horodatage ISO 8601).
avis_bodacc_completsbooléenFaux si l'entreprise a plus d'avis que ceux servis ici.
sirene_dutexte ou nullDate de l'extrait Sirene lu (AAAA-MM-JJ).
mentiontexteCe qui est servi des coordonnées, et ce qui ne l'est jamais.
curseur_suivanttexte ou nullCurseur de la page suivante, à repasser dans curseur ; null sur la dernière page.
creditsobjetCrédits débités par cet appel (réservés, pour une tâche en cours), et crédits encore utilisables ce mois avant la coupure : crédits offerts, crédits inclus du mois et crédits facturables sous le plafond de dépense (null si inconnus ou en bac à sable).
Afficher les 2 champsMasquer
debitesentier0 au moins
restantsentier ou null
Erreurs possibles
- 400parametres_invalidesUn paramètre manque ou ne passe pas son contrôle ; le détail est donné champ par champ
- 401cle_absenteL'en-tête Authorization manque
- 401cle_invalideLa clé est inconnue, révoquée ou expirée
- 403organisation_suspendueL'organisation de la clé n'est pas active
- 403portee_insuffisanteLa clé ou l'accès de l'organisation n'ouvre pas cette opération
- 403hors_bac_a_sableUne clé pk_test_ demande une entrée hors du jeu figé de l'opération
- 402credits_insuffisantsLes crédits ne suffisent plus pour cet appel
- 429plafond_cleLe plafond mensuel de crédits de la clé est atteint
- 429quota_minuteLe débit par minute de l'organisation est atteint
- 503charge_globaleL'API est momentanément surchargée, tous clients confondus ; rien n'est débité
- 503creneau_reserveEntre 20h30 et minuit (heure de Paris), la réponse n'est pas déjà en mémoire
- 504delai_depasseLe calcul dépasse le délai de l'opération ; rien n'est débité
- 503service_indisponibleL'API est momentanément indisponible
- 500erreur_interneUne erreur de notre côté ; rien n'est servi ni débité
Une ressource absente répond par un code de la famille des ressources absentes, propre à l'opération, sans débit.
Agents et mandataires
/api/v1/agentsLes agents et mandataires immobiliers vus sur les portails et dans les annuaires des réseaux, servis comme professionnels : nom d'exercice, réseau, SIREN, communes, nombre de biens, types et prix, et coordonnées professionnelles avec leur origine. Filtres : commune (code INSEE, rapprochée par le code postal et le nom de la commune principale), code postal, département, SIREN de l'agence ou réseau. Seules les adresses électroniques publiées par le professionnel sont servies, jamais une adresse construite par motif ; un professionnel qui s'est opposé à nos envois n'a plus aucune coordonnée servie. Aucun agent : 404 ressource_absente, rien n'est débité.
- Coût
- 1 crédit par élément rendu
- Accès
- À l'usage ou avec l'abonnement Data
- Portée
- entreprises
- Outil MCP
- agents_immobiliers
- Bac à sable
- Oui, sans débit, sur un jeu figé
- Mémoire
- 6 h
- Délai
- 5 s
Paramètres
inseetexteCode INSEE de la commune ou de l'arrondissement (5 caractères, 2A ou 2B pour la Corse).
cptexteCode postal principal du professionnel.
departementtexteDépartement principal du professionnel.
sirentexteSIREN de l'agence ou du réseau.
reseautexteRéseau contenant ce texte (iad, SAFTI...), sans tenir compte de la casse.
de 2 à 80 caractères
limiteentierNombre d'éléments par page (50 au plus).
de 1 à 50 ; par défaut 20
curseurtexteCurseur opaque rendu par la page précédente (curseur_suivant), à repasser tel quel.
de 1 à 1 024 caractères
Exemple d'appel
curl https://pillr.fr/api/v1/agents \
-H "Authorization: Bearer $PILLR_CLE"Réponse
donneesliste d'objetsLes professionnels trouvés, du plus actif au moins actif.
Afficher les 20 champsMasquer
idtexteIdentifiant stable du professionnel dans la base de Pillr.
type_vendeurtextemandataire : agent ou mandataire en nom propre ; agence : boîte commune d'une agence ; professionnel : statut non précisé.
Valeurs :
mandataire,agence,professionnelnom_exercicetexte ou nullNom d'exercice du professionnel, tel que publié.
individuelbooléen ou nullVrai pour un agent ou mandataire en nom propre, faux pour une agence.
reseautexte ou nullsirentexte ou nullcommune_principaletexte ou nullcode_postal_principaltexte ou nulldepartement_principaltexte ou nullcommunesliste de textesCommunes où le professionnel a des biens en vente.
biensentier ou nullBiens en vente relevés.
typesliste de textesTypes de biens.
prix_minnombre ou nullprix_mediannombre ou nullprix_maxnombre ou nullportailsliste de textessourcesliste de textesSources du rapprochement (annonces, annuaires de réseaux, sites).
rapprochementtexte ou nullMéthode de rapprochement des sources (nom normalisé, contraint par le département).
contacts_proobjetCoordonnées professionnelles, avec leur origine.
Afficher les 5 champsMasquer
telephonetexte ou nullTéléphone professionnel publié ; null s'il est inconnu ou retiré.
emailtexte ou nullAdresse électronique PUBLIÉE par le professionnel (annonce, site, mentions légales) ; jamais une adresse construite par motif.
sitetexte ou nullSite web (domaine) ; null s'il est inconnu.
originetexte ou nullOù l'adresse électronique a été lue : published (publiée par le professionnel), desc_extracted (lue dans une annonce), site_legal (mentions légales du site).
retireesbooléenVrai si le professionnel s'est opposé à nos envois : aucune coordonnée n'est alors servie.
qualiteobjetCe qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.
Afficher les 7 champsMasquer
nentier ou nullNombre d'observations derrière la valeur ; null si sans objet.
0 au moins
provenancetexte ou nullmesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.
Valeurs :
mesure,estimeincertitudeobjet ou nullIncertitude de la valeur : fourchette et demi-largeur.
Afficher les 3 champsMasquer
demi_largeur_pctnombre ou nullDemi-largeur de la fourchette, en % de la valeur.
basnombre ou nullhautnombre ou null
drapeauxliste de textesCe qui doit faire lire la valeur avec prudence ; vide si rien.
Valeurs :
prix_atypique,surface_atypique,vente_en_bloc,doublon_probable,date_estimee,peu_d_observations,valeur_imputee,rattachement_incertain,donnee_anciennemethodetexte ou nullMéthode de calcul ou de rattachement, en clair.
donnees_dutexte ou nullDate de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).
sourcetexteSource publique ou moteur Pillr, en clair.
mentiontexteCe qui est servi des coordonnées, et ce qui ne l'est jamais.
curseur_suivanttexte ou nullCurseur de la page suivante, à repasser dans curseur ; null sur la dernière page.
creditsobjetCrédits débités par cet appel (réservés, pour une tâche en cours), et crédits encore utilisables ce mois avant la coupure : crédits offerts, crédits inclus du mois et crédits facturables sous le plafond de dépense (null si inconnus ou en bac à sable).
Afficher les 2 champsMasquer
debitesentier0 au moins
restantsentier ou null
Erreurs possibles
- 400parametres_invalidesUn paramètre manque ou ne passe pas son contrôle ; le détail est donné champ par champ
- 401cle_absenteL'en-tête Authorization manque
- 401cle_invalideLa clé est inconnue, révoquée ou expirée
- 403organisation_suspendueL'organisation de la clé n'est pas active
- 403portee_insuffisanteLa clé ou l'accès de l'organisation n'ouvre pas cette opération
- 403hors_bac_a_sableUne clé pk_test_ demande une entrée hors du jeu figé de l'opération
- 402credits_insuffisantsLes crédits ne suffisent plus pour cet appel
- 429plafond_cleLe plafond mensuel de crédits de la clé est atteint
- 429quota_minuteLe débit par minute de l'organisation est atteint
- 503charge_globaleL'API est momentanément surchargée, tous clients confondus ; rien n'est débité
- 504delai_depasseLe calcul dépasse le délai de l'opération ; rien n'est débité
- 503service_indisponibleL'API est momentanément indisponible
- 500erreur_interneUne erreur de notre côté ; rien n'est servi ni débité
Une ressource absente répond par un code de la famille des ressources absentes, propre à l'opération, sans débit.
Entreprise : avis BODACC et autorisations
/api/v1/entreprises/{siren}Une entreprise par son SIREN : tous ses avis BODACC depuis 2009 (création, modifications, radiation, ventes et cessions, procédures collectives, dépôts des comptes), avec leur contenu structuré (établissements, jugements, actes), ses établissements Sirene de l'immobilier, ses autorisations d'urbanisme (Sitadel) et, si c'est une agence, ses enseignes et ses mandats par commune. Les personnes physiques d'un avis (gérants, associés) ne gardent que leur qualité ; un avis qui porte sur une personne physique ne sert ni son identité ni ses textes. Filtres : familles d'avis et date de début. SIREN inconnu de toutes les sources : 404 ressource_absente, rien n'est débité.
- Coût
- 3 crédits par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Portée
- entreprises
- Outil MCP
- entreprise
- Bac à sable
- Non
- Mémoire
- 24 h
- Délai
- 15 s
Paramètres
sirentexteobligatoireNuméro SIREN de l'entreprise (9 chiffres, sans espace).
famillesvaleurNe garder que ces familles d'avis (une ou plusieurs).
depuistexteNe garder que les avis parus à partir de cette date (AAAA-MM-JJ).
Exemple d'appel
curl https://pillr.fr/api/v1/entreprises/{siren} \
-H "Authorization: Bearer $PILLR_CLE"Réponse
sirentextedenominationtexte ou nullformetexte ou nullForme juridique (lue au BODACC) ou catégorie juridique (Sirene).
categorie_juridiquetexte ou nullapetexte ou nullsigletexte ou nullentrepreneur_individuelbooléen ou nulladresse_siegevaleurAdresse du siège : établissement siège Sirene, ou siège déclaré au dernier avis BODACC.
identite_luetexteD'où viennent la dénomination et la forme.
Valeurs :
sirene,bodacc,aucuneetablissementsliste d'objetsÉtablissements Sirene de l'immobilier rattachés au SIREN.
Afficher les 9 champsMasquer
sirettextesiegebooléen ou nulladressetexte ou nullNuméro et voie de l'établissement ; null pour une unité en diffusion partielle.
code_postaltexte ou nullcommunetexte ou nullinseetexte ou nulltranche_effectiftexte ou nullTranche d'effectif salarié (code Sirene).
cree_letexte ou nullactifbooléen ou nullFaux pour un établissement fermé (état administratif F).
n_avisentieravisliste d'objetsAvis BODACC depuis 2009, le plus récent d'abord, filtrés par familles et date si demandé.
Afficher les 17 champsMasquer
idtexteIdentifiant de l'avis au BODACC.
datetexte ou nullDate de parution (AAAA-MM-JJ).
familletexte ou nullFamille d'avis (code de la source : creation, modification, radiation, collective, vente, dpc...).
famille_libelletexte ou nulltypetexte ou nullType d'avis (avis initial, rectificatif, annulation).
numero_annoncetexte ou nullparutiontexte ou nullNuméro de parution du BODACC.
tribunaltexte ou nullvilletexte ou nullcptexte ou nulldepartementtexte ou nulldenominationtexte ou nullDénomination de la personne morale visée par l'avis ; null pour un avis qui porte sur une personne physique.
sirensliste de textesSIREN cités par l'avis ; vide pour une personne physique.
porte_sur_personne_physiquebooléen ou nullVrai si l'avis porte sur une personne physique : son identité, son registre et ses textes ne sont pas servis.
contenuobjetLe contenu structuré de l'avis, tel que publié, en JSON.
Afficher les 11 champsMasquer
personnesvaleurContenu de l'avis tel que publié au BODACC, en JSON, personnes physiques réduites à leur qualité.
etablissementsvaleurContenu de l'avis tel que publié au BODACC, en JSON, personnes physiques réduites à leur qualité.
jugementvaleurContenu de l'avis tel que publié au BODACC, en JSON, personnes physiques réduites à leur qualité.
actevaleurContenu de l'avis tel que publié au BODACC, en JSON, personnes physiques réduites à leur qualité.
modifications_generalesvaleurContenu de l'avis tel que publié au BODACC, en JSON, personnes physiques réduites à leur qualité.
radiation_rcsvaleurContenu de l'avis tel que publié au BODACC, en JSON, personnes physiques réduites à leur qualité.
depotvaleurContenu de l'avis tel que publié au BODACC, en JSON, personnes physiques réduites à leur qualité.
diversvaleurContenu de l'avis tel que publié au BODACC, en JSON, personnes physiques réduites à leur qualité.
precedents_proprietairesvaleurContenu de l'avis tel que publié au BODACC, en JSON, personnes physiques réduites à leur qualité.
precedents_exploitantsvaleurContenu de l'avis tel que publié au BODACC, en JSON, personnes physiques réduites à leur qualité.
avis_precedentvaleurContenu de l'avis tel que publié au BODACC, en JSON, personnes physiques réduites à leur qualité.
lientexte ou nullLien de l'avis sur bodacc.fr ; null pour un avis qui porte sur une personne physique.
charge_letexte ou nullDate de chargement de l'avis dans le lac de Pillr (horodatage ISO 8601).
avis_tronquesbooléenVrai si l'entreprise a plus de 1000 avis : les plus anciens ne sont pas servis.
permisliste d'objetsAutorisations d'urbanisme déposées par l'entreprise (Sitadel).
Afficher les 4 champsMasquer
sourcetextelogements, locaux, demolir ou amenager (fichiers Sitadel).
numerotexte ou nulldatetexte ou nullDate de l'autorisation (AAAA-MM-JJ).
lignevaleurLa ligne Sitadel complète de l'autorisation, en JSON.
agenceobjet ou nullSi l'entreprise est une agence vue sur les portails : ses enseignes et ses mandats par commune ; null sinon.
Afficher les 2 champsMasquer
reseauxliste d'objetsAfficher les 8 champsMasquer
enseignetexte ou nullEnseigne ou réseau de franchise (Century 21, Laforêt...) ; null si l'agence n'en a pas.
nom_commercialtexte ou nullNom commercial publié sur le portail.
identifiant_portailtextecommune_principaletexte ou nulldepartement_principaltexte ou nullnb_annoncesentier ou nullrapprochementtexte ou nullComment l'agence du portail a été rapprochée de son SIREN.
calcule_letexte ou null
mandats_par_communeliste d'objetsAfficher les 7 champsMasquer
inseetexteenseignetextemandatsentierexclusifsentierduree_mediane_jnombre ou nullpart_baisses_pctnombre ou nullmoistexte ou null
donnees_dutexte ou nullDate du plus récent avis servi.
qualiteobjetCe qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.
Afficher les 7 champsMasquer
nentier ou nullNombre d'observations derrière la valeur ; null si sans objet.
0 au moins
provenancetexte ou nullmesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.
Valeurs :
mesure,estimeincertitudeobjet ou nullIncertitude de la valeur : fourchette et demi-largeur.
Afficher les 3 champsMasquer
demi_largeur_pctnombre ou nullDemi-largeur de la fourchette, en % de la valeur.
basnombre ou nullhautnombre ou null
drapeauxliste de textesCe qui doit faire lire la valeur avec prudence ; vide si rien.
Valeurs :
prix_atypique,surface_atypique,vente_en_bloc,doublon_probable,date_estimee,peu_d_observations,valeur_imputee,rattachement_incertain,donnee_anciennemethodetexte ou nullMéthode de calcul ou de rattachement, en clair.
donnees_dutexte ou nullDate de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).
sourcetexteSource publique ou moteur Pillr, en clair.
limitesliste de textescreditsobjetCrédits débités par cet appel (réservés, pour une tâche en cours), et crédits encore utilisables ce mois avant la coupure : crédits offerts, crédits inclus du mois et crédits facturables sous le plafond de dépense (null si inconnus ou en bac à sable).
Afficher les 2 champsMasquer
debitesentier0 au moins
restantsentier ou null
Erreurs possibles
- 400parametres_invalidesUn paramètre manque ou ne passe pas son contrôle ; le détail est donné champ par champ
- 401cle_absenteL'en-tête Authorization manque
- 401cle_invalideLa clé est inconnue, révoquée ou expirée
- 403organisation_suspendueL'organisation de la clé n'est pas active
- 403portee_insuffisanteLa clé ou l'accès de l'organisation n'ouvre pas cette opération
- 403hors_bac_a_sableUne clé pk_test_ l'appelle : l'opération n'a pas de bac à sable
- 402credits_insuffisantsLes crédits ne suffisent plus pour cet appel
- 429plafond_cleLe plafond mensuel de crédits de la clé est atteint
- 429quota_minuteLe débit par minute de l'organisation est atteint
- 503charge_globaleL'API est momentanément surchargée, tous clients confondus ; rien n'est débité
- 503creneau_reserveEntre 20h30 et minuit (heure de Paris), la réponse n'est pas déjà en mémoire
- 504delai_depasseLe calcul dépasse le délai de l'opération ; rien n'est débité
- 503service_indisponibleL'API est momentanément indisponible
- 500erreur_interneUne erreur de notre côté ; rien n'est servi ni débité
Une ressource absente répond par un code de la famille des ressources absentes, propre à l'opération, sans débit.