api

API Deal&Co

v1

Publiez des annonces automobiles et immobilières directement depuis votre logiciel de gestion, site de diffusion, ou outil d'automatisation (Make, Zapier, n8n…).

loginSe connecter pour obtenir une clé
lock

Sécurisé

HTTPS + clé API Bearer par compte

bolt

Instantané

Annonce en ligne dès la requête

business

Réservé aux pros

Comptes professionnels uniquement

lockAuthentification

Toutes les requêtes doivent inclure votre clé dans le header Authorization.

  1. 1Connectez-vous avec un compte professionnel
  2. 2Rendez-vous dans Mon profil → API
  3. 3Donnez un nom à votre clé et cliquez sur "Générer"
  4. 4Copiez la clé — elle n'est affichée qu'une seule fois
Header à inclure dans chaque requête
Authorization: Bearer dc_live_xxxxxxxxxxxxxxxxxxxxxxxx
Content-Type: application/json
warning

Votre clé commence toujours par dc_live_. Ne la partagez jamais — elle donne accès à votre compte.

rocket_launchDémarrage rapide

Publiez votre première annonce en 30 secondes.

cURL — exemple minimal
curl -X POST https://www.dealandcompany.fr/api/v1/listings \
  -H "Authorization: Bearer dc_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"title":"BMW 320d","price":15900,"category":"Véhicules","description":"...","location":"Paris 75001"}'

Réponse · 201 Created

{
  "ok": true,
  "id": "clxyz1234abcd",
  "url": "https://www.dealandcompany.fr/annonce/clxyz1234abcd",
  "status": "APPROVED",
  "createdAt": "2026-04-15T14:32:00.000Z"
}

Le champ url contient le lien direct vers l'annonce publiée.

list_altChamps requis

ChampTypeDescription
titlerequis
stringTitre de l'annonce (3–200 caractères)
pricerequis
numberPrix en euros (≥ 0)
categoryrequis
stringVéhicules · Immobilier · Multimédia · Mode · Maison · Loisirs · Animaux · Services · Divers
descriptionrequis
stringDescription complète (10–10 000 caractères)
locationrequis
stringVille et code postal (ex : Paris 75001)
subcategory
stringSous-catégorie (optionnel)
condition
stringNeuf · Très bon état · Bon état · État correct · Pour pièces
phone
stringNuméro de téléphone du vendeur
hidePhone
booleantrue pour masquer le numéro au public
images
string[]URLs des photos (max 15 — voir section Photos)
vehicle
objectDétails du véhicule (si category = Véhicules)
immo
objectDétails du bien immobilier (si category = Immobilier)

photo_libraryPhotos

Uploadez les photos via POST /api/v1/upload, puis passez les URLs dans le champ images.

Format

multipart/form-data

Champ

file

Taille max

10 Mo / photo

Types

JPEG, PNG, WebP, GIF

Max photos

15 par annonce

Stockage

Vercel Blob CDN

Workflow upload + annonce
# Étape 1 — Uploader la photo
curl -X POST https://www.dealandcompany.fr/api/v1/upload \
  -H "Authorization: Bearer dc_live_xxx" \
  -F "file=@/chemin/vers/photo.jpg"

# Réponse
{ "url": "https://xxx.blob.vercel-storage.com/uploads/photo.jpg" }

# Étape 2 — Utiliser l'URL dans l'annonce
{
  "title": "...",
  "images": ["https://xxx.blob.vercel-storage.com/uploads/photo.jpg"]
}

errorCodes d'erreur

201

Created

Annonce créée avec succès.

400

Bad Request

Champ requis manquant ou invalide.

401

Unauthorized

Clé API absente, invalide ou révoquée.

429

Too Many Reqs

Trop de requêtes. Patientez avant de réessayer.

500

Server Error

Erreur interne. Réessayez dans quelques secondes.

Prêt à intégrer l'API ?

Créez votre clé API en quelques secondes depuis votre espace professionnel.

loginSe connecter pour obtenir une clé