Skip to content

AtharvaKDev/Peter-API

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

39 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Peter API

Free API for Jokes, Facts, Questions and more coming soon!

API URL

API Reference

Get Version

Returns the Version and Last Update Date of the API

  GET /api/version

Get Quote

  GET /api/quote
Endpoint Type Description
quote string Returns a Quote from the API.

Get Roast

  GET /api/roast/<username>
Endpoint Type Description
roast/<username> string Returns a Joke from the API.

Required Parameters: username

Get Joke

  GET /api/joke
Endpoint Type Description
joke string Returns a Joke from the API.

Get Darkjoke

  GET /api/darkjoke
Endpoint Type Description
darkjoke string Returns a Dark-Joke from the API.

Get Fact

  GET /api/fact
Endpoint Type Description
fact string Returns a Fact from the API.

Get Question

  GET /api/question
Endpoint Type Description
question string Returns a Question from the API.

Usage/Examples

import requests

url = requests.get("https://peter-api.up.railway.app/api/darkjoke")
result = url.json()

buildup = result['buildup']
punchline = result['punchline']
joke = buildup + "? " + punchline
print(joke)

Output:

Why did the blind man fall into the well? Because he couldn't see that well.

License

MIT