# Viajes: hoteles

El `google_travel_hotels` La fuente de datos está diseñada para recuperar los resultados de búsqueda de hoteles del servicio Google Travel.

{% hint style="warning" %}
Para asegurar un uso óptimo de este servicio, incluye el `"render": "html"` parámetro en tu solicitud.
{% endhint %}

## Ejemplos de solicitud

En este ejemplo, hacemos una solicitud para recuperar la `2`ª página de resultados de disponibilidad de hoteles para `2` huéspedes adultos entre `2023-10-01` y `2023-10-10` para `2` a `4`hoteles de -estrellas en París desde `google.com`.

{% tabs %}
{% tab title="cURL" %}

```shell
curl 'https://realtime.oxylabs.io/v1/queries' \
--user 'USERNAME:PASSWORD' \
-H 'Content-Type: application/json' \
-d '{
        "source": "google_travel_hotels",
        "start_page": 2,
        "query": "hotels in Paris",
        "render": "html",
        "context": [
            {"key": "adults", "value": 2},
            {"key": "hotel_dates", "value": "2023-10-01,2023-10-10"},
            {"key": "hotel_classes", "value": [2, 3, 4]}
        ]
    }'
```

{% endtab %}

{% tab title="Python" %}

```python
import requests
from pprint import pprint

# Estructura la carga útil.
payload = {
    'source': 'google_travel_hotels',
    'query': 'hotels in Paris',
    'start_page': 2,
    'render': 'html',
    'context': [
        {'key': 'adults', 'value': 1},
        {'key': 'hotel_dates', 'value': '2023-10-01,2023-10-10'},
        {'key': 'hotel_classes', 'value': [2,3,4]},
    ],
}

# Obtén la respuesta.
response = requests.request(
    'POST',
    'https://realtime.oxylabs.io/v1/queries',
    auth=('USERNAME', 'PASSWORD'),
    json=payload,
)

# Imprime la respuesta con formato en stdout.
pprint(response.json())

```

{% endtab %}

{% tab title="Node.js" %}

```javascript
const https = require("https");

const username = "USERNAME";
const password = "PASSWORD";
const body = {
    source: "google_travel_hotels",
    start_page: 2,
    query: "hotels in Paris",
    render: "html",
    context: [
        { key: "adults", value: 2 },
        { key: "hotel_dates", value: "2023-10-01,2023-10-10" },
        { key: "hotel_classes", value: [2, 3, 4] },
    ],
};

const options = {
    hostname: "realtime.oxylabs.io",
    path: "/v1/queries",
    method: "POST",
    headers: {
        "Content-Type": "application/json",
        Authorization:
            "Basic " + Buffer.from(`${username}:${password}`).toString("base64"),
    },
};

const request = https.request(options, (response) => {
    let data = "";

    response.on("data", (chunk) => {
        data += chunk;
    });

    response.on("end", () => {
        const responseData = JSON.parse(data);
        console.log(JSON.stringify(responseData, null, 2));
    });
});

request.on("error", (error) => {
    console.error("Error:", error);
});

request.write(JSON.stringify(body));
request.end();
```

{% endtab %}

{% tab title="HTTP" %}

```http
https://realtime.oxylabs.io/v1/queries?source=google_travel_hotels&query=hotels+in+Paris&start_page=3&render=html&context[0][key]=adults&context[0][value]=1&context[1][key]=hotel_dates&context[1][value]=2023-10-01,2023-10-10&context[2][key]=hotel_classes&context[2][value]=[2,3,4]&access_token=12345abcde
```

{% endtab %}

{% tab title="PHP" %}

```php
<?php

$params = array(
    'source' => 'google_travel_hotels',
    'start_page' => 2,
    'query' => 'hotels in Paris',
    'render' => 'html',
    'context' => [
        ['key' => 'adults', 'value' => 2],
        ['key' => 'hotel_dates', 'value' => '2023-10-01,2023-10-10'],
        ['key' => 'hotel_classes', 'value' => [2, 3, 4]]
    ]
);

$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, "https://realtime.oxylabs.io/v1/queries");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($params));
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_USERPWD, "USERNAME" . ":" . "PASSWORD");


$headers = array();
$headers[] = "Content-Type: application/json";
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);

$result = curl_exec($ch);
echo $result;

if (curl_errno($ch)) {
    echo 'Error:' . curl_error($ch);
}
curl_close($ch);
```

{% endtab %}

{% tab title="Golang" %}

```go
package main

import (
	"bytes"
	"encoding/json"
	"fmt"
	"io/ioutil"
	"net/http"
)

func main() {
	const Username = "USERNAME"
	const Password = "PASSWORD"

	payload := map[string]interface{}{
		"source":     "google_travel_hotels",
		"start_page": 2,
		"query":      "hotels in Paris",
		"render":     "html",
		"context": []map[string]interface{}{
			{"key": "adults", "value": 2},
			{"key": "hotel_dates", "value": "2023-10-01,2023-10-10"},
			{"key": "hotel_classes", "value": []interface{}{2, 3, 4}},
		},
	}

	jsonValue, _ := json.Marshal(payload)

	client := &http.Client{}
	request, _ := http.NewRequest("POST",
		"https://realtime.oxylabs.io/v1/queries",
		bytes.NewBuffer(jsonValue),
	)

	request.SetBasicAuth(Username, Password)
	response, _ := client.Do(request)

	responseText, _ := ioutil.ReadAll(response.Body)
	fmt.Println(string(responseText))
}
```

{% endtab %}

{% tab title="C#" %}

```csharp
using System;
using System.Collections.Generic;
using System.Net.Http;
using System.Net.Http.Json;
using System.Threading.Tasks;

namespace OxyApi
{
    class Program
    {
        static async Task Main()
        {
            const string Username = "USERNAME";
            const string Password = "PASSWORD";

            var parameters = new {
                source = "google_travel_hotels",
                start_page = 2,
                query = "hotels in Paris",
                render = "html",
                context = new dynamic [] {
                    new { key = "adults", value = 2 },
                    new { key = "hotel_dates", value = "2023-10-01,2023-10-10" },
                    new { key = "hotel_classes", value = new int [] {2, 3, 4} }
                }
            };

            var client = new HttpClient();

            Uri baseUri = new Uri("https://realtime.oxylabs.io");
            client.BaseAddress = baseUri;

            var requestMessage = new HttpRequestMessage(HttpMethod.Post, "/v1/queries");
            requestMessage.Content = JsonContent.Create(parameters);

            var authenticationString = $"{Username}:{Password}";
            var base64EncodedAuthenticationString = Convert.ToBase64String(System.Text.ASCIIEncoding.UTF8.GetBytes(authenticationString));
            requestMessage.Headers.Add("Authorization", "Basic " + base64EncodedAuthenticationString);

            var response = await client.SendAsync(requestMessage);
            var contents = await response.Content.ReadAsStringAsync();

            Console.WriteLine(contents);
        }
    }
}
```

{% endtab %}

{% tab title="Java" %}

```java
package org.example;

import okhttp3.*;
import org.json.JSONArray;
import org.json.JSONObject;
import java.util.concurrent.TimeUnit;

public class Main implements Runnable {
    private static final String AUTHORIZATION_HEADER = "Authorization";
    public static final String USERNAME = "USERNAME";
    public static final String PASSWORD = "PASSWORD";

    public void run() {
        JSONObject jsonObject = new JSONObject();
        jsonObject.put("source", "google_travel_hotels");
        jsonObject.put("start_page", 2);
        jsonObject.put("query", "hotels in Paris");
        jsonObject.put("render", "html");
        jsonObject.put("context", new JSONArray()
                .put(new JSONObject().put("key", "adults").put("value", 2))
                .put(new JSONObject().put("key", "hotel_dates").put("value", "2023-10-01,2023-10-10"))
                .put(new JSONObject().put("key", "hotel_classes").put("value", new JSONArray().put(2).put(3).put(4)))
        );

        Authenticator authenticator = (route, response) -> {
            String credential = Credentials.basic(USERNAME, PASSWORD);
            return response
                    .request()
                    .newBuilder()
                    .header(AUTHORIZATION_HEADER, credential)
                    .build();
        };

        var client = new OkHttpClient.Builder()
                .authenticator(authenticator)
                .readTimeout(180, TimeUnit.SECONDS)
                .build();

        var mediaType = MediaType.parse("application/json; charset=utf-8");
        var body = RequestBody.create(jsonObject.toString(), mediaType);
        var request = new Request.Builder()
                .url("https://realtime.oxylabs.io/v1/queries")
                .post(body)
                .build();

        try (var response = client.newCall(request).execute()) {
            if (response.body() != null) {
                try (var responseBody = response.body()) {
                    System.out.println(responseBody.string());
                }
            }
        } catch (Exception exception) {
            System.out.println("Error: " + exception.getMessage());
        }

        System.exit(0);
    }

    public static void main(String[] args) {
        new Thread(new Main()).start();
    }
}
```

{% endtab %}

{% tab title="JSON" %}

```json
{
    "source": "google_travel_hotels",
    "start_page": 2, 
    "query": "hotels in Paris",
    "render": "html", 
    "context": [
        {
            "key": "adults", 
            "value": 2
        }, 
        {
            "key": "hotel_dates", 
            "value": "2023-10-01,2023-10-10"
        },
        {
            "key": "hotel_classes", 
            "value": [2,3,4]
        }
    ]
}
```

{% endtab %}
{% endtabs %}

Usamos el método de integración síncrona [**Realtime**](/products/es/web-scraper-api/integration-methods/realtime.md) en nuestros ejemplos. Si deseas usar [**Proxy Endpoint**](/products/es/web-scraper-api/integration-methods/proxy-endpoint.md) o la integración asíncrona [**Push-Pull**](/products/es/web-scraper-api/integration-methods/push-pull.md) consulta la sección de [**métodos de integración**](/products/es/web-scraper-api/integration-methods.md) .

## Valores de los parámetros de solicitud

### Genérico

Configuración básica y opciones de personalización para extraer resultados de Google Travel: Hotels.

<table><thead><tr><th width="222">Parámetro</th><th width="350.3333333333333">Descripción</th><th>Valor predeterminado</th></tr></thead><tbody><tr><td><mark style="background-color:green;"><strong>source</strong></mark></td><td>Establece el scraper.</td><td><code>google_travel_hotels</code></td></tr><tr><td><mark style="background-color:green;"><strong>query</strong></mark></td><td><p>La palabra clave o frase a buscar.</p><p><code>"query": "hotels"</code> dará como resultado una lista de hoteles en un <code>geo_location</code>.</p><p><code>"query": "hotels in &#x3C;Location>"</code> dará como resultado una lista de hoteles para <code>&#x3C;Location></code>. Por ejemplo, <code>"query": "hotels in Paris"</code> mostrará hoteles en París, independientemente de la <code>geo_location</code>.</p></td><td>-</td></tr><tr><td><mark style="background-color:green;"><strong>render</strong></mark></td><td>Habilita el renderizado de JavaScript cuando se establece en <code>html</code>. <a href="/spaces/xofNngbwiAAH0MB3lMAb/pages/47852075b446d7f11217f4c0334348f21fb197b8#javascript-rendering"><strong>Más información</strong></a><strong>.</strong></td><td>-</td></tr><tr><td><code>callback_url</code></td><td>URL de tu endpoint de callback. <a href="/spaces/xofNngbwiAAH0MB3lMAb/pages/28181dba27c108c1684f7f17f5d8fef78bd80d90"><strong>Más información</strong></a></td><td>-</td></tr><tr><td><code>user_agent_type</code></td><td>Tipo de dispositivo y navegador. La lista completa se puede encontrar <a href="/spaces/xofNngbwiAAH0MB3lMAb/pages/c0794af77dadf44c32dae6894baaca0b93585869"><strong>aquí</strong></a>.</td><td><code>desktop</code></td></tr></tbody></table>

&#x20;   \- parámetro obligatorio

### Localización

Adapta los resultados de búsqueda a ubicaciones geográficas e idiomas específicos.

<table><thead><tr><th width="222">Parámetro</th><th width="350.3333333333333">Descripción</th><th>Valor predeterminado</th></tr></thead><tbody><tr><td><code>geo_location</code></td><td>La ubicación geográfica para la que se debe adaptar el resultado. <strong>Usar este parámetro correctamente es extremadamente importante para obtener los datos correctos.</strong> Ten en cuenta que esta fuente puede aceptar un número limitado de <code>geo_location</code> valores; consulta <a href="/spaces/xofNngbwiAAH0MB3lMAb/pages/7ba8016b17441e2b1496d43e14d3e47b6eefb6f9#google-travel-hotels"><strong>esta sección</strong></a> para ver <code>geo_location</code> los valores que <strong>no</strong> generan resultados precisos.</td><td>-</td></tr><tr><td><code>locale</code></td><td><code>Accept-Language</code> valor del encabezado que cambia el idioma de la interfaz web de tu página de búsqueda de Google. <a href="/spaces/xofNngbwiAAH0MB3lMAb/pages/6eb70a43f15a81321802a17be08ec05b79c90a3f#locale-1"><strong>Más información</strong></a>.</td><td>-</td></tr></tbody></table>

{% hint style="info" %}
**NOTA:** `"geo_location": "Estados Unidos"` y otras ubicaciones de área amplia no son compatibles. Usa ubicaciones a nivel de ciudad `geo_location`, por ejemplo, `Seattle,Washington,United States`
{% endhint %}

### Paginación

Controles para gestionar la paginación.

<table><thead><tr><th width="222">Parámetro</th><th width="350.3333333333333">Descripción</th><th width="167">Valor predeterminado</th></tr></thead><tbody><tr><td><code>start_page</code></td><td>Número de página inicial.</td><td><code>1</code></td></tr></tbody></table>

### Filtrado

Opciones avanzadas para adaptar y refinar el contexto de búsqueda.

<table><thead><tr><th width="222">Parámetro</th><th width="350.3333333333333">Descripción</th><th>Valor predeterminado</th></tr></thead><tbody><tr><td><code>context:adults</code></td><td>Número de huéspedes adultos</td><td><code>2</code></td></tr><tr><td><code>context:children</code></td><td>Número de huéspedes niños</td><td>-</td></tr><tr><td><code>context</code>:<br><code>hotel_classes</code></td><td>Filtra los resultados por número de estrellas del hotel. Puedes especificar uno o más valores entre <code>2</code> y <code>5</code>. Ejemplo: <code>[3,4]</code></td><td>-</td></tr><tr><td><code>context</code>:<br><code>hotel_dates</code></td><td>Fechas de estancia en el hotel, de - a. Ejemplo: <code>2023-07-12,2023-07-13</code></td><td>-</td></tr></tbody></table>

### Parámetros de contexto

Todos los parámetros de contexto deben añadirse al arreglo `context` como objetos con pares `key` y `valor` value, por ejemplo.:

```json
...
"context": [
    {
        "key": "filter",
        "value": "0"
    }
]
...
```

## Ejemplo de salida

```json
{
    "results": [
        {
            "content":"<!doctype html>\n<html lang=\"en\">\n<head>
            ...
            </script></body>\n</html>\n",            
            "created_at": "2024-02-13 11:30:09",
            "updated_at": "2024-02-13 11:30:36",
            "page": 2,
            "url": "https://www.google.com/travel/search?q=hotels%20in%20Paris&qs=OAA&hrf=OAI4AzgEWAGSAQIgAbABAA&ap=EgNDQXcwAGgA&ts=CAEaFhIUEhIKBwjnDxAKGAESBwjnDxAKGAo&uule=w%20CAIQICINdW5pdGVkIHN0YXRlcw&gl=us&hl=en&ved=0CAAQ5JsGahcKEwjIwci_m6iEAxUAAAAAHQAAAAAQew",
            "job_id": "7163132237108506625",
            "status_code": 200
        }
    ]
}
```

<figure><img src="/files/d50e3f21a8052a5c7c030b34bbe3223965b17c52" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developers.oxylabs.io/api-targets/es/motores-de-busqueda/google/travel-hotels.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.