Hospedagem e viagens

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

Atualizado em 05/11/2026.

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. Autenticação: chave da própria APIcultura (apk_live_...); nenhuma conta de terceiros precisa ser conectada.

Endpoints e preço por chamada

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

{
  "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

{
  "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

{
  "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:

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

Exemplo de chamada HTTP

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. Veja também todas as ferramentas, como conectar seu agente e o FAQ.

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