{"id":25861551,"url":"https://github.com/rakarmp/kitagawachan-api","last_synced_at":"2025-07-08T01:36:44.276Z","repository":{"id":188822240,"uuid":"679493692","full_name":"rakarmp/Kitagawachan-Api","owner":"rakarmp","description":"This API provides a collection of quotes from various anime series and characters. ","archived":false,"fork":false,"pushed_at":"2023-09-11T09:47:42.000Z","size":1108,"stargazers_count":5,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-01T23:44:03.301Z","etag":null,"topics":["anime","anime-quotes","animeapi","animechan-api","query-quotes","quotes-api"],"latest_commit_sha":null,"homepage":"https://kitagawachan-api.vercel.app","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rakarmp.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2023-08-17T01:22:18.000Z","updated_at":"2024-07-02T21:07:03.000Z","dependencies_parsed_at":"2023-08-20T01:34:00.178Z","dependency_job_id":null,"html_url":"https://github.com/rakarmp/Kitagawachan-Api","commit_stats":null,"previous_names":["rakarmp/kitagawachan-api"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/rakarmp/Kitagawachan-Api","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rakarmp%2FKitagawachan-Api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rakarmp%2FKitagawachan-Api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rakarmp%2FKitagawachan-Api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rakarmp%2FKitagawachan-Api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rakarmp","download_url":"https://codeload.github.com/rakarmp/Kitagawachan-Api/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rakarmp%2FKitagawachan-Api/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":264176186,"owners_count":23568611,"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":["anime","anime-quotes","animeapi","animechan-api","query-quotes","quotes-api"],"created_at":"2025-03-01T23:44:14.112Z","updated_at":"2025-07-08T01:36:44.258Z","avatar_url":"https://github.com/rakarmp.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align='center'\u003e\n\u003cimg src='Kitagawachan.jpg' alt='kitagawachan' width='150px' height='200px'/\u003e\n\n  \u003ch3\u003eKitagawachan Api\u003c/h3\u003e\n\n\u003csamp\u003eRest Api Collection Quote Anime\u003c/samp\u003e\n\n\u003ch3\u003eBuilt Use\u003c/h3\u003e\n\u003cimg src=\"https://img.shields.io/badge/MongoDB-%234ea94b.svg?style=for-the-badge\u0026logo=mongodb\u0026logoColor=white\" alt=\"MongoDB\"/\u003e\n\u003cimg src=\"https://img.shields.io/badge/express.js-%23404d59.svg?style=for-the-badge\u0026logo=express\u0026logoColor=%2361DAFB\" alt=\"Express.js\"/\u003e\n\u003cimg src=\"https://img.shields.io/badge/node.js-6DA55F?style=for-the-badge\u0026logo=node.js\u0026logoColor=white\" alt=\"NodeJS\"/\u003e\n\u003c/div\u003e\n\n\u003cbr /\u003e\u003cbr /\u003e\n\n_Welcome to the Kitagawachan Api documentation. This API provides a collection of quotes from various anime series and characters. You can retrieve random quotes, quotes by anime title, quotes by anime character, create new quotes, and more. The API is built using Express.js and MongoDB._\n\nTo test the POST request functionality, you can visit the [Try POST Request Page](https://kitagawachan-api.vercel.app/trypost) in your web browser. This page allows you to submit quotes to the Kitagawachan-Api and see the response.\n\n**Base URL**: `http://localhost:8000` (Update the URL if your server is running on a different host/port)\n\n## Endpoints\n\n### 1. Get Random Quote\n\nRetrieve a random anime quote.\n\n- **URL**: `/quotes/random`\n- **Method**: GET\n- **Response**:\n\n```\n{\n  \"_id\": \"quote_id\",\n  \"anime\": \"Anime Title\",\n  \"character\": \"Character Name\",\n  \"quote\": \"Quote text...\"\n}\n```\n\n### 2. Get Random Quote by Anime Title\n\nRetrieve a random anime quote based on the provided anime title.\n\n- **URL**: `/quotes/random/:animeTitle`\n- **Method**: GET\n- **Parameters**:\n  - `animeTitle`: The title of the anime.\n- **Response**:\n\n```\n{\n  \"_id\": \"quote_id\",\n  \"anime\": \"Anime Title\",\n  \"character\": \"Character Name\",\n  \"quote\": \"Quote text...\"\n}\n```\n\n### 3. Get Random Quote by Anime Character\n\nRetrieve a random anime quote based on the provided anime character.\n\n- **URL**: `/quotes/random/character/:animeCharacter`\n- **Method**: GET\n- **Parameters**:\n  - `animeCharacter`: The name of the anime character.\n- **Response**:\n\n```\n{\n  \"_id\": \"quote_id\",\n  \"anime\": \"Anime Title\",\n  \"character\": \"Character Name\",\n  \"quote\": \"Quote text...\"\n}\n```\n\n### 4. Get Five Random Quotes\n\nRetrieve a list of five random anime quotes.\n\n- **URL**: `/quotes/random/5`\n- **Method**: GET\n- **Response**:\n\n```\n[\n  {\n    \"_id\": \"quote_id_1\",\n    \"anime\": \"Anime Title\",\n    \"character\": \"Character Name\",\n    \"quote\": \"Quote text...\"\n  },\n  {\n    \"_id\": \"quote_id_2\",\n    \"anime\": \"Anime Title\",\n    \"character\": \"Character Name\",\n    \"quote\": \"Quote text...\"\n  },\n  // ...\n]\n```\n\n### 5. Get Five Random Quotes by Anime Title\n\nRetrieve a list of five random anime quotes based on the provided anime title.\n\n- **URL**: `/quotes/random/5/:animeTitle`\n- **Method**: GET\n- **Parameters**:\n  - `animeTitle`: The title of the anime.\n- **Response**:\n\n```\n[\n  {\n    \"_id\": \"quote_id_1\",\n    \"anime\": \"Anime Title\",\n    \"character\": \"Character Name\",\n    \"quote\": \"Quote text...\"\n  },\n  {\n    \"_id\": \"quote_id_2\",\n    \"anime\": \"Anime Title\",\n    \"character\": \"Character Name\",\n    \"quote\": \"Quote text...\"\n  },\n  // ...\n]\n```\n\n### 6. Get Five Quotes by Anime Character\n\nRetrieve a list of five anime quotes based on the provided anime character.\n\n- **URL**: `/quotes/character/:animeCharacter`\n- **Method**: GET\n- **Parameters**:\n  - `animeCharacter`: The name of the anime character.\n- **Response**:\n\n```\n[\n  {\n    \"_id\": \"quote_id_1\",\n    \"anime\": \"Anime Title\",\n    \"character\": \"Character Name\",\n    \"quote\": \"Quote text...\"\n  },\n  {\n    \"_id\": \"quote_id_2\",\n    \"anime\": \"Anime Title\",\n    \"character\": \"Character Name\",\n    \"quote\": \"Quote text...\"\n  },\n  // ...\n]\n```\n\n### 7. Create a New Quote\n\nCreate a new anime quote.\n\n- **URL**: `/quotes`\n- **Method**: POST\n- **Request Body**:\n\n```\n{\n  \"anime\": \"Anime Title\",\n  \"character\": \"Character Name\",\n  \"quote\": \"Quote text...\"\n}\n```\n\n- **Response** (on successful creation):\n\n```\n{\n  \"_id\": \"new_quote_id\",\n  \"anime\": \"Anime Title\",\n  \"character\": \"Character Name\",\n  \"quote\": \"Quote text...\"\n}\n```\n\n### 8. Get Quotes with Pagination\n\nRetrieve a paginated list of anime quotes.\n\n- **URL**: `/quotes`\n- **Method**: GET\n- **Query Parameters**:\n  - `page`: Page number (default: 1)\n  - `limit`: Number of quotes per page (default: 10)\n- **Response**:\n\n```\n{\n  \"docs\": [\n    {\n      \"_id\": \"quote_id_1\",\n      \"anime\": \"Anime Title\",\n      \"character\": \"Character Name\",\n      \"quote\": \"Quote text...\"\n    },\n    {\n      \"_id\": \"quote_id_2\",\n      \"anime\": \"Anime Title\",\n      \"character\": \"Character Name\",\n      \"quote\": \"Quote text...\"\n    },\n    // ...\n  ],\n  \"totalPages\": 3,\n  \"currentPage\": 1\n  // ...\n}\n```\n\n## Error Responses\n\n- **Status Code**: 404 Not Found\n  - **Response**:\n\n```\n{\n  \"message\": \"Quote not found\"\n}\n```\n\n- **Status Code**: 500 Internal Server Error\n  - **Response**:\n\n```\n{\n  \"error\": \"Error message...\"\n}\n```\n\n**Note**: Replace `localhost:8000` with the appropriate base URL if your server is running on a different host or port. Make sure you have MongoDB properly configured and running.\n\nThat concludes the updated documentation for the Anime Quote API. Feel free to use these endpoints to fetch and create quotes from various anime series and characters. If you encounter any issues or have questions, please refer to the provided code or seek further assistance.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frakarmp%2Fkitagawachan-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frakarmp%2Fkitagawachan-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frakarmp%2Fkitagawachan-api/lists"}