Endpoint
URL :/external-integration/ad/search
Méthode : GET
Authentification : Requiert un token LinkedAPI avec scope externalIntegration et une clé rattachée à un groupe d’agences.
Clé requise : toutes les clés (lecture seule suffit). Voir Types de clé.
Headers
Query Parameters
Pagination
- Taille de page fixe : 50 annonces.
- Itérez jusqu’à
hasMore: false. - Le champ de taille de page de la réponse s’appelle ici
pageSize— maislimitsur GET Contacts, GET Users et GET Transaction Search. Même sens, deux noms : lisez celui de la route que vous appelez.
Exemples de requête
Réponse de succès
Code :200
Aucun résultat
Champs de la réponse
Chaque élément deads reprend les mêmes champs que GET Ad (id, reference, status, title, surface, salePrice, location, pictures, transactionType, owner, etc.). Les champs non renseignés sont absents de la réponse.
Réponses d’erreur
statusinvalide :400 Bad Request
- LinkedAPI agencyGroup manquant :
400 Bad Request
- Header
Authorizationabsent, ou IP non whitelistée sur une clé sécurisée :403 Not authorized to access this resource
- Token invalide :
401 Invalid bearer token
Notes
- Scope : seules les annonces de votre périmètre autorisé sont retournées.
- Pagination : 50 annonces par page. Itérez jusqu’à
hasMore: false. - Filtres :
transactionetstatussont combinables. Sans filtre, toutes les annonces du périmètre sont retournées. - Médias : les
picturessont des URLs CloudFront publiques. - Endpoint en lecture seule.
Rate limits
Cette route est limitée à 200 req / minute par groupe d’agences (bucket dédié).- Headers :
RateLimit-Limit,RateLimit-Remaining,RateLimit-Reset(secondes avant reset). - Dépassement →
429 Too Many Requestsavec headerRetry-After: