Donate using PayPal

CycleStreets API (v2)

  • Details for:
  • API overview
  • Obtain API key
  • Usage policy
  • Uptime policy

List galleries

This API call returns a list of the Photo Galleries available.

Example

Example which retrieves the data.

https://api.cyclestreets.net/v2/galleries.list?fields=id,title,description,photos,datetime,galleryHref

Result:

{
    "galleries": {
        "317": {
            "id": 317,
            "title": "Cambridge Station Cycle Parking",
            "description": "Photos of the new and improved cycling parking.",
            "photos": [
                1,
                2,
                3,
                4,
                5,
                6
            ],
            "datetime": 1437335911,
            "galleryHref": "https://www.cyclestreets.net/galleries/317/"
        },
        "318": {
            "id": 318,
            "title": "Abuse of Cycle Lanes at Stansted Airport",
            "description": "Motorists won't stay out of the cycle lanes.",
            "photos": [
                20,
                25,
                26,
                27
            ],
            "datetime": 1437336779,
            "galleryHref": "https://www.cyclestreets.net/galleries/318/"
        }
    }
}

Request parameters - required

None.

Request parameters - optional

fields string, comma-separated list of fields from the list below

Controls what information is returned; the fields id, title, description, photos and datetime are included by default.

Available fields are:

  • id Unique identifier for the gallery
  • title Gallery title
  • description Gallery description
  • photos Array of constituent photos in the gallery
  • datetime Datetime as a Unixtime timestamp; NB the format can be changed using the datetime parameter (see below)
  • galleryHref URL link to the gallery
  • galleryUpdateHref URL link to the gallery update page

datetime string

If specified, the datetime field (if requested in the fields list) will be converted from unixtime (the default output format) to a formatted version; the available output formats are:

  • friendly A friendly format suitable for showing on a webpage, e.g. '6:55pm, 4th October 2013'; this is equivalent to date ('g:ia, jS F Y', $date) in PHP
  • friendlydate A friendly date format suitable for showing on a webpage, e.g. '4th October, 2013'; this is equivalent to date ('jS F, Y', $date) in PHP
  • sqldatetime SQL DATETIME format (i.e. simplified ISO 8601 format): YYYY-MM-DD HH:MM:SS
  • unixtime Unixtime (the default)

Response

JSON structure as per example above.

If no galleries are found, the call will return an empty array.

Error response

None.

We welcome your feedback, especially to report bugs or give us route feedback.

My comments relate to: *






Your comments: *
URL of page: * https://www.cyclestreets.net/api/v2/galleries.list/
How did you find out about CycleStreets?:
Your name:
Our ref: Please leave blank - anti-spam measure

* Items marked with an asterisk [*] are required fields and must be fully completed.