Update README.md

This commit is contained in:
Dmitrii Selivanov authored and GitHub committed 2022-01-03 15:56:23 +03:00
1 parent ad3bb54772
commit 4a8a36a4da
1 file changed
+34
+34
View File
@@ -34,6 +34,40 @@ With the removal of dislike stats from the YouTube API, our backend switched to
You can learn more at our website at: [returnyoutubedislike.com](https://www.returnyoutubedislike.com/)
## API documentation
Third party use of this open API is allowed with the following restrictions:
- **Attribution**: This project should be clearly attributed with either a link to this repo or a link to [returnyoutubedislike.com](https://returnyoutubedislike.com/).
- **Rate Limiting**: There are per client rate limits in place of 100 per minute and 10'000 per day. This will return a *429* status code indicating that your application should back off.
The API is accessible over the following base URL:
https://returnyoutubedislikeapi.com
List of available endpoints is available here:
https://returnyoutubedislikeapi.com/swagger/index.html
### Get votes
Example to get votes of a given YouTube video ID:
`/votes?videoId=kxOuG8jMIgI`
```json
{
"id": "kxOuG8jMIgI",
"dateCreated": "2021-12-20T12:25:54.418014Z",
"likes": 27326,
"dislikes": 498153,
"rating": 1.212014408444885,
"viewCount": 3149885,
"deleted": false
}
```
None existing YouTube ID will return status code *404* "Not Found".
Wrong formed YouTube ID will return *400* "Bad Request".
<!---
## API documentation