https://github.com/arthurhd/immosheets
Tired of searching with your mouse ? Let's automate the process. 🚀
https://github.com/arthurhd/immosheets
automation data google-sheets google-sheets-api immosheets leboncoin open-source orpi pypi python real-estate seloger sheets-api
Last synced: 22 days ago
JSON representation
Tired of searching with your mouse ? Let's automate the process. 🚀
- Host: GitHub
- URL: https://github.com/arthurhd/immosheets
- Owner: arthuRHD
- License: mit
- Created: 2022-07-18T17:30:04.000Z (almost 4 years ago)
- Default Branch: master
- Last Pushed: 2025-10-27T16:03:17.000Z (6 months ago)
- Last Synced: 2026-01-14T11:29:02.503Z (3 months ago)
- Topics: automation, data, google-sheets, google-sheets-api, immosheets, leboncoin, open-source, orpi, pypi, python, real-estate, seloger, sheets-api
- Language: Python
- Homepage: https://immosheets.io/
- Size: 683 KB
- Stars: 45
- Watchers: 2
- Forks: 10
- Open Issues: 19
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
Tired of searching with your mouse ? Let's automate the process.
## Description :
+ Introducing "**immosheets**", a tool that streamlines your search process by automating it.
+ No more tedious mouse clicking and scrolling through search results. With **immosheets**, you can quickly and easily find what you're looking for with just a few simple commands.
+ Whether you're a developer looking for code snippets or a researcher scouring the web for information, **immosheets** can help you save time and increase your productivity.
Try immosheets out today and see the difference for yourself!
## Usage
### Install
```sh
pip install immosheets
```
### Write your script
This is meant to be used as a package for your bot.
```py
from immosheets import (SelogerService, SelogerSearchQuery, SelogerRealEstateFilter,
SelogerRealEstateType, SelogerTransactionType, GoogleSpreadsheetsService)
seloger = SelogerService(api_key='my_seloger_api_key')
google_sheets = GoogleSpreadsheetsService(credentials_file_path='./credentials.json')
query = SelogerSearchQuery(
maximumPrice="800",
zipCodes="76300,76800,76000",
includeNewConstructions="false",
transactionType=SelogerTransactionType.RENT,
realtyTypes=SelogerRealEstateType.APPARTMENT,
sortBy=SelogerRealEstateFilter.NEWEST
)
google_sheets.use("my_sheet_id").clear().add_headers()
for result in seloger.search(query):
google_sheets.insert(result)
```
## Generating credentials
| **Third party** | **Instructions** |
|-----------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [
](https://www.google.fr/intl/fr/sheets/about/) | To learn how to create credentials, go to [Create credentials](https://developers.google.com/workspace/guides/create-credentials). Once you create the credentials, make sure the downloaded JSON file is saved as credentials.json. Then move the file to your working directory and fill the path when instanciating the service. |
| [
](https://www.seloger.com/) | Write to apidojo@gmail.com, they'll give you access to their private "SeLoger" API with free 500 calls per month. Thanks [@julienbonnet50](https://github.com/julienbonnet50) for investigating. |
| [
](https://www.orpi.com/) | Nothing to do. |
| [
](https://www.erafrance.com) | Work in progress. |
| [
](https://www.laforet.com/) | Work in progress. |
Check out examples for more.
## For contributors
To install development dependencies
```sh
pip install -r requirements.txt
```
To install the package locally with your new code inside
```sh
pip install -e .
```
There are no unit tests or documentation currently, we're working on that.
## Integration
+ At this time, I am able to integrate with seloger.com and Google Sheets.
+ I am currently in the process of implementing support for Leboncoin.
+ If you would like me to integrate with any other third-party platforms, please submit a request in the form of an issue.
+ Additional integrations beyond seloger.com and Google Sheets are being considered and are open for request through the creation of an issue.
+ Your suggestions will be taken into consideration and evaluated for feasibility and compatibility with my current system.
+ We appreciate your feedback and suggestions as it helps us to improve and expand my capabilities to better serve you!
### You can actually write your own integration based on defaults abstract classes located at the root of the package :
- 'RealEstateService' for data acquisition
- 'ReportingService' to display and manage data
### Integration Ideas
Here's a few integrations ideas:
- Excel
- MongoDB
- MySQL
- ElasticSearch
- Persist data as a File (JSON, XML, CSV)
- Explorimmo
- meilleursagents.com
- apimo.net