{"id":18397677,"url":"https://github.com/arufars/api-blue-archive","last_synced_at":"2025-04-07T04:33:30.794Z","repository":{"id":157771735,"uuid":"555906631","full_name":"arufars/api-blue-archive","owner":"arufars","description":"open-source api character information from blue archive game.","archived":false,"fork":false,"pushed_at":"2024-07-08T02:47:53.000Z","size":1047,"stargazers_count":37,"open_issues_count":6,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-22T13:37:41.695Z","etag":null,"topics":["anime","api","api-rest","blue-archive","bluearchive","free-api","game","rest-api"],"latest_commit_sha":null,"homepage":"https://api-blue-archive.vercel.app","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/arufars.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}},"created_at":"2022-10-22T16:04:13.000Z","updated_at":"2025-03-20T16:51:35.000Z","dependencies_parsed_at":"2024-02-07T11:34:38.220Z","dependency_job_id":"70e6068e-8848-4894-a46f-7fcf6595d929","html_url":"https://github.com/arufars/api-blue-archive","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/arufars%2Fapi-blue-archive","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arufars%2Fapi-blue-archive/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arufars%2Fapi-blue-archive/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arufars%2Fapi-blue-archive/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/arufars","download_url":"https://codeload.github.com/arufars/api-blue-archive/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247595370,"owners_count":20963939,"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","api","api-rest","blue-archive","bluearchive","free-api","game","rest-api"],"created_at":"2024-11-06T02:18:03.647Z","updated_at":"2025-04-07T04:33:25.808Z","avatar_url":"https://github.com/arufars.png","language":"TypeScript","funding_links":[],"categories":["Index"],"sub_categories":["Games \u0026 Comics"],"readme":"# Blue Archive API\n\n![](https://img.shields.io/website?down_message=offline\u0026style=flat-square\u0026up_message=online\u0026url=https%3A%2F%2Fapi-blue-archive.vercel.app%2F)\n\nbaseurl: https://api-blue-archive.vercel.app\n\n\n# Overview\n\nThis is an open source API providing character information about the Blue Archive.This information is sourced from the public, i do not claim to own it.\n\n\n# Technologies use\n\nNextjs, MongoDB, Mongoose, Vercel, Nextjscors, Typescript, Tailwindcss ( UI )\n\n# Route\n\nAll Route and Example results\n\n### Get all characters Blue Archive ( By default 20 )\n\n\u003e endpoint : [`/api/characters`](https://api-blue-archive.vercel.app/api/characters)\n\n\u003cdetails\u003e\n  \u003csummary\u003e\u003cem\u003ePayload Example\u003c/em\u003e\u003c/summary\u003e\n\n  ```json\n    {\n      \"_id\": \"634105b907843834fd29f006\",\n      \"name\": \"Airi\",\n      \"school\": \"Trinity\",\n      \"birthday\": \"January 30\",\n      \"photoUrl\": \"https://static.miraheze.org/bluearchivewiki/thumb/9/96/Airi.png/266px-Airi.png\",\n      \"imageSchool\": \"https://static.miraheze.org/bluearchivewiki/thumb/9/9c/Trinity.png/50px-Trinity.png\",\n      \"damageType\": \"Explosive\"\n    }\n  ```\n\u003c/details\u003e\n\n\n### Get all characters pagination ( 20 )\n\n\u003e endpoint : [`/api/characters?page=NUMBER\u0026perPage=NUMBER`](https://api-blue-archive.vercel.app/api/characters?page=1\u0026perPage=20)\n\n\u003cdetails\u003e\n  \u003csummary\u003e\u003cem\u003ePayload Example\u003c/em\u003e\u003c/summary\u003e\n\n ```json\n  {\n    \"_id\": \"6341063807843834fd29f0aa\",\n    \"name\": \"Iori\",\n    \"school\": \"Gehenna\",\n    \"birthday\": \"November 8\",\n    \"photoUrl\": \"https://static.miraheze.org/bluearchivewiki/thumb/2/26/Iori.png/266px-Iori.png\",\n    \"imageSchool\": \"https://static.miraheze.org/bluearchivewiki/thumb/b/bd/Gehenna.png/50px-Gehenna.png\",\n    \"damageType\": \"Penetration\"\n  }\n  ```\n\u003c/details\u003e\n\n\n\n### Get characters with a specific name, choice Asuna, Hibiki\n\n\u003e endpoint : [`/api/characters?name=Aru`](https://api-blue-archive.vercel.app)\n\u003e you can choose a `query` other than `name`, [more](#query)\n\n\u003cdetails\u003e\n  \u003csummary\u003e\u003cem\u003ePayload Example\u003c/em\u003e\u003c/summary\u003e\n\n  ```json\n    {\n      \"_id\": \"634105c607843834fd29f01a\",\n      \"name\": \"Aru\",\n      \"school\": \"Gehenna\",\n      \"birthday\": \"March 12\",\n      \"photoUrl\": \"https://static.miraheze.org/bluearchivewiki/thumb/d/db/Aru.png/266px-Aru.png\",\n      \"imageSchool\": \"https://static.miraheze.org/bluearchivewiki/thumb/b/bd/Gehenna.png/50px-Gehenna.png\",\n      \"damageType\": \"Explosive\"\n    }\n  ```\n\u003c/details\u003e\n\n\n\n### Get random character ( 1 )\n\n\u003e endpoint : [`/api/character/random`](https://api-blue-archive.vercel.app) \n\n\u003e You can use query count to get more than 1 character\n\u003e endpoint : [`/api/character/random?count=NUMBER`](http://localhost:3000/api/character/random?count=2)\n\n\u003cdetails\u003e\n  \u003csummary\u003e\u003cem\u003ePayload Example\u003c/em\u003e\u003c/summary\u003e\n  \n  ```json\n    {\n      \"_id\": \"634106a407843834fd29f11a\",\n      \"name\": \"Miyako\",\n      \"names\": {\n        \"firstName\": \"Miyako\",\n        \"lastName\": \"Tsukiyuki\",\n        \"japanName\": \" 月雪 ミヤコ\",\n        \"_id\": \"634106a407843834fd29f11b\"\n      },\n\n      \"age\": \"15\",\n      \"school\": \"SRT\",\n      \"birthday\": \"January 7\",\n      \"photoUrl\": \"https://static.miraheze.org/bluearchivewiki/thumb/3/3e/Miyako.png/266px-Miyako.png\",\n      \"imageSchool\": \"https://static.miraheze.org/bluearchivewiki/thumb/5/5a/SRT.png/50px-SRT.png\"\n    }\n  ```\n\u003c/details\u003e\n\n\n\n### Get all students specific ( By default 4 )\n\n\u003e endpoint : [`/api/characters/students`](https://api-blue-archive.vercel.app)\n\n\u003cdetails\u003e\n  \u003csummary\u003e\u003cem\u003ePayload Example\u003c/em\u003e\u003c/summary\u003e\n  \n```json\n  {\n    \"_id\": \"634105c207843834fd29f012\",\n    \"name\": \"Ako\",\n    \"names\": {\n      \"firstName\": \"Ako\",\n      \"lastName\": \"Amau\",\n      \"japanName\": \" 天雨 アコ\"\n    },\n    \"age\": \"17\",\n    \"school\": \"Gehenna\",\n    \"birthday\": \"December 22\",\n    \"background\": \"A student of Gehenna Academy, Ako is the executive officer of the Disciplinary Committee, and a sort-of secretary to its president Hina. At first glance she may appear kind and good-natured, but Ako has zero tolerance for students who break the rules. She is constantly at Hina's side, assisting in her duties as president of the Disciplinary Committee. This has prompted other students to call her \\\"Hina's Pet\\\" amongst other things, but Ako doesn't particulary care.\",\n    \"height\": \"165cm\",\n    \"photoUrl\": \"https://static.miraheze.org/bluearchivewiki/thumb/7/72/Ako.png/266px-Ako.png\",\n    \"imageSchool\": \"https://static.miraheze.org/bluearchivewiki/thumb/b/bd/Gehenna.png/50px-Gehenna.png\",\n    \"hobbies\": [\"President Hina\"],\n    \"voice\": \"Kouno Marika\",\n    \"voices\": \"https://static.miraheze.org/bluearchivewiki/a/aa/Ako_Title.ogg\",\n    \"role\": [\"Support/Back\", \"Support\", \"Back\"],\n    \"damageType\": \"Mystic\",\n    \"armorType\": \"Heavy\",\n    \"affinity\": [\n      {\n        \"urban\": \"https://static.miraheze.org/bluearchivewiki/thumb/1/13/Icon_location_city.png/24px-Icon_location_city.png\",\n        \"urbanEmotion\": \"https://static.miraheze.org/bluearchivewiki/thumb/8/81/Icon_mood_d.png/20px-Icon_mood_d.png\"\n      },\n\n      {\n        \"outdoors\": \"https://static.miraheze.org/bluearchivewiki/thumb/6/6d/Icon_location_outdoors.png/24px-Icon_location_outdoors.png\",\n        \"outdoorsEmotion\": \"https://static.miraheze.org/bluearchivewiki/thumb/5/5f/Icon_mood_b.png/20px-Icon_mood_b.png\"\n      },\n\n      {\n        \"indoors\": \"https://static.miraheze.org/bluearchivewiki/thumb/c/c1/Icon_location_indoors.png/24px-Icon_location_indoors.png\",\n        \"indoorsEmotion\": \"https://static.miraheze.org/bluearchivewiki/thumb/e/e3/Icon_mood_s.png/20px-Icon_mood_s.png\"\n      }\n    ],\n    \"weapon\": \"HG\",\n    \"weaponUnique\": \"Hotshot\",\n    \"weaponImage\": \"https://static.miraheze.org/bluearchivewiki/6/6f/Weapon_Icon_20008.png\",\n    \"realeaseDate\": \"2021/11/17\"\n  }\n\n  ```\n\u003c/details\u003e\n\n\n\n \u003ch3 id=\"query\"\u003eAll Query\u003c/h3\u003e\n \nAll keys can make requests from query\n\n| Query          |\n| -------------- |\n| `name`         |\n| `names`        |\n| `age`          |\n| `birthday`     |\n| `heigth`       |\n| `school`       |\n| `hobbies`      |\n| `voice`        |\n| `damageType`   |\n| `role`         |\n| `armorType`    |\n| `affinity`     |\n| `weapon`       |\n| `realeaseDate` |\n\n# Error Handling\n\nAsk for assistance from us if you need it or if something doesn't seem to be working right.\n\n\u003cbr /\u003e\n\n# License\n\nThis project is licensed under the MIT License - see the [LICENSE](https://github.com/arufars/api-blue-archive/blob/main/LICENSE) file for details\n\n\u003cbr /\u003e\n\n# Acknowledgments\n\n- [Blue Archive](https://bluearchive.wiki/wiki/Main_Page)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Farufars%2Fapi-blue-archive","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Farufars%2Fapi-blue-archive","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Farufars%2Fapi-blue-archive/lists"}