// docs

Trivago PDP

Extrai os detalhes de uma acomodação do Trivago, incluindo identidade, descrição, avaliação, endereço, imagens, comodidades, quartos e ofertas disponíveis.

Nota importante: alguns campos podem retornar null em produção, dependendo da página de origem. Nesta documentação, os exemplos de output são preenchidos intencionalmente com valores não nulos para facilitar integração.

Quando a entidade consultada não existe na origem, o extract e a tool MCP retornam 200 com data: null e notFound: true. Esse caso é tratado como resposta concluída, não como erro de servidor.

Chamada HTTP

cURL
curl -X POST https://api.geckoapi.com.br/v1/extract \
  -H "Authorization: Bearer SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{
  "url": "https://www.trivago.com.br/pt-BR/oar/hotel-atlantico-prime-rio-de-janeiro?search=100-4626720",
  "target": "trivago.com.br",
  "type": "pdp"
}'

Chamada MCP

A mesma seam também aparece no MCP hospedado como uma tool dedicada. Os argumentos reaproveitam os campos do extract, mas target e type já ficam fixos pela tool.

Ver guia completo do MCP

Endpoint

POST /v1/mcp

Tool name

trivago_com_br_pdp

Auth

Bearer ou X-API-Key

trivago_com_br_pdp tools/call
{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "trivago_com_br_pdp",
    "arguments": {
      "url": "https://www.trivago.com.br/pt-BR/oar/hotel-atlantico-prime-rio-de-janeiro?search=100-4626720",
      "executionId": "exec_example_123"
    }
  }
}

Possibilidades de input

Campos suportados nesta API do POST /v1/extract, com regras específicas de obrigatoriedade e condicionais.

Campo Tipo Status Regra Default Exemplo
url
URL alvo da extração. Para alguns PLPs pode ser omitida quando a API monta a URL a partir de outros campos.
string (URL) Obrigatório URL pública de uma acomodação em trivago.com.br ou trivago.com. - https://www.mercadolivre.com.br/p/MLB123456
target
Fonte alvo da extração.
enum Obrigatório Sempre obrigatório e deve ser trivago.com.br. - mercadolivre.com.br
type
Tipo da extração: pdp, idp, plp, ilp, quote, review ou places.
enum Obrigatório Sempre obrigatório e deve ser pdp. - pdp
checkinDate
Data de check-in para Booking PDP/PLP, Hoteis.com PDP/PLP e Trivago PDP/PLP.
string (YYYY-MM-DD) Condicional Data de check-in no formato YYYY-MM-DD. Quando enviada, checkoutDate também deve ser informada. - 2026-03-01
checkoutDate
Data de check-out para Booking PDP/PLP, Hoteis.com PDP/PLP e Trivago PDP/PLP. Deve ser maior que checkinDate.
string (YYYY-MM-DD) Condicional Data de check-out no formato YYYY-MM-DD e posterior a checkinDate. - 2026-03-02
numAdults
Quantidade de adultos para Booking, Airbnb, Hoteis.com, Trivago, Decolar, GOL, Azul e LATAM.
integer (1-30) Opcional Quantidade de adultos usada para consultar ofertas datadas. 2 2
numChildren
Quantidade de criancas para Booking, Hoteis.com, Trivago, Decolar, GOL, Azul e LATAM.
integer (0-30) Opcional Quantidade de crianças usada para consultar ofertas datadas. 0 0
numRooms
Quantidade de quartos para Booking, Hoteis.com PDP/PLP e Trivago PDP/PLP.
integer (1-15) Opcional Quantidade de quartos usada para consultar ofertas datadas. 1 1
lang
Idioma para Booking e Trivago (default no backend: pt-br).
string (ll ou ll-cc) Opcional Idioma dos textos retornados no formato ll ou ll-cc. pt-BR pt-br
currency
Moeda para Booking, Trivago e Azul (default no backend: BRL).
string (ISO 4217) Opcional Moeda das ofertas no formato ISO 4217. BRL BRL

Exemplos de request

Detalhes de uma acomodação

Informe apenas a URL pública para extrair o conteúdo estável da acomodação.

Detalhes de uma acomodação
{
  "url": "https://www.trivago.com.br/pt-BR/oar/hotel-atlantico-prime-rio-de-janeiro?search=100-4626720",
  "target": "trivago.com.br",
  "type": "pdp"
}

Detalhes com ofertas para uma estadia

Datas, ocupação e moeda são opcionais e permitem enriquecer o resultado com ofertas datadas.

Detalhes com ofertas para uma estadia
{
  "url": "https://www.trivago.com.br/pt-BR/oar/hotel-atlantico-prime-rio-de-janeiro?search=100-4626720",
  "target": "trivago.com.br",
  "type": "pdp",
  "checkinDate": "2026-07-20",
  "checkoutDate": "2026-07-22",
  "numAdults": 2,
  "numChildren": 0,
  "numRooms": 1,
  "currency": "BRL"
}

Schema de response (leaf paths)

Mapa de paths de saída com tipo esperado para esta API.

responseSchema
{
  "requestId": "string (uuid)",
  "executionId": "string (uuid)",
  "notFound": "boolean (optional; true when the accommodation was not found and data is null)",
  "data.source": "string",
  "data.type": "string",
  "data.parser": "string",
  "data.requestUrl": "string (URL)",
  "data.extractedAt": "string (ISO datetime)",
  "data.data.id": "number",
  "data.data.namespace": "number",
  "data.data.url": "string (URL)",
  "data.data.canonicalUrl": "string (URL)",
  "data.data.name": "string",
  "data.data.description": "string (optional)",
  "data.data.propertyId": "string (optional)",
  "data.data.accommodationType": "string (optional)",
  "data.data.starRating": "number (optional)",
  "data.data.isSuperior": "boolean (optional)",
  "data.data.aggregateRating.rating": "number (optional)",
  "data.data.aggregateRating.reviewCount": "number (optional)",
  "data.data.aggregateRating.formatted": "string (optional)",
  "data.data.address.line": "string (optional)",
  "data.data.address.streetAddress": "string (optional)",
  "data.data.address.postalCode": "string (optional)",
  "data.data.address.city": "string (optional)",
  "data.data.address.country": "string (optional)",
  "data.data.address.latitude": "number (optional)",
  "data.data.address.longitude": "number (optional)",
  "data.data.checkInHour": "string (optional)",
  "data.data.checkOutHour": "string (optional)",
  "data.data.mainImage": "string (URL, optional)",
  "data.data.image[].id": "string (optional)",
  "data.data.image[].url": "string (URL)",
  "data.data.image[].width": "number (optional)",
  "data.data.image[].height": "number (optional)",
  "data.data.image[].tags[]": "string",
  "data.data.image[].sourceNames[]": "string",
  "data.data.imageCount": "number (optional)",
  "data.data.amenityGroups[].id": "number (optional)",
  "data.data.amenityGroups[].namespace": "number (optional)",
  "data.data.amenityGroups[].name": "string (optional)",
  "data.data.amenityGroups[].features[].id": "number (optional)",
  "data.data.amenityGroups[].features[].namespace": "number (optional)",
  "data.data.amenityGroups[].features[].name": "string (optional)",
  "data.data.topAmenities[].id": "number (optional)",
  "data.data.topAmenities[].namespace": "number (optional)",
  "data.data.topAmenities[].name": "string (optional)",
  "data.data.topAmenities[].isFree": "boolean (optional)",
  "data.data.topAmenities[].isAvailable": "boolean (optional)",
  "data.data.rooms[].id": "string (optional)",
  "data.data.rooms[].name": "string (optional)",
  "data.data.rooms[].maxChildren": "number (optional)",
  "data.data.rooms[].maxGuests": "number (optional)",
  "data.data.rooms[].maxPersons": "number (optional)",
  "data.data.rooms[].sizeSquareMeters": "number (optional)",
  "data.data.rooms[].hasAirConditioner": "boolean (optional)",
  "data.data.rooms[].hasFreeWifi": "boolean (optional)",
  "data.data.rooms[].views[]": "string",
  "data.data.rooms[].beds[].id": "string (optional)",
  "data.data.rooms[].beds[].name": "string (optional)",
  "data.data.rooms[].beds[].count": "number (optional)",
  "data.data.rooms[].beds[].numberOfOccupants": "number (optional)",
  "data.data.rooms[].amenities[]": "string",
  "data.data.rooms[].images[]": "string (URL)",
  "data.data.deals[].id": "string (optional)",
  "data.data.deals[].advertiser.id": "number (optional)",
  "data.data.deals[].advertiser.namespace": "number (optional)",
  "data.data.deals[].advertiser.name": "string (optional)",
  "data.data.deals[].advertiser.logo": "string (URL, optional)",
  "data.data.deals[].url": "string (URL, optional)",
  "data.data.deals[].description": "string (optional)",
  "data.data.deals[].roomCategory": "string (optional)",
  "data.data.deals[].pricePerNight.amount": "number (optional)",
  "data.data.deals[].pricePerNight.eurocents": "number (optional)",
  "data.data.deals[].pricePerNight.currency": "string (optional)",
  "data.data.deals[].pricePerStay.amount": "number (optional)",
  "data.data.deals[].pricePerStay.eurocents": "number (optional)",
  "data.data.deals[].pricePerStay.currency": "string (optional)",
  "data.data.deals[].strikePricePerNight.amount": "number (optional)",
  "data.data.deals[].strikePricePerNight.eurocents": "number (optional)",
  "data.data.deals[].strikePricePerNight.currency": "string (optional)",
  "data.data.deals[].strikePricePerStay.amount": "number (optional)",
  "data.data.deals[].strikePricePerStay.eurocents": "number (optional)",
  "data.data.deals[].strikePricePerStay.currency": "string (optional)",
  "data.data.deals[].savingsPercentage": "number (optional)",
  "data.data.deals[].freeCancellationDeadline": "string (ISO datetime, optional)",
  "data.data.deals[].eligibleForDetailsPage": "boolean (optional)",
  "data.data.hasFreeWifi": "boolean (optional)",
  "data.data.popular": "boolean (optional)",
  "data.data.distance": "string (optional)",
  "data.data.constructionYear": "number (optional)",
  "data.data.createdAt": "string (ISO datetime, optional)",
  "data.data.checkinDate": "string (YYYY-MM-DD, optional)",
  "data.data.checkoutDate": "string (YYYY-MM-DD, optional)",
  "data.data.numAdults": "number",
  "data.data.numChildren": "number",
  "data.data.numRooms": "number",
  "data.data.currency": "string",
  "data.data.lang": "string"
}

Exemplo de response

responseExample
{
  "requestId": "5de70952-2419-4920-8d9a-6d278a735290",
  "executionId": "01JZTRIVAGOPDP000000000001",
  "data": {
    "source": "trivago.com.br",
    "type": "pdp",
    "parser": "graphql_accommodation_details",
    "requestUrl": "https://www.trivago.com.br/pt-BR/oar/hotel-atlantico-prime-rio-de-janeiro?search=100-4626720%3Bdr-20260720-20260722",
    "extractedAt": "2026-07-12T15:32:00.000Z",
    "data": {
      "id": 4626720,
      "namespace": 100,
      "url": "https://www.trivago.com.br/pt-BR/oar/hotel-atlantico-prime-rio-de-janeiro?search=100-4626720",
      "canonicalUrl": "https://www.trivago.com.br/pt-BR/oar/hotel-atlantico-prime-rio-de-janeiro?search=100-4626720",
      "name": "Hotel Atlântico Prime",
      "description": "Hotel no centro do Rio de Janeiro.",
      "propertyId": "4626720",
      "accommodationType": "Hotel",
      "starRating": 4,
      "isSuperior": false,
      "aggregateRating": {
        "rating": 7.402,
        "reviewCount": 35843,
        "formatted": "7.4"
      },
      "address": {
        "line": "R. do Rezende, 87, Rio de Janeiro, Brasil",
        "streetAddress": "R. do Rezende, 87",
        "postalCode": "20231-091",
        "city": "Rio de Janeiro",
        "country": "Brasil",
        "latitude": -22.91,
        "longitude": -43.18
      },
      "checkInHour": "14:00",
      "checkOutHour": "12:00",
      "mainImage": "https://imgcy.trivago.com/c_fill,d_dummy.jpeg,e_sharpen:60,f_auto,h_480,q_60,w_720/itemimages/prime.jpeg",
      "image": [
        {
          "id": "image-1",
          "url": "https://imgcy.trivago.com/c_fill,d_dummy.jpeg,e_sharpen:60,f_auto,h_480,q_60,w_720/itemimages/prime-room.jpeg",
          "width": 1200,
          "height": 800,
          "tags": [
            "910-1"
          ],
          "sourceNames": [
            "Hotel"
          ]
        }
      ],
      "imageCount": 67,
      "amenityGroups": [
        {
          "id": 1,
          "namespace": 910,
          "name": "Geral",
          "features": [
            {
              "id": 2,
              "namespace": 920,
              "name": "Wi-Fi"
            }
          ]
        }
      ],
      "topAmenities": [
        {
          "id": 2,
          "namespace": 920,
          "name": "Wi-Fi",
          "isFree": true,
          "isAvailable": true
        }
      ],
      "rooms": [
        {
          "id": "1",
          "name": "Quarto duplo",
          "maxChildren": 1,
          "maxGuests": 2,
          "maxPersons": 2,
          "sizeSquareMeters": 250,
          "hasAirConditioner": true,
          "hasFreeWifi": true,
          "views": [
            "Cidade"
          ],
          "beds": [
            {
              "id": "1",
              "name": "Cama casal",
              "count": 1,
              "numberOfOccupants": 2
            }
          ],
          "amenities": [
            "Frigobar"
          ],
          "images": [
            "https://imgcy.trivago.com/c_fill,d_dummy.jpeg,e_sharpen:60,f_auto,h_480,q_60,w_720/itemimages/prime-room.jpeg"
          ]
        }
      ],
      "deals": [
        {
          "id": "deal-1",
          "advertiser": {
            "id": 3620,
            "namespace": 400,
            "name": "Ourtrip",
            "logo": "https://imgcy.trivago.com/partnerlogos-s3/3620"
          },
          "url": "https://www.trivago.com.br/forward/test",
          "description": "Quarto duplo luxo",
          "pricePerNight": {
            "amount": 224,
            "eurocents": 3842,
            "currency": "BRL"
          },
          "pricePerStay": {
            "amount": 448,
            "currency": "BRL"
          },
          "eligibleForDetailsPage": false
        }
      ],
      "hasFreeWifi": true,
      "popular": true,
      "checkinDate": "2026-07-20",
      "checkoutDate": "2026-07-22",
      "numAdults": 2,
      "numChildren": 0,
      "numRooms": 1,
      "currency": "BRL",
      "lang": "pt-BR"
    }
  }
}

Referência completa de campos

Path Tipo Descrição Exemplo
data.data.accommodationType string (optional) Tipo da acomodação, como hotel, pousada ou apartamento. Hotel
data.data.address.city string (optional) Cidade da acomodação. Rio de Janeiro
data.data.address.country string (optional) País da acomodação. Brasil
data.data.address.latitude number (optional) Latitude da acomodação. -22.91
data.data.address.line string (optional) Endereço completo formatado. R. do Rezende, 87, Rio de Janeiro, Brasil
data.data.address.longitude number (optional) Longitude da acomodação. -43.18
data.data.address.postalCode string (optional) Código postal da acomodação. 20231-091
data.data.address.streetAddress string (optional) Logradouro e número da acomodação. R. do Rezende, 87
data.data.aggregateRating.formatted string (optional) Resumo textual da avaliação. 7.4
data.data.aggregateRating.rating number (optional) Nota agregada das avaliações. 7.402
data.data.aggregateRating.reviewCount number (optional) Quantidade agregada de avaliações. 35843
data.data.amenityGroups[].features[].id number (optional) Identificador da comodidade no grupo. 2
data.data.amenityGroups[].features[].name string (optional) Nome da comodidade no grupo. Wi-Fi
data.data.amenityGroups[].features[].namespace number (optional) Namespace da comodidade no grupo. 920
data.data.amenityGroups[].id number (optional) Identificador do grupo de comodidades. 1
data.data.amenityGroups[].name string (optional) Nome do grupo de comodidades. Geral
data.data.amenityGroups[].namespace number (optional) Namespace do grupo de comodidades. 910
data.data.canonicalUrl string (URL) URL canônica da acomodação sem parâmetros transitórios. https://www.trivago.com.br/pt-BR/oar/hotel-atlantico-prime-rio-de-janeiro?search=100-4626720
data.data.checkinDate string (YYYY-MM-DD, optional) Data de check-in usada para consultar ofertas, quando informada. 2026-07-20
data.data.checkInHour string (optional) Horário informado para início do check-in. 14:00
data.data.checkoutDate string (YYYY-MM-DD, optional) Data de check-out usada para consultar ofertas, quando informada. 2026-07-22
data.data.checkOutHour string (optional) Horário informado para término do check-out. 12:00
data.data.constructionYear number (optional) Ano de construção informado, quando disponível. N/A
data.data.createdAt string (ISO datetime, optional) Data de criação informada pelo upstream, quando disponível. N/A
data.data.currency string Moeda usada para normalizar os preços. BRL
data.data.deals[].advertiser.id number (optional) Identificador do anunciante. 3620
data.data.deals[].advertiser.logo string (URL, optional) URL do logotipo do anunciante, quando disponível. https://imgcy.trivago.com/partnerlogos-s3/3620
data.data.deals[].advertiser.name string (optional) Nome do anunciante. Ourtrip
data.data.deals[].advertiser.namespace number (optional) Namespace do anunciante. 400
data.data.deals[].description string (optional) Descrição da oferta, quando disponível. Quarto duplo luxo
data.data.deals[].eligibleForDetailsPage boolean (optional) Indica se a oferta pode ser aberta na página de detalhes. false
data.data.deals[].freeCancellationDeadline string (ISO datetime, optional) Prazo para cancelamento gratuito, quando disponível. N/A
data.data.deals[].id string (optional) Identificador da oferta. deal-1
data.data.deals[].pricePerNight.amount number (optional) Preço numérico por noite. 224
data.data.deals[].pricePerNight.currency string (optional) Moeda do preço por noite. BRL
data.data.deals[].pricePerNight.eurocents number (optional) Preço por noite normalizado em centavos de euro. 3842
data.data.deals[].pricePerStay.amount number (optional) Preço numérico da estadia. 448
data.data.deals[].pricePerStay.currency string (optional) Moeda do preço da estadia. BRL
data.data.deals[].pricePerStay.eurocents number (optional) Preço da estadia normalizado em centavos de euro. N/A
data.data.deals[].roomCategory string (optional) Categoria do quarto associada à oferta. N/A
data.data.deals[].savingsPercentage number (optional) Percentual de economia calculado para a oferta. N/A
data.data.deals[].strikePricePerNight.amount number (optional) Preço anterior por noite, quando disponível. N/A
data.data.deals[].strikePricePerNight.currency string (optional) Moeda do preço anterior por noite. N/A
data.data.deals[].strikePricePerNight.eurocents number (optional) Preço anterior por noite em centavos de euro. N/A
data.data.deals[].strikePricePerStay.amount number (optional) Preço anterior da estadia, quando disponível. N/A
data.data.deals[].strikePricePerStay.currency string (optional) Moeda do preço anterior da estadia. N/A
data.data.deals[].strikePricePerStay.eurocents number (optional) Preço anterior da estadia em centavos de euro. N/A
data.data.deals[].url string (URL, optional) URL de saída para a oferta. https://www.trivago.com.br/forward/test
data.data.description string (optional) Descrição textual da acomodação, quando disponível. Hotel no centro do Rio de Janeiro.
data.data.distance string (optional) Distância textual exibida pelo Trivago, quando disponível. N/A
data.data.hasFreeWifi boolean (optional) Indica se a acomodação informa Wi-Fi gratuito. true
data.data.id number Identificador da acomodação no Trivago. 4626720
data.data.image[].height number (optional) Altura da imagem em pixels. 800
data.data.image[].id string (optional) Identificador de uma imagem da galeria. image-1
data.data.image[].sourceNames[] string Fontes atribuídas à imagem. Hotel
data.data.image[].tags[] string Categorias associadas à imagem. 910-1
data.data.image[].url string (URL) URL de uma imagem da galeria. https://imgcy.trivago.com/c_fill,d_dummy.jpeg,e_sharpen:60,f_auto,h_480,q_60,w_720/itemimages/prime-room.jpeg
data.data.image[].width number (optional) Largura da imagem em pixels. 1200
data.data.imageCount number (optional) Quantidade total de imagens informada pelo upstream. 67
data.data.isSuperior boolean (optional) Indica se a classificação possui a distinção superior. false
data.data.lang string Idioma normalizado usado nas operações GraphQL. pt-BR
data.data.mainImage string (URL, optional) URL da imagem principal, quando disponível. https://imgcy.trivago.com/c_fill,d_dummy.jpeg,e_sharpen:60,f_auto,h_480,q_60,w_720/itemimages/prime.jpeg
data.data.name string Nome comercial da acomodação. Hotel Atlântico Prime
data.data.namespace number Namespace associado ao identificador da acomodação. 100
data.data.numAdults number Quantidade de adultos usada na consulta. 2
data.data.numChildren number Quantidade de crianças usada na consulta. 0
data.data.numRooms number Quantidade de quartos usada na consulta. 1
data.data.popular boolean (optional) Indica se o Trivago destaca a acomodação como popular. true
data.data.propertyId string (optional) Identificador de propriedade associado à acomodação. 4626720
data.data.rooms[].amenities[] string Comodidades específicas do quarto. Frigobar
data.data.rooms[].beds[].count number (optional) Quantidade de camas deste tipo. 1
data.data.rooms[].beds[].id string (optional) Identificador do tipo de cama. 1
data.data.rooms[].beds[].name string (optional) Nome do tipo de cama. Cama casal
data.data.rooms[].beds[].numberOfOccupants number (optional) Capacidade de ocupantes por cama. 2
data.data.rooms[].hasAirConditioner boolean (optional) Indica se o quarto possui ar-condicionado. true
data.data.rooms[].hasFreeWifi boolean (optional) Indica se o quarto oferece Wi-Fi gratuito. true
data.data.rooms[].id string (optional) Identificador do quarto. 1
data.data.rooms[].images[] string (URL) URL de uma imagem do quarto. https://imgcy.trivago.com/c_fill,d_dummy.jpeg,e_sharpen:60,f_auto,h_480,q_60,w_720/itemimages/prime-room.jpeg
data.data.rooms[].maxChildren number (optional) Quantidade máxima de crianças no quarto. 1
data.data.rooms[].maxGuests number (optional) Quantidade máxima de hóspedes no quarto. 2
data.data.rooms[].maxPersons number (optional) Capacidade máxima total do quarto. 2
data.data.rooms[].name string (optional) Nome ou categoria do quarto. Quarto duplo
data.data.rooms[].sizeSquareMeters number (optional) Área do quarto em metros quadrados. 250
data.data.rooms[].views[] string Vistas informadas para o quarto. Cidade
data.data.starRating number (optional) Classificação por estrelas, quando informada. 4
data.data.topAmenities[].id number (optional) Identificador de uma comodidade em destaque. 2
data.data.topAmenities[].isAvailable boolean (optional) Indica se a comodidade está disponível. true
data.data.topAmenities[].isFree boolean (optional) Indica se a comodidade é gratuita. true
data.data.topAmenities[].name string (optional) Nome da comodidade em destaque. Wi-Fi
data.data.topAmenities[].namespace number (optional) Namespace da comodidade em destaque. 920
data.data.url string (URL) URL consultada da acomodação. https://www.trivago.com.br/pt-BR/oar/hotel-atlantico-prime-rio-de-janeiro?search=100-4626720
data.extractedAt string (ISO datetime) Data e hora UTC da extração. 2026-07-12T15:32:00.000Z
data.parser string Estratégia usada para normalizar a resposta GraphQL. graphql_accommodation_details
data.requestUrl string (URL) URL da acomodação recebida e normalizada. https://www.trivago.com.br/pt-BR/oar/hotel-atlantico-prime-rio-de-janeiro?search=100-4626720%3Bdr-20260720-20260722
data.source string Fonte pública consultada. trivago.com.br
data.type string Tipo do seam executado. pdp
executionId string (uuid) Identificador idempotente da execução. 01JZTRIVAGOPDP000000000001
notFound boolean (optional; true when the accommodation was not found and data is null) Presente e verdadeiro quando a acomodação não foi encontrada; nesse caso data é nulo. N/A
requestId string (uuid) Identificador da requisição na GeckoAPI. 5de70952-2419-4920-8d9a-6d278a735290

Erros comuns

Respostas com notFound: true não entram nesta tabela, porque retornam sucesso HTTP 200.

Status errorCode Quando acontece
400 INVALID_PAYLOAD JSON inválido ou violação das regras de validação do payload.
401 UNAUTHORIZED Header Authorization ausente ou token/chave inválida.
402 INSUFFICIENT_CREDITS Saldo de créditos insuficiente para a API solicitada.
403 FORBIDDEN Usuário sem acesso ou API temporariamente desabilitada.
409 EXECUTION_CONFLICT executionId conflita com uma execução em estado incompatível.
429 RATE_LIMIT_EXCEEDED / TOO_MANY_INFLIGHT_REQUESTS Limite de taxa ou limite de requisições em voo excedido.
5xx UPSTREAM_TIMEOUT / UPSTREAM_HTTP_ERROR / WORKER_INVOCATION_FAILED / WORKER_FUNCTION_ERROR / WORKER_INVALID_RESPONSE / INTERNAL_ERROR Falha de servidor no worker, provider/proxy ou gateway. Nesses casos os créditos são estornados automaticamente.