Avatar image for rick
#1 Edited by rick (119 posts) - - Show Bio

OK, no promises. We'll try to add stuff to the API that may be missing. The simpler the request the more likely it will be added. If you've got a request, reply here. Please be concise. Tell us what entity you want what data added to. Also give is a sample use case if your request isn't 100% evident. Psuedo code is best. Too much English will end up being TL;DR, we all have ADHD here.

Avatar image for hyperspacerebel
#2 Edited by Hyperspacerebel (8 posts) - - Show Bio

The easiest addition to the api to get the CVS off of scraping the html is to add two new fields to the issue query:

  1. image_alternates - a list of urls to all alternate images attached to the issue (e.g. The 13 images all stacked up on the right side of this issue page)
  2. user_review_average - a float specifying the average review score for the issue (e.g. 4.25 on this issue page)

There's other user review info that could be cool to have access to, however that specifically is not needed with the currently built CVS as I understand it.

Hopefully someone else has looked at the plugin code and can confirm those are the two pieces of data we'd need. I've looked through most of the codebase and I've got a fairly good grasp of it, but I could easily have overlooked something.

Avatar image for cbanack
#3 Edited by cbanack (124 posts) - - Show Bio

Yes, @hyperspacerebel, you are correct.

If the API provided those to fields of data in the 'issue' entity, it would allow the '__issue_scrape_extra_details' function in cvdb.py to be removed, and that is the only place where Comic Vine Scraper scrapes HTML directly. Essentially, CVS could stop scraping HTML with no loss of functionality at all.

Also note that the 'user_review_average' is not nearly as important as the 'image_alternatives'. 'Image_alternatives' is used for automatic cover matching and manually displaying additional covers. This is one of the centerpiece functionalities of the scraper--something that a LOT of people would really miss. The user_review_average is only for scraping one little, optional field and would not be missed nearly so much.

Avatar image for jkthemac
#4 Posted by JKtheMac (6 posts) - - Show Bio

Thinking across the board for the widest number of API uses, the main thing missing is a weekly release based resource. If you had a release_date resource an API dedicated to accessing information about new comics would hardly ever have to use any other resource. Searching for volume and issue data would become unnecessary because you are starting from specific information.

What should be included in such a resource is open for debate, but consider it from the perspective of an application telling users which comics are on the shelves on any particular week, and which info they would need to make a decision to purchase it and you couldn't go far wrong.

Obviously, for a mainly crowd sourced database, the information on upcoming issues would be limited but usually there is pretty good data at the beginning of the week on your database.

A great number of applications are mainly interested in current material, and anything that puts that info in the hands of developers in a paged list format would be a godsend.

Avatar image for wengole
#5 Posted by wengole (1 posts) - - Show Bio

ISBN would be nice

Avatar image for devpool
#6 Posted by Devpool (1 posts) - - Show Bio

At the issue level, a site link to the wiki would be nice.

Avatar image for herrdoktorbd
#7 Posted by HerrDoktorBD (19 posts) - - Show Bio

ISBN would be awesome.

@wengole said:

ISBN would be nice

Avatar image for naicigam
#8 Posted by naicigam (1 posts) - - Show Bio

ISBN would be awesome.

@wengole said:

ISBN would be nice

Agree!!! Anything that allow us to create a barcode scanner for issues would be awesome!!!

Avatar image for faceless105
#9 Posted by faceless105 (1 posts) - - Show Bio

I'm new to comic vine, but I'm really liking it so far.

I'd love ISBN, UPC, or EAN where available. Having a global identifier that's more specific than a title is always a win in my book.

Also publisher. I'd love nothing more to filter by Marvel, DC, etc, or even exclude by them.

Avatar image for boshuda
#10 Posted by boshuda (70 posts) - - Show Bio

A 'type' identifier feels almost necessary since it appears as though television shows are now being added to the DB.

Avatar image for sharkskinman
#11 Edited by SharkSkinMan (1 posts) - - Show Bio

There are two things I've noticed with the person resources:

The 1st issue is a bug. Query the resource of a person who is dead (Jack Kirby will do), and include the death date. If you're querying XML, then the death element will be absent (for people who are still alive, then it will be present, but empty). This only happens for XML - JSON works fine. See www.comicvine.com/api/person/4040-5614/?api_key=1234abcd&format=xml&field_list=birth,death,name for an example, after replacing the API key with a real one.

The 2nd is that while the HTML includes the twitter handle of each person, this information is not available through the API.

Avatar image for maumau
#12 Posted by maumau (5 posts) - - Show Bio

@naicigam said:
@herrdoktorbd said:

ISBN would be awesome.

@wengole said:

ISBN would be nice

Agree!!! Anything that allow us to create a barcode scanner for issues would be awesome!!!

1. ISBN would be so super cool!

2. Variant cover would be very cool.

3. Upcoming releases next week/this week would be nice.

Avatar image for nirajhasissues
#13 Edited by nirajhasissues (2 posts) - - Show Bio

The API is really powerful and I think a few additional things could make it even more awesome:

  1. ISBN
  2. Buy links (linking to Amazon / Comixology)
  3. Upcoming weekly releases (Have to reply on in_store_date or added _to_api right now)
  4. Add 'mature / adult' tag to adult content. This makes it easier for us to sort / filter out this kind of content if we need to.
Avatar image for nirajhasissues
#14 Edited by nirajhasissues (2 posts) - - Show Bio

I just thought of another addition / update:

  1. Coupling a volume's issues and trades together. For example, Saga has a volume for issues, and a volume for its volumes. It would be nice to merge both into a singular volume.
Avatar image for bolia
#15 Posted by bolia (3 posts) - - Show Bio

Filter volumes by publisher (Id) would be nice.

Avatar image for letkeman1978
#16 Posted by letkeman1978 (1 posts) - - Show Bio

How about a recommendation feature? For instance it would be nice to know that if you were interested in Batman New 52 then you may be interested in Batman & Robin New 52 and so on.

Avatar image for heavyionau
#17 Edited by heavyionAU (1 posts) - - Show Bio

I would like a resolution-independent hash code with all images. That -- along with the hash algorithm used -- would allow one to identify issues just by their cover image. There are ~530,000 issues in your database. In order to avoid querying for such a field on these issues (bad idea!) I sure would like to download a single file of 20MB (or so) with the issue identifier and the image hash. That would make it extremely easy for software to tag comics correctly and automatically.

Avatar image for imawindev
#18 Edited by imawindev (6 posts) - - Show Bio

Do you even work on this any more? The API seems pretty abandoned to me. With no official answers in over a year and the mess that is rate limiting it doesn't seem to be a good idea to use the API, at all.

Avatar image for joerdie
#19 Posted by joerdie (6 posts) - - Show Bio

I don't know if anyone is still monitoring this forum but I really could use the ability to sort by start_year under volumes. It's crazy to me that I can't do that for certain series like "X-Men." There are currently 1026 results. If I could filter by start_desc, I would easily be able to find "X-Men Blue" for example which started this year without knowing the exact name.

Avatar image for brazol
#20 Edited by Brazol (3 posts) - - Show Bio

Is anyone still working on this API? The ISBN was requested many times through the years. Will it be added to API?

Avatar image for darksir
#21 Posted by DarkSir (2 posts) - - Show Bio

This may already exist, but it would be great to be able to access user created lists via the API.

Avatar image for cljedi
#22 Posted by CLJedi (3 posts) - - Show Bio

A tutorial.