API para Tripadvisor

API para Tripadvisor: Buscar

Busque hotéis, restaurantes e atrações no Tripadvisor em qualquer destino e receba registros detalhados de locais (notas, número de avaliações, contatos, preços) em JSON normalizado.

POST/v1/run/tripadvisor.search
Disponibilidade
100,00%
30d · 7 chamadas
Requisições
7
30d · semanal, últimas 12 sem.
Resposta
14,2s
mediana · 30d

Rede de provedores

Provedores ordenados por tráfego

Teste

Faça sua primeira requisição

requireFieldsarray
Opcional; se omitido, o roteamento não muda e a fonte mais barata atende. Informe os campos de saída que esta requisição precisa poder retornar, por exemplo `phone` ou `website`, e ela só será atendida por uma fonte que retorne todos eles. Os campos que você não informar continuam sendo retornados sempre que a fonte que atende os tiver. Isso pode aumentar o seu preço: quando a fonte mais barata não consegue retornar um campo informado, uma fonte mais cara atende, e você recebe a cotação e é cobrado pelo preço dela. Um campo informado ainda pode vir ausente em um local que realmente não o tenha. Se você informar uma combinação de campos que nenhuma fonte retorna sozinha, a requisição é recusada como entrada inválida, sem cobrança.
Abrir em
Obter chave grátis
Resposta de exemplo
Execuções grátis retornam só os primeiros 3 resultados. Recarregue uma chave para receber a resposta completa.
{
  "data": {
    "items": [
      {
        "address": "123 Main St",
        "category": "general",
        "city": "San Francisco",
        "country": "US",
        "email": "alex@example.com",
        "hotelClass": "+1 555-0142",
        "id": "a1b2c3d4",
        "image": "https://example.com/image.jpg",
        "latitude": 37.7749,
        "longitude": -122.4194,
        "phone": "+1 555-0142",
        "postalCode": "94107",
        "priceLevel": "19.99",
        "priceRange": "19.99",
        "ranking": "example",
        "rating": 4.6,
        "reviewCount": 12500,
        "title": "Example title",
        "type": "general",
        "url": "https://example.com/page",
        "website": "https://example.com/page"
      }
    ]
  },
  "found": true,
  "reason": "not_found"
}
Interface da resposta
interface TripadvisorSearchResponse {
  data: {
    items: {
      address?: string;
      category?: string;
      city?: string;
      country?: string;
      email?: string;
      hotelClass?: string;
      id?: string;
      image?: string;
      latitude?: number;
      longitude?: number;
      phone?: string;
      postalCode?: string;
      priceLevel?: string;
      priceRange?: string;
      ranking?: string;
      rating: number | null;
      reviewCount?: number | null;
      title: string;
      type?: string;
      url: string;
      website?: string;
    }[];
  } | null;
  found: boolean;
  reason?: "not_found";
}

Referência completa de parâmetros e resposta - todos os campos, tipos e exemplos deste endpoint.

Referência

Requisição, resposta e preço

Última verificação em 2026-09-29 · disponibilidade e latência medidas em 30d
POST /v1/run/tripadvisor.search
curl -X POST https://api.getanyapi.com/v1/run/tripadvisor.search \
  -H "Authorization: Bearer $ANYAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":3,"query":"Paris"}'
CampoTipoValor de exemplo
Corpo da requisição
querystring"Paris"Destino ou palavra-chave a buscar (ex.: Barcelona).
currencystringCódigo de moeda ISO dos preços (ex.: USD, EUR).
includeAttractionsbooleanInclui atrações e atividades nos resultados; defina false para excluí-las (ex.: false). Padrão: true.
includeHotelsbooleanInclui hotéis nos resultados; defina false para excluí-los (ex.: false). Padrão: true.
includeRestaurantsbooleanInclui restaurantes nos resultados; defina false para excluí-los (ex.: false). Padrão: true.
limitinteger3Número máximo de resultados a retornar (1-20, padrão 20).
requireFieldsarrayOpcional; se omitido, o roteamento não muda e a fonte mais barata atende. Informe os campos de saída que esta requisição precisa poder retornar, por exemplo `phone` ou `website`, e ela só será atendida por uma fonte que retorne todos eles. Os campos que você não informar continuam sendo retornados sempre que a fonte que atende os tiver. Isso pode aumentar o seu preço: quando a fonte mais barata não consegue retornar um campo informado, uma fonte mais cara atende, e você recebe a cotação e é cobrado pelo preço dela. Um campo informado ainda pode vir ausente em um local que realmente não o tenha. Se você informar uma combinação de campos que nenhuma fonte retorna sozinha, a requisição é recusada como entrada inválida, sem cobrança.
Resposta
dataobjectThe result wrapper, or null when nothing matched.
data.itemsobject[]Matching Tripadvisor place records (hotels, restaurants, attractions). Populated whenever the provider has data for the entity.
data.items[].addresspode ser exigidostringFull formatted street address.
data.items[].categorystringHigh-level category (e.g. hotel, restaurant, attraction).
data.items[].citypode ser exigidostringCity the place is in.
data.items[].countrypode ser exigidostringCountry the place is in.
data.items[].emailpode ser exigidostringBusiness contact email, when listed.
data.items[].hotelClasspode ser exigidostringStar rating / hotel class, when applicable.
data.items[].idstringTripadvisor location id (stable identifier for the place).
data.items[].imagestringPrimary place photo URL.
data.items[].latitudepode ser exigidonumberLatitude of the place in decimal degrees.
data.items[].longitudepode ser exigidonumberLongitude of the place in decimal degrees.
data.items[].phonepode ser exigidostringBusiness phone number, when listed.
data.items[].postalCodepode ser exigidostringPostal code of the place.
data.items[].priceLevelpode ser exigidostringRelative price level indicator (e.g. $$, $$$$).
data.items[].priceRangepode ser exigidostringNightly or per-visit price range in the requested currency.
data.items[].rankingpode ser exigidostringRanking string within its location (e.g. "#2 of 1,885 hotels in Paris").
data.items[].ratingnumberAverage traveler rating out of 5; null for a place Tripadvisor has not rated (such as a city). Populated whenever the provider has data for the entity.
data.items[].reviewCountnumberTotal number of traveler reviews; null when the source does not report it.
data.items[].titlestringPlace name. Populated whenever the provider has data for the entity.
data.items[].typestringTripadvisor place type (e.g. HOTEL, RESTAURANT, ATTRACTION).
data.items[].urlstringCanonical Tripadvisor listing page URL. Populated whenever the provider has data for the entity.
data.items[].websitepode ser exigidostringThe place's own website URL, when listed.
foundbooleanTrue when the search returned at least one matching place.
reason"not_found"Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.
Preço
Preço por requisiçãoUSDUS$ 0,003
Preço /mil req.USDUS$ 3,00

Dúvidas frequentes

Sobre o endpoint Buscar da API para Tripadvisor

O endpoint Buscar da AnyAPI para Tripadvisor retorna dados de Tripadvisor em JSON normalizado com uma chamada POST para /v1/run/tripadvisor.search. Busque hotéis, restaurantes e atrações no Tripadvisor em qualquer destino e receba registros detalhados de locais (notas, número de avaliações, contatos, preços) em JSON normalizado. A AnyAPI distribui cada requisição entre 2 fontes, com failover automático quando uma falha. Custa a partir de US$ 3 por mil requisições, em dólares, sem assinatura e sem mínimo mensal. Nos últimos 30 dias, 100,0% das chamadas ao endpoint Buscar da API para Tripadvisor feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 14,2 segundos, em 7 chamadas medidas.

Custa a partir de US$ 3 por mil requisições, em dólares, sem assinatura e sem mínimo mensal. Você recarrega uma carteira em dólares e cada chamada desconta dela. Algumas requisições pagas pela carteira que falham geram cobranças de processamento, que repassamos pelo custo, sem margem; a resposta de erro mostra o valor cobrado.

Busque hotéis, restaurantes e atrações no Tripadvisor em qualquer destino e receba registros detalhados de locais (notas, número de avaliações, contatos, preços) em JSON normalizado. A resposta é JSON normalizado, com o mesmo envelope que todo endpoint da AnyAPI retorna, então processar um segundo endpoint é só trocar a URL, e nada mais.

Nos últimos 30 dias, 100,0% das chamadas ao endpoint Buscar da API para Tripadvisor feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 14,2 segundos, em 7 chamadas medidas. Estas são medições da própria AnyAPI sobre o tráfego que passa pelo gateway, recalculadas continuamente, e não uma meta de nível de serviço publicada.
Mais para chamar

Outros endpoints de Tripadvisor

Avaliaçõesa partir de US$ 3,00 /mil req.