Logic-Immo Agency API returns an agency profile: name, logo, description, address with coordinates, legal details (company name, legal form, share capital, SIREN, SIRET, professional card, financial guarantee), contact points, opening hours, social links, services, languages, rating, listing counts, every listing id with its position and the reviews on the page. The agency id is provider.agency_id in search results and listing detail. An unknown agency returns 404 and is not billed.
Good to know: full listing cards are included for only a few listings. Open the rest with the listing route.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
1 required parameter needed before sending a request.
string
Required
Agency id from search or listing results. Example: B6HPBdNxeEw1nSFC7vJnzm.
1234567890
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"data": {
"id": "B6HPBdNxeEw1nSFC7vJnzm",
"name": "PARIS MARAIS SOTHEBY S IR",
"legal": {
"siren": "832584809",
"siret": "83258480900012",
"rcs_city": "PARIS",
"legal_form": "SARL",
"prefecture": null,
"company_name": "PARIS OUEST REALTY",
"social_capital": 10000,
"registration_number": "83258480900012",
"financial_guarantee_fund": "GALIAN",
"professional_card_number": "75012019000041551",
"financial_guarantee_amount": 120000
},
"links": {
"youtube": "https://www.youtube.com/channel/UCUTx-9iAih5seXyXwRqmvAA",
"facebook": "https://www.facebook.com/ParisOuestSothebysInternationalRealty?ref=hl"
},
"rating": {
"count": 91,
"value": 4.7
},
"address": {
"city": "PARIS",
"street": "39 RUE DE TURENNE",
"country": "fr",
"zip_code": "75003",
"published": true
},
"network": null,
"reviews": [
{
"id": "7125375",
"date": "2026-10-04T00:00:00.000Z",
"text": "Premier contact tr\u00e8s en confiance \u00e0 Mme Mantel qui a su nous accompagner tout au long de l\u2019acquisition de notre bien avec bienveillance et disponibilit\u00e9.",
"rating": 5,
"language": "fr",
"reviewer_name": "A. B."
},
{
"id": "7089840",
"date": "2026-09-09T00:00:00.000Z",
"text": "Super accompagnement, des agents qui r\u00e9pondent vite, et tres sympathique. J\u2019ai pu avoir acc\u00e8s \u00e0 tout les documents tr\u00e8s rapidement, et sans probl\u00e8mes !",
"rating": 5,
"language": "fr",
"reviewer_name": "A. B."
}
],
"listings": [
{
"id": "26SI4MLVFTZH",
"url": "https://www.logic-immo.com/detail-annonce/vente/ile-de-france/paris-75/paris-75000/26SI4MLVFTZH",
"tags": {
"new": true,
"exclusive": false,
"brokerage_fee": false,
"virtual_visit_3d": true
},
"type": "PROFESSIONAL",
"brand": "logicimmo",
"dates": {
"created_at": "2026-10-22T10:44:00Z",
"updated_at": "2026-10-23T10:26:10.736Z"
},
"facts": [
{
"type": "numberOfRooms",
"label": "pi\u00e8ces",
"value": "5 pi\u00e8ces"
}
],
"price": {
"value": 1240000,
"currency": "EUR",
"formatted": "1\u202f240\u202f000\u00a0\u20ac",
"on_request": false,
"per_sqm_text": "10\u202f783,55\u00a0\u20ac/m\u00b2"
},
"rooms": 5,
"title": "Appartement \u00e0 vendre",
"images": [
{
"alt": "Appartement \u00e0 vendre 1\u202f240\u202f000\u00a0\u20ac 5 pi\u00e8ces 3 chambres 115 m\u00b2 \u00c9tage 4/6 Paris 12\u00e8me arrondissement 75012",
"url": "https://cdnihddipa.cloudimg.io/e/3/7/d/e37d3022-6e4f-431a-8498-54bf878ee41f.jpg?ci_seal=b82857f0c70c2483d569ca6e85054112ecc7d08c",
"class": null
},
{
"alt": null,
"url": "https://cdnihddipa.cloudimg.io/c/3/8/e/c38ef17e-d3d2-4e61-b19d-cd29c8ff960a.jpg?ci_seal=e6b1c53c2ff55122e9ced07c11062768bb157efa",
"class": null
}
],
"portal": "logicimmo",
"status": "Published",
"address": {
"city": "Paris 12\u00e8me arrondissement",
"district": "Aligre-Gare de Lyon",
"zip_code": "75012"
},
"surface": {
"main_sqm": 114.99,
"plot_sqm": null
},
"bedrooms": 3,
"headline": "Paris 12\u00e8me - Aligre / Gare de Lyon - Appartement haussmannien b",
"provider": {
"name": "PARIS MARAIS SOTHEBY S IR",
"phones": [
"+33100000000"
],
"address": "39 RUE DE TURENNE, 75003 PARIS",
"fee_url": "https://www.parisouest-sothebysrealty.com/fr/mentions-legales-bareme/",
"website": null,
"logo_url": "https://cdnihddipa.cloudimg.io/9/7/9/c/979cd793-ab50-4385-b043-060b1fe71d97.jpg?ci_seal=20b9d6786fadbfb2af562b6a072218691d99c168",
"agency_id": "B6HPBdNxeEw1nSFC7vJnzm",
"profile_url": "https://www.logic-immo.com/agences-immobilieres/B6HPBdNxeEw1nSFC7vJnzm",
"private_owner": false,
"publisher_type": "AGENCY",
"legal_information": [
"SARL PARIS OUEST REALTY au capital de 10\u202f000\u00a0\u20ac",
"Garantie financi\u00e8re GALIAN pour un montant de 120\u202f000\u00a0\u20ac"
]
},
"reference": "283257567",
"transport": [
{
"type": "METRO",
"lines": [
{
"name": "1",
"color": "#ffcd00"
}
]
}
],
"floorplans": [],
"coordinates": {
"latitude": 48.84657107021485,
"longitude": 2.370265064273393
},
"description": "Paris 12\u00e8me - Aligre / Gare de Lyon. Au sein d'un bel immeuble ancien datant de 1902, au 4\u00e8me \u00e9tage avec ascenseur, nous vous proposons un appartement bourgeois de 4 pi\u00e8ces d'une superficie de 114,99 m\u00b2 loi Carrez. Vous serez s\u00e9duit par sa luminosit\u00e9 exceptionnelle, ses volumes g\u00e9n\u00e9reux et son charm",
"photo_count": 14,
"short_title": "Appartement",
"distribution": "BUY",
"energy_class": "D",
"is_suggestion": false,
"property_type": "APARTMENT",
"has_detail_page": true,
"place_hierarchy": [
{
"id": "AD09FR37",
"type_key": "AD09"
}
],
"year_of_construction": 1902
},
{
"id": "24BW5WR1EZR8",
"coordinates": {
"latitude": 48.85886926018233,
"longitude": 2.362502721903317
}
}
],
"services": [
"BUY_SELL_REAL_ESTATE",
"ESTIMATION"
],
"image_url": "https://mms.logic-immo.com/9/7/9/c/979cd793-ab50-4385-b043-060b1fe71d97.jpg?ci_eqs=&ci_seal=20b9d6786fadbfb2af562b6a072218691d99c168&w=240",
"languages": [
"fr",
"de"
],
"coordinates": {
"latitude": 48.85719,
"longitude": 2.364324
},
"description": "Paris Marais Sotheby's International Realty vous apporte son expertise pour l'avis de valeur, l'acquisition ou la vente de votre bien immobilier. Situ\u00e9e au 39, rue de Turenne - 75003 Paris, l'agence commercialise des biens de prestige dans les quartiers suivants : Place des Vosges, H\u00f4tel de ville, S",
"opening_hours": [],
"contact_points": [
{
"type": "DEFAULT",
"email": "contact@example.test",
"mobile": null,
"telephone": "+33100000000"
},
{
"type": "RENT",
"email": null,
"mobile": null,
"telephone": "01 00 00 00 00"
}
],
"listing_counts": {
"sold": 0,
"rented": 0,
"for_rent": 0,
"for_sale": 39,
"new_build": 0
},
"intermediary_type": "AGENCY"
},
"meta": {
"billable": true,
"endpoint_family": "agency"
},
"success": true
}Errors
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
The agency id is missing or malformed. This response is not billable.
{
"errors": {
"q": [
"The q field is required."
]
},
"message": "The request validation failed"
}Not Found
The agency does not exist. This response is not billable.
{
"meta": {
"billable": false,
"retryable": false,
"endpoint_family": "agency"
},
"error": {
"code": "NOT_FOUND",
"message": "The requested resource was not found."
},
"success": false
}Upstream Unavailable
Logic-Immo could not be reached, or returned data that does not match the expected shape. Retry shortly. This response is not billable.
{
"meta": {
"billable": false,
"retryable": true,
"endpoint_family": "agency"
},
"error": {
"code": "UPSTREAM_UNAVAILABLE",
"message": "Logic-Immo could not be reached. Please retry shortly."
},
"success": false
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.