# Search Tripadvisor

> Search Tripadvisor is a paid API for AI agents from agents.litescrape.com, paid per call via MPP, $0.000150/call, status unknown (last checked 2026-09-18).

Searches Tripadvisor by text and returns structured place results including name, type, rating, review count, location, and place_id.

## Facts

- Endpoint: GET https://agents.litescrape.com/api/tripadvisor/search
- Price: $0.000150/call
- Payment: MPP
- Status: unknown
- Last checked: 2026-09-18
- Activations on Zero: 0
- Provider: agents.litescrape.com
- Website: https://agents.litescrape.com
- Canonical page: https://www.zero.xyz/c/agents-litescrape-com-search-tripadvisor-a402373a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_1xiPamQWQ8x-e9ZtfTso_

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agents-litescrape-com-search-tripadvisor-a402373a
```

Example prompt: Search Tripadvisor for the top-rated Italian restaurants in Florence, Italy — show me up to 20 results including their ratings and review counts.

## When to prefer this

Use this endpoint when you need to search Tripadvisor specifically for travel-related places — hotels, restaurants, attractions, or geographic areas — and require structured data (ratings, review counts, place IDs) for downstream processing such as fetching detailed reviews. Prefer this over generic web search when you need Tripadvisor-native place_ids for chaining with place-detail or reviews endpoints, or when filtering by place type, geography, or locale matters.

## Known failure modes

- Missing required 'q' parameter returns a 400 error with error_code and error message
- lat provided without lon (or vice versa) causes a parameter validation error
- Invalid place_type enum value returns an error response
- geo_id not recognized by Tripadvisor returns empty search_results
- Pagination offset (start) beyond available results returns empty search_results
- Rate limiting or upstream Tripadvisor service unavailability returns a retryable error with retryable:true

## How this service works

Searches Tripadvisor by text and returns search_results (name, place type, rating, review count, location, and the place_id for the place and reviews endpoints). Narrow by place_type (accommodation, attraction, attraction_product, eatery, or geo), a geo_id, or lat and lon, choose the language with locale and a localized tripadvisor_domain, and page with start and num (up to 30 per call). One call is one request.

## Output

Returns an array of search_results where each item includes the place name, place type (accommodation/attraction/eatery/geo), star rating, review count, location details, and a place_id usable with Tripadvisor place-detail and reviews endpoints. Also includes search_metadata (request ID, status, time taken), search_parameters (normalized inputs), and a pagination object with a next-page URL when more results exist.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "q"
 ],
 "properties": {
  "q": {
   "type": "string",
   "maxLength": 500,
   "description": "Search text."
  },
  "lat": {
   "type": "number",
   "maximum": 90,
   "minimum": -90,
   "description": "Search-center latitude. Requires lon."
  },
  "lon": {
   "type": "number",
   "maximum": 180,
   "minimum": -180,
   "description": "Search-center longitude. Requires lat."
  },
  "num": {
   "type": "integer",
   "default": 30,
   "maximum": 30,
   "minimum": 1,
   "description": "Number of results."
  },
  "start": {
   "type": "integer",
   "default": 0,
   "maximum": 10000,
   "minimum": 0,
   "description": "Result offset."
  },
  "geo_id": {
   "type": "string",
   "description": "Positive Tripadvisor geography ID to search within."
  },
  "locale": {
   "type": "string",
   "default": "en-US",
   "description": "Language or language-COUNTRY code."
  },
  "place_type": {
   "enum": [
    "all",
    "accommodation",
    "attraction",
    "attraction_product",
    "eatery",
    "geo"
   ],
   "type": "string",
   "default": "all",
   "description": "Result entity type."
  },
  "tripadvisor_domain": {
   "type": "string",
   "default": "www.tripadvisor.com",
   "description": "Localized Tripadvisor hostname."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "pagination": {
   "type": "object",
   "description": "Present when more results exist: next (a ready-made URL for the next page) or next_page_token."
  },
  "search_results": {
   "type": "array",
   "items": {
    "type": "object"
   },
   "description": "Places: name, place type, rating, review count, location, place_id."
  },
  "search_metadata": {
   "type": "object",
   "properties": {
    "id": {
     "type": "string"
    },
    "status": {
     "type": "string"
    },
    "total_time_taken": {
     "type": "number"
    }
   }
  },
  "search_parameters": {
   "type": "object",
   "description": "The request parameters as normalized by the API."
  }
 },
 "description": "Successful responses carry request metadata, the normalized parameters, and the result groups available for the operation. Optional groups are omitted when the source does not provide them. Errors are a JSON body with error, error_code, status_code, request_id, retryable, and the echoed search_parameters."
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-litescrape-com-search-tripadvisor-a402373a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.litescrape.com](https://www.zero.xyz/host/agents.litescrape.com/llms.txt)