{"id":34051661,"url":"https://github.com/arthurhd/immosheets","last_synced_at":"2026-04-06T02:01:43.408Z","repository":{"id":46330376,"uuid":"515280180","full_name":"arthuRHD/immosheets","owner":"arthuRHD","description":"Tired of searching with your mouse ? Let's automate the process. 🚀","archived":false,"fork":false,"pushed_at":"2025-10-27T16:03:17.000Z","size":699,"stargazers_count":45,"open_issues_count":19,"forks_count":10,"subscribers_count":2,"default_branch":"master","last_synced_at":"2026-01-14T11:29:02.503Z","etag":null,"topics":["automation","data","google-sheets","google-sheets-api","immosheets","leboncoin","open-source","orpi","pypi","python","real-estate","seloger","sheets-api"],"latest_commit_sha":null,"homepage":"https://immosheets.io/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/arthuRHD.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"arthuRHD"}},"created_at":"2022-07-18T17:30:04.000Z","updated_at":"2025-06-19T18:14:47.000Z","dependencies_parsed_at":"2023-02-11T05:10:15.808Z","dependency_job_id":"f5379a51-5892-4e5c-b80a-c83066481d23","html_url":"https://github.com/arthuRHD/immosheets","commit_stats":{"total_commits":20,"total_committers":5,"mean_commits":4.0,"dds":"0.19999999999999996","last_synced_commit":"f0de3909a8baad8e46ddb78b5b4d3c14c0e4d311"},"previous_names":["arthurhd/seloger-google-sheets"],"tags_count":11,"template":false,"template_full_name":null,"purl":"pkg:github/arthuRHD/immosheets","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arthuRHD%2Fimmosheets","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arthuRHD%2Fimmosheets/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arthuRHD%2Fimmosheets/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arthuRHD%2Fimmosheets/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/arthuRHD","download_url":"https://codeload.github.com/arthuRHD/immosheets/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arthuRHD%2Fimmosheets/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31456664,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-05T21:22:52.476Z","status":"online","status_checked_at":"2026-04-06T02:00:07.287Z","response_time":112,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["automation","data","google-sheets","google-sheets-api","immosheets","leboncoin","open-source","orpi","pypi","python","real-estate","seloger","sheets-api"],"created_at":"2025-12-14T01:33:26.723Z","updated_at":"2026-04-06T02:01:43.403Z","avatar_url":"https://github.com/arthuRHD.png","language":"Python","readme":"\u003cdiv id=\"header\" align=\"center\"\u003e\n  \u003cimg src=\"SVGLogo.svg\"/\u003e\u003cbr\u003e\u003cbr\u003e\n    \u003cp\u003e\u003cstrong\u003e\u003cem\u003eTired of searching with your mouse ? Let's automate the process.\u003c/em\u003e\u003c/strong\u003e\u003c/p\u003e\n    \u003ca href=\"https://app.codacy.com/project/badge/Grade/ba1afb9f8ffe402ca6a31a30ba63b628\"\u003e\n      \u003cimg src=\"https://app.codacy.com/project/badge/Grade/ba1afb9f8ffe402ca6a31a30ba63b628\" alt=\"Codacy Badge\"\u003e\n   \u003c/a\u003e\n   \u003ca href=\"https://badge.fury.io/py/immosheets\"\u003e\n      \u003cimg src=\"https://badge.fury.io/py/immosheets.svg\" alt=\"PyPI version\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://pepy.tech/project/immosheets\"\u003e\n     \u003cimg src=\"https://static.pepy.tech/badge/immosheets\" alt=\"Downloads\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/arthuRHD/immosheets/actions/workflows/python-publish.yml\"\u003e\n    \u003cimg src=\"https://github.com/arthuRHD/immosheets/actions/workflows/python-publish.yml/badge.svg\" alt=\"release\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/arthuRHD/immosheets/actions/workflows/documentation-publish.yml\"\u003e\n    \u003cimg src=\"https://github.com/arthuRHD/immosheets/actions/workflows/documentation-publish.yml/badge.svg\" alt=\"documentation\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/arthuRHD/immosheets/actions/workflows/codacy.yml\"\u003e\n    \u003cimg src=\"https://github.com/arthuRHD/immosheets/actions/workflows/codacy.yml/badge.svg\" alt=\"Codacy Security Scan\"\u003e\n  \u003c/a\u003e\n\u003c/div\u003e\n\u003cbr\u003e\n\n## Description :\n+ Introducing \"**immosheets**\", a tool that streamlines your search process by automating it. \n+ 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. \n+ 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. \n\n\u003cdiv align=\"center\"\u003e\n\u003ch3\u003eTry immosheets out today and see the difference for yourself!\u003ch3\u003e\n\u003c/div\u003e\n\n\n\n## Usage\n\n### Install\n\n```sh\npip install immosheets\n```\n\n### Write your script\n\nThis is meant to be used as a package for your bot.\n\n```py\nfrom immosheets import (SelogerService, SelogerSearchQuery, SelogerRealEstateFilter, \nSelogerRealEstateType, SelogerTransactionType, GoogleSpreadsheetsService)\n\n\nseloger = SelogerService(api_key='my_seloger_api_key')\ngoogle_sheets = GoogleSpreadsheetsService(credentials_file_path='./credentials.json')\n\nquery = SelogerSearchQuery(\n    maximumPrice=\"800\",\n    zipCodes=\"76300,76800,76000\",\n    includeNewConstructions=\"false\",\n    transactionType=SelogerTransactionType.RENT,\n    realtyTypes=SelogerRealEstateType.APPARTMENT,\n    sortBy=SelogerRealEstateFilter.NEWEST\n)\n\ngoogle_sheets.use(\"my_sheet_id\").clear().add_headers()\n\nfor result in seloger.search(query):\n    google_sheets.insert(result)\n```\n## Generating credentials\n\n| **Third party** | **Instructions**                                                                                                                                                                                                                                                                                                                     |\n|-----------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| [\u003cimg src=\"https://kstatic.googleusercontent.com/files/adf55cdf4c7f8fb38efbf8df6c2792660fbeff2d05be05f2ec8e9c265a179b51c64b9679d8aee00e09cad19ce419d90a2d999b82cea4200abbe78c73e6bfaacf\" width=100\u003e](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. |\n| [\u003cimg src=\"https://is1-ssl.mzstatic.com/image/thumb/Purple112/v4/bf/64/69/bf646951-e676-9162-1300-4e9a3beb1a8f/AppIcon-0-1x_U007emarketing-0-7-0-85-220.png/256x256bb.jpg\" width=100\u003e](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. |\n| [\u003cimg src=\"https://static.orpi.com/images/orpibackend/default/5c6e83b340014_Orpi_picto_Agences%20ORPI_ROUGE.png\" width=100\u003e](https://www.orpi.com/) | Nothing to do. |\n|  [\u003cimg src=\"https://www.erafrance.com/assets/imgs/era-logo-national.svg\" width=100\u003e](https://www.erafrance.com) | Work in progress. |\n| [\u003cimg src=\"https://www.ouestfrance-immo.com/photo-laforet-guingamp/client/1498/laforet-guingamp-1498logo.jpg\" width=100\u003e](https://www.laforet.com/) | Work in progress. |\n\nCheck out examples for more.\n\n## For contributors\n\nTo install development dependencies\n\n```sh\npip install -r requirements.txt\n```\n\nTo install the package locally with your new code inside\n\n```sh\npip install -e .\n```\n\nThere are no unit tests or documentation currently, we're working on that.\n\n## Integration\n\n+ At this time, I am able to integrate with seloger.com and Google Sheets.\n+ I am currently in the process of implementing support for Leboncoin.\n+ If you would like me to integrate with any other third-party platforms, please submit a request in the form of an issue.\n+ Additional integrations beyond seloger.com and Google Sheets are being considered and are open for request through the creation of an issue.\n+ Your suggestions will be taken into consideration and evaluated for feasibility and compatibility with my current system.\n+ We appreciate your feedback and suggestions as it helps us to improve and expand my capabilities to better serve you!\n\n### You can actually write your own integration based on defaults abstract classes located at the root of the package :\n\n- 'RealEstateService' for data acquisition\n- 'ReportingService' to display and manage data\n    \n    \n### Integration Ideas \n    \nHere's a few integrations ideas:\n\n- Excel\n- MongoDB\n- MySQL\n- ElasticSearch\n- Persist data as a File (JSON, XML, CSV)\n- Explorimmo\n- meilleursagents.com\n- apimo.net\n","funding_links":["https://github.com/sponsors/arthuRHD"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Farthurhd%2Fimmosheets","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Farthurhd%2Fimmosheets","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Farthurhd%2Fimmosheets/lists"}