{"id":21348541,"url":"https://github.com/igor-ad/olx-watcher","last_synced_at":"2026-05-06T13:37:27.955Z","repository":{"id":226298537,"uuid":"768305564","full_name":"Igor-ad/olx-watcher","owner":"Igor-ad","description":"Tracking OLX product prices and price changes","archived":false,"fork":false,"pushed_at":"2025-01-30T12:12:16.000Z","size":217,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-30T13:22:45.636Z","etag":null,"topics":["api-rest","cli-application","cron-job","docker","docker-compose","email-sender","file-storage","logger","mit-license","olx","php","php8","price-tracker","redis-cache","watcher"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Igor-ad.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-03-06T20:59:27.000Z","updated_at":"2025-01-30T12:12:19.000Z","dependencies_parsed_at":"2024-03-20T16:29:03.476Z","dependency_job_id":"6c23502d-dba2-4efa-9643-86445250084b","html_url":"https://github.com/Igor-ad/olx-watcher","commit_stats":null,"previous_names":["igor-ad/olx-watcher"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Igor-ad%2Folx-watcher","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Igor-ad%2Folx-watcher/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Igor-ad%2Folx-watcher/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Igor-ad%2Folx-watcher/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Igor-ad","download_url":"https://codeload.github.com/Igor-ad/olx-watcher/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243822931,"owners_count":20353575,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["api-rest","cli-application","cron-job","docker","docker-compose","email-sender","file-storage","logger","mit-license","olx","php","php8","price-tracker","redis-cache","watcher"],"created_at":"2024-11-22T02:22:40.015Z","updated_at":"2025-10-29T19:36:08.316Z","avatar_url":"https://github.com/Igor-ad.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# olx-watcher\n\nTracking OLX product prices and price changes\n\n![License MIT](https://img.shields.io/badge/License-MIT-blue)\n[![Supported PHP Versions](https://img.shields.io/badge/PHP-8.2,%208.3,%208.4-blue)](https://github.com/Igor-ad/olx-watcher/)\n![GitHub release](https://img.shields.io/badge/Release-1.2.0-green)\n\n### Requirements:\n\nPHP ^8.2, composer, git, docker, redis or file storage,\ncomposer/autoload psr-4\n\n```\nInit cmd:\ncd /projects\ngit clone https://github.com/Igor-ad/olx-watcher.git\ncd /projects/olx-watcher\ncp ./src/config.ini.examlpe ./src/config.ini\nchmod 777 ./src/olx_watcher.log\nchmod 777 ./src/subscribe.db\ncomposer install\ndocker-compose up\n```\n\nIn the last version of the application implements a replacement of the storage type. Changed JSON storage to serialized\nstorage. The storage now stores serialized Subject objects instead of object hashes as arrays.\n\nProduct price checking service: OlxWatcher\\Services\\WatcherService\n\nSubscription Service: OlxWatcher\\Services\\SubscribeService\n\nParser script of products price: OlxWatcher\\Parsers\\Parser\n\nSaving subscribers and prices of products is implemented in serialized storage in the file: src/subscribe.db\n\nPossible to use file cache \u0026 SubjectCollection: OlxWatcher\\Database\\FileRepository\nor Redis cache \u0026 SubjectCollection: OlxWatcher\\Database\\RedisRepository.\n\nSample subscription storage file: src\\subscribe_example.db\n\nThe mailing uses sendmail: OlxWatcher\\Notifiers\\MailNotifier.\n\nAll operations are logged to the file:  src/olx_watcher.log.\n\nTo subscribe, you need to make a GET request with two parameters:\nyour email address and URL of the source OLX - advertisements for the sale of product.\n\nExample:\n\n```\nhttp://example-olx-watcher?status=subscribe\u0026email=test@mail.com\u0026url=https://www.olx.ua/powerbank.html\n```\n\nTo unsubscribe from all subscriptions you must send a GET request:\n\n```\nhttp://example-olx-watcher?email=test@mail.com\u0026status=unsubscribe\n```\n\nThe cron script checks every 15 minutes for changes in the price of a product and, if there is a change, sends emails to\nsubscribers.\n\nFor example, the structure of the Subject subscription object is given as a JSON array. In the last version, these are\nserialized Subject objects.\n\n```\n{\n    \"https://www.olx.ua/d/uk/obyavlenie/korpus-ups-dbzh-ups-dlya-routera-SdWRvYr.html\": {\n        \"previous_price\": \"120\",\n        \"last_price\": \"120\",\n        \"previous_time\": \"2025-01-07 08:28:35\",\n        \"last_time\": \"2025-01-07 08:28:35\",\n        \"subscribers\": [\n            \"test3@mail.com\",\n            \"test4@mail.com\",\n            \"test1@mail.com\",\n            \"test2@mail.com\"\n        ],\n        \"has_update\": true\n    },\n    \"https://www.olx.ua/d/uk/obyavlenie/samsung-inr-18650-35e-DSrAt.html\": {\n        \"previous_price\": \"80\",\n        \"last_price\": \"80\",\n        \"previous_time\": \"2025-01-07 08:43:06\",\n        \"last_time\": \"2025-01-07 08:43:06\",\n        \"subscribers\": [\n            \"test1@mail.com\",\n            \"test2@mail.com\",\n            \"test3@mail.com\"\n        ],\n        \"has_update\": false\n    }\n}\n```\n\n### Example email:\n\n![image](public/test_mail.jpg)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Figor-ad%2Folx-watcher","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Figor-ad%2Folx-watcher","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Figor-ad%2Folx-watcher/lists"}