Marvel Module¶

class marvel.marvel.Marvel(public_key, private_key)¶

Marvel API class

This class provides methods to interface with the Marvel API

>>> m = Marvel("acb123....", "efg456...")

get_character(id)¶

Fetches a single character by id.

get /v1/public/characters

Parameters:	id – ID of Character
Returns:	CharacterDataWrapper

>>> m = Marvel(public_key, private_key)
>>> cdw = m.get_character(1009718)
>>> print cdw.data.count
1
>>> print cdw.data.results[0].name
Wolverine

get_characters(*args, **kwargs)¶

Fetches lists of comic characters with optional filters.

get /v1/public/characters/{characterId}

Returns:	CharacterDataWrapper

>>> m = Marvel(public_key, private_key)
>>> cdw = m.get_characters(orderBy="name,-modified", limit="5", offset="15")
>>> print cdw.data.count
1401
>>> for result in cdw.data.results:
...     print result.name
Aginar
Air-Walker (Gabriel Lan)
Ajak
Ajaxis
Akemi

get_comic(id)¶

Fetches a single comic by id.

get /v1/public/comics/{comicId}

Parameters:	id – ID of Comic
Returns:	ComicDataWrapper

>>> m = Marvel(public_key, private_key)
>>> cdw = m.get_comic(1009718)
>>> print cdw.data.count
1
>>> print cdw.data.result.name
Some Comic

get_comics(*args, **kwargs)¶

Fetches list of comics.

get /v1/public/comics

Returns:	ComicDataWrapper

>>> m = Marvel(public_key, private_key)
>>> cdw = m.get_comics(orderBy="issueNumber,-modified", limit="10", offset="15")
>>> print cdw.data.count
10
>>> print cdw.data.results[0].name
Some Comic

get_creator(id)¶

Fetches a single creator by id.

get /v1/public/creators/{creatorId}

Parameters:	id – ID of Creator
Returns:	CreatorDataWrapper

>>> m = Marvel(public_key, private_key)
>>> cdw = m.get_creator(30)
>>> print cdw.data.count
1
>>> print cdw.data.result.fullName
Stan Lee

get_creators(*args, **kwargs)¶

Fetches lists of creators.

get /v1/public/creators

Returns:	CreatorDataWrapper

>>> m = Marvel(public_key, private_key)
>>> cdw = m.get_creators(lastName="Lee", orderBy="firstName,-modified", limit="5", offset="15")
>>> print cdw.data.total
25
>>> print cdw.data.results[0].fullName
Alvin Lee

get_event(id)¶

Fetches a single event by id.

get /v1/public/event/{eventId}

Parameters:	id – ID of Event
Returns:	EventDataWrapper

>>> m = Marvel(public_key, private_key)
>>> response = m.get_event(253)
>>> print response.data.result.title
Infinity Gauntlet

get_events(*args, **kwargs)¶

Fetches lists of events.

get /v1/public/events

Returns:	EventDataWrapper

>>> #Find all the events that involved both Hulk and Wolverine
>>> #hulk's id: 1009351
>>> #wolverine's id: 1009718
>>> m = Marvel(public_key, private_key)
>>> response = m.get_events(characters="1009351,1009718")
>>> print response.data.total
38
>>> events = response.data.results
>>> print events[1].title
Age of Apocalypse

get_series(*args, **kwargs)¶

Fetches lists of events.

get /v1/public/events

Returns:	SeriesDataWrapper

>>> #Find all the series that involved Wolverine
>>> #wolverine's id: 1009718
>>> m = Marvel(public_key, private_key)
>>> response = m.get_series(characters="1009718")
>>> print response.data.total
435
>>> series = response.data.results
>>> print series[0].title
5 Ronin (2010)

get_single_series(id)¶

Fetches a single comic series by id.

get /v1/public/series/{seriesId}

Parameters:	id – ID of Series
Returns:	SeriesDataWrapper

>>> m = Marvel(public_key, private_key)
>>> response = m.get_single_series(12429)
>>> print response.data.result.title
5 Ronin (2010)

get_stories(*args, **kwargs)¶

Fetches lists of stories.

get /v1/public/stories

Returns:	StoryDataWrapper

>>> #Find all the stories that involved both Hulk and Wolverine
>>> #hulk's id: 1009351
>>> #wolverine's id: 1009718
>>> m = Marvel(public_key, private_key)
>>> response = m.get_stories(characters="1009351,1009718")
>>> print response.data.total
4066
>>> stories = response.data.results
>>> print stories[1].title
Cover #477

get_story(id)¶

Fetches a single story by id.

get /v1/public/stories/{storyId}

Parameters:	id – ID of Story
Returns:	StoryDataWrapper

>>> m = Marvel(public_key, private_key)
>>> response = m.get_story(29)
>>> print response.data.result.title
Caught in the heart of a nuclear explosion, mild-mannered scientist Bruce Banner finds himself...