Skip to content

Latest commit

 

History

History
124 lines (93 loc) · 6.15 KB

README.md

File metadata and controls

124 lines (93 loc) · 6.15 KB
Raw


Tired of searching with your mouse ? Let's automate the process.

Codacy Badge PyPI version Downloads release documentation Codacy Security Scan

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

pip install immosheets

Write your script

This is meant to be used as a package for your bot.

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)

Genereting credentials

Third party Instructions
To learn how to create credentials, go to 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.
Write to [email protected], they'll give you access to their private "SeLoger" API with free 500 calls per month. Thanks @julienbonnet50 for investigating.
Nothing to do.
Work in progress.
Work in progress.

Check out examples for more.

For contributors

To install development dependencies

pip install -r requirements.txt

To install the package locally with your new code inside

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 few integrations ideas:

  • Excel
  • MongoDB
  • MySQL
  • ElasticSearch
  • Persist data as a File (JSON, XML, CSV)
  • Explorimmo
  • meilleursagents.com
  • apimo.net