World of Spectrum API

The magazines API currently has three settings.

Magazines List

http://worldofspectrum.org/infoseek/api/magazines?X-API-KEY=test

This produces a list of magazines.

The results returned are:-

ID - The unique infoseek ID for the magazine
Magazine - The name of the magazine
Slug - The URL slug of the magazine
logo - The magazine logo

The magazines list can accept several optional parameters.
limit - Set the number of records to retrieve. The test API has a maximum of 10
offset - Offset the search results
magazine - you can search for specific magazines. You can use wildcards here. For a specific match, '_crash'. Starts with - 'crash%', or ends with: '%crash'. By default the search is both start with and ends with.
language - The publication language.
medium - The publication medium.
random - setting any value here returns a random list based on the other search criteria

You can also list the languages used like so:-

http://worldofspectrum.org/infoseek/api/magazines_languages?X-API-KEY=test

And the medium used like so:-

http://worldofspectrum.org/infoseek/api/magazines_medium?X-API-KEY=test

Magazines Issues

You can list the issues produced per magazine by using the magazines_issues list and sending the infoseek magazine id like so:-

http://worldofspectrum.org/infoseek/api/magazines_issues?X-API-KEY=test&magazine=57

The results returned are:-

ID - The unique Infoseek ID for the issue.
Issue - The issue number
Year - The year of release
Month - The month of release
Day -- The day of the release
Cover - The cover file
Language - The language of the issue
Medium - The original medium used for publication

The issue list can accept several optional parameters.
limit - Set the number of records to retrieve. The test API has a maximum of 10
offset - Offset the search results

Magazines Pages

You can list the pages produced per issue by using the magazines_pages list and sending the infoseek issue id like so:-

http://worldofspectrum.org/infoseek/api/magazines_issues?X-API-KEY=test&issue=549

The results returned are:-

ID - The unique Infoseek ID for the page
Magazine - The name of the magazine.
Issue - The issue number
Page - The page number
Scan - The unique ID for the page image
TocText - The Table of Contents text where listed
Magazine_id - the infoseek magazine ID
Issue_id - the infoseek magazine issue ID

The pages list can accept several optional parameters.
limit - Set the number of records to retrieve. The test API has a maximum of 10
offset - Offset the search results
toc - Only list pages with table of contents text

Listing Table of Contents
You can list pages with table of contents text by adding toc to the url like so:-
http://worldofspectrum.org/infoseek/api/magazines_issues?X-API-KEY=test&issue=3294&toc=1

Searching Table of Contents

You can search the TOC by using the magazines_toc_search api.

http://worldofspectrum.org/infoseek/api/magazines_toc_search?X-API-KEY=test&search=megabasic

The search can accept several optional parameters.
limit - Set the number of records to retrieve. The test API has a maximum of 10
offset - Offset the search results
search - The search term. You can use wildcards here. For a specific match, '_megabasic'. Starts with - 'megabasic%', or ends with: '%megabasic'. By default the search is both start with and ends with.

The results returned are:-

Magazines Adverts

Where available you can also search for adverts listed in a magazine issue with the following:-

worldofspectrum.org/infoseek/api/magazines_adverts?X-API-KEY=test&issue=3294

The results returned are:-

magazine_title - The name of the magazine
magazine_id - the infoseek magazine ID
magazine_slug - the unique slug for the magazine
magazine_issue_id - the unique infoseek issued ID
magazine_issue - the issue number
magazine_issue_year - the year the issue was released
magazine_issue_month - the month number the issue was released
magazine_issue_day - the day number the issue was released (weekly releases)
magazine_issue_volume - the volume number of the issue
magazine_page_number - the "real" page number including cover
magazine_page - the magazine page according to table of contents
magazine_page_scan - the unique image name
reference_code - the SPOT reference code
reference_code_string - the SPOT reference text
topic - the SPOT topic text
topic_id - the SPOT topic ID
feature_id - the SPOT feature ID
feature_string - the SPOT feature text
description - a brief description of the page
text - extended description
url - the direct WoS URL to the page

The advert list can accept several optional parameters.
limit - Set the number of records to retrieve. The test API has a maximum of 10
issue (required) - The issue number to search

Magazines SPOT*oN references

Where available you can also search for references listed in a magazine issue with the following:-

worldofspectrum.org/infoseek/api/magazines_spot?X-API-KEY=test&issue=3294

The results returned are:-

The reference list can accept several optional parameters.
limit - Set the number of records to retrieve. The test API has a maximum of 10
issue (required) - The issue number to search

NOTE - MORE OPTIONS WILL BE ADDED AS MORE DATA IS LOADED INTO THE NEW SYSTEM