# Hospedagem e viagens

> Hospedagem e viagens: Anúncios do Airbnb e hotéis do Booking.com.

URL: https://apicultura.app/ferramentas/hospedagem-viagens/
Atualizado em 05/11/2026 (2026-11-05).

## O que é Hospedagem e viagens na APIcultura

Acesse Hospedagem e viagens pelo APIcultura com uma única chave de API e saldo pré-pago em R$. Anúncios do Airbnb e hotéis do Booking.com. Respostas em JSON, cobrança só por chamada concluída e estorno automático em falhas.

Categoria: [Mapas e locais](/catalogo/?cat=locais). Autenticação: chave da própria APIcultura (`apk_live_...`); nenhuma conta de terceiros precisa ser conectada.

## Endpoints e preço por chamada

| Endpoint (slug) | O que faz | Preço por chamada | Rota |
|---|---|---|---|
| `airbnb-anuncio` | Anúncio do Airbnb | R$ 0,01 | `POST /v1/call/airbnb-anuncio` |
| `booking-hotel` | Hotel no Booking.com | R$ 0,01 | `POST /v1/call/booking-hotel` |
| `hoteis-google-buscar` | Hotéis no Google | R$ 0,04 | `POST /v1/call/hoteis-google-buscar` |

### Anúncio do Airbnb (`airbnb-anuncio`)

Detalhes de um anúncio do Airbnb. Preço: R$ 0,01 por chamada.

- `listing` (string, obrigatório), ex.: `678901120783302718`

### Schema de entrada de airbnb-anuncio

```json
{
  "required": [
    "listing"
  ],
  "properties": {
    "listing": {
      "type": "string",
      "maxLength": 2000
    }
  }
}
```

### Hotel no Booking.com (`booking-hotel`)

Detalhes de um hotel do Booking.com. Preço: R$ 0,01 por chamada.

- `hotel` (string, obrigatório), ex.: `https://www.booking.com/hotel/us/felix.html`

### Schema de entrada de booking-hotel

```json
{
  "required": [
    "hotel"
  ],
  "properties": {
    "hotel": {
      "type": "string",
      "maxLength": 2000
    }
  }
}
```

### Hotéis no Google (`hoteis-google-buscar`)

Hotéis e preços do Google Hotels para uma busca. Preço: R$ 0,04 por chamada.

- `keyword` (string, opcional), ex.: `cheap hotel`
- `location_name` (string, opcional), ex.: `New York,New York,United States`
- `location_code` (integer, opcional)
- `location_coordinate` (string, opcional)
- `search_this_area` (boolean, opcional)
- `language_name` (string, opcional)
- `language_code` (string, opcional), ex.: `en`
- `depth` (integer, opcional)
- `check_in` (string, opcional), ex.: `2026-08-24`
- `check_out` (string, opcional), ex.: `2026-08-25`
- `currency` (string, opcional), ex.: `USD`
- `adults` (integer, opcional), ex.: `2`
- `children` (array, opcional), ex.: `14`
- `stars` (array, opcional)
- `min_rating` (number, opcional)
- `sort_by` (string, opcional), ex.: `highest_rating`
- `min_price` (integer, opcional)
- `max_price` (integer, opcional)
- `free_cancellation` (boolean, opcional)
- `is_vacation_rentals` (boolean, opcional)
- `amenities` (array, opcional)
- `tag` (string, opcional), ex.: `example`

### Schema de entrada de hoteis-google-buscar

```json
{
  "required": [],
  "properties": {
    "keyword": {
      "type": "string",
      "maxLength": 2000
    },
    "location_name": {
      "type": "string",
      "maxLength": 2000
    },
    "location_code": {
      "type": "number"
    },
    "location_coordinate": {
      "type": "string",
      "maxLength": 2000
    },
    "search_this_area": {
      "type": "boolean"
    },
    "language_name": {
      "type": "string",
      "maxLength": 2000
    },
    "language_code": {
      "type": "string",
      "maxLength": 2000
    },
    "depth": {
      "type": "number"
    },
    "check_in": {
      "type": "string",
      "maxLength": 2000
    },
    "check_out": {
      "type": "string",
      "maxLength": 2000
    },
    "currency": {
      "type": "string",
      "maxLength": 2000
    },
    "adults": {
      "type": "number"
    },
    "children": {
      "type": "array"
    },
    "stars": {
      "type": "array"
    },
    "min_rating": {
      "type": "number"
    },
    "sort_by": {
      "type": "string",
      "maxLength": 2000
    },
    "min_price": {
      "type": "number"
    },
    "max_price": {
      "type": "number"
    },
    "free_cancellation": {
      "type": "boolean"
    },
    "is_vacation_rentals": {
      "type": "boolean"
    },
    "amenities": {
      "type": "array"
    },
    "tag": {
      "type": "string",
      "maxLength": 2000
    }
  }
}
```

## Exemplo de chamada MCP

Com o MCP da APIcultura conectado, o agente usa a ferramenta `call` com o slug do endpoint e a entrada:

```json
{ "name": "call", "arguments": { "slug": "airbnb-anuncio", "input": {"listing":"678901120783302718"}, "max_cost_brl": 0.1 } }
```

## Exemplo de chamada HTTP

```bash
curl -X POST https://api.apicultura.app/v1/call/airbnb-anuncio \
  -H "Authorization: Bearer $APICULTURA_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"listing":"678901120783302718"}'
```

## Formato da resposta, preço e limites

A resposta é JSON com `data` (o resultado do endpoint) e `meta` (inclui `cost_brl`, o valor cobrado). Preço deste endpoint: R$ 0,01 por chamada. Falhas do serviço (502) e pedidos recusados (422) não são cobrados. Use `max_cost_brl` para limitar o gasto por chamada; o saldo pré-pago em R$ é o teto. Parâmetros de entrada: exemplo acima.

## Experimente

Teste no playground interativo: [Hospedagem e viagens no playground](/ferramentas/ferramenta.html?slug=hospedagem-viagens). Veja também [todas as ferramentas](/ferramentas/), [como conectar seu agente](/como-conectar/) e o [FAQ](/faq/).

> **Nota.** Hospedagem e viagens é marca de seus respectivos donos, citada apenas para identificar a integração.