New Comic Book Day API

Overview

The Shortboxed comics api is a simple and free api to help retrieve and query new comic book day data in json. All services provided are best effort. Feel free to let us know how you're using the api as we'd love to promote it.

Bugs or feature requests? Contact us at [email protected]

API Domain: api.shortboxed.com

Apps Using The API

New Comic Book Day

Get new releases

Returns this weeks current new releases 
 GET /comics/v1/new

        comics: 
        [
            {
                publisher: "MARVEL COMICS",
                description: " Showdown on Wall Street!",
                title: "CAPTAIN AMERICA SAM WILSON #6",
                price: "$3.99",
                creators: "(W) Nick Spencer (A) Joe Bennett (CA) Oscar Jimenez",
                release_date: "2016-02-03",
                diamond_id: "DEC150773"
            },
            {
                publisher: "DC COMICS",
                description: "Let the doctor make you strong, ",
                title: "BATMAN BEYOND #9",
                price: "$2.99",
                creators: "(W) Dan Jurgens (A) Bernard Chang (CA) Philip Tan",
                release_date: "2016-02-03",
                diamond_id: "DEC150278"
            },

            ...
        ]

Get previous releases

Returns last weeks new releases 
 GET /comics/v1/previous

        comics:
        [
            {
                publisher: "MARVEL COMICS",
                description: " Showdown on Wall Street!",
                title: "CAPTAIN AMERICA SAM WILSON #6",
                price: "$3.99",
                creators: "(W) Nick Spencer (A) Joe Bennett (CA) Oscar Jimenez",
                release_date: "2016-02-03",
                diamond_id: "DEC150773"
            },
            {
                publisher: "DC COMICS",
                description: "Let the doctor make you strong, ",
                title: "BATMAN BEYOND #9",
                price: "$2.99",
                creators: "(W) Dan Jurgens (A) Bernard Chang (CA) Philip Tan",
                release_date: "2016-02-03",
                diamond_id: "DEC150278"
            },

            ...
        ]

Get future releases

Returns next weeks new releases 
 GET /comics/v1/future

        comics:
        [
            {
                publisher: "MARVEL COMICS",
                description: " Showdown on Wall Street!",
                title: "CAPTAIN AMERICA SAM WILSON #6",
                price: "$3.99",
                creators: "(W) Nick Spencer (A) Joe Bennett (CA) Oscar Jimenez",
                release_date: "2016-02-03",
                diamond_id: "DEC150773"
            },
            {
                publisher: "DC COMICS",
                description: "Let the doctor make you strong, ",
                title: "BATMAN BEYOND #9",
                price: "$2.99",
                creators: "(W) Dan Jurgens (A) Bernard Chang (CA) Philip Tan",
                release_date: "2016-02-03",
                diamond_id: "DEC150278"
            },

            ...
        ]

Query

You can query new comic book releases using query string paramters. If undefined, the default release date will be the most current. Refer to available releases endpoint for release availability. 
 GET /comics/v1/query?release_date=2016-02-17&title=thor&publisher=marvel&creator=jason

        comics:
        [
            {
                publisher: "MARVEL COMICS",
                description: "The path of the All-Mother and Asgard is torn apart by civil war...",
                title: "MIGHTY THOR #4",
                price: "$3.99",
                creators: "(W) Jason Aaron (A/CA) Russell Dauterman",
                release_date: "2016-02-17",
                diamond_id: "DEC150774"
            }
        ]
Name Type Description
release_date string (optional) A valid comic book release date can be provided in iso8601 format (ie: 2016-02-17). Defaults to most current release if undefined
publisher string (optional) Any valid publisher
title string (optional) Any comic book title
creators string (optional) Any creator name

Get Release Date

Fetch data for a titles with a specific release date. Currently, the backlog of releases are severely limited. I need to find a sources for past releases 
 GET /comics/v1/release_date/2016-02-17

    comics:
    [
        {
            publisher: "MARVEL COMICS",
            description: "The path of the All-Mother and Asgard is torn apart by civil war...",
            title: "MIGHTY THOR #4",
            price: "$3.99",
            creators: "(W) Jason Aaron (A/CA) Russell Dauterman",
            release_date: "2016-02-17",
            diamond_id: "DEC150774"
        }
    ]

Available Release Dates

Fetch all available release dates 
 GET /comics/v1/releases/available

    dates:
    [
        "2015-04-01",
        "2016-01-20",
        "2016-01-27",
        "2016-02-03",
        "2016-02-10",
        "2016-02-17"
    ]

Diamond ID

Fetch data for a specific diamond id 
 GET /comics/v1/diamond_id/DEC150774

    comics:
    [
        {
            publisher: "MARVEL COMICS",
            description: "The path of the All-Mother and Asgard is torn apart by civil war...",
            title: "MIGHTY THOR #4",
            price: "$3.99",
            creators: "(W) Jason Aaron (A/CA) Russell Dauterman",
            release_date: "2016-02-17",
            diamond_id: "DEC150774"
        }
    ]