{"id":33319274,"url":"https://github.com/vanshbordia/vlrdevapi","last_synced_at":"2026-01-18T02:54:38.823Z","repository":{"id":318732835,"uuid":"1075710777","full_name":"Vanshbordia/vlrdevapi","owner":"Vanshbordia","description":"Type-safe Python client for scraping Valorant esports data from VLR.gg . Fast, reliable, and production-ready.","archived":false,"fork":false,"pushed_at":"2025-11-19T12:50:33.000Z","size":1117,"stargazers_count":0,"open_issues_count":3,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-11-19T14:22:30.845Z","etag":null,"topics":["hacktoberfest","library","python","valorant","vlr","vlrgg","webscraping"],"latest_commit_sha":null,"homepage":"https://vlrdevapi.pages.dev/docs","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/Vanshbordia.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-10-13T22:07:47.000Z","updated_at":"2025-10-24T11:50:31.000Z","dependencies_parsed_at":null,"dependency_job_id":"d6a56921-5041-4d43-84d9-72d5045d3812","html_url":"https://github.com/Vanshbordia/vlrdevapi","commit_stats":null,"previous_names":["vanshbordia/vlrdevapi"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/Vanshbordia/vlrdevapi","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Vanshbordia%2Fvlrdevapi","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Vanshbordia%2Fvlrdevapi/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Vanshbordia%2Fvlrdevapi/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Vanshbordia%2Fvlrdevapi/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Vanshbordia","download_url":"https://codeload.github.com/Vanshbordia/vlrdevapi/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Vanshbordia%2Fvlrdevapi/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":285319005,"owners_count":27151474,"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","status":"online","status_checked_at":"2025-11-19T02:00:05.673Z","response_time":65,"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":["hacktoberfest","library","python","valorant","vlr","vlrgg","webscraping"],"created_at":"2025-11-19T20:00:29.488Z","updated_at":"2025-11-19T20:01:21.125Z","avatar_url":"https://github.com/Vanshbordia.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# vlrdevapi\n\n[![PyPI version](https://badge.fury.io/py/vlrdevapi.svg)](https://badge.fury.io/py/vlrdevapi)\n[![Python Version](https://img.shields.io/pypi/pyversions/vlrdevapi.svg)](https://pypi.org/project/vlrdevapi/)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Documentation Status](https://readthedocs.org/projects/vlrdevapi/badge/?version=latest)](https://vlrdevapi.readthedocs.io/en/latest/?badge=latest)\n\n**Python library for VLR.gg Valorant esports data**\n\nAccess Valorant esports data from VLR.gg with a clean, type-safe Python API. Get tournament info, match schedules, player stats, team data, and more.\n\n## Features\n\n- **Complete Data Access**: Events, matches, players, teams, series, and search\n- **Type-Safe**: Frozen Python dataclasses with rich type hints\n- **Production-Ready**: Error handling, retry logic, and rate limiting\n- **Easy to Use**: Simple, intuitive API design\n\n## Installation\n\n```bash\npip install vlrdevapi\n```\n\nRequires Python 3.11+\n\n## Quick Start\n\n```python\nimport vlrdevapi as vlr\n\n# Search for anything\nresults = vlr.search.search(\"nrg\")\nprint(f\"Found {results.total_results} results\")\n\n# Get upcoming matches\nmatches = vlr.matches.upcoming(limit=5)\nfor match in matches:\n    print(f\"{match.team1.name} vs {match.team2.name}\")\n\n# Player stats\nprofile = vlr.players.profile(player_id=4164)\nprint(f\"{profile.handle} - {profile.country}\")\n\n# Team info\nteam = vlr.teams.info(team_id=1034)\nprint(f\"{team.name} ({team.tag})\")\n\n# Event details\nevents = vlr.events.list_events(tier=\"vct\", status=\"ongoing\")\n```\n\n## API Modules\n\n### Search\n```python\n# Search everything\nresults = vlr.search.search(\"nrg\")\n\n# Type-specific searches\nplayers = vlr.search.search_players(\"tenz\")\nteams = vlr.search.search_teams(\"sentinels\")\nevents = vlr.search.search_events(\"champions\")\n```\n\n### Matches\n```python\n# Get matches\nupcoming = vlr.matches.upcoming(limit=10)\nlive = vlr.matches.live()\ncompleted = vlr.matches.completed(limit=10)\n```\n\n### Players\n```python\n# Player data\nprofile = vlr.players.profile(player_id=4164)\nmatches = vlr.players.matches(player_id=4164, limit=20)\nstats = vlr.players.agent_stats(player_id=4164, timespan=\"60d\")\n```\n\n### Teams\n```python\n# Team data\ninfo = vlr.teams.info(team_id=1034)\nroster = vlr.teams.roster(team_id=1034)\nmatches = vlr.teams.upcoming_matches(team_id=1034)\nplacements = vlr.teams.placements(team_id=1034)\n```\n\n### Events\n```python\n# Event data\nevents = vlr.events.list_events(tier=\"vct\", status=\"ongoing\")\ninfo = vlr.events.info(event_id=2498)\nmatches = vlr.events.matches(event_id=2498)\nstandings = vlr.events.standings(event_id=2498)\n```\n\n### Series\n```python\n# Match details\ninfo = vlr.series.info(match_id=530935)\nmaps = vlr.series.matches(series_id=530935)\n```\n\n## Documentation\n\nFull documentation available at [vlrdevapi.readthedocs.io](https://vlrdevapi.readthedocs.io/)\n\n- [API Reference](https://vlrdevapi.readthedocs.io/en/latest/api/) - Complete function documentation\n- [Examples](https://vlrdevapi.readthedocs.io/en/latest/examples.html) - Practical code examples\n- [Installation Guide](https://vlrdevapi.readthedocs.io/en/latest/installation.html) - Setup instructions\n\n## Common Use Cases\n\n- Analytics dashboards and statistics trackers\n- Tournament tracking and match notifications\n- Player performance analysis\n- Discord bots and automated reports\n- Betting prediction models\n- Research and data analysis\n\n## FAQ\n\n**Is this official?** No, VLR.gg has no official API. This is a community library.\n\n**How do I find IDs?** Check VLR.gg URLs. Example: `vlr.gg/player/4164/aspas` → player ID is `4164`\n\n**Python version?** Requires Python 3.11+\n\n## Links\n\n- [Documentation](https://vlrdevapi.readthedocs.io/)\n- [GitHub](https://github.com/vanshbordia/vlrdevapi)\n- [Issues](https://github.com/vanshbordia/vlrdevapi/issues)\n\n## License\n\nMIT License - see LICENSE file\n\n---\n\n**Disclaimer:** Not affiliated with VLR.gg or Riot Games. Use responsibly.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvanshbordia%2Fvlrdevapi","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvanshbordia%2Fvlrdevapi","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvanshbordia%2Fvlrdevapi/lists"}