meowfacts

Description:

A simple api that returns a random fact about cats on a GET request

Example Usage

curl https://meowfacts.herokuapp.com/

Response

{
  "data": [
    "0": 	"Mother cats teach their kittens to use the litter box."
  ]
}

Advanced Usage

You can request more than one fact at a time by using the GET param count

curl https://meowfacts.herokuapp.com/?count=3

Response

{
  "data": [
    "0": 	"Mother cats teach their kittens to use the litter box.",
    "1": "A cat can sprint at about thirty-one miles per hour.",
    "2": "The worlds richest cat is worth $13 million after his human passed away and left her fortune to him."
  ]
}

You can request a specific fact if you know the ID / order it is buy passing the GET param id

curl https://meowfacts.herokuapp.com/?id=3

Response

{
  "data": [
    "0": 	"Mother cats teach their kittens to use the litter box."
  ]
}

Language Support

You can request the response in different languages by using the GET param lang

curl https://meowfacts.herokuapp.com/?lang=ukr

Response

{
  "data": [
    "0": 	"Найбагатший у світі кіт коштує 13 мільйонів доларів після того, як його людина померла і залишила йому свій стан"
  ]
}

Supported Languages

The supported languages are listed below, you can use any of the lang Values in the first column as a lang param.

"?lang=esp" and "?lang=esp-mx" will both return spanish for your response, and simply using the ISO-639-1 code will default to esp-mx for simplicity.

LANG Variable	ISO 639-1	Language Name	Localization (country)
eng-us	eng	English	USA
ger-de	ger	German	DE
ukr-ua	ukr	Ukrainian	UA
rus-ru	rus	Russian	RUS
por-br	por	Portuguese	BR
esp-es	esp	Spanish	ES
esp-mx	esp	Spanish (default)	MX
ces-cz or cze-cz	cze (B) ces (T)	Czech	CZ
tl-fil	fil	Filipino	PH
urd-ur	urd	Urdu	UR

Help us expand and improve Internationalization on this API (Click to expand)

Help us expand and improve Internationalization on this API

Note: We are trying to follow the browser's language tags, which are formally defined in RFC 5646, which rely on the ISO 639 standard (quite often the 639-1 code list) for language codes to be used.

We would love it if you helped this project by taking a look at our Call for Contributors to see if you can make a contribution that helps us be more inclusive and support more languages.

Documentation

Local Development

Installation

npm install

Basic usage

npm run start

Dedication && Funding

This api is dedicated to pistachio; she brought me great comfort in dire times. Words can't describe the debt I owe to her.

If you enjoy this api, or just love cats, please donate to:

NYC Animal Project Website

NYC Animal Project Paypal Link

NYC Animal Project is a struggling `no kill` cat shelter in the heart of new york that relies entirely on fosters and help from small donations. I can say personally having volunteered for them, even a few cents donation would make a difference for the very small organization. I fostered many kittens from them, and Pistachio was the runt that went un-adopted. She was shy, but very outgoing when she got settled. I highly recommend to foster and adopt if you can.