freeFacts

A REST API for facts

Exclusivly built this for Bink Chrome Extension project and decided to publish for others to use as well. The database currently includes more than 5000 facts all around the world.

Note - You won't see more than 10 facts on page if you click on url. If you want all facts in your application then you should use npm package.

Install NPM package

npm install allfacts

Documentation for NPM package

Table of Contents

• Get a random fact.
• Get all facts

API Documentation

Get a random fact

Returns a single random fact from the server.

Request

https://freefacts.herokuapp.com/facts/random

Params

name: string (required)

Response

[
  {
    id: "601cf8cb3a683514a0200c9d",
    message: "Peanuts aren’t technically nuts",
  },
];

Get all facts

Returns all facts.

Request

https://freefacts.herokuapp.com/facts/

Params

name: string (required)

Response

{
    "count": "5700",
    "All_facts: {
        "facts" : [
            "_id": "601cf11396e9c813e0e46c61",
            "name": "The first oranges weren’t orange"
        ]
    }
}

Get featured

If you are using my API in your application, get featured here. Make an issue with your application.

• Bink Chrome Extension by AmitGujar

Contributing

All feedback and contributions are welcome!