{"uid":"cap_pOCvt9ttntvOZlrwuESWq","slug":"bien-ici-french-real-estate-listings-c8c241ec","name":"Bien'ici French Real Estate Listings","description":"Pay-per-call job market and real estate data tools for AI agents, from official and public sources. Payment: x402, USDC on Base, Solana, Arc, Polygon, Arbitrum, Monad, World Chain, Optimism, Avalanche, Celo or Stellar, or RLUSD/XRP on the XRP Ledger. No signup, no API key; a failed call is not charged.","url":"https://api.jobsproperty-api.workers.dev/api/realestate/bienici-real-estate?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["place"],"properties":{"deal":{"type":"string","description":"buy (default) or rent"},"type":{"type":"string","description":"flat (default), house, parking or land"},"limit":{"type":"string","description":"Ads to return, 1 to 50 (default 20)"},"place":{"type":"string","description":"City or area name, e.g. paris, lyon, bordeaux (required)"},"maxPrice":{"type":"string","description":"Optional maximum price in EUR"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"ads":[{"id":"ag754691-538488038","url":"https://www.bienici.com/annonce/vente/ag754691-538488038","city":"Paris 20e","rooms":1,"title":"Cave bas Ménilmontant","agency":"PRIMAS immobilier","bedrooms":null,"district":"Ménilmontant - Amandiers","newBuild":false,"priceEur":23000,"surfaceM2":16,"postalCode":"75020","pricePerM2":1438,"energyClass":"NS","priceDropped":false,"propertyType":"flat"},{"id":"laforet-immo-facile-52877953","url":"https://www.bienici.com/annonce/vente/laforet-immo-facile-52877953","city":"Paris 2e","rooms":1,"title":"PARIS 2e RUE DE RICHELIEU - CHAMBRE INDÉPENDANTE AU DERNIER ÉTAGE","agency":"Laforêt PARIS 1&2","bedrooms":null,"district":"Gaillon - Vivienne","newBuild":false,"priceEur":35000,"surfaceM2":4.2,"postalCode":"75002","pricePerM2":8333,"energyClass":"NS","priceDropped":true,"propertyType":"flat"}],"deal":"buy","type":"flat","count":5,"place":{"name":"Paris","type":"city","zoneIds":["-7444"],"postalCodes":["75000"]},"total":9658,"source":"https://www.bienici.com/realEstateAds.json","checkedAt":"2026-10-23T09:36:58.838Z"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_th7MOkiV2UQCx0yL3oMBc","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns French property listings from Bien'ici for a given city or area, with full ad details including price, surface, rooms, energy class, and agency.","exampleAgentPrompt":"Can you pull up flats for sale in Lyon from Bien'ici — show me up to 30 results and filter to a max price of 300,000 EUR?","exampleUseCases":[{"title":"Apartment hunting in Paris","prompt":"Search Bien'ici for flats to buy in Paris, show me 20 results — I want to see the price per m², district, energy class, and whether any prices have been dropped recently."},{"title":"Rental home search in Bordeaux","prompt":"Find houses to rent in Bordeaux on Bien'ici and show me up to 25 listings with their prices, surface areas, and agency names."},{"title":"Affordable parking spot search","prompt":"Look for parking spots for sale in Lyon under 20,000 EUR on Bien'ici and tell me how many total results there are."}],"resultDescription":"A JSON object containing an array of property ads (up to 50), each with id, URL, title, city, postal code, district, price in EUR, price per m², surface in m², room count, bedroom count, property type, energy class, agency name, new-build flag, and price-dropped flag; plus the deal type, property type filter, place metadata (name, type, zone IDs, postal codes), total matching ad count, data source URL, and timestamp of retrieval.","failureModes":["Unknown or misspelled place name returns empty results or an error","Limit parameter out of range (1-50) may be rejected or clamped","Bienici source site unavailable causes a fetch failure","No listings matching the filters returns an empty ads array with total 0","Invalid deal or type enum values may cause unexpected results"],"whenToPreferThis":"Use this endpoint when you need structured French property listings with rich metadata (price/m², energy class, district, agency, new-build/price-drop flags) from Bien'ici. Prefer it over generic web scraping when you need clean, parseable JSON for French cities. Choose this for buy or rent searches across flats, houses, parking, and land in France.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T00:34:29.457Z","isFirstParty":false,"canonicalSlug":"bien-ici-french-real-estate-listings-c8c241ec"}