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.
- **Documentation:** [https://scrappa.co/docs/logic-immo-api/logic_immo_agency](https://scrappa.co/docs/logic-immo-api/logic_immo_agency) - **API group:** Logic-Immo API - **Endpoint:** `GET https://scrappa.co/api/logic-immo/agency` ## Authentication Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key. ## Parameters | Parameter | Type | Required | Description | | --- | --- | --- | --- | | `id` | string | Yes | Agency id from search or listing results. Example: B6HPBdNxeEw1nSFC7vJnzm. | ## Example response ```json { "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 | Status | Error | Description | | --- | --- | --- | | 422 | Validation Error | The agency id is missing or malformed. This response is not billable. | | 404 | Not Found | The agency does not exist. This response is not billable. | | 503 | 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. | ## More Scrappa resources - [API documentation](https://scrappa.co/docs) - [Full LLM-readable API reference](https://scrappa.co/llms-full.txt) - [OpenAPI specification](https://scrappa.co/docs/api.json) - [Pricing](https://scrappa.co/pricing)