comics.org data REST API methods
this page updated: January 12 2023 08:49:33 UTC.
MySQL data source:
gcd data dump
2022-12-01 03:48:39 GMT
demo source control:
https://github.com/ctgarry/api.comics.org
OpenAPI Specification:
hosted at Swagger HUB
With the latest upload of the data source the schema has changed and some examples are not working correctly. I will fix this shortly.
Publisher
Verb
Example
Equivalent
Tables
GET
/v1/publisher/54/
└─
/v1/publisher/?name=dc&page=1
gcd_publisher
GET
└─
/v1/publisher/54/brand_groups
gcd_brand_group
GET
/v1/indicia_publisher/5
gcd_indicia_publisher
Series
Verb
Example
Equivalent
Tables
GET
/v1/series/97
└─
/v1/series/?name=fantastic&page=1
gcd_series
GET
└─
/v1/series/97/brand_emblems
(Publisher's Brands)
gcd_brand; gcd_issue
GET
└─
/v1/series/97/indicia_publishers
(Indicia Publishers)
gcd_indicia_publisher; gcd_issue
GET
└─
/v1/series/97/awards
(Awards)
gcd_received_award; gcd_award
GET
└─
/v1/series/72/bonds
(Tracking)
gcd_series_bond
Issues
Verb
Example
Equivalent
Tables
GET
/v1/issue/7521
└─
/v1/issue/?barcode=76194120001990111
gcd_issue
GET
└─
/v1/issue/114119/indicia_printer
(printer)
gcd_issue_indicia_printer, gcd_indicia_printer
GET
└─
/v1/issue/391286/issue_reprints
Parts of this issue are reprinted in another issue
gcd_issue_reprint
GET
└─
/v1/issue/536367/reprints_from_issue
Parts of this issue are reprinted TO a specific STORY
gcd_reprint_from_issue
GET
└─
/v1/issue/636292/reprints_to_issue
Parts of this issue are reprinted FROM a specific STORY
gcd_reprint_to_issue
GET
└─/v1/issue/7521/stories
(list of stories)
gcd_story
Printers
Verb
Example
Equivalent
Tables
GET
/v1/printer/9
└─
/v1/printer/?name=hemmets&page=1
gcd_printer
GET
└─
/v1/printer/9/indicia_printers
(indicia printers)
gcd_printer, gcd_indicia_printer
GET
/v1/indicia_printer/8
└─
/v1/indicia_printer/?name=egmont&page=1
gcd_indicia_printer
Brands
Verb
Example
Equivalent
Tables
GET
/v1/brand_emblem/4
gcd_brand
GET
└─/v1/brand_emblem/4/groups
(Brand Groups)
gcd_brand_emblem_group
GET
└─/v1/brand_emblem/4/publisher_brand_uses
(At Publishers)
gcd_brand_use
GET
/v1/brand_group/1563
gcd_brand_group
GET
└─/v1/brand_group/1563/emblem_brand_uses
(Used Brand Emblems)
gcd_brand_use
Brand-Related Items
Verb
Example
Equivalent
Tables
GET
/v1/brand_use/5256
-
gcd_brand_use
Stories
Verb
Example
Equivalent
Tables
GET
/v1/story/2782805
gcd_story
GET
└─/v1/story/2782805/credits
(creator object credits)
gcd_story_credit
GET
└─/v1/story/175376/awards
(awards)
gcd_received_award
GET
└─/v1/story/2782805/abstract
(story abstract)
gcd_biblio_entry
GET
└─/v1/story/209149/reprints
This story is reprinted as another story
gcd_reprint
GET
└─/v1/story/928788/reprints_from_issue
Parts of this issue are reprinted TO a specific STORY
gcd_reprint_from_issue
GET
└─/v1/story/506106/reprints_to_issue
Parts of this issue are reprinted FROM a specific STORY
gcd_reprint_to_issue
Creators
Verb
Example
Equivalent
Tables
GET
/v1/creator/11642
└─
/v1/creator/?name=davis&page=1
gcd_creator
GET
└─
/v1/creator/11642/names
(Names)
gcd_creator_name_detail
GET
└─
/v1/creator/11642/schools
(Schools)
gcd_creator_school
GET
└─
/v1/creator/11642/degrees
(Degrees)
gcd_creator_degree
GET
└─
/v1/creator/11642/signatures
(Signatures)
gcd_creator_signature
GET
└─
/v1/creator/11642/awards
(Awards)
gcd_received_award
GET
└─/v1/creator/11642/awards_for_stories
(Awards for Stories)
gcd_received_award
GET
└─
/v1/creator/11642/art_influences
(Art Influences)
gcd_creator_art_influence
GET
└─
/v1/creator/11642/memberships
(Memberships)
gcd_creator_membership
GET
└─
/v1/creator/11642/non_comic_works
(Non Comics Works)
gcd_creator_non_comic_work
GET
└─
/v1/creator/14078/relations
(Relations)
gcd_creator_relation; gcd_creator_relation_creator_name
Creator-Related Items
Verb
Example
Equivalent
Tables
GET
/v1/school/445
└─
/v1/school/?name=missouri&page=1
gcd_school
GET
/v1/creator_school/607
The assignment of a creator to a school
gcd_creator_school
GET
/v1/award/6
└─/v1/award/?name=hugo&page=1
gcd_award
GET
/v1/received_award/4938
The assignment of a creator to an award
gcd_received_award
GET
/v1/creator_signature/2857
gcd_creator_signature
GET
/v1/creator_art_influence/1083
gcd_creator_art_influence
GET
/v1/creator_membership/139
gcd_creator_membership
Features
Verb
Example
Equivalent
Tables
GET
/v1/feature/98/
└─/v1/feature/?name=mickey&page=1
gcd_feature
GET
└─/v1/feature/98/logos
(Feature Logos)
gcd_feature_logo_2_feature
GET
└─
/v1/feature/98/feature_relations
(Feature Relations)
gcd_feature_relation
GET
(Stories having this feature)
gcd_story_feature_object
Feature Logos
Verb
Example
Equivalent
Tables
GET
/v1/feature_logo/93/
gcd_feaure_logo
GET
(Stories having this logo)
gcd_story_feature_logo
Supporting Tables
supporting tables
Verb
Example
Note
Tables
GET
-
(135 types)
django_content_type
GET
/v1/countries
(269 countries)
stddata_country
GET
└─
/v1/country/225
by id
stddata_country
GET
/v1/languages
(153 languages)
stddata_language
GET
└─
/v1/language/25
by id
stddata_language
GET
/v1/scripts
(84 written scripts)
stddata_script
GET
└─
/v1/script/37
by id
stddata_script
GET
/v1/date/6
(250k+)
stddata_date
GET
/v1/tag/10
(56k+)
taggit_tag
GET
/v1/taggeditem/7972
(350k+)
taggit_taggeditem
types
Verb
Example
Note
Tables
GET
/v1/series_publication_types
(3 types)
gcd_series_publication_type
GET
└─
/v1/series_publication_type/1
by id
gcd_series_publication_type
GET
/v1/series_bond_types
(6 types)
gcd_series_bond_type
GET
└─
/v1/series_bond_type/1
by id
gcd_series_bond_type
GET
/v1/story_types
(28 types)
gcd_story_type
GET
└─
/v1/story_type/1
by id
gcd_story_type
GET
/v1/credit_types
(13 types)
gcd_credit_type
GET
└─
/v1/credit_type/1
by id
gcd_credit_type
GET
/v1/feature_types
(3 types)
gcd_feature_type
GET
└─
/v1/feature_type/1
by id
gcd_feature_type
GET
/v1/feature_relation_types
(1 type)
gcd_feature_relation_type
GET
└─
/v1/feature_relation_type/1
by id
gcd_feature_relation_type
GET
/v1/name_types
(10 types)
gcd_name_type
GET
└─
/v1/name_type/1
by id
gcd_name_type
GET
/v1/degrees
(8 degrees)
gcd_degree
GET
└─
/v1/degree/1
by id
gcd_degree
GET
/v1/membership_types
(3 types)
gcd_membership_type
GET
└─
/v1/membership_type/1
by id
gcd_membership_type
GET
/v1/non_comic_work_types
(12 types)
gcd_non_comic_work_type
GET
└─
/v1/non_comic_work_type/1
by id
gcd_non_comic_work_type
GET
/v1/non_comic_work_roles
(12 roles)
gcd_non_comic_work_role
GET
└─
/v1/non_comic_work_role/1
by id
gcd_non_comic_work_role
GET
/v1/relation_types
(8 types)
gcd_relation_type
GET
└─
/v1/relation_type/1
by id
gcd_relation_type
Tools for reading the output:
http://jsonviewer.stack.hu
Tools for sending the requests:
"POSTMan" REST API Emulator
"SOAPUI" REST API Emulator
"Advanced Rest Client" REST API Emulator
Tools for API specifications:
OpenAPI Specification (OAS) v3
Beautiful APIs with Swagger (OAS)
etc...