{"id":22080566,"url":"https://github.com/electronic-mango/wowhead-news-rss-filter","last_synced_at":"2026-05-04T02:40:07.675Z","repository":{"id":172737132,"uuid":"648645305","full_name":"Electronic-Mango/wowhead-news-rss-filter","owner":"Electronic-Mango","description":"Wowhead news RSS filter.","archived":false,"fork":false,"pushed_at":"2024-06-15T13:04:11.000Z","size":34,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-29T04:24:33.840Z","etag":null,"topics":["api","fastapi","python","python3","rss","wowhead"],"latest_commit_sha":null,"homepage":"","language":"Python","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/Electronic-Mango.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":"2023-06-02T13:06:20.000Z","updated_at":"2024-06-15T13:04:14.000Z","dependencies_parsed_at":"2023-11-16T10:26:49.018Z","dependency_job_id":"6072c0c1-3f21-46a9-b5af-58f9e0bd29b6","html_url":"https://github.com/Electronic-Mango/wowhead-news-rss-filter","commit_stats":null,"previous_names":["electronic-mango/wowhead-news-rss-filter"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Electronic-Mango%2Fwowhead-news-rss-filter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Electronic-Mango%2Fwowhead-news-rss-filter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Electronic-Mango%2Fwowhead-news-rss-filter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Electronic-Mango%2Fwowhead-news-rss-filter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Electronic-Mango","download_url":"https://codeload.github.com/Electronic-Mango/wowhead-news-rss-filter/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245168808,"owners_count":20571799,"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","fastapi","python","python3","rss","wowhead"],"created_at":"2024-11-30T23:15:48.119Z","updated_at":"2026-05-04T02:40:02.647Z","avatar_url":"https://github.com/Electronic-Mango.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Wowhead news RSS filter\n\n[Wowhead](https://www.wowhead.com/) does provide RSS feed for its [news](https://www.wowhead.com/news) section, however it's categories selection is limited.\nFor example - you cannot receive news only from `live` category, there's only `live`+`PTR` together.\nYou are also always receiving sponsored posts.\n\nThis REST API wraps Wowhead's RSS, but allows for filtering out any category you like.\n\nThe API is created with `Python3.11` and [`FastAPI`](https://fastapi.tiangolo.com/).\n\n\n\n## Running the API\n\n### Manually\n\n1. Install all packages from `requirements.txt`\n2. Start the api via `uvicorn`\n\n```shell\npip install -r requirements.txt\nuvicorn src.main:app\n```\n\nUvicorn will by default start the API on address `127.0.0.1:8000`, you can change it via `--host \u003cnew host\u003e` and `--port \u003cnew port\u003e` parameters.\nMore details are in [Uvicorn documentation](https://www.uvicorn.org/settings/). \n\n\n### Docker\n\nYou can start the API via Docker Compose, without any additional configuration:\n```shell\ndocker compose up -d --build\n```\n\nBy default, Compose will forward local port 5021 to container port 8000, where the API is listening.\nYou can change both ports in `docker-compose.yml`, just make sure, that environment variable `UVICORN_PORT` matches new forwarded port on container side.\n\n```yaml\nenvironment:\n  - UVICORN_PORT=8000\nports:\n  - 5021:8000\n```\n\nYou can remove `ports` section if you want to disable port forwarding.\n\n\n## Endpoints\n\nYou can access (automatically generated) docs via `/`, `/docs` or `/redoc`.\n\nBesides docs, there's only one endpoint `/news/{category}`.\nYou can check values for `category` at the bottom of [Wowhead news page](https://www.wowhead.com/news), there's a RSS button with all categories.\nJust make sure that you check the last value in URL, not the name on the page.\n\nSome examples (case sensitive) are:\n * [`all`](https://www.wowhead.com/news/rss/all)\n * [`retail`](https://www.wowhead.com/news/rss/retail)\n * [`diablo`](https://www.wowhead.com/news/rss/diablo)\n * [`classic-series`](https://www.wowhead.com/news/rss/classic-series)\n * [`other-blizzard-games`](https://www.wowhead.com/news/rss/other-blizzard-games)\n\nWithout any additional parameters it will just forward Wowhead news RSS for a given category.\nYou can remove articles from specific categories via `remove` query parameter.\nYou can specify multiple `remove` parameters to remove multiple different categories.\n\n| Route                                                 | Description                                                             |\n|-------------------------------------------------------|-------------------------------------------------------------------------|\n| `/news/all`                                           | All unfiltered news                                                     |\n| `/news/retail?remove=PTR`                             | Retail WoW news without articles from \"PTR\" category                    |\n| `/news/classic-series?remove=Blizzard\u0026remove=Wowhead` | Classic WoW news without articles from \"Blizzard\" or \"Wowhead\" category |\n\n\n\n## Errors\n\nIf Wowhead responds with anything else than code 200, then API will forward received status code with message \"Error when accessing Wowhead!\".\nResponse contents are not forwarded as Wowhead usually responds with full webpage.\n\nCode 404 usually means, that value of passed `category` is incorrect.\n**Keep in mind, that value for `category` is case sensitive, as it is case sensitive for Wowhead RSS links.**\n\n\n\n## Disclaimer\n\nThis API is in no way affiliated, associated, authorized, endorsed by, or in any way officially connected with Wowhead.\nThis is an independent and unofficial project.\nUse at your own risk.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Felectronic-mango%2Fwowhead-news-rss-filter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Felectronic-mango%2Fwowhead-news-rss-filter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Felectronic-mango%2Fwowhead-news-rss-filter/lists"}