---
name: tripadvisor.x402.paysponge.com
description: This host provides two Tripadvisor data endpoints: one for retrieving structured location metadata (name, coordinates, address, category, awards) and one for retrieving photo assets (URLs in multiple sizes, captions, publication dates) for a given location. Both endpoints require a known Tripadvisor location ID as input.
host: tripadvisor.x402.paysponge.com
---

# tripadvisor.x402.paysponge.com

tripadvisor.x402.paysponge.com exposes read-only access to Tripadvisor location data for agents that already hold a location ID. It serves use cases such as displaying location profiles, embedding photos, or enriching travel-related content with authoritative Tripadvisor metadata. It does not provide search, reviews, ratings, or booking functionality.

## When to use this host

Use this host when an agent holds a known Tripadvisor location ID and needs either structured location metadata or photo assets for that location. It is appropriate for display, enrichment, or navigation tasks tied to a specific location. Do not use this host for location search by name or keyword — a search endpoint outside this host is required to obtain location IDs first. Do not use it for reviews, ratings, or pricing data, as those capabilities are not available here. This host is also not suited for bulk operations across many locations in a single call.

## Capabilities

### Location Metadata

Retrieves structured descriptive data for a known Tripadvisor location, including its name, address, geographic coordinates, category, subcategory, web URL, and awards.

- **`fetch-tripadvisor-location-details`** — Returns detailed metadata for a TripAdvisor location by ID, including name, web URL, coordinates, category, subcategory, address, and awards.

### Location Photos

Retrieves photo assets associated with a Tripadvisor location, including image URLs in five sizes, captions, album classification, and publication dates.

- **`fetch-tripadvisor-location-photos`** — Returns photo metadata for a Tripadvisor location, including photo IDs, captions, publication dates, album, source, and image URLs in five sizes (thumbnail, small, medium, large, original).

## Workflows

### Build Location Profile Card

*Use when an agent needs to construct a complete visual profile for a Tripadvisor location, combining descriptive metadata with representative images.*

1. **`fetch-tripadvisor-location-details`** — Retrieve the location's name, address, coordinates, category, and TripAdvisor URL to populate the text fields of the profile card.
2. **`fetch-tripadvisor-location-photos`** — Retrieve photo URLs and captions to populate the image section of the profile card using the appropriate size variant.

## Skill reference

### `fetch-tripadvisor-location-photos`

**Tripadvisor Location Photos** — Returns photo metadata for a Tripadvisor location, including photo IDs, captions, publication dates, album, source, and image URLs in five sizes (thumbnail, small, medium, large, original).

*Use when:* Use when an agent needs to retrieve photos associated with a specific Tripadvisor location, such as to display images, extract image URLs, or inspect photo captions and publication dates for a hotel, restaurant, or attraction.

*Not for:* Do not use for searching locations by name or retrieving general location details; use a location search or location details endpoint instead. Not suitable for bulk photo ingestion across many locations in a single call.

**Inputs:**

- `locationId` (string, required) — Tripadvisor location ID used as a path parameter to identify the location whose photos are requested.

**Returns:** Returns a data array of photo objects, each with an integer ID, caption, ISO 8601 published_date, album, source name, and an images object with URLs and dimensions for thumbnail, small, medium, large, and original sizes.

**Example:** `GET https://tripadvisor.x402.paysponge.com/api/v1/location/187147/photos`

---

### `fetch-tripadvisor-location-details`

**Tripadvisor Location Details** — Returns detailed metadata for a TripAdvisor location by ID, including name, web URL, coordinates, category, subcategory, address, and awards.

*Use when:* Use when an agent needs structured metadata for a known TripAdvisor location ID, such as retrieving its name, geographic coordinates, category classification, or direct TripAdvisor URL for further navigation or display.

*Not for:* Do not use for searching locations by name or keyword; this endpoint requires a known TripAdvisor location ID. Not suitable for retrieving reviews or ratings — use a reviews endpoint instead.

**Inputs:**

- `locationId` (string, required) — TripAdvisor location ID used as a path parameter to identify the location whose details are requested.

**Returns:** Returns a JSON object with location_id, name, web_url, address_obj, ancestors, latitude, longitude, see_all_photos URL, category, subcategory, neighborhood_info, and awards for the requested location.

**Example:** `GET https://tripadvisor.x402.paysponge.com/api/v1/location/60745/details`

---
