{"id":19584372,"url":"https://github.com/gpalleschi/quotes_api","last_synced_at":"2025-05-12T14:25:43.921Z","repository":{"id":95881880,"uuid":"479035267","full_name":"gpalleschi/quotes_api","owner":"gpalleschi","description":"Quote API RESTful Node.js based Multilingual (Italian, English and Spanish) is a free, open source quote api to get random quote. Quotes are loaded on sqlite3 DB.","archived":false,"fork":false,"pushed_at":"2025-04-29T17:00:54.000Z","size":4399,"stargazers_count":3,"open_issues_count":4,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-12T14:25:43.570Z","etag":null,"topics":["api","multilingual","nodeexpress","nodejs","quotes","quotes-api","rest-api","restful-api","sqlite3","sqlite3-database","vercel","vercel-serverless"],"latest_commit_sha":null,"homepage":"https://quotes-api-three.vercel.app/api","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gpalleschi.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"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,"zenodo":null}},"created_at":"2022-04-07T15:06:17.000Z","updated_at":"2025-04-29T17:00:57.000Z","dependencies_parsed_at":"2025-02-26T12:31:41.070Z","dependency_job_id":"f63a4cea-66f2-42f3-8d65-f887f86ecbb0","html_url":"https://github.com/gpalleschi/quotes_api","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gpalleschi%2Fquotes_api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gpalleschi%2Fquotes_api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gpalleschi%2Fquotes_api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gpalleschi%2Fquotes_api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gpalleschi","download_url":"https://codeload.github.com/gpalleschi/quotes_api/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253754402,"owners_count":21958856,"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","multilingual","nodeexpress","nodejs","quotes","quotes-api","rest-api","restful-api","sqlite3","sqlite3-database","vercel","vercel-serverless"],"created_at":"2024-11-11T07:47:57.563Z","updated_at":"2025-05-12T14:25:43.904Z","avatar_url":"https://github.com/gpalleschi.png","language":"JavaScript","readme":"# quote_api\nQuote API RESTful Node.js based Multilingual (Italian, English and Spanish) is a free, open source quote api to get random quote. Quotes are loaded on sqlite3 DB. Actually is hosted on [Vercel](https://quotes-api-three.vercel.app/api/).   \n\n## API Reference\n\n- [Get Random Quote](#Random)  \n- [Get Random Quote Image](#RandomImage)  \n- [Info](#Info)  \n- [Authors](#Authors)  \n- [Quotes](#Quotes)\n- [Error Managment](#Error-Managment)\n\n\u003chr/\u003e\n\n## Random\n\n```HTTP\nGET /api/randomquote\n```\n\nReturn a random quote.\n\n**Query parameters**  \n\n\n| Param     | Type     | Description   | Mandatory                                                                                                                                                                                                                                                                                                                          |\n| :-------- | :------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |---|\n| language | `String`    | Language Code (ex. en, it, es) | Yes | \n\n**Response**\n\n```ts\n{\n    // Quote\n    quote: string\n    // Author name\n    author: string\n    // tags\n    tags: string\n}\n```\n**Examples**\n\n`http://localhost:35907/api/randomquote?language=en`\n\n```\n{\n  \"quote\": \"Three things cannot be long hidden: the sun, the moon, and the truth.\",\n  \"author\": \"Buddha\",\n  \"tags\": \"famous\"\n}\n```\n\u003chr/\u003e\n\n## RandomImage\n\n```HTTP\nGET /api/randomimage\n```\n\nReturn a random image with a quote and its author (To generate random image use pixabay service).\n\n**Query parameters**  \n\n\n| Param     | Type     | Description   | Mandatory                                                                                                                                                                                                                                                                                                                          |\n| :-------- | :------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |---|\n| language | `String`    | Language Code (ex. en, it, es) | Yes | \n\n**Response**\n\n```ts\n{\n    // url image\n    url: string\n    // width image\n    width : number\n    // height image\n    height : number\n    // Author name\n    author: string\n    // Quote\n    quote: string\n}\n```\n\n**Examples**\n\n`http://localhost:35907/api/randomimage?language=en`\n\n```\n{\n    \"url\": \"https://pixabay.com/get/g6e739078013913a6cc494f4fa619b28b40d3b74f8d631c9fa8454a20654f6a1cbf45b4117d180dd8ad0789664ca946d5cee9224be3de79b4c620d5bdafbf2179_640.jpg\",\n    \"width\" : 640,\n    \"height\" : 426,\n    \"author\": \"Frida Kahlo\",\n    \"quote\": \"Nada dura para siempre… por eso quiero que seas mi nada.\"\n}\n```\n\u003chr/\u003e\n\n## Info\n\n```HTTP\nGET /api/Info\n```\n\nReturn info about total quotes and authors.\n\n**Query parameters**  \n\n| Param     | Type     | Description   | Mandatory                                                                                                                                                                                                                                                                                                                          |\n| :-------- | :------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |---|\n| language | `String`    | Language Code (ex. en, it, es) | Yes | \n\n**Response**  \n\n```ts\n{\n    // version\n    version: string\n    // Language code\n    language: string\n    // Total quotes loaded\n    quotes: number\n    // Total authors loaded \n    authors: number\n}\n```\n**Examples**\n\n`http://localhost:35907/api/info?language=en`\n\n```\n{\n  \"version\": \"1.7.2\",\n  \"language\": \"en\",\n  \"quotes\": 1746,\n  \"authors\": 717\n}\n```\n\n\u003chr/\u003e\n\n## Authors\n\n```HTTP\nGET /api/authors\n```\n\nReturn list of Authors with relative total quotes.\n\n**Query parameters**  \n\n| Param     | Type     | Description   | Mandatory                                                                                                                                                                                                                                                                                                                          |\n| :-------- | :------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |---|\n| language | `String`    | Language Code (ex. en, it, es) | Yes | \n| search | `String`    | String to research Author in like sql format (ex. %Goethe%) | No | \n\n**Response**  \n\n```ts\n{\n    // Author Name\n    author: string\n    // Total quotes loaded\n    totQuotes: number\n}\n```\n**Examples**\n\n`http://localhost:35907/api/authors?language=it\u0026search=%OSCAR%`\n\n```\n[\n  {\n    \"author\": \"Oscar Wilde\",\n    \"totQuotes\": 91\n  }\n]\n```\n\n\u003chr/\u003e\n\n## Quotes  \n\n```HTTP\nGET /api/quotes\n```\n\nReturn list of quotes of an author.\n\n**Query parameters**  \n\n| Param     | Type     | Description   | Mandatory                                                                                                                                                                                                                                                                                                                          |\n| :-------- | :------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |---|\n| language | `String`    | Language Code (ex. en, it, es) | Yes | \n| author | `String`    | String to research Author in like sql format (ex. %Goethe%) | Yes | \n| limit | `Numeric`    | Limit quotes extracted (Default value is 10) | No | \n\n**Response**  \n\n```ts\n{\n    // Total quotes founded\n    totQuotes: number\n    quotes: array\u003c{\n        // Quote\n        quote: string\n        // Author name\n        author: string\n        // tags\n        tags: string      \n    }\u003e\n}\n```\n**Examples**\n\n`http://localhost:35907/api/quotes?language=en\u0026author=%Obama%`\n\n```\n{\n  \"totQuotes\": 6,\n  \"quotes\": [\n    {\n      \"quote\": \"If you're walking down the right path and you're willing to keep walking, eventually you'll make progress.\",\n      \"author\": \"Barack Obama\",\n      \"tags\": \"famous\"\n    },\n    {\n      \"quote\": \"Focusing your life solely on making a buck shows a poverty of ambition. It asks too little of yourself. And it will leave you unfulfilled.\",\n      \"author\": \"Barack Obama\",\n      \"tags\": \"famous\"\n    },\n    {\n      \"quote\": \"Change will not come if we wait for some other person or some other time. We are the ones weve been waiting for. We are the change that we seek.\",\n      \"author\": \"Barack Obama\",\n      \"tags\": \"famous\"\n    },\n    {\n      \"quote\": \"Change will not come if we wait for some other person or some other time. We are the ones weve been waiting for. We are the change that we seek.\",\n      \"author\": \"Barack Obama\",\n      \"tags\": \"famous\"\n    },\n    {\n      \"quote\": \"Focusing your life solely on making a buck shows a poverty of ambition. It asks too little of yourself. And it will leave you unfulfilled.\",\n      \"author\": \"Barack Obama\",\n      \"tags\": \"famous\"\n    },\n    {\n      \"quote\": \"If you're walking down the right path and you're willing to keep walking, eventually you'll make progress.\",\n      \"author\": \"Barack Obama\",\n      \"tags\": \"famous\"\n    }\n  ]\n}\n```\n\n\u003chr/\u003e\n\n## Error Managment\n\n**Error Response**  \n```ts\n{\n    // Language code\n    error: number,\n    // Function Name\n    function: string,\n    // Description error\n    description: string\n}\n```    \n\n### Prerequisites  \n\n* Node v22.14.0 or upper\n* npm  v11.3.0 or upper\n\n### Built With  \n* [Visual Code Editor](https://code.visualstudio.com)  \n\n### NPM Modules\nnpm install  \n\n### Run\nnpm start\n\n### Authors  \n\n* **Giovanni Palleschi** - [gpalleschi](https://github.com/gpalleschi)  \n\n\n### License\n\nThis project is licensed under the GNU GENERAL PUBLIC LICENSE 3.0 License - see the [LICENSE](LICENSE) file for details ","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgpalleschi%2Fquotes_api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgpalleschi%2Fquotes_api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgpalleschi%2Fquotes_api/lists"}