{"id":14155521,"url":"https://github.com/Glowstudent777/YouVersion-API-NPM","last_synced_at":"2025-08-06T01:31:43.189Z","repository":{"id":63600245,"uuid":"569091999","full_name":"Glowstudent777/YouVersion-API-NPM","owner":"Glowstudent777","description":"A simple module to get the Verse of the Day or any verse you would like.","archived":false,"fork":false,"pushed_at":"2024-10-25T22:29:08.000Z","size":422,"stargazers_count":31,"open_issues_count":0,"forks_count":5,"subscribers_count":5,"default_branch":"main","last_synced_at":"2024-12-02T08:03:20.213Z","etag":null,"topics":["bible","javascript","nodejs","npm","verse","verse-of-the-day","youversion"],"latest_commit_sha":null,"homepage":"https://www.npmjs.com/package/@glowstudent/youversion","language":"TypeScript","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/Glowstudent777.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":["Glowstudent777"],"patreon":null,"open_collective":null,"ko_fi":"Glowstudent","tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"lfx_crowdfunding":null,"custom":null}},"created_at":"2022-11-22T03:56:57.000Z","updated_at":"2024-11-20T05:47:40.000Z","dependencies_parsed_at":"2023-01-23T19:15:18.600Z","dependency_job_id":"fab38551-9265-440f-b879-b70b7a529522","html_url":"https://github.com/Glowstudent777/YouVersion-API-NPM","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Glowstudent777%2FYouVersion-API-NPM","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Glowstudent777%2FYouVersion-API-NPM/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Glowstudent777%2FYouVersion-API-NPM/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Glowstudent777%2FYouVersion-API-NPM/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Glowstudent777","download_url":"https://codeload.github.com/Glowstudent777/YouVersion-API-NPM/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":228821405,"owners_count":17977166,"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":["bible","javascript","nodejs","npm","verse","verse-of-the-day","youversion"],"created_at":"2024-08-17T08:03:45.794Z","updated_at":"2025-08-06T01:31:43.177Z","avatar_url":"https://github.com/Glowstudent777.png","language":"TypeScript","funding_links":["https://github.com/sponsors/Glowstudent777","https://ko-fi.com/Glowstudent"],"categories":["npm"],"sub_categories":[],"readme":"# YouVersion API\n\nA simple module to get the Verse of the Day and any verse you would like.\n\n## Installation\n\n\u003e [!NOTE]\n\u003e I use `pnpm` in these examples. `NPM` will also work if you don't have or want to install `pnpm`\n\nFirst step is of course installing the module\n\n```bash\npnpm install @glowstudent/youversion\n```\n\n## Usage\n\n#### Import the library\n\n```javascript\nconst YouVersion = require(\"@glowstudent/youversion\");\n```\n\n#### Getting the verse of the day:\n\n\u003e **Note**\n\u003e The default language is English\n\n```javascript\nconst YouVersion = require(\"@glowstudent/youversion\");\n\n(async () =\u003e {\n  console.log(await YouVersion.getVerseOfTheDay());\n})();\n```\n\n```json\n{\n  \"citation\": \"Hebrews 11:1 (NIV)\",\n  \"passage\": \"Now faith is confidence in what we hope for and assurance about what we do not see.\"\n}\n```\n\n#### Getting the verse of the day in a different language:\n\nYou can specify a single or multiple languages by passing them as a string separated by a comma. The languages must be in the format of the ISO 639-1 code. For example, `en` for English, `es` for Spanish, `fr` for French, and `de` for German. It will return the first language that is available. If the language is not available it will move on to the next language in the list.\n\nSingle language:\n\n```javascript\nconst YouVersion = require(\"@glowstudent/youversion\");\n\n(async () =\u003e {\n  console.log(await YouVersion.getVerseOfTheDay(\"sk\"));\n})();\n```\n\nMultiple languages:\n\n```javascript\nconst YouVersion = require(\"@glowstudent/youversion\");\n\n(async () =\u003e {\n  console.log(await YouVersion.getVerseOfTheDay(\"es, fr, de\"));\n})();\n```\n\n#### Getting any verse:\n\n```javascript\nconst YouVersion = require(\"@glowstudent/youversion\");\n\n(async () =\u003e {\n  console.log(await YouVersion.getVerse(\"John\", \"3\", \"16\", \"KJV\"));\n})();\n```\n\n```json\n{\n  \"citation\": \"John 3:16 KJV\",\n  \"passage\": \"For God so loved the world, that he gave his only begotten Son, that whosoever believeth in him should not perish, but have everlasting life.\"\n}\n```\n\n---\n\n## Responses\n\nRequests return a JSON object and a status code.\n\n### Good Respsonses\n\nGood responses will return a JSON with a `citation` and a `passage`.\n\n```json\n{\n  \"citation\": \"John 3:16 NLT\",\n  \"passage\": \"For God so loved the world, that he gave his only begotten Son, that whosoever believeth in him should not perish, but have everlasting life.\"\n}\n```\n\n### Bad Responses\n\nIf `book` is not specified or cannot be read it will return an error.\n\n```json\n{\n  \"code\": 400,\n  \"message\": \"Missing field 'book'\"\n}\n```\n\n\u003cbr\u003e\n\nTrying to access a book that does not exist will prompt a similar response but with a different error message\n\n```json\n{\n  \"code\": 400,\n  \"message\": \"Could not find book 'Coffee' by name or alias.\"\n}\n```\n\n## Links\n\n- [GitHub](https://github.com/Glowstudent777/YouVersion-API)\n- [npm](https://www.npmjs.com/package/@glowstudent/youversion)\n- [Discord](https://discord.gg/4wM63P7ZUd)\n\n## Contributing\n\n\u003e [!NOTE]\n\u003e Most of the logic is now in the `YouVersion-Core` repository. If you would like to contribute to the core repository, please visit [here](https://github.com/Glowstudent777/YouVersion-Core).\n\nBefore creating an issue, please ensure that it hasn't already been reported/suggested.\n\n## License\n\nThis project is licensed under the terms of the\n[MIT license](/LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FGlowstudent777%2FYouVersion-API-NPM","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FGlowstudent777%2FYouVersion-API-NPM","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FGlowstudent777%2FYouVersion-API-NPM/lists"}