AAPNewswire API

AAPNewswire API (application programming interface) allows you to programmatically access News and Multimedia data produced by AAP for use in your own applications.

Use of the AAPNewswire API needs an API key provided by AAP. Access to various data and methods offered by the API are defined by your agreement with AAP.

AAPNewswire API uses a RESTful style and calls to the API are made via HTTP GET requests.

The AAPNewswire API returns data in XML (Default) and JSON formats.

Basics

Base Url http://api.aapnewswire.com.au/Rest/v1/
Request URL Format http://api.aapnewswire.com.au/Rest/v1/Method?ApiKey=YourKey&format=json/xml(default)

AAPNewsInPictures

Information This call returns a list of pictures and associated headline and caption for each item from the last 48 hours.
Request http://api.aapnewswire.com.au/Rest/v1/AAPNewsInPictures?ApiKey=YourKey
&format=json/xml(default)
Response XML
<NewsInPictures xmlns="AAPNewswire">
  <Copyright>String e.g. "Copyright (c) 2012 Australian Associated Press.  All Rights Reserved."</Copyright>
  <Slides>
    <Slide>
      <Category>String e.g. "A" or "I"</Category>
      <Credit>String e.g. "AAP"</Credit>
      <Headline>String</Headline>
      <ImageUrl>String</ImageUrl>
      <SlideCaption>String</SlideCaption>
      <SlideTitle>String</SlideTitle>
      <Subject>String</Subject>
      <Updated>ISO8601 timestamp: e.g. "2010-02-29T09:22:00+11"</Updated>
    </Slide>
  </Slides>
  <UpdateStatus>String e.g. "OK" or "Error NNN"</UpdateStatus>
  <UpdateTotalStories>Integer</UpdateTotalStories>
</NewsInPictures>
              
Response JSON
{
  "Copyright":String e.g. "Copyright (c) 2012 Australian Associated Press.  All Rights Reserved.",
  "Slides":[{
	  "Category":String e.g. "A" or "I",
	  "Credit":String e.g. "AAP",
	  "Headline":String,
	  "ImageUrl":String,
	  "SlideCaption":String,
	  "SlideTitle":String,
	  "Subject":String,
	  "Updated":"\/Epoch Time e.g. 928113600000+1000 \/"
  }],
  "UpdateStatus":String e.g. "OK" or "Error NNN",
  "UpdateTotalStories":Integer
}
              

AAP Story Categories

Category Code Category Name
A Australia
N New Zealand
I World
T Domestic Sport
E Entertainment
F Finance
S World Sport
R Horse Racing

Story Sources

Abbreviation Source Name
AAP Australian Associated Press
NZN New Zealand Newswire
AP Associated Press
AFP Agence France-Presse
PAA Press Association
DPA Deutsche Presse-Agentur GmbH
MCT McClatchy - Tribune Information Services
GNE Global News Enterprise
EFE Agencia EFE

Subject Codes

A NewsCode/SubjectCode e.g. (01000000 for Arts, Culture and Entertainment) is a single code representing a concept which is used to categorize news content. Many of these codes can make a set for a specific use, such a set is branded as NewsCodes by the IPTC, more generic terms are controlled vocabulary, taxonomy, or list of values.*

* http://www.iptc.org/site/NewsCodes/Overview/