← Retour à Abracadeal

API partenaires

Éditeurs de logiciels immobiliers et automobiles : diffusez les annonces de vos clients sur Abracadeal, automatiquement. La diffusion est gratuite pour les agences et les garages.

Version 1 — mise à jour le 5 novembre 2026. Contact technique : contact@abracadeal.fr

Principe

  1. Votre client active Abracadeal dans votre logiciel. C'est son accord pour la diffusion.
  2. Vous déclarez l'agence (PUT /v1/agencies/{agency_id}) avec son SIRET.
  3. Vous envoyez ses annonces (PUT /v1/agencies/{agency_id}/listings). Elles sont contrôlées puis mises en ligne, et mises à jour à chaque envoi.
Aucune inscription à faire pour l'agence. Si elle n'a pas encore de compte Abracadeal, nous l'ouvrons automatiquement à partir de votre déclaration : SIRET contrôlé au registre officiel, puis e-mail à l'agence pour choisir son mot de passe. Il faut pour cela son e-mail et son téléphone. Si l'ouverture automatique n'est pas possible, l'agence passe au statut pending et nous la traitons rapidement ; ses annonces sont ensuite acceptées sans action de votre part.

Accès

URL de base

https://jplzvxmpbpjssyinozap.supabase.co/functions/v1/partner-api/v1

Authentification : une clé par éditeur, fournie sur demande à contact@abracadeal.fr, à envoyer dans chaque requête :

Authorization: Bearer abk_live_xxxxxxxxxxxxxxxx

Les échanges se font en JSON (UTF-8), en HTTPS uniquement. POST est accepté partout où PUT l'est. Une clé de test est disponible pour vos développements.

Les routes

MéthodeRouteRôle
GET/pingVérifie la clé.
PUT/agencies/{agency_id}Déclare ou met à jour une agence (activation par l'agence).
GET/agencies/{agency_id}Statut de l'agence et nombre d'annonces par statut.
DELETE/agencies/{agency_id}L'agence désactive Abracadeal : toutes ses annonces sont retirées.
PUT/agencies/{agency_id}/listingsEnvoie des annonces (ajout, mise à jour, ou stock complet).
GET/agencies/{agency_id}/listingsListe des annonces de l'agence, avec statut et lien public.
DELETE/agencies/{agency_id}/listings/{reference}Retire une annonce (vendue, louée, mandat terminé).

agency_id est votre identifiant de l'agence : 1 à 80 caractères parmi A-Z a-z 0-9 . _ : -.

Déclarer une agence

PUT /v1/agencies/AG-1234
{
  "siret": "12345678900012",
  "name": "Agence du Port",
  "sector": "immobilier",
  "email": "contact@agenceduport.fr",
  "phone": "04 93 00 00 00",
  "city": "Cannes",
  "postal_code": "06400",
  "consent": true
}
ChampObligatoireDescription
siretoui14 chiffres. Ne peut plus changer une fois l'agence diffusée.
nameouiNom commercial de l'agence.
consentouitrue : l'agence a activé elle-même la diffusion sur Abracadeal dans votre logiciel.
sectornonimmobilier (par défaut) ou vehicules.
email, phonerecommandésIndispensables pour ouvrir automatiquement le compte de l'agence. Le téléphone est celui affiché aux acheteurs.
city, postal_codenonAdresse de l'agence.

Réponse (201 à la création, 200 ensuite) :

{ "ok": true, "agency": { "agency_id": "AG-1234", "status": "active", "status_detail": "Annonces acceptées.", … } }

Statuts : active (annonces acceptées), pending (compte en cours d'ouverture par Abracadeal), stopped (diffusion arrêtée ; un nouveau PUT la relance).

Envoyer des annonces

PUT /v1/agencies/AG-1234/listings
{
  "mode": "partial",
  "listings": [
    {
      "reference": "MANDAT-0456",
      "transaction": "vente",
      "type_bien": "appartement",
      "titre": "Appartement 3 pièces avec terrasse",
      "description": "…",
      "prix": 395000,
      "surface": 68,
      "pieces": 3,
      "chambres": 2,
      "ville": "Cannes",
      "code_postal": "06400",
      "dpe": "C",
      "ges": "C",
      "photos": ["https://…/1.jpg", "https://…/2.jpg"]
    }
  ]
}

Réponse :

{ "ok": true, "mode": "partial", "received": 1, "created": 1, "updated": 0,
  "unchanged": 0, "removed": 0, "rejected": 0, "rejected_detail": null }

Une annonce incomplète (sans photo, sans ville, type non reconnu…) est refusée sans bloquer les autres ; la raison figure dans rejected_detail.

Champs immobilier

Les noms français ci-dessous sont recommandés ; les équivalents anglais courants sont aussi reconnus (price, city, rooms, living_area, energy_class…).

ChampDescription
reference *Identifiant unique et stable du bien.
transaction *vente ou location.
type_bien *appartement, maison, terrain, local commercial, bureaux, parking…
titre, descriptionTexte de l'annonce.
prix *En euros. Loyer mensuel pour une location.
ville *, code_postalCommune du bien.
surface, surface_terrainEn m².
pieces, chambres, salles_de_bain, etageNombres.
dpe, gesClasses A à G (obligatoires pour les logements, selon la réglementation).
honoraires, charges_mensuelles, charges_annuellesInformations financières.
photos *Liste d'URL publiques (45 maximum).
urlLien vers l'annonce sur le site de l'agence.

Champs véhicules

ChampDescription
reference *Numéro de stock unique et stable.
marque *, modele *, versionIdentification du véhicule.
prix *En euros TTC.
annee, kilometrageNombres.
carburant, boiteessence, diesel, hybride, électrique… ; manuelle, automatique.
typevoiture (par défaut), moto, utilitaire, camping-car…
ville, code_postalPar défaut, l'adresse du garage.
photos *Liste d'URL publiques (45 maximum).

* champs nécessaires à la mise en ligne.

Erreurs

Toute erreur renvoie { "ok": false, "error": { "code": "…", "message": "…" } }.

HTTPCodeSignification
401unauthorizedClé absente ou invalide.
404agency_not_foundAgence non déclarée.
409agency_pendingCompte de l'agence en cours d'ouverture : renvoyez plus tard.
409agency_stoppedDiffusion arrêtée par l'agence.
413too_manyPlus de 200 annonces dans l'appel.
422invalid_siret, consent_required, missing_reference…Données invalides (détail dans message).
502 / 500import_failed, server_errorProblème temporaire : réessayez plus tard.

Exemple complet

curl -X PUT "https://jplzvxmpbpjssyinozap.supabase.co/functions/v1/partner-api/v1/agencies/AG-1234/listings" \
  -H "Authorization: Bearer abk_live_xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"mode":"partial","listings":[{"reference":"MANDAT-0456","transaction":"vente","type_bien":"maison","prix":520000,"ville":"Mougins","surface":120,"pieces":5,"dpe":"B","ges":"B","photos":["https://exemple.fr/1.jpg"]}]}'

Bon à savoir