{"id":18232788,"url":"https://github.com/theriturajps/quotes-api","last_synced_at":"2025-04-11T03:08:20.818Z","repository":{"id":259355758,"uuid":"870766609","full_name":"theriturajps/Quotes-API","owner":"theriturajps","description":"Quotes API: A free and open API providing a rich collection of motivational quotes to inspire and uplift users in your applications.","archived":false,"fork":false,"pushed_at":"2024-10-24T02:56:40.000Z","size":76,"stargazers_count":11,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-11T03:08:05.692Z","etag":null,"topics":["api","apigateway","apis","free-api","github","javascript","quotes-api","theriturajps","vercel"],"latest_commit_sha":null,"homepage":"https://qapi.vercel.app","language":"HTML","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/theriturajps.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"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":{"github":"theriturajps","buy_me_a_coffee":"riturajps"}},"created_at":"2024-10-10T16:18:40.000Z","updated_at":"2025-02-26T13:16:29.000Z","dependencies_parsed_at":"2024-10-24T19:49:38.062Z","dependency_job_id":"26985e3a-e5e0-483f-8d14-3b789337912f","html_url":"https://github.com/theriturajps/Quotes-API","commit_stats":null,"previous_names":["theriturajps/quotes-api"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theriturajps%2FQuotes-API","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theriturajps%2FQuotes-API/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theriturajps%2FQuotes-API/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theriturajps%2FQuotes-API/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/theriturajps","download_url":"https://codeload.github.com/theriturajps/Quotes-API/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248333604,"owners_count":21086200,"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","apigateway","apis","free-api","github","javascript","quotes-api","theriturajps","vercel"],"created_at":"2024-11-04T14:03:41.216Z","updated_at":"2025-04-11T03:08:20.800Z","avatar_url":"https://github.com/theriturajps.png","language":"HTML","funding_links":["https://github.com/sponsors/theriturajps","https://buymeacoffee.com/riturajps"],"categories":[],"sub_categories":[],"readme":"# Quotes API\n\n![Javascript](https://img.shields.io/badge/JavaScript-F7DF1E.svg?style=for-the-badge\u0026logo=JavaScript\u0026logoColor=black) ![Vercel](https://img.shields.io/badge/Vercel-000000.svg?style=for-the-badge\u0026logo=Vercel\u0026logoColor=white)\n\nWelcome to the Quotes API! Access a vast collection of motivational quotes designed to enhance your applications. This free and open API is easy to integrate into your projects, helping you inspire and motivate your users effectively.\n\n\u003cdiv align='center'\u003e\n  \u003cbr\u003e\n  \u003cimg src=\"https://github.com/user-attachments/assets/b989a196-34e8-4b42-9e9a-9351608a2248\" alt=\"Free-Quotes-API-A-free-and-Open-Source-Quotes-API\"\u003e\n  \u003cbr\u003e\n\u003c/div\u003e\n\n## Technologies Used\n\n- **Language**: JavaScript\n- **Backend**: Express.js\n- **Hosting**: Vercel\n\n## Getting Started\n\nTo get started with the API, you can make requests to the following endpoints to get quotes:\n\n### Get a Random Quote\n\n```\nGET https://qapi.vercel.app/api/random\n```\n\nThis will return a JSON response with a random quote and its author.\n\n### Get All Quotes\n\n```\nGET https://qapi.vercel.app/api/quotes\n```\n\nThis will return a JSON response with all quotes in the collection.\n\n### Get Quote by ID\n\n```\nGET https://qapi.vercel.app/api/quotes/{id}\n```\n\nReplace `{id}` with the specific ID of the quote you want to fetch. This will return a JSON response with the quote and its author.\n\n## Example Responses\n\n### Random Quote\n\n```json\n{\n    \"id\" : 1, \n    \"quote\": \"Success is not the key to happiness. Happiness is the key to success. If you love what you are doing, you will be successful.\",\n    \"author\": \"Albert Schweitzer\"\n}\n```\n\n### All Quotes\n\n```json\n[\n    {\n        \"id\": 1,\n        \"quote\": \"The best way to get started is to quit talking and begin doing.\",\n        \"author\": \"Walt Disney\"\n    },\n    {\n        \"id\": 2,\n        \"quote\": \"The pessimist sees difficulty in every opportunity. The optimist sees opportunity in every difficulty.\",\n        \"author\": \"Winston Churchill\"\n    },\n    {\n        \"id\": 3,\n        \"quote\": \"Don’t let yesterday take up too much of today.\",\n        \"author\": \"Will Rogers\"\n    }\n]\n```\n\n### Quote by ID\n\n```json\n{\n    \"id\": 1,\n    \"quote\": \"The best way to get started is to quit talking and begin doing.\",\n    \"author\": \"Walt Disney\"\n}\n```\n\n## Rate Limiting\n- **Window Duration**: 15 minutes\n- **Maximum Requests**: 200 requests per IP within the window duration\n- **Response on Limit Exceed**: A 429 Too Many Requests status code with the following JSON response\n\n```json\n{\n  \"message\": \"Too many requests from this IP, please try again after 15 minutes\"\n}\n```\n\n## Usage\n\nYou can use the API to display quotes on your website or application to motivate your users. Here are some examples of how you can use the API with JavaScript:\n\n### Get Random Quote\n\n```javascript\nfetch('https://qapi.vercel.app/api/random')\n    .then(response =\u003e response.json())\n    .then(data =\u003e {\n        console.log(data.quote);\n        console.log(\"- \" + data.author);\n    });\n```\n\n### Get All Quotes\n\n```javascript\nfetch('https://qapi.vercel.app/api/quotes')\n    .then(response =\u003e response.json())\n    .then(data =\u003e {\n        data.forEach(quote =\u003e {\n            console.log(quote.quote);\n            console.log(\"- \" + quote.author);\n        });\n    });\n```\n\n### Get Quote by ID\n\n```javascript\nconst quoteId = 1; // Example ID\nfetch(`https://qapi.vercel.app/api/quotes/${quoteId}`)\n    .then(response =\u003e response.json())\n    .then(data =\u003e {\n        console.log(data.quote);\n        console.log(\"- \" + data.author);\n    });\n```\n\n## Installation\n\n1. Clone this repository:\n```\ngit clone https://github.com/theriturajps/quotes-api.git\n```\n2. Go inside Folder\n```\ncd quotes-api\n```\n3. Install the dependencies:\n```\nnpm install\n```\n3.Start the server:\n```\nnpm start\n```\n\n## License\n\nThis project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.\n\n## More Details\n\n\u003ca href=\"https://github.com/theriturajps\"\u003e![Github](https://img.shields.io/badge/GitHub-181717.svg?style=for-the-badge\u0026logo=GitHub\u0026logoColor=white)\u003c/a\u003e \u003ca href=\"https://telegram.me/riturajps\"\u003e![Telegram](https://img.shields.io/badge/Telegram-26A5E4.svg?style=for-the-badge\u0026logo=Telegram\u0026logoColor=white)\u003c/a\u003e \u003ca href=\"https://instagram.com/riturajps\"\u003e![Instagram](https://img.shields.io/badge/Instagram-E4405F.svg?style=for-the-badge\u0026logo=Instagram\u0026logoColor=white)\u003c/a\u003e\n\n\n- **Developer :-** @theriturajps\n- **Fork :-** [Fork this Repo](https://github.com/theriturajps/Quotes-API/fork)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftheriturajps%2Fquotes-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftheriturajps%2Fquotes-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftheriturajps%2Fquotes-api/lists"}