Facts API

The Facts API provides tons of random interesting facts about science, literature, philosophy and other cool topics.

/v1/facts GET

https://api.api-ninjas.com/v1/facts

Returns one (or more) random facts.


Parameters

  • limit  optional premium only

    How many results to return. Must be between 1 and 100. Default is 1.

Headers

  • X-Api-Key  required

    API Key associated with your account.

Sample Request Live Demo!

https://api.api-ninjas.com/v1/facts

Headers

X-Api-KeyLog in or sign up to get your API Key

Sample Response

JSON
1 2 3 4 5 [ { "fact": "After the Eiffel Tower was built, one person was killed during the installation of the lifts. No one was killed during the actual construction of the tower" } ]

Code Examples

1 2 3 4 5 6 7 8 9 import requests limit = 3 api_url = 'https://api.api-ninjas.com/v1/facts?limit={}'.format(limit) response = requests.get(api_url, headers={'X-Api-Key': 'YOUR_API_KEY'}) if response.status_code == requests.codes.ok: print(response.text) else: print("Error:", response.status_code, response.text)

If your programming language is not listed in the Code Example above, you can still make API calls by using a HTTP request library written in your programming language and following the above documentation.