{"id":18096138,"url":"https://github.com/bbilly1/ryd-client","last_synced_at":"2025-07-11T01:05:08.030Z","repository":{"id":57463363,"uuid":"441426284","full_name":"bbilly1/ryd-client","owner":"bbilly1","description":"Python client library for the Return YouTube Dislike API","archived":false,"fork":false,"pushed_at":"2022-08-16T08:12:11.000Z","size":40,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-06T10:55:43.229Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"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/bbilly1.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}},"created_at":"2021-12-24T09:40:15.000Z","updated_at":"2024-06-13T22:17:31.000Z","dependencies_parsed_at":"2022-09-14T16:42:08.807Z","dependency_job_id":null,"html_url":"https://github.com/bbilly1/ryd-client","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bbilly1%2Fryd-client","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bbilly1%2Fryd-client/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bbilly1%2Fryd-client/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bbilly1%2Fryd-client/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bbilly1","download_url":"https://codeload.github.com/bbilly1/ryd-client/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243581094,"owners_count":20314167,"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":[],"created_at":"2024-10-31T19:12:48.878Z","updated_at":"2025-03-14T13:13:44.297Z","avatar_url":"https://github.com/bbilly1.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# RYD Client\nPython client library for the **Return YouTube Dislike API**:\n\n- [https://returnyoutubedislike.com/](https://returnyoutubedislike.com/)\n- [https://github.com/Anarios/return-youtube-dislike/](https://github.com/Anarios/return-youtube-dislike/)\n\n\n## Functionality\n- Get votes from a single or a list of YouTube video IDs.\n- Register your user ID by solving the challenge.\n- Cast your vote for a single or a list of YouTube video IDs. \n\n## Install\nDownload and install the library from [https://pypi.org/project/ryd-client/](https://pypi.org/project/ryd-client/):\n\n```shell\npip install ryd-client\n```\n\n## Usage\nTake a look at the command examples below.\n\n### Get \nPass a list of YouTube video IDs and get a list of votes or pass a string of a single YouTube video ID to get a single votes dictionary:\n\n```python\nfrom ryd_client import ryd_client\n\n# Examle for a list of IDs\n\nresult = ryd_client.get([\"kxOuG8jMIgI\", \"CaaJyRvvaq8\"])\n\n[{'id': 'kxOuG8jMIgI',\n  'likes': 27863,\n  'dislikes': 509751,\n  'rating': 1.2113002641063706,\n  'viewCount': 3211800,\n  'deleted': False,\n  'status': 200},\n {'id': 'CaaJyRvvaq8',\n  'likes': 505944,\n  'dislikes': 13401,\n  'rating': 4.900014260551845,\n  'viewCount': 3610078,\n  'deleted': False,\n  'status': 200}]\n\n\n# Example for a single ID\n\nresult = ryd_client.get(\"kxOuG8jMIgI\")\n\n{'id': 'kxOuG8jMIgI',\n 'likes': 27863,\n 'dislikes': 509751,\n 'rating': 1.2113002641063706,\n 'viewCount': 3211800,\n 'deleted': False,\n 'status': 200}\n```\n\n### Register\nTo cast a vote, you need to be registered in the API with your user id. Generate a random user id, one per user, store it in your application and reuse for all future votes from this user.\n\n```python\nimport ryd_client\n\nuser_id = ryd_client.generate_user_id()\n\n# Returns a random 36 char string of ascii_letters and digits\n'5v3X3mxQOm3fkez8aWsGsEgjpFe0pJNPWIJi'\n\n```\n\nRegister your user_id in the api:\n\n```python\nfrom ryd_client import ryd_client\n\nsuccess = ryd_client.register(user_id)\n\n# Returns True on success, False on fail\nTrue\n\n```\n\n### Post\nOnce your `user_id` is registered, you are allowed to vote. Vote on a list or on a single video ID. Pass a list or a single tuple where the first value of the tuple is the video ID and second value is the vote either as `string` or `int`:\n- like: 1\n- dislike: -1\n- neutral: 0 (aka *undo* your previous vote)\n\nStrings automatically get converted to the matching number, both are valid:\n\n```python\nfrom ryd_client import ryd_client\n\n# Examle for a list of votes\nvotes = [\n    (\"kxOuG8jMIgI\", \"dislike\"),\n    (\"CaaJyRvvaq8\", 1),\n    (\"CEp5SLT-DJg\", 0),\n]\n\nresponse = ryd_client.post(votes, user_id=user_id)\n\n[{'id': 'kxOuG8jMIgI', 'status': True, 'vote': -1},\n {'id': 'CaaJyRvvaq8', 'status': True, 'vote': 1},\n {'id': 'CEp5SLT-DJg', 'status': True, 'vote': 0}]\n\n# Examle for a single vote\n\nvote = (\"kxOuG8jMIgI\", -1)\nresponse = ryd_client.post(vote, user_id=user_id)\n\n{'id': 'kxOuG8jMIgI', 'status': True, 'vote': -1}\n\n```\n\n\n## Acknowledgement\nIf you find this API useful, please consider donating to the [project](https://returnyoutubedislike.com/donate).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbbilly1%2Fryd-client","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbbilly1%2Fryd-client","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbbilly1%2Fryd-client/lists"}