Access AusStage data for your website

You can use the Data Exchange service to embed AusStage data in a website using specially created URLs. Artists, companies and researchers can record information about their work in AusStage and then display that information in their own web pages.

AusStage data can be embedded in a website dynamically by using JavaScript, by importing the RSS feed into your content management system, or in the case of performance feedback collected by using the Researching Audiences service and iFrame.

Use the Code Generator to create code that can be embedded into a web page. Up-to-date data is drawn live from the database each time the web page is viewed. You can choose which records you want displayed. Three types of record can be retrieved using this service:

More information about retrieving records is outlined below.

If you have any feedback, questions or queries about the Data Exchange service, please contact us.

Event Records

Back to top

Event records associated with contributors, organisations, venues, secondary genres, subjects and works can be retrieved using this service. For example to retrieve event data about organisations it is necessary to know the unique Organisation Identifier for the organisation, or organisations, that are of interest. These numbers are displayed at the bottom of the record details page in the AusStage website.

Lists of secondary genre identifiers and subjects identifiers is availble on this website.

The event records are retrieved by constructing a URL with two required attributes and four optional attributes. These are outlined in the table below. If an optional attribute is missing the default value will be used.

The start of the URL is always the same and it is: http://www.ausstage.edu.au/exchange/events?

Event records are always sorted in reverse chronological order (most recent first) before any record limits are applied and the data is returned.

Attribute Description Value Required
type The type of unique identifier that is being used
  • contributor
  • organisation
  • venue
  • secgenre
  • subjects
  • work
Yes
id A unique identifier, or list of unique identifiers, for records matching the specified type Up to ten unique numeric identifiers Yes
output The type of output used to format the data
  • html (default)
  • json
  • xml
  • rss
No
limit The number of records to be returned
  • 10 (default)
  • all (all records)
  • an arbitary number
No
sort The way records are sorted. Note: records are sorted before the record limit is applied
  • firstdate (event first date)
  • createdate (the date the event record was created)
  • updatedate (the date the event record was updated)
No
callback The name of the JavaScript function used to enclose the data
Most commonly used with the json output attribute as part of using the JSONP technique for AJAX requests
Any valid JavaScript function name No

Example URLs

Listed below are some sample URLs that demonstrate how the URL for event records can be constructed.

 

Resource Records

Back to top

Resource records associated with contributors, organisations, venues, secondary genres, subjects, works and resource sub-types can be retrieved using this service. For example to retrieve resource data about organisations it is necessary to know the unique Organisation Identifier for the organisation, or organisations, that are of interest. These numbers are displayed at the bottom of the record details page in the AusStage website.

Lists of secondary genre identifiers, subjects identifiers and and resource sub-types are availble on this website.

The resource records are retrieved by constructing a URL with two required attributes and three optional attributes. These are outlined in the table below. If an optional attribute is missing the default value will be used.

The start of the URL is always the same and it is: http://www.ausstage.edu.au/exchange/resources?

Attribute Description Value Required
type The type of unique identifier that is being used
  • contributor
  • organisation
  • venue
  • secgenre
  • subjects
  • work
  • ressubtype
Yes
id A unique identifier, or list of unique identifiers, for records matching the specified type Up to ten unique numeric identifiers Yes
output The type of output used to format the data
  • html (default)
  • json
  • xml
  • rss
No
limit The number of records to be returned
  • 10 (default)
  • all (all records)
  • an arbitary number
No
sort The way records are sorted. Note: records are sorted before the record limit is applied
  • createdate (the date the event record was created)
  • updatedate (the date the event record was updated)
No
callback The name of the JavaScript function used to enclose the data
Most commonly used with the json output attribute as part of using the JSONP technique for AJAX requests
Any valid JavaScript function name No

Example URLs

Listed below are some sample URLs that demonstrate how the URL for resource records can be constructed.

 

Feedback Records

Back to top

Feedback records are pieces of feedback collected by the Researching Audiences Service and are associated with a performance record. A performance record is a record in the database that identifies a unique performance that has used the researching audiences service to collect feedback.

The feedback records are retrieved by constructing a URL with two required attributes and four optional attributes. These are outlined in the table below. If an optional attribute is missing the default value will be used.

The start of the URL is always the same and it is: http://www.ausstage.edu.au/exchange/feedback?

Attribute Description Value Required
type The type of unique identifier that is being used
  • performance
Yes
id A unique identifier, or list of unique identifiers, for records matching the specified type Up to ten unique numeric identifiers Yes
output The type of output used to format the data
Unlike the other record types feedback can be retieved using the special "iframe" output type. This output wraps the html output in a complete set of HTML tags so that it can be used as the source for an iframe
  • html (default)
  • json
  • xml
  • rss
  • iframe
No
limit The number of records to be returned
  • 10 (default)
  • all (all records)
  • an arbitary number
No
callback The name of the JavaScript function used to enclose the data
Most commonly used with the json output attribute as part of using the JSONP technique for AJAX requests
Any valid JavaScript function name No
css Used in conjunction with the iframe parameter to specify the fully qualified URL of a CSS file that is used to style the content contained in the iframe   No

Example URLs

Listed below is a sample URL that demonstrate how the URL for feedback records can be constructed.

Embed Ausstage Data in Your Website

This page helps you generate code that will dynamically show data from the Ausstage database.

The code is able to be copied and pasted directly into a web page.


Preview

Copy the code below and paste it into your website

Below is a list of secondary genre identifiers that can be used with the Data Exchange service. Persistent Link to this tab.

Identifier Description Event Count Resource Count

Loading secondary genre list, please wait...

Identifier Description Event Count Resource Count

Below is a list of subject identifiers that can be used with the Data Exchange service. Persistent Link to this tab.

Identifier Description Event Count Resource Count

Loading subjects list, please wait...

Identifier Description Event Count Resource Count

Below is a list of resource sub type identifiers that can be used with the Data Exchange service. Persistent Link to this tab.

Identifier Description Resource Count

Loading resource sub-type list, please wait...

Identifier Description Resource Count

Enter a name, or part of a name, and click the search button

Select an entity by clicking the 'choose' button on the right of the record. You can continue searching and add up to 10 entities. Click the close button when you have finished.

  Contributor Name Event Dates Functions
  Organisation Name Address
  Venue Name Address


Loading Search Results...

Note: Search results are limited to 100 records. If you do not see the results that you expected, please refine your search.

Description Event Count

Loading secondary genre list, please wait...

Description Event Count

Loading subjects list, please wait...

Description Event Count

Loading subjects list, please wait...

Country Venue Count

Loading country list, please wait...