Summoner

I’ve recently been working with the Serials Solutions Summon API for some side work at George Washington University Libraries. Since the work is largely in Python I created a very simple reusable module called summoner for talking to the API. It largely just does the authentication bits, and gets out of the way…but it may be of interest to you if you use Python and work at a library that subscribes to Summon.

Anyway, I found myself wanting to get a picture of the metadata fields that are used in Summon responses, so I wrote a little script that does an open ended search and then walks through lots of results tallying up the fields used by content type. You can find the results for a scan of 50,000 records below.

As you can see the majority (78%) of the results were newspaper and journal articles. There was a fair bit of diversity in the fields returned for these. It was kind of interesting that 83% of the journal articles had ISSNs (I was expecting it to be higher). 50% had EISSNs so perhaps the 17% that lacked ISSNs had an EISSN instead. Only 41% of journals had subject terms. The sampling of the other content areas was probably too low to make any guesses.

The big caveat here is that these numbers reflect GWU’s particular holdings and subscription options. Still, if you use the Summon API you might find them interesting; and if you are really curious you can run the script for your own institution.

Newspaper Articles (54.0%)

Field Name Coverage
PublicationYear 100.0%
openUrl 100.0%
PublicationPlace_xml 100.0%
DatabaseTitle 100.0%
Title 100.0%
Score 100.0%
PublicationTitle 100.0%
link 100.0%
PublicationDecade 100.0%
Publisher_xml 100.0%
Copyright 100.0%
LinkModel 100.0%
DBID 100.0%
ISSN 100.0%
MergedId 100.0%
isFullTextHit 100.0%
PQPubID 100.0%
StartPage 100.0%
PublicationDate 100.0%
PublicationPlace 100.0%
Genre 100.0%
PublicationDate_xml 100.0%
Publisher 100.0%
SourceType 100.0%
IsScholarly 100.0%
Language 100.0%
ExternalDocumentID 100.0%
URI 100.0%
PublicationCentury 100.0%
ID 100.0%
IsPeerReviewed 100.0%
inHoldings 100.0%
ContentType 100.0%
SSID 100.0%
thumbnail_l 100.0%
thumbnail_m 100.0%
thumbnail_s 100.0%
hasFullText 100.0%
Copyright_xml 100.0%
EISSN 100.0%
PQID 100.0%
Snippet 88.9%
DatabaseTitleList 88.9%
AbstractList 88.9%
Abstract 88.9%
SubjectTerms 74.1%
GeographicLocations 14.8%
GeographicLocations_xml 14.8%

Journal Articles (24.0%)

Field Name Coverage
PublicationYear 100.0%
openUrl 100.0%
Score 100.0%
PublicationTitle 100.0%
link 100.0%
PublicationDecade 100.0%
isFullTextHit 100.0%
LinkModel 100.0%
Title 100.0%
MergedId 100.0%
PublicationDate 100.0%
ExternalDocumentID 100.0%
PublicationDate_xml 100.0%
IsScholarly 100.0%
Language 100.0%
hasFullText 100.0%
ID 100.0%
IsPeerReviewed 100.0%
inHoldings 100.0%
ContentType 100.0%
SourceType 100.0%
PublicationCentury 100.0%
Author 91.7%
Author_xml 91.7%
StartPage 91.7%
ISSN 83.3%
Issue 83.3%
Volume 83.3%
thumbnail_l 83.3%
thumbnail_m 83.3%
thumbnail_s 83.3%
Publisher_xml 75.0%
Publisher 75.0%
SSID 75.0%
DatabaseTitle 58.3%
Copyright 58.3%
DBID 58.3%
Copyright_xml 58.3%
URI 50.0%
EISSN 50.0%
Snippet 41.7%
Genre 41.7%
SubjectTerms 41.7%
PQID 41.7%
PublicationPlace_xml 33.3%
Database_xml 33.3%
PQPubID 33.3%
PublicationPlace 33.3%
EndPage 33.3%
Discipline 25.0%
PageCount 25.0%
Notes 25.0%
DatabaseTitleList 25.0%
Audience 25.0%
AbstractList 25.0%
Abstract 25.0%
DOI 16.7%
RelatedPersons 16.7%
RelatedPersons_xml 16.7%
PublicationSeriesTitle 16.7%
ClassificationCodes 16.7%
CODEN 8.3%
GeographicLocations 8.3%
DLL_JC 8.3%
GeographicLocations_xml 8.3%
PCID 8.3%

Reference (10.0%)

Field Name Coverage
PublicationYear 100.0%
openUrl 100.0%
Title 100.0%
Source 100.0%
Score 100.0%
PublicationTitle 100.0%
link 100.0%
ISBN 100.0%
PublicationDecade 100.0%
Publisher_xml 100.0%
IsPeerReviewed 100.0%
LinkModel 100.0%
MergedId 100.0%
isFullTextHit 100.0%
PublicationDate 100.0%
ExternalDocumentID 100.0%
PublicationDate_xml 100.0%
Publisher 100.0%
IsScholarly 100.0%
Language 100.0%
PublicationCentury 100.0%
ID 100.0%
SourceType 100.0%
inHoldings 100.0%
ContentType 100.0%
SSID 100.0%
thumbnail_l 100.0%
thumbnail_m 100.0%
thumbnail_s 100.0%
hasFullText 100.0%
Copyright 80.0%
Snippet 80.0%
DBID 80.0%
URI 80.0%
Copyright_xml 80.0%
Discipline 60.0%
SubjectTerms 40.0%
PublicationPlace_xml 20.0%
EISBN 20.0%
Author_xml 20.0%
Edition 20.0%
Author 20.0%
StartPage 20.0%
PublicationPlace 20.0%

Patents (6.0%)

Field Name Coverage
Discipline 100.0%
PublicationYear 100.0%
openUrl 100.0%
Author 100.0%
Snippet 100.0%
Score 100.0%
link 100.0%
PublicationDecade 100.0%
Author_xml 100.0%
IsPeerReviewed 100.0%
LinkModel 100.0%
DBID 100.0%
Title 100.0%
MergedId 100.0%
isFullTextHit 100.0%
PublicationDate 100.0%
ExternalDocumentID 100.0%
PublicationDate_xml 100.0%
IsScholarly 100.0%
Language 100.0%
Notes 100.0%
URI 100.0%
DatabaseTitleList 100.0%
PublicationCentury 100.0%
AbstractList 100.0%
ID 100.0%
inHoldings 100.0%
ContentType 100.0%
SourceType 100.0%
Abstract 100.0%
hasFullText 100.0%

Books (2.0%)

Field Name Coverage
PublicationYear 100.0%
openUrl 100.0%
PublicationPlace_xml 100.0%
Author 100.0%
Source 100.0%
Score 100.0%
link 100.0%
LCCallNum 100.0%
PublicationDecade 100.0%
Author_xml 100.0%
IsPeerReviewed 100.0%
LinkModel 100.0%
LCCN 100.0%
DBID 100.0%
Title 100.0%
MergedId 100.0%
isFullTextHit 100.0%
PublicationDate 100.0%
ExternalDocumentID 100.0%
PublicationDate_xml 100.0%
IsScholarly 100.0%
Language 100.0%
PublicationPlace 100.0%
URI 100.0%
PublicationCentury 100.0%
OCLC 100.0%
FullText_t_NoSnippeting 100.0%
ID 100.0%
inHoldings 100.0%
ContentType 100.0%
SourceType 100.0%
hasFullText 100.0%

Web Resources (2.0%)

Field Name Coverage
PublicationYear 100.0%
openUrl 100.0%
Copyright 100.0%
Author 100.0%
Score 100.0%
link 100.0%
PublicationDecade 100.0%
Author_xml 100.0%
IsPeerReviewed 100.0%
LinkModel 100.0%
DBID 100.0%
Title 100.0%
MergedId 100.0%
isFullTextHit 100.0%
SubjectTerms 100.0%
ExternalDocumentID 100.0%
PublicationDate_xml 100.0%
PublicationDate 100.0%
IsScholarly 100.0%
Language 100.0%
Notes 100.0%
URI 100.0%
Copyright_xml 100.0%
hasFullText 100.0%
ID 100.0%
inHoldings 100.0%
ContentType 100.0%
SourceType 100.0%
PublicationCentury 100.0%

Book Chapters (2.0%)

Field Name Coverage
Discipline 100.0%
PublicationYear 100.0%
DOI 100.0%
openUrl 100.0%
PublicationPlace_xml 100.0%
Copyright 100.0%
Title 100.0%
EISBN 100.0%
Snippet 100.0%
Score 100.0%
PublicationTitle 100.0%
link 100.0%
ISBN 100.0%
PublicationDecade 100.0%
Publisher_xml 100.0%
IsPeerReviewed 100.0%
LinkModel 100.0%
MergedId 100.0%
isFullTextHit 100.0%
StartPage 100.0%
PublicationDate 100.0%
PublicationPlace 100.0%
PublicationDate_xml 100.0%
SubjectTerms 100.0%
Publisher 100.0%
SourceType 100.0%
IsScholarly 100.0%
Language 100.0%
ExternalDocumentID 100.0%
DatabaseTitleList 100.0%
PublicationCentury 100.0%
AbstractList 100.0%
ID 100.0%
SSID 100.0%
inHoldings 100.0%
ContentType 100.0%
EndPage 100.0%
Abstract 100.0%
thumbnail_l 100.0%
thumbnail_m 100.0%
thumbnail_s 100.0%
hasFullText 100.0%
Copyright_xml 100.0%

Creative Commons License
Summoner by Ed Summers, unless otherwise expressly stated, is licensed under a Creative Commons Attribution 4.0 International License.

Leave a Reply