Data feeds for galleries (RSS, JSON)

Availability 

Infradox XS 20

Article last updated

7 December 2015

Related articles

Dynamic subdomains

Search filters and gallery access control

Data access API

Introduction

You can provide RSS feeds for your latest galleries 1) within a specific group, 2) within a specific root level or 3) regardless of the root level or group. 

In version 26.5 we have added support for JSON formatted feeds.

RSS feeds

http://www.mywebsite.com/rss/[locale id]/[subdomain id]/[rootlevel id]/[group id]/[max items]/[thumbnail]/galleries.rss

  • [locale id]
    The id of the language for your feed. Use 1 for English.
  • [subdomain id]
    The id of the subdomain. Use 0 for "no subdomain". Note that if you have configured a root level to display only if a specific subdomain is active, its galleries will be excluded from the feed if the [subdomain id] is 0. For further information read the article about Gallery access control.
  • [rootlevel id]
    Use the id of a rootlevel that you have created with Gallery manager, to retrieve galleries from this root level - regardless of the groups within the galleries are created.
  • [group id]
    Use the id of a group to retrieve galleries for a specific group only. In this case you must specify 0 for the [rootlevel id].
    To retrieve the latest galleries regardless of the root level or group, use both 0 for the [rootlevel id] and the [group id].
  • [max items]
    A number between 1 and 100 for the number of items you want to retrieve.
  • [thumbnail]
    1 to add a thumbnail to the description, 0 for the description without a thumbnail.

Examples

  • http://www.mywebsite.com/rss/1/0/900/0/10/0/galleries.rss
    A feed in English with the 10 latest galleries created under root level 900, without a thumbnail as part of the description.
  • http://www.mywebsite.com/rss/1/0/0/3310/10/1/galleries.rss
    A feed in English with the 10 latest galleries created in group 3310, including a thumbnail as part of the description.
  • http://www.mywebsite.com/rss/1/0/0/0/50/0/galleries.rss
    A feed in English with the 50 most recent galleries, regardless of the root level or group and no thumbnail as part of the description.

A simple URL for your 10 latest galleries

To keep it simple, you can also use the following RSS feed url to retrieve the 10 latest galleries in English - regardless of the root level or group:

  • http://www.yourwebsite.com/galleries.rss

JSON feeds

http://www.mywebsite.com/json/[locale id]/[subdomain id]/[rootlevel id]/[group id]/[max items]/[page]/galleries.json

  • [locale id] 
    The id of the language for your feed. Use 1 for English.
  • [subdomain id]
    The id of the subdomain. Use 0 for "no subdomain". Note that if you have configured a root level to display only if a specific subdomain is active, its galleries will be excluded from the feed if the [subdomain id] is 0. For further information read the article about Gallery access control.
  • [rootlevel id]
    Use the id of a rootlevel that you have created with Gallery manager, to retrieve galleries from this root level - regardless of the groups within the galleries are created.
  • [group id]
    Use the id of a group to retrieve galleries for a specific group only. In this case you must specify 0 for the [rootlevel id].
    To retrieve the latest galleries regardless of the root level or group, use both 0 for the [rootlevel id] and the [group id].
  • [max items]
    The maximum number of galleries to be retrieved. Note that a call will return a maximum of 100 galleries. To fetch the next 100 galleries you need to change the [page] parameter accordingly. Note that you must use a [max items] value that is high enough if you want to retrieve many pages. If you don't need more than 100 galleries then also set [max items] to 100. 
  • [page]
    1 to fetch the first 100 galleries, 2 to fetch the next 100 galleries and so on. 

Example

  • http://www.mywebsite.com/json/1/0/900/0/1000/1/galleries.json
    Fetches the first 100 galleries in English from root level 900.
  • http://www.mywebsite.com/json/1/0/0/0/1000/2/galleries.json
    Fetches galleries 101 to 200 in English regardless of the root level or group.

Data feeds are accessed as "Guest"

If you use gallery access control, certain galleries may be excluded from the feeds. Feed users are treated as "guests". I.e. if you have configured a root level to be hidden for guests, its galleries will not be part of any gallery RSS feed. Further information can be found here.

Have more questions? Submit a request

0 Comments

Article is closed for comments.
Powered by Zendesk