API de Minube

Regístrate para acceder a nuestro API

Acerca de

Terminos de uso

Branding

Documentación

Registro para desarrolladores


¿Cómo hacer las peticiones?

Lo primero que tienes que hacer es tener tu llave de acceso, esta la pides con el registro que tenemos aqui mismo. Algo importante que debes recordar que esta llave debe de ir incluida en todas tus peticiones. Las peticiones se hacen al más puro estilo de REST, asi que solo tendrás que hacer una petición a URLs como esta: 

http://api.minube.com/locations/countries.xml?api_key=tullaveaqui

Las respuestas son en XML, aún en las que hayan resultado datos vacios o en las que haya ocurrido un error. Puedes saber el estado de cada respuesta directamente en el primer atributo "status" del elemento "response".

JSON

Además de tener las respuestas en formato XML, tenemos disponible JSON para aquellos que prefieran trabajar con Javascript. El único cambio a realizar es en la URL de la petición, cambiando el .xml a .json, de forma que quede: 

http://api.minube.com/locations/countries.json?api_key=tullaveaqui

La estructura de los objetos es la misma que en la respuesta XML equivalente.

Además de los parámetros indicados en cada sección, las peticiones realizadas en JSON soportan un parámetro adicional: callback. Este parámetro permite realizar operaciones sobre los resultados devueltos en la petición, sin tener que manipularlos internamente en el código. Por ejemplo, suponiendo que en tu código incluyas lo siguiente: 

<script type="text/javascript">
function foo(bar)
{
	for(var x=0; x<bar.response.countries.length; x++)
		alert(bar.response.countries[x].name + " tiene " +
		bar.response.countries[x].pois_count + " rincones!");
}
</script>
<script src="http://api.minube.com/locations/countries.json?
callback=foo&limit=5&api_key=tullaveaqui"></script>

Al momento de cargar la página, ejecutaría la función foo, enviándole como parámetro la respuesta de la petición realizada, resultando en una serie de alertas informándo al usuario de la cantidad de rincones en cada país. De esta manera, se pueden procesar los datos recibidos de una manera sencilla y transparente, filtrandolos para trabajar exclusivamente con lo requerido, o cambiándole el formato a la respuesta para que sea empleada en alguna otra función en el código, por ejemplo.

Sistema de Tickets

Para cada aplicación tenemos un límite de tickets que se pueden hacer mensualmente. Un ticket es el costo que nosotros le damos a una petición ya que unas son más complicadas que otras. Por el momento estamos en fase experimental y de pruebas, asi que cada petición solo vale 1 ticket, pero en el futuro ajustaremos estos costes de acuerdo a su uso. Solo recuerda no rebasar tu límite de tickets que es de 2000 mensuales.

Documentación de métodos

locations/countries

Regresa una lista de países
Subir

Parámetros

  • Sin parámetros regresa todas los países.
  • id (opcional): Id del país a buscar.
  • name (opcional): Nombre del país a buscar.
  • order (opcional): Ordenar resultados por:
    [pois_count*, name, id, full_count, see_count, restaurant_count, blog_count, hotel_count].
  • limit (opcional): Límite de resultados.
  • page (opcional): Página de resultados. 1 por defecto.
Un ejemplo de petición: 
http://api.minube.com/locations/countries.xml?api_key=xx&name=italia
Un ejemplo de la respuesta XML: 
<?xml version="1.0" encoding="UTF-8"?>
<response status="ok">
  <countries>
    <country>
      <id>104</id>
      <name>Italia</name>
      <pois_count>5021</pois_count>
      <full_count>734</full_count>
      <see_count>602</see_count>
      <restaurant_count>57</restaurant_count>
      <blog_count>23</blog_count>
      <hotel_count>13237</hotel_count>
      <latitude>41.871941</latitude>
      <longitude>12.567380</longitude>
    </country>
  </countries>
</response>

locations/cities

Regresa una lista de ciudades
Subir

Parámetros

  • Sin parámetros regresa todas las ciudades.
  • id (opcional): Id de la ciudad a buscar.
  • name (opcional): Nombre de la ciudad a buscar.
  • country (opcional): Nombre o id del país al que pertenece la ciudad.
  • order (opcional): Ordenar resultados por:
    [pois_count*, name, id, full_count, see_count, restaurant_count, blog_count, hotel_count].
  • limit (opcional): Límite de resultados. 20 por defecto.
  • page (opcional): Página de resultados. 1 por defecto.
Un ejemplo de petición: 
http://api.minube.com/locations/cities.xml?api_key=xx&name=madrid
Un ejemplo de la respuesta XML: 
<?xml version="1.0" encoding="UTF-8"?>
<response status="ok">
  <cities>
    <city>
      <id>1252</id>
      <name>Madrid</name>
      <pois_count>2051</pois_count>
      <full_count>966</full_count>
      <see_count>607</see_count>
      <restaurant_count>315</restaurant_count>
      <blog_count>14</blog_count>
      <hotel_count>415</hotel_count>
      <latitude>40.416706</latitude>
      <longitude>-3.703270</longitude>
      <country>
        <id>63</id>
        <name>España</name>
      </country>
    </city>
  </cities>
</response>

places/categories

Regresa una lista de categorias de rincones
Subir

Parámetros

  • Sin parámetros regresa todas las categorías.
  • id (opcional): Id de la categoría a buscar.
  • name (opcional): Nombre de la categoría a buscar.
  • supercategory (opcional): Id de la supercategoría a buscar.
  • order (opcional): Ordenar resultados por: [name*, id, group].
  • limit (opcional): Límite de resultados.
  • page (opcional): Página de resultados. 1 por defecto.
Un ejemplo de petición: 
http://api.minube.com/places/categories.xml?api_key=xx
Un ejemplo de la respuesta XML: 
<?xml version="1.0" encoding="UTF-8"?>
<response status="ok">
  <categories>
    <category>
      <id>131</id>
      <name>Abadias</name>
      <supercategory>2</supercategory>      
      <group>tosee</group> 
    </category>
  </categories>
</response>

places/supercategories

Regresa una lista de supercategorias de rincones
Subir

Parámetros

  • Sin parámetros regresa todas las supercategorías.
  • id (opcional): Id de la supercategorías a buscar.
  • name (opcional): Nombre de la supercategorías a buscar.
  • order (opcional): Ordenar resultados por: [name*, id, group].
  • limit (opcional): Límite de resultados.
  • page (opcional): Página de resultados. 1 por defecto.
Un ejemplo de petición: 
http://api.minube.com/places/supercategories.xml?api_key=xx
Un ejemplo de la respuesta XML: 
<?xml version="1.0" encoding="UTF-8"?>
<response status="ok">
  <supercategories>
    <supercategory>
      <id>2</id>
      <name>Cultura</name>
    </supercategory>
  </supecategories>
</response>

places/pois

Regresa una lista de rincones
Subir

Parámetros

  • Sin parámetros regresa el máximo de rincones.
  • id (opcional): Id del rincón a buscar.
  • city (opcional): Nombre o id de la ciudad donde se encuentra el rincón.
  • country (opcional): Nombre o id del país donde se encuentra el rincón.
  • category (opcional): Nombre o id de la categoría del rincón.
  • supercategory (opcional): Id de la supercategoría del rincón.
  • category_group (opcional): Grupo de categorías.
  • order (opcional): Ordenar resultados por: [date*, id, views, comments, total_score].
  • limit (opcional): Límite de resultados. 20 por defecto.
  • page (opcional): Página de resultados. 1 por defecto.
Un ejemplo de petición: 
http://api.minube.com/places/pois.xml?api_key=xx&city=madrid&country=españa
Un ejemplo de la respuesta XML: 
<?xml version="1.0" encoding="UTF-8"?>
<response status="ok">
  <pois>
    <poi>
      <id>70489</id>
      <name><![CDATA[Restaurante Kabuki Wellington]]></name>
      <date>2009-05-21 01:51:37</date>
      <address><![CDATA[Calle de Velazquez 6]]></address>
      <zip_code><![CDATA[55555]]></zip_code>
      <telephone><![CDATA[123456789]]></telephone>
      <website><![CDATA[http://www.example.com]]></website>
      <comments>0</comments>
      <views>1</views>
      <latitude>40.421833</latitude>
      <longitude>-3.684441</longitude>
      <url>http://www.minube.com/rincon/70489</url>
      <category>
        <id>29</id>
        <name>Restaurantes</name>
        <group>eat</group>
      </category>
      <supercategory>
        <id>3</id>
      </supercategory>            
      <country>
        <id>63</id>
        <name>España</name>
      </country>
      <city>
        <id>1252</id>
        <name>Madrid</name>
      </city>
    </poi>
  </pois>
</response>

places/comments

Regresa una lista de comentarios de rincones
Subir

Parámetros

  • Sin parámetros regresa todos los comentarios.
  • id (opcional): Id del comentario a buscar.
  • user (opcional): Nombre o id del usuario propietario del comentario.
  • poi (opcional): Id del rincón a buscar.
  • category (opcional): Nombre o id de la categoría del rincón.
  • supercategory (opcional): Id de la supercategoría del rincón.
  • category_group (opcional): Grupo de categorías.
  • country (opcional): Nombre o id del país donde se encuentra el rincón.
  • city (opcional): Nombre o id de la ciudad donde se encuentra el rincón.
  • order (opcional): Ordenar resultados por: [date*, id].
  • limit (opcional): Límite de resultados. 20 por defecto.
  • page (opcional): Página de resultados. 1 por defecto.
Un ejemplo de petición: 
http://api.minube.com/places/comments.xml?api_key=xx&country=francia&category=teatros
Un ejemplo de la respuesta XML: 
<?xml version="1.0" encoding="UTF-8"?>
<response status="ok">
  <comments>
    <comment>
      <id>66441</id>
      <date>2007-11-12 00:00:00</date>
      <content><![CDATA[Este teatro esta situado en la ciudad de Paris, en el 
distrito 13, y ofrece un numero variado de muestras: se centra en piezas clasicas del 
teatro (Shakespeare, Racine, etc.), y ofrece conciertos de todo tipo. Los precios son 
interesantes por la calidad de los actores, los musicos y el sonido de 
la sala.]]></content>
      <poi>
        <id>68530</id>
        <name><![CDATA[Teatro 13]]></name>
        <url>http://www.minube.com/rincon/68530</url>
        <category>
          <id>92</id>
          <name>Teatros</name>
          <group>tosee</group>
        </category>
	    <supercategory>
	      <id>5</id>
	    </supercategory>        
        <user>
          <id>54275</id>
          <username>matthieu1985</username>
          <url>http://www.minube.com/viajero/matthieu1985</url>
        </user>
        <country>
          <id>71</id>
          <name>Francia</name>
        </country>
        <city>
          <id>1401</id>
          <name>Paris</name>
        </city>
      </poi>
    </comment>
  </comments>
</response>

places/nearby

Regresa una lista de rincones cercanos
Subir

Parámetros

  • id (requerido): Id del rincón a buscar.
  • category (opcional): Nombre o id de la categoría de los rincones cercanos.
  • supercategory (opcional): Id de la supercategoría de los rincones cercanos.
  • category_group (opcional): Grupo de categorías.
  • order (opcional): Ordenar resultados por: [views*, id, date, comments, distance, total_score].
  • limit (opcional): Límite de resultados. 20 por defecto.
  • page (opcional): Página de resultados. 1 por defecto.
Un ejemplo de petición: 
http://api.minube.com/places/nearby.xml?api_key=xx&id=70489&category=restaurantes
Un ejemplo de la respuesta XML: 
<?xml version="1.0" encoding="UTF-8"?>
<response status="ok">
  <pois>
    <poi>
      <id>543</id>
      <name><![CDATA[Restaurante Ojala]]></name>
      <date>2007-11-27 13:32:41</date>
      <address><![CDATA[San Andres 1]]></address>
      <zip_code><![CDATA[28004]]></zip_code>
      <telephone><![CDATA[91 523 27 47]]></telephone>
      <website><![CDATA[http://]]></website>
      <comments>2</comments>
      <views>13356</views>
      <latitude>40.425533</latitude>
      <longitude>-3.703945</longitude>
      <url>http://www.minube.com/rincon/543</url>
      <distance>1703.4</distance>
      <category>
        <id>29</id>
        <name>Restaurantes</name>
        <group>eat</group>
      </category>
      <supercategory>
        <id>3</id>
      </supercategory>      
      <country>
        <id>63</id>
        <name>España</name>
      </country>
      <city>
        <id>1252</id>
        <name>Madrid</name>
      </city>
    </poi>
  </pois>
</response>

places/coordinates

Regresa una lista de rincones cercanos a una coordenada dada
Subir

Parámetros

  • latitude (requerido): Latitud deseada.
  • longitude (requerido): Longitud deseada.
  • distance (opcional): Distancia máxima (metros) a la coordenada dada. 500mts por defecto.
  • category (opcional): Nombre o id de la categoría de los rincones cercanos.
  • supercategory (opcional): Id de la supercategoría de los rincones cercanos.
  • category_group (opcional): Grupo de categorías.
  • order (opcional): Ordenar resultados por: [views, id, date, comments, distance*].
  • limit (opcional): Límite de resultados. 50 por defecto.
  • page (opcional): Página de resultados. 1 por defecto.
Un ejemplo de petición: 
http://api.minube.com/places/coordinates.xml?api_key=xx&latitude=52.2679&longitude=4.54327
Un ejemplo de la respuesta XML: 
<?xml version="1.0" encoding="UTF-8"?>
<response status="ok">
  <pois>
    <poi>
      <id>95</id>
      <name><![CDATA[Keukenhof]]></name>
      <distance>1.11508095705312</distance>
      <date>2007-10-17 10:47:08</date>
      <address><![CDATA[Stationsweg 166a]]></address>
      <zip_code><![CDATA[2161]]></zip_code>
      <telephone><![CDATA[+31 (0) 252 465 555]]></telephone>
      <website><![CDATA[http://www.keukenhof.nl/nm/espagnol.html]]</website>
      <comments>4</comments>
      <views>618</views>
      <latitude>52.267910</latitude>
      <longitude>4.543269</longitude>
      <url>http://www.minube.com/rincon/95</url>
      <category>
        <id>4</id>
        <name>Reservas Naturales</name>
        <group>tosee</group>
      </category>
      <supercategory>
        <id>1</id>
      </supercategory>      
      <country>
        <id>90</id>
        <name>Holanda</name>
      </country>
      <city>
        <id>249236</id>
        <name>Lisse</name>
      </city>
    </poi>
  </pois>
</response>

media/pictures

Regresa una lista de fotos
Subir

Parámetros

  • Sin parámetros regresa máximo posible de fotos.
  • id (opcional): Id de la foto a buscar.
  • poi (opcional): Id del rincón de la foto.
  • country (opcional): Nombre o id del país donde se encuentra el rincón.
  • city (opcional): Nombre o id de la ciudad donde se encuentra el rincón.
  • category (opcional): Nombre o id de la categoría del rincón.
  • order (opcional): Ordenar resultados por: [date*, id, views, comments].
  • limit (opcional): Límite de resultados. 20 por defecto.
  • page (opcional): Página de resultados. 1 por defecto.
Un ejemplo de petición: 
http://api.minube.com/media/pictures.xml?api_key=xx&city=boston
Un ejemplo de la respuesta XML: 
<?xml version="1.0" encoding="UTF-8"?>
<response status="ok">
  <pictures>
    <picture>
      <id>195046</id>
      <views>76</views>
      <date>2009-01-28 13:52:50</date>
      <url>http://d9ptcxk3xvglv.cloudfront.net/8b2da2bd6f60372f5ea30fa0d2a5e0c5</url>
      <user>
        <id>52341</id>
        <username>p4bl0</username>
        <url>http://www.minube.com/viajero/p4bl0</url>
      </user>
      <poi>
        <id>36423</id>
        <name><![CDATA[Prudential Tower]]></name>
        <category>Miradores</category>
        <url>http://www.minube.com/rincon/36423</url>
      </poi>
      <country>
        <id>242</id>
        <name>Estados Unidos</name>
      </country>
      <city>
        <id>145650</id>
        <name>Boston</name>
      </city>
    </picture>
  </pictures>
</response>

media/picture_comments

Regresa una lista de los comentarios en fotos
Subir

Parámetros

  • Sin parámetros regresa máximo posible de comentarios.
  • id (opcional): Id del comentario a buscar.
  • picture_id (opcional): Id de la foto.
  • order (opcional): Ordenar resultados por: [date*, id, picture_id].
  • limit (opcional): Límite de resultados. 20 por defecto.
  • page (opcional): Página de resultados. 1 por defecto.
Un ejemplo de petición: 
http://api.minube.com/media/picture_comments.xml?api_key=xx&picture_id=359790
Un ejemplo de la respuesta XML: 
<?xml version="1.0" encoding="UTF-8"?>
<response status="ok">
  <picture_comments>
    <picture_comment>
      <id>8717</id>
      <content><![CDATA[Magnificooooooo!!!!!felicitaciones. Saludos]]></content>
      <date>2009-05-21 04:13:07</date>
      <user>
        <id>53698</id>
        <username>martapilar</username>
        <url>http://www.minube.com/viajero/martapilar</url>
      </user>
      <picture>
        <id>359790</id>
        <poi_id>70416</poi_id>
        <url>http://d9ptcxk3xvglv.cloudfront.net/224f9027d45aed5a2ab0b5f510497067</url>
      </picture>
    </picture_comment>
  </picture_comments>
</response>

media/videos

Regresa una lista de videos
Subir

Parámetros

  • Sin parámetros regresa máximo posible de videos.
  • id (opcional): Id del video a buscar.
  • poi (opcional): Id del rincón del video.
  • country (opcional): Nombre o id del país donde se encuentra el rincón.
  • city (opcional): Nombre o id de la ciudad donde se encuentra el rincón.
  • category (opcional): Nombre o id de la categoría del rincón.
  • order (opcional): Ordenar resultados por: [date*, id, views].
  • limit (opcional): Límite de resultados. 20 por defecto.
  • page (opcional): Página de resultados. 1 por defecto.
Un ejemplo de petición: 
http://api.minube.com/media/videos.xml?api_key=xx&city=roma
Un ejemplo de la respuesta XML: 
<?xml version="1.0" encoding="UTF-8"?>
<response status="ok">
  <videos>
    <video>
      <id>1932</id>
      <views>74</views>
      <date>2009-03-05 17:07:02</date>
      <url>http://www.minube.com/videos/rincon/2551/1932</url>
      <user>
        <id>51221</id>
        <username>Mou</username>
        <url>http://www.minube.com/viajero/Mou</url>
      </user>
      <poi>
        <id>2551</id>
        <name><![CDATA[Vistas desde el Coliseo]]></name>
        <category>De interes turistico</category>
        <url>http://www.minube.com/rincon/2551</url>
      </poi>
      <country>
        <id>104</id>
        <name>Italia</name>
      </country>
      <city>
        <id>1878</id>
        <name>Roma</name>
      </city>
    </video>
  </videos>
</response>

media/video_comments

Regresa una lista de los comentarios en videos
Subir

Parámetros

  • Sin parámetros regresa máximo posible de comentarios.
  • id (opcional): Id del comentario a buscar.
  • video_id (opcional): Id del video.
  • order (opcional): Ordenar resultados por: [date*, id, video_id].
  • limit (opcional): Límite de resultados. 20 por defecto.
  • page (opcional): Página de resultados. 1 por defecto.
Un ejemplo de petición: 
http://api.minube.com/media/video_comments.xml?api_key=xx
Un ejemplo de la respuesta XML: 
<?xml version="1.0" encoding="UTF-8"?>
<response status="ok">
  <video_comments>
    <video_comment>
      <id>582</id>
      <content><![CDATA[Asi es Naxos, tal y como estan las cosas con un vuelo barato 
te sale rentable y ademas disfrutas de un lugar realmente espectacular porque ademas 
me olvide decir que esta propia casa que alquila los chalets organiza excursiones de 
todo tipo por toda la isla a precios de risa ademas que decir de lo que cuesta comer 
por libre en Tailandia. Saludos.]]></content>
      <date>2009-05-20 13:10:16</date>
      <user>
        <id>54173</id>
        <username>miguelangelcartagena</username>
        <url>http://www.minube.com/viajero/miguelangelcartagena</url>
      </user>
      <video>
        <id>2949</id>
        <poi_id>70380</poi_id>
        <url>http://www.minube.com/videos/rincon/70380/2949</url>
      </video>
    </video_comment>
  </video_comments>
</response>

buzz/flights

Regresa una lista de los mejores precios de vuelos
Subir

Parámetros

  • Sin parámetros regresa máximo posible de vuelos.
  • source_iata (opcional): Código IATA del aeropuerto origen.
  • source_city (opcional): Nombre o id de la ciudad origen.
  • source_country (opcional): Nombre o id del país origen.
  • destination_iata (opcional): Código IATA del aeropuerto destino.
  • destination_city (opcional): Nombre o id de la ciudad destino.
  • destination_country (opcional): Nombre o id del país destino.
  • order (opcional): Ordenar resultados por: [best_price*, depart_date, return_date].
  • limit (opcional): Límite de resultados. 20 por defecto.
  • page (opcional): Página de resultados. 1 por defecto.
Un ejemplo de petición: 
http://api.minube.com/buzz/flights.xml?api_key=xx&source_country=espana&source_city=madrid
Un ejemplo de la respuesta XML: 
<?xml version="1.0" encoding="UTF-8"?>
<response status="ok">
  <flights>
    <flight>
      <best_price>20.98</best_price>
      <depart_date>2009-06-07</depart_date>
      <return_date>2009-06-14</return_date>
      <url>http://www.minube.com/homes/flights/1190948</url>
      <source_city>
        <id>1252</id>
        <name>Madrid</name>
      </source_city>
      <source_country>
        <id>63</id>
        <name>España</name>
      </source_country>
      <destination_city>
        <id>1261</id>
        <name>Santander</name>
      </destination_city>
      <destination_country>
        <id>63</id>
        <name>España</name>
      </destination_country>
    </flight>
  </flights>
</response>

buzz/cities

Regresa una lista de las ciudades que cuentan con información de precios de vuelos
Subir

Parámetros

  • Sin parámetros regresa la lista entera de ciudades.
  • source_city (opcional): ID de la ciudad origen del vuelo.
  • source_iata (opcional): Código IATA del aeropuerto origen.
  • destination_city (opcional): Nombre o id de la ciudad destino.
  • destination_iata (opcional): Código IATA del aeropuerto destino.
  • order (opcional): Ordenar resultados por: [name*, pois_count, id, full_count, see_count, restaurant_count, blog_count, hotel_count].
  • limit (opcional): Límite de resultados. 20 por defecto.
  • page (opcional): Página de resultados. 1 por defecto.
Un ejemplo de petición: 
http://api.minube.com/buzz/cities.xml?api_key=xx&source_iata=MAD&limit=1

		Un ejemplo de la respuesta XML:
		
<?xml version="1.0" encoding="UTF-8"?>
<response status="ok">
	<cities>
		<city>
			<id>1248</id>
			<name>A Coruña</name>
			<pois_count>288</pois_count>
			<full_count>222</full_count>
			<see_count>164</see_count>
			<restaurant_count>55</restaurant_count>
			<blog_count>0</blog_count>
			<hotel_count>21</hotel_count>
			<latitude>43.371490</latitude>
			<longitude>-8.395970</longitude>
			<country>
				<id>63</id>
				<name>España</name>
			</country>
		</city>
	</cities>
</response>
 		

		
		
		
		

			
search/flights

			
Lanza una búsqueda de vuelos

			Subir 
		


		
Parámetros


		
    
			
  • source_iata (requerido): Código IATA del aeropuerto de origen.
    • 
			
  • destiny_iata (requerido): Código IATA del aeropuerto de destino.
    • 
			
  • depart_date (opcional): Fecha de salida. Por defecto el día siguiente.
    • 
			
  • depart_time (opcional): Hora del vuelo de salida: 'anytime'*, 'early', 'morning', 'afternoon', 'night'.
    • 
			
  • return_date (opcional): Fecha de regreso. Por defecto dos días después de la fecha actual.
    • 
			
  • return_time (opcional): Hora del vuelo de regreso: 'anytime'*, 'early', 'morning', 'afternoon', 'night'.
    • 
			
  • adults (opcional): Cantidad de adultos en el vuelo. Por defecto 1.
    • 
			
  • children (opcional): Cantidad de niños en el vuelo. Por defecto 0.
    • 
			
  • babies (opcional): Cantidad de bebes en el vuelo. Por defecto 0.
    • 
			
  • stops (opcional): Vuelo con o sin paradas: 'with_stops'* o 'direct'
    • 
			
  • source_nearby_airport (opcional): Permitir aeropuertos cercanos al origen. 'true' o 'false'*
    • 
			
  • destiny_nearby_airport (opcional): Permitir aeropuertos cercanos al destino. 'true' o 'false'*
    • 
		


		Un ejemplo de petición:
		
http://api.minube.com/search/flights.json?api_key=xx&source_iata=MAD&destiny_iata=BCN


		Un ejemplo de la respuesta XML:
		
<?xml version="1.0" encoding="UTF-8"?>
<response status="ok">
	<search>
		<id>14e59da61b53572ff0e43aad356d65c0</id>
	</search>
</response>
 		

		
		
		
		

			
search/lodges

			
Lanza una búsqueda de hoteles

			Subir 
		


		
Parámetros


		
    
			
  • city (requerido): Ciudad en la que se buscaran hoteles.
    • 
			
  • country (requerido): País al que pertenece dicha ciudad.
    • 
			
  • date_in (opcional): Fecha de entrada. Por defecto una semana después de la fecha actual.
    • 
			
  • date_out (opcional): Fecha de salida. Por defecto dos semanas después de la fecha actual.
    • 
			
  • rooms (opcional): Cantidad de habitaciones deseadas.
    • 
			
  • adults (opcional): Cantidad de adultos en el vuelo. Por defecto 2.
    • 
			
  • children (opcional): Cantidad de niños en el vuelo. Por defecto 0.
    • 
		


		Un ejemplo de petición:
		
http://api.minube.com/search/lodges.json?api_key=xx&city=Madrid&country=Espa%C3%B1a

		Tip: ¡No olviden codificar los parámetros de la búsqueda! En Javascript, se emplea la función encodeURIComponent. En PHP, se usa urlencode.

		Un ejemplo de la respuesta XML:
		
<?xml version="1.0" encoding="UTF-8"?>
<response status="ok">
	<search>
		<id>e17afb268eee5f081b9a19ee32a83421</id>
	</search>
</response>
 		

		
		
		
		

			
search/fetch

			
Obtiene los resultados de una búsqueda iniciada anteriormente

			Subir 
		


		
Parámetros


		
    
			
  • sid (requerido): ID de la búsqueda de la que se desean los resultados.
    • 
			
  • type (requerido): Tipo de búsqueda lanzada: 'flights'* o 'lodges'
    • 
		


		Un ejemplo de petición:
		
http://api.minube.com/search/fetch.json?api_key=xx&type=lodges&sid=e17afb268eee5f081b9a19ee32a83421


		Un ejemplo abreviado de la respuesta XML para una búsqueda de hoteles:
		
<?xml version="1.0" encoding="UTF-8"?>
<response status="ok">
	<lodges>
		<lodge>
		<distance>4520.5</distance>
		<hotel_id>32350</hotel_id>
		<latitude>40.469717775782600</latitude>
		<longitude>-3.685820658704060</longitude>
		<normalized>25 foxa suite</normalized>
		<price>0</price>
		<rating>4</rating>
		<address><![CDATA[Agustín de Foxa, 25]]></address>
		<hotel_company><![CDATA[Desconocido]]></hotel_company>
		<hotel_type><![CDATA[Hotel]]></hotel_type>
		<hotelurl><![CDATA[http://www.nomaders.com//minube/track.aspx?CityCode=6396&StartDate=12/10/2009&EndDate=19/10/2009&Type=SingleHotel&Rooms=1&Kids=0&Adults=2&HotelId=a28014d2-2716-4820-869b-cfd6d29859e7&src=MI]]></hotelurl>
		<imageurl><![CDATA[http://www.venere.com//img/hotel/8/1/1/1/111118/image_hotel_exterior_outside_1.jpg]]></imageurl>
		<name><![CDATA[Hotel Suite Foxa 25]]></name>
		<shop><![CDATA[Nomaders]]></shop>
		<providers>
			<provider>
				<activado>1</activado>
				<price>0</price>
				<deeplink><![CDATA[http://www.nomaders.com//minube/track.aspx?CityCode=6396&StartDate=12/10/2009&EndDate=19/10/2009&Type=SingleHotel&Rooms=1&Kids=0&Adults=2&HotelId=a28014d2-2716-4820-869b-cfd6d29859e7&src=MI]]></deeplink>
				<shop><![CDATA[Nomaders]]></shop>
			</provider>
		</providers>
		<amenities>
			<amenity><![CDATA[Internet]]></amenity>
			<amenity><![CDATA[Parking]]></amenity>
			<amenity><![CDATA[Bar / Restaurante]]></amenity>
		</amenities>
		</lodge>
	</lodges>
</response>
 		

 		
 		Un ejemplo abreviado de la respuesta XML para una búsqueda de vuelos:
		
<?xml version="1.0" encoding="UTF-8"?>
<response status="ok">
	<flights>
		<flight>
			<duration>9000</duration>
			<duration_simple>4800</duration_simple>
			<extra_cost>0</extra_cost>
			<mcarriers>N</mcarriers>
			<price>90</price>
			<deeplink><![CDATA[http://eulerian.govoyages.com/dynclick/govolo-es/?etf-name=Flux%20minube%20-%20Vol&etf-prdref=VOL&ref=2007102301&vildep=MAD&Vilarr=BCN&DatDep=061009&DatArr=071009&AllRet=oui&Adultes=1&ENFANTS=0&BEBES=0&TypeClasse=0&langue=es&eurl=http://www.advences.com/mirror/listevols.cfm]]></deeplink>
			<shop><![CDATA[Govolo]]></shop>
			<flightGo>
				<arrival>BCN</arrival>
				<arrivalTZ>60</arrivalTZ>
				<arrivaldate>2009-10-06</arrivaldate>
				<arrivaltime>22:15</arrivaltime>
				<date>2009-10-06</date>
				<departure>MAD</departure>
				<departureTZ>60</departureTZ>
				<flightcode>UX</flightcode>
				<stops>0</stops>
				<time>20:55</time>
				<type>Economica</type>
				<airline><![CDATA[Air Europa]]></airline>
				<arrival_city><![CDATA[Barcelona]]></arrival_city>
				<departure_city><![CDATA[Madrid]]></departure_city>
				<arrivalName><![CDATA[Barcelona]]></arrivalName>
				<departureName><![CDATA[Barajas]]></departureName>
			</flightGo>
			<flightReturn>
				<arrival>MAD</arrival>
				<arrivalTZ>60</arrivalTZ>
				<arrivaldate>2009-10-07</arrivaldate>
				<arrivaltime>10:20</arrivaltime>
				<date>2009-10-07</date>
				<departure>BCN</departure>
				<departureTZ>60</departureTZ>
				<flightcode>UX</flightcode>
				<stops>0</stops>
				<time>09:10</time>
				<type>Economica</type>
				<airline><![CDATA[UX]]></airline>
				<arrival_city><![CDATA[Madrid]]></arrival_city>
				<departure_city><![CDATA[Barcelona]]></departure_city>
				<arrivalName><![CDATA[Barajas]]></arrivalName>
				<departureName><![CDATA[Barcelona]]></departureName>
			</flightReturn>
			<providers>
				<provider>
					<activado>1</activado>
					<price>90</price>
					<deeplink><![CDATA[http://eulerian.govoyages.com/dynclick/govolo-es/?etf-name=Flux%20minube%20-%20Vol&etf-prdref=VOL&ref=2007102301&vildep=MAD&Vilarr=BCN&DatDep=061009&DatArr=071009&AllRet=oui&Adultes=1&ENFANTS=0&BEBES=0&TypeClasse=0&langue=es&eurl=http://www.advences.com/mirror/listevols.cfm]]></deeplink>
					<shop><![CDATA[Govolo]]></shop>
				</provider>
				<provider>
					<activado>1</activado>
					<price>143.8</price>
					<deeplink><![CDATA[http://www.barceloviajes.com/sites/all/vuelos/valoracion.jsp?tprod=VUE&id=170&sistema=AMA&sesion=V174460810&eticket=S&utm_source=MINUBE&est=1&utm_medium=feed_afiliado&utm_term=vuelos]]></deeplink>
					<shop><![CDATA[Barcelo Viajes]]></shop>
				</provider>
			</providers>
		</flight>
	</flights>
</response>