{"id":13414634,"url":"https://github.com/wh-iterabb-it/meowfacts","last_synced_at":"2025-03-14T22:31:54.873Z","repository":{"id":37550206,"uuid":"205547429","full_name":"wh-iterabb-it/meowfacts","owner":"wh-iterabb-it","description":"🐈 a simple api which returns a catfact","archived":false,"fork":false,"pushed_at":"2025-01-01T08:22:30.000Z","size":632,"stargazers_count":423,"open_issues_count":18,"forks_count":59,"subscribers_count":5,"default_branch":"main","last_synced_at":"2025-01-07T20:46:38.557Z","etag":null,"topics":["api","catfacts","hacktoberfest","js-api-examples","learning-by-doing","restful-api"],"latest_commit_sha":null,"homepage":"https://meowfacts.herokuapp.com/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/wh-iterabb-it.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":"docs/FUNDING.yml","license":"LICENSE","code_of_conduct":"docs/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"custom":"https://www.paypal.me/animalproject"}},"created_at":"2019-08-31T13:22:38.000Z","updated_at":"2025-01-07T19:57:04.000Z","dependencies_parsed_at":"2023-09-21T16:38:25.351Z","dependency_job_id":"3b80653a-ce00-4d11-9a9e-f30313a13604","html_url":"https://github.com/wh-iterabb-it/meowfacts","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wh-iterabb-it%2Fmeowfacts","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wh-iterabb-it%2Fmeowfacts/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wh-iterabb-it%2Fmeowfacts/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wh-iterabb-it%2Fmeowfacts/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/wh-iterabb-it","download_url":"https://codeload.github.com/wh-iterabb-it/meowfacts/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243657999,"owners_count":20326456,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","catfacts","hacktoberfest","js-api-examples","learning-by-doing","restful-api"],"created_at":"2024-07-30T21:00:31.692Z","updated_at":"2025-03-14T22:31:54.507Z","avatar_url":"https://github.com/wh-iterabb-it.png","language":"JavaScript","funding_links":["https://www.paypal.me/animalproject"],"categories":["Index","\u003ca id=\"animals\"\u003e\u003c/a\u003e🐶 Animals"],"sub_categories":["Animals","📚 Additional Resources"],"readme":"meowfacts\n=========\n\n[![Issues](https://img.shields.io/github/issues/wh-iterabb-it/meowfacts.svg)](https://github.com/wh-iterabb-it/meowfacts/issues)\n[![License](https://img.shields.io/badge/license-GPL-blue.svg)](https://github.com/wh-iterabb-it/meowfacts/blob/main/LICENSE)\n![Known Vulnerabilities](https://snyk.io/test/github/wh-iterabb-it/meowfacts/badge.svg) \n[![codecov](https://codecov.io/gh/wh-iterabb-it/meowfacts/branch/main/graph/badge.svg)](https://codecov.io/gh/wh-iterabb-it/meowfacts)\n\n\n## Description:\n\nA simple api that returns a random fact about cats on a GET request\n\n### Example Usage\n\n``` \ncurl https://meowfacts.herokuapp.com/\n```\n\nResponse\n\n```json\n{\n  \"data\": [\n    \"0\": \t\"Mother cats teach their kittens to use the litter box.\"\n  ]\n}\n```\n\n\n### Advanced Usage\n\nYou can request more than one fact at a time by using the GET param `count`\n\n```bash\ncurl https://meowfacts.herokuapp.com/?count=3\n```\n\nResponse\n\n```json\n{\n  \"data\": [\n    \"0\": \t\"Mother cats teach their kittens to use the litter box.\",\n    \"1\": \"A cat can sprint at about thirty-one miles per hour.\",\n    \"2\": \"The worlds richest cat is worth $13 million after his human passed away and left her fortune to him.\"\n  ]\n}\n```\n\nYou can request a specific fact if you know the ID / order it is buy passing the GET param `id`\n\n```bash\ncurl https://meowfacts.herokuapp.com/?id=3\n```\n\nResponse\n\n```json\n{\n  \"data\": [\n    \"0\": \t\"Mother cats teach their kittens to use the litter box.\"\n  ]\n}\n```\n\n### Language Support \n\nYou can request the response in different languages by using the GET param `lang`\n\n```bash\ncurl https://meowfacts.herokuapp.com/?lang=ukr\n```\n\nResponse\n\n```json\n{\n  \"data\": [\n    \"0\": \t\"Найбагатший у світі кіт коштує 13 мільйонів доларів після того, як його людина померла і залишила йому свій стан\"\n  ]\n}\n```\n\n#### Supported Languages\n\nThe supported languages are listed below, you can use any of the `lang Values` in the first column as a `lang` param. \n\n\"?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. \n\n| LANG Variable | [ISO 639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) | Language Name | Localization (country) |\n| :---: | :---: | :---: | :---: |\n| `eng-us`  | `eng` | English | USA |\n| `ces-cz` or `cze-cz` | `cze` (B) `ces` (T) | Czech | CZ |\n| `ger-de`  | `ger` | German | DE |\n| `ben-in`  | `ben` | Bengali | IN |\n| `esp-es`  | `esp` | Spanish | ES |\n| `esp-mx`  | `esp` | Spanish (default) | MX |\n| `rus-ru`  | `rus` | Russian | RUS |\n| `por-br`  | `por` | Portuguese | BR |\n| `tl-fil`  | `fil` | Filipino | PH |\n| `ukr-ua`  | `ukr` | Ukrainian | UA |\n| `urd-ur`  | `urd` | Urdu | UR |\n| `ita-it`  | `ita` | Italian | IT |\n| `zho-tw` | `zho` | Chinese | TW (Taiwan) |\n| `kor-ko`  | `kor` | Korean | KO |\n\n\n\u003cdetails\u003e\n  \u003csummary\u003eHelp us expand and improve Internationalization on this API  (Click to expand)\u003c/summary\u003e\n  \u003ch3\u003eHelp us expand and improve Internationalization on this API\u003c/h3\u003e\n  \n  \u003cp\u003e\u003cb\u003eNote:\u003c/b\u003e We are trying to follow the browser's language tags, which are formally defined in \u003ca href=\"https://datatracker.ietf.org/doc/html/rfc5646\"\u003eRFC 5646\u003c/a\u003e, which rely on the \u003ca href=\"https://en.wikipedia.org/wiki/ISO_639\"\u003eISO 639\u003c/a\u003e standard (quite often the \u003ca href=\"https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes\"\u003e639-1 code list\u003c/a\u003e) for \u003ca href=\"https://en.wikipedia.org/wiki/Language_code\"\u003elanguage codes\u003c/a\u003e to be used.\u003c/p\u003e \n\n\u003cp\u003eWe would love it if you helped this project by taking a look at our \u003ca href=\"https://github.com/wh-iterabb-it/meowfacts/issues/175\"\u003eCall for Contributors\u003c/a\u003e to see if you can make a contribution that helps us be more inclusive and support more languages. \u003c/p\u003e\n\u003c/details\u003e\n\n\n### Documentation\n\n\u003cdiv align=\"center\"\u003e\n  \u003cp\u003e\n    \u003ca href=\"https://app.swaggerhub.com/apis-docs/wh-iterabb-it/meowfacts/1.0.0\"\u003e\n      \u003cimg width=\"200\" height=\"72\" src=\"https://raw.githubusercontent.com/swagger-api/swagger.io/wordpress/images/assets/SW-logo-clr.png\" /\u003e\n    \u003c/a\u003e\n  \u003c/p\u003e\n  \u003cp\u003e\n    \u003ca href=\"https://rapidapi.com/wh-iterabb-it-wh-iterabb-it-default/api/meowfacts/\"\u003e\n      \u003cimg width=\"200\" height=\"52\" src=\"https://rapidapi.com/static-assets/default/dark-logo-78e48dc1-ca3f-4d67-a6f5-74032f439c8b.svg\" /\u003e\n    \u003c/a\u003e\n  \u003c/p\u003e\n    \u003cp\u003e\n    \u003ca href=\"https://meow-facts.netlify.app/\"\u003e\n      \u003cimg width=\"200\" height=\"52\" src=\"https://img.shields.io/badge/Community_Documentation-FFFFFF.svg?logo=bookstack\u0026logoColor=blue\u0026style=for-the-badge\" /\u003e\n    \u003c/a\u003e\n  \u003c/p\u003e\n\u003c/div\u003e\n\n\n## Local Development\n\n### Installation\n\n```\nnpm install\n```\n\nBasic usage\n\n```\nnpm run start\n```\n\n### Dedication \u0026\u0026 Funding\n\n\n\n\n\u003cdiv align=\"center\"\u003e\n\u003cp\u003eThis api is dedicated to pistachio; she brought me great comfort in dire times. Words can't describe the debt I owe to her. \u003c/p\u003e\n  \u003cimg width=\"500\" height=\"500\" alt=\"My cat, Sleeping on her back on a table, she did this everywhere because the fan would cool her belly.\" src=\"https://i.imgur.com/2EGh2Bp.jpg\" /\u003e\n  \u003cp\u003eIf you enjoy this api, or just love cats, please donate to:\u003c/p\u003e\n  \u003cp\u003e\u003ca href=\"https://www.animalprojectnyc.org/\"\u003eNYC Animal Project Website\u003c/a\u003e\u003c/p\u003e\n  \u003cp\u003e\u003ca href=\"https://www.paypal.me/animalproject\"\u003eNYC Animal Project Paypal Link\u003c/a\u003e\u003c/p\u003e\n  \n  \u003cp align=\"justify\"\u003e\u003cstrong\u003eNYC Animal Project\u003c/strong\u003e 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.\u003c/p\u003e\n\n\u003c/div\u003e\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwh-iterabb-it%2Fmeowfacts","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwh-iterabb-it%2Fmeowfacts","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwh-iterabb-it%2Fmeowfacts/lists"}