We don’t consider our digitised collections to be a static resource. We want you to re-use these images and our other assets. Whether you are a student, a teacher, an artist, or a blogger, we encourage you to use our collection images and open data in your own works.

Computer, c1970The published images and data from our collections are made available under a BY-SA 4.0 Creative Commons licence. This means that you can use the images under the following conditions:

  1.  Where published, the image must be credited to the ‘Royal Pavilion & Museums, Brighton & Hove’
  2. Where the image is used in another work, that work must be shared on the same basis as this image

If you would like to use an image from our collections in a way that is not covered by these terms, please contact us with details of your proposed use.

Please note that this licence does not cover images of objects in our collections where the copyright is retained by a third party (eg. the original artist). In such cases, download links will be turned off and the image will be clearly credited to the copyright holder.

Images

The digital images featured on our online collections are available for free use under a BY-SA Creative Commons licence. These are usually sized at 1000 pixels on the longest side, and are a good size for most web uses.

Published hi-res images are also be available for re-use under the BY-SA licence. These are currently available via our online Image Store.

Data and API

You can use our metadata to create a new widget, mashup or application. We have an Application Programmer’s Interface (API) that is easy to use and quick to get started with. Via the API you can submit search queries to return metadata for individual projects, partners or subjects.

The API is based upon OpenSearch, and by default takes a Lucene style query syntax.  The API is available via a rate limiting proxy, and we don’t issue usage keys: by using the API you agree to having your use of it monitored.  API search requests are limited to 100 requests per hour.  The data made available through the API is licensed as BY-SA 4.0 Creative Commons licence, and you are asked to provide a credit and link back to Royal Pavilion & Museums’ main website in your application or mashup.   For non-rate limited, or commercial use, of the data please contact us for licensing terms.

Getting Started

The search records API call is passed a search query and returns a corresponding result set.

URL Format

http://api.collectionsbase.org.uk/os/?queryType=lucene&[REQUEST PARAMETERS]&fq[]=dc.source:BTNRP&facet=on

you must have: queryType=lucene and fq[]=dc.source:BTNRP to just search Royal Pavilion & Museums Collections online as CollectionsBase holds more than one dataset

REQUEST PARAMETERS:

you must have q=search term

optionally,

startPage=N the offset from which the result list paging should start, default is 1

count=N the number of the results to return in the listing, the default is 15

sort=title – the field upon which results are sorted. If sort isn’t specified the results are sorted by relevance. sort by title is the other option

facet=on – show the default facet lists

facet.mincount=10 – show only facets with at least 10 documents in the index

format=rss or xml – , defaults to RSS

Examples

http://api.collectionsbase.org.uk/os/?queryType=lucene&startPage=1&q=painting&count=15&fq[]=dc.source:BTNRP&facet=on&format=rss

Advanced Query Syntax

q=+term1 +term2   both terms must match in documents

q=+term1 -term2  term1 must be in documents, term2 must not be in documents

q=dc.subject:term1  search only dc.subject index

Indexes

By default, all contents are searched.  You can narrow this to just the following Qualified Dublin Core indices:

  • dc.subject
  • dc.creator
  • dcterms.temporal
  • dcterms.spatial
  • dc.title
  • dc.description
  • dc.source
  • dcterms.format

Additional Query Filters

If you wish to have additional Filter Query parameters, supply them in the standard array syntax.  So, to show only results with a thumbnail image, use fq[]=have_thumbnail:1

Above all, have fun :-)

If you have any questions please email the developers at info@orangeleaf.com.

More information