{"id":16433912,"url":"https://github.com/danielsogl/marvel-api-wrapper","last_synced_at":"2025-10-27T02:30:48.057Z","repository":{"id":45425496,"uuid":"130843482","full_name":"danielsogl/marvel-api-wrapper","owner":"danielsogl","description":"A simple to use Marvel API wrapper powered by Express.js and TypeScript","archived":false,"fork":false,"pushed_at":"2023-12-15T17:57:31.000Z","size":187,"stargazers_count":5,"open_issues_count":1,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-02-01T01:32:48.296Z","etag":null,"topics":["api-wrapper","express","heroku","marvel-api","nodejs","typescript"],"latest_commit_sha":null,"homepage":"","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/danielsogl.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-04-24T11:27:20.000Z","updated_at":"2021-01-30T01:19:28.000Z","dependencies_parsed_at":"2022-09-12T21:41:14.906Z","dependency_job_id":null,"html_url":"https://github.com/danielsogl/marvel-api-wrapper","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/danielsogl%2Fmarvel-api-wrapper","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/danielsogl%2Fmarvel-api-wrapper/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/danielsogl%2Fmarvel-api-wrapper/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/danielsogl%2Fmarvel-api-wrapper/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/danielsogl","download_url":"https://codeload.github.com/danielsogl/marvel-api-wrapper/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":238422804,"owners_count":19469620,"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-wrapper","express","heroku","marvel-api","nodejs","typescript"],"created_at":"2024-10-11T08:47:36.179Z","updated_at":"2025-10-27T02:30:42.749Z","avatar_url":"https://github.com/danielsogl.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Marvel API Wrapper\n\n[![Build Status](https://travis-ci.org/danielsogl/marvel-api-wrapper.svg?branch=master)](https://travis-ci.org/danielsogl/marvel-api-wrapper)\n\nA simple to use Marvel API wrapper powered by [Express.js](http://expressjs.com/de/) and [TypeScript](https://www.typescriptlang.org)\n\n![Marvel logo](https://upload.wikimedia.org/wikipedia/commons/0/04/MarvelLogo.svg 'Marvel API Wrapper')\n\n## About\n\nThis repository allows you to use the official [Marvel API](https://developer.marvel.com) with some awesome features.\n\n* Caching\n* Simple configuration\n* Only requests without another Marvel API library\n\nAnd the best feature is you only need to call the API wrapper like you would call the official API. So you don't need to read two documentations.\n\n```http\nhttp://localhost:8080/characters\nhttp://localhost:8080/comics\n...\n```\n\nYou can also add the documented URL parameters like this:\n\n```http\nhttp://localhost:8080/characters?nameStartsWith=S\u0026orderBy=-name\u0026limit=50\u0026offset=10\n```\n\n## Setup\n\n1.  Go to the official [Marvel developers](https://developer.marvel.com) website and create a new account. After that, you will find a private and a public key inside your developer's profile page.\n\n2.  Generate a new `.env` file inside the root path of this repository and place them like this:\n\n```text\nPUBLIC_KEY=12345\nPRIVATE_KEY=12345\n```\n\n3.  Start the server by running the `npm run watch` command.\n\n## Build\n\nBecause this repository is built in TypeScript you have to compile the `*.ts` files to plain JavaScript.\nRun `npm run build` and the compiled `*.js` files are placed inside the `dist` folder.\n\n## Deploy\n\nI recommend using [Heroku](https://www.heroku.com) to deploy this repository because of nearly zero configuration and zero costs. Heroku also gives you the ability to use Redis as in-memory-database. The repository is already configured to run out of the box on Heroku.\n\n[![Deploy](https://www.herokucdn.com/deploy/button.svg)](https://heroku.com/deploy?template=https://github.com/danielsogl/marvel-api-wrapper)\n\n## Test\n\nI added basic unit tests to this repository. You find them inside the `./tests` folder. Feel free to add your own.\nTo run the tests just run `npm run tests`.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdanielsogl%2Fmarvel-api-wrapper","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdanielsogl%2Fmarvel-api-wrapper","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdanielsogl%2Fmarvel-api-wrapper/lists"}