{"id":19284163,"url":"https://github.com/swang/marvel","last_synced_at":"2025-04-22T03:31:49.414Z","repository":{"id":13803680,"uuid":"16499524","full_name":"swang/marvel","owner":"swang","description":"API wrapper for Marvel Comics","archived":false,"fork":false,"pushed_at":"2022-12-30T20:20:32.000Z","size":173,"stargazers_count":13,"open_issues_count":6,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-10-31T18:17:47.168Z","etag":null,"topics":["marvel","marvel-api","marvel-comics"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","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/swang.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2014-02-04T01:53:47.000Z","updated_at":"2020-09-05T19:58:27.000Z","dependencies_parsed_at":"2023-01-14T07:00:13.053Z","dependency_job_id":null,"html_url":"https://github.com/swang/marvel","commit_stats":null,"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/swang%2Fmarvel","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/swang%2Fmarvel/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/swang%2Fmarvel/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/swang%2Fmarvel/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/swang","download_url":"https://codeload.github.com/swang/marvel/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":223888475,"owners_count":17220074,"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":["marvel","marvel-api","marvel-comics"],"created_at":"2024-11-09T21:36:49.580Z","updated_at":"2024-11-09T21:36:50.272Z","avatar_url":"https://github.com/swang.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# marvel\nMarvel is an API wrapper for Marvel's Comics API\n\n[![Build Status](https://travis-ci.org/swang/marvel.png?branch=master)](https://travis-ci.org/swang/marvel)\n\n### v1.1 will be the last release to support node v0.10.0/v0.12.0\n\n# install\n\n```\nnpm install marvel\n```\n\n# examples\n\n```js\nvar Marvel = require('marvel')\n\nvar marvel = new Marvel({ publicKey: \"\u003cpubKey\u003e\", privateKey: \"\u003cprivateKey\u003e\"})\n\nmarvel.characters\n  .name(\"Hulk\")\n  .get(function(err, resp) {\n    if (err) { console.log(\"Error: \", err) }\n    else { console.log(resp) }\n  })\n```\n\nThis finds out the event id for \"Civil War\" and then returns 50 characters that were in the event (along with their thumbnail picture, if applicable)\n\n```js\nvar Marvel = require('marvel')\n\nvar marvel = new Marvel({ publicKey: \"\u003cpubKey\u003e\", privateKey: \"\u003cprivateKey\u003e\"})\n\nmarvel.events\n  .name(\"civil war\")\n  .get(function(err, res) {\n    if (err) { throw err }\n    var eventId = res[0].id\n\n    marvel.characters\n      .events(eventId)\n      .limit(50)\n      .get(function(err, res) {\n        if (err) { throw err }\n        res.forEach(function(chr) {\n          console.log(chr.name + \" \" + (!!chr.thumbnail ? (chr.thumbnail.path + \".\" + chr.thumbnail.extension) : \"\"))\n        })\n      })\n  })\n```\n\n# documentation\n\nThis new version of the Marvel library tries to make it easier to form queries.\n\n\u003e ## characters\n\n##### #id(character_id)\nSearches for a character with an id of, `character_id`.\n\n##### #name(name)\nSearches for the character named, `name`.\n\n##### #nameStartsWith(name)\nSearches for characters whose name begins with `name`.\n\n##### #modifiedSince(date)\nLimits results to characters that have been modified after inputed `date` (format is: 2014-06-10T16:12:58-0400).\n\n##### #orderBy(field)\nOrders the returning JSON by the field, `field`. If a minus sign (-) is in front of the `field`, then it returns in descending order.\n\nOptions are: name, modified, -name, -modified\n\n##### #offset(num)\nReturns results only after `num` matches have occurred.\n\n##### #limit(offset, num)\nIf two parameters are given, it returns `num` results only after `offset` records have been returned.\nIf only one parameter is given, it returns the first `num` results.\n\n\u003e ## comics\n\n##### #id(comic_id)\nSearches for a comic with an id of, `comic_id`.\n\n##### #format(name)\nReturn comics that only contain format, `name`\n\nOptions are: comic, magazine, trade paperback, hardcover, digest, graphic novel, digital comic, infinite comic\n\n##### #formatType(type)\nReturn comics that only contain format type, `type`\n\nOptions are: comic, collection\n\n##### #noVariants(bool)\nWhether or not to exclude \"variants\" of the comic, e.g. alternate covers (true for yes, false for no)\n\n##### #dateDescriptor(dateString)\nReturn comics within the time period specified in `dateString`\n\nOptions are: lastWeek, thisWeek, nextWeek, thisMonth\n\n##### #dateRange(date[, date2, date3])\nReturn comics within the predefined range in `date` with additional dates separated by commas\n\n##### #title(name)\nSearches for comics named, `name`.\n\n##### #titleStartsWith(name)\nSearches for comics whose name begins with `name`.\n\n##### #startYear(num)\nLimits results to comic series that started in the year `num`\n\n##### #issueNumber(num)\nLooks only for comics whose issue number match `num`\n\n##### #diamondCode(code)\nFilter by Diamond Code `code`\n\n##### #digitalId(num)\nFilter by Digital ID, `num`\n\n##### #upc(code)\nFilter by UPC code, `code`\n\n##### #isbn(code)\nFilter by ISBN code, `code`\n\n##### #ean(code)\nFilter by EAN code, `code`\n\n##### #issn(code)\nFilter by ISSN code, `code`\n\n##### #hasDigitalIssue(bool)\nIncludes only results which are available digitally if `bool` is true.\n\n##### #sharedAppearances(charId[, charId2, charId3])\nAccepts a comma-separated list of IDs which match only comics in which those characters have appeared together\n\n##### #collaborators(creatorId[, creatorId2, creatorId3])\nAccepts a comma-separated list of IDs which match only comics in which those creators have appeared together\n\n##### #modifiedSince(date)\nLimits results to characters that have been modified after inputed `date` (format is: 2014-06-10T16:12:58-0400).\n\n##### #orderBy(field)\nOrders the returning JSON by the field, `field`. If a minus sign (-) is in front of the `field`, then it returns in descending order.\n\nOptions are: focDate, onsaleDate, title, issueNumber, modified, -focDate, -onsaleDate, -title, -issueNumber, -modified\n\n##### #offset(num)\nReturns results only after `num` matches have occurred.\n\n##### #limit(offset, num)\nIf two parameters are given, it returns `num` results only after `offset` records have been returned.\nIf only one parameter is given, it returns the first `num` results.\n\n\u003e ## creators\n\n##### #id(creator_id)\nSearches for a creator with an id of, `creator_id`.\n\n##### #firstName(name)\nSearches for creators with first name, `name`.\n\n##### #middleName(name)\nSearches for creator with middle name, `name`.\n\n##### #lastName(name)\nSearches for creator with last name, `name`.\n\n##### #suffix(name)\nSearches for creator with suffix/honorific, `name`.\n\n##### #nameStartsWith(str)\nSearches for creator's name that begins with `str`.\n\n##### #firstNameStartsWith(str)\nSearches for creator's first name that begins with `str`.\n\n##### #middleNameStartsWith(str)\nSearches for creator's middle name that begins with `str`.\n\n##### #lastNameStartsWith(str)\nSearches for creator's last name that begins with `str`.\n\n##### #modifiedSince(date)\nLimits results to characters that have been modified after inputed `date` (format is: 2014-06-10T16:12:58-0400).\n\n##### #orderBy(field)\nOrders the returning JSON by the field, `field`. If a minus sign (-) is in front of the `field`, then it returns in descending order.\n\nOptions are: lastName, firstName, middleName, suffix, modified, -lastName, -firstName, -middleName, -suffix, -modified\n\n##### #offset(num)\nReturns results only after `num` matches have occurred.\n\n##### #limit(offset, num)\nIf two parameters are given, it returns `num` results only after `offset` records have been returned.\nIf only one parameter is given, it returns the first `num` results.\n\n\u003e ## events\n\n##### #id(event_id)\nSearches for an event with an id of `event_id`.\n\n##### #name(name)\nSearches for the event named, `name`.\n\n##### #nameStartsWith(name)\nSearches for events whose name begins with `name`.\n\n##### #modifiedSince(date)\nLimits results to characters that have been modified after inputed `date` (format is: 2014-06-10T16:12:58-0400).\n\n##### #orderBy(field)\nOrders the returning JSON by the field, `field`. If a minus sign (-) is in front of the `field`, then it returns in descending order.\n\nOptions are: name, startDate, modified, -name, -startDate, -modified\n\n##### #offset(num)\nReturns results only after `num` matches have occurred.\n\n##### #limit(offset, num)\nIf two parameters are given, it returns `num` results only after `offset` records have been returned.\nIf only one parameter is given, it returns the first `num` results.\n\n\u003e ## series\n\n##### #id(series_id)\nSearches for a series with an id of `series_id`.\n\n##### #title(name)\nSearches for series named, `name`.\n\n##### #titleStartsWith(name)\nSearches for series whose name begins with `name`.\n\n##### #startYear(num)\nLimits results to comic series that started in the year `num`\n\n##### #seriesType(type)\nFilter the series by publication frequency type.\n\nOptions are: collection, one shot, limited, ongoing\n\n##### #contains(format[,format2])\nReturn only series that contain one or more comics with the specified format\n\nOptions are: comic, magazine, trade paperback, hardcover, digest, graphic novel, digital comic, infinite comic\n\n##### #modifiedSince(date)\nLimits results to characters that have been modified after inputed `date` (format is: 2014-06-10T16:12:58-0400).\n\n##### #orderBy(field)\nOrders the returning JSON by the field, `field`. If a minus sign (-) is in front of the `field`, then it returns in descending order.\n\nOptions are: title, modified, startYear, -title, -modified, -startYear\n\n##### #offset(num)\nReturns results only after `num` matches have occurred.\n\n##### #limit(offset, num)\nIf two parameters are given, it returns `num` results only after `offset` records have been returned.\nIf only one parameter is given, it returns the first `num` results.\n\n\u003e ## stories\n\n##### #id(story_id)\nSearches for a story with an id of `story_id`.\n\n##### #modifiedSince(date)\nLimits results to characters that have been modified after inputed `date` (format is: 2014-06-10T16:12:58-0400).\n\n##### #orderBy(str)\nOrders the returning JSON by the field `str`. If a minus sign (-) is in front of the `str`, then it orders in descending order.\n\n##### #offset(num)\nReturns results only after `num` matches have occurred.\n\n##### #limit(offset, num)\nIf two parameters are given, it returns `num` results only after `offset` records have been returned.\nIf only one parameter is given, it returns the first `num` results.\n\n# license\nMIT\n\n# author\nShuan Wang (shuanwang@gmail.com)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fswang%2Fmarvel","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fswang%2Fmarvel","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fswang%2Fmarvel/lists"}