Using Muselia API you can display what museums are in a geographic area on your own web site. The information about museums we share is great to enrich your application (art related sites, hotels and vacation sites, touristic sites...).

Our API is very simple and easy to use. It accepts two kinds of requests:

Get top 10 museums in a city

You have to make a GET request like this sample one:

http://www.muselia.com/apimuseums?city=new-york&country=united-states

Request parameters

Country: The name of one country where we have museums listed, check our destinations page to see our list of countries. You have to write the country name replacing spaces for dashes and in small caps.

City: The name of one city of the country indicated in the country parameter. Check the page of the country (i.e: Spain) to see available cities. You have to write the city name replacing spaces for dashes and in small caps.

Callback: The optional parameter "callback" specifies the JSONP callback. More information about JSONP.

Get museums in a geographical area (BBOX)

You have to make a GET request like this sample one:

http://www.muselia.com/apimuseums?BBOX=-3.713889,40.369044,-3.596603,40.4225,&quantity=5

Request parameters

BBOX: You have to indicate a rectangle in order to get the museums of a geographical area. This Bounding Box is defined with four coordinates, in the following order: minimum longitude, minimum latitude, maximum longitude, maximum latitude.

Quantity: An additional parameter "quantity" may be specified to determine the number of museums you want to get. By default is 5 and it max value is 99

Callback: The optional parameter "callback" specifies the JSONP callback. More information about JSONP.

Response

The response has the same format for both methods, data is formatted using JSON. An example:


    [{
      "name": "Museum of Modern Art - MOMA",
      "url": "http://www.muselia.com/us/new-york/museum-of-modern-art/",
      "coordinates": "40.7609644465,-73.9769124985",
      "address": "11 West 53 Street  New York, NY 10019",
      "image": "http://www.muselia.com/us/new-york/museum-of-modern-art/imgmain/"
    },{
      "name": "Metropolitan Museum of Art",
      "url": "http://www.muselia.com/us/new-york/metropolitan-museum-of-art/",
      "coordinates": "40.7790536295,-73.9626646042",
      "address": "1000 Fifth Avenue New York, NY 10028",
      "image": "http://www.muselia.com/us/new-york/metropolitan-museum-of-art/imgmain/"
    },{
      "name": "Guggenheim Museum",
      "url": "http://www.muselia.com/us/new-york/guggenheim-museum/",
      "coordinates": "40.7828204613,-73.9591884613",
      "address": "1071 Fifth Avenue, New York, NY 10128",
      "image": "http://www.muselia.com/us/new-york/guggenheim-museum/imgmain/"
    }]