https://github.com/givensuman/johnmulapi
An API for John Mulaney quotes
https://github.com/givensuman/johnmulapi
api comedy rest
Last synced: about 1 year ago
JSON representation
An API for John Mulaney quotes
- Host: GitHub
- URL: https://github.com/givensuman/johnmulapi
- Owner: givensuman
- License: mit
- Created: 2021-06-02T19:05:22.000Z (about 5 years ago)
- Default Branch: main
- Last Pushed: 2025-01-21T15:38:28.000Z (over 1 year ago)
- Last Synced: 2025-01-21T16:35:14.435Z (over 1 year ago)
- Topics: api, comedy, rest
- Language: TypeScript
- Homepage: http://johnmulapi.givensuman.com
- Size: 2.39 MB
- Stars: 0
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# johnmulapi
An API for John Mulaney quotes
[johnmulapi.givensuman.com](https://johnmulapi.givensuman.com)
[api.johnmulapi.givensuman.com](https://api.johnmulapi.givensuman.com)
### How do I use this?
```shell
# shell
$ curl https://api.johnmulapi.givensuman.com
```
```javascript
// javascript
fetch('https://api.johnmulapi.givensuman.com')
.then(res => res.json())
.then(data => console.log(data);
```
```python
# python
import requests
quote = (requests
.get('https://api.johnmulapi.givensuman.com')
.json())
print(quote)
```
👇
```json
{
"data": "I don't look older, I just look worse.",
"status": 200,
"message": null
}
```
### Parameters
| name | type | default | description |
| --------- | ------- | --------- | -------------------------------------------------------- |
| quantity | number | 1 | Number of quotes to return |
| minLength | number | undefined | Minimum length of the quotes to return |
| maxLength | number | undefined | Maximum length of the quotes to return |
| unique | boolean | false | Whether the returned quotes (if multiple) must be unique |
```
# example usage
curl 'https://api.johnmulapi.givensuman.com/?quantity=5&unique=true&maxLength=75'
```
### Can I use this in a project?
Please do. Let me know how it goes.
##### Shamelessly inspired by [kanye.rest](https://kanye.rest/)