# Viator Product Detail API Documentation

Retrieve one Viator tour or activity by product code: title, destination, rating, review count, price (USD), duration in minutes, free cancellation, supplier, languages, overview and highlights as plain text, inclusions, exclusions, additional info, cancellation policy, itinerary with stops and coordinates, departure locations and images. An unknown product code is a not billable 404. Prices are in USD.

- **Documentation:** [https://scrappa.co/docs/viator-api/viator_product](https://scrappa.co/docs/viator-api/viator_product)
- **API group:** Viator API
- **Endpoint:** `GET https://scrappa.co/api/viator/product`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `product_code` | string | Yes | Viator product code, 2 to 20 letters and digits. Take it from the search response. Example: 70273P7. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/viator/product?product_code=70273P7"
```

## Example response

```json
{
    "success": true,
    "data": {
        "product": {
            "product_code": "70273P7",
            "title": "Small Group Tour to Sintra, Pena Palace, Cabo Roca and Cascais",
            "url": "https://www.viator.com/tours/Lisbon/Tour-to-Sintra-Pena-Palace-Cabo-da-Roca-Regaleira-and-Cascais/d538-70273P7",
            "destination": {
                "id": 538,
                "name": "Lisbon, Portugal"
            },
            "rating": 4.9,
            "review_count": 5009,
            "price": {
                "amount": 80.11,
                "currency": "USD"
            },
            "duration_minutes": 480,
            "free_cancellation": true,
            "supplier_name": "Tour Sweet Tours - Animacao Turistica Lda.",
            "languages": [
                "pt",
                "en",
                "it",
                "fr",
                "es"
            ],
            "overview": "Explore beyond Lisbon city limits and see several of Portugal\u2019s top attractions in one day on this seamless, small-group tour.",
            "highlights": [
                "This personalized, small-group tour is capped at just eight participants"
            ],
            "inclusions": [
                "Air-conditioned vehicle"
            ],
            "exclusions": [
                "Lunch"
            ],
            "additional_info": [
                "Not wheelchair accessible"
            ],
            "cancellation_policy": "You can cancel up to 24 hours in advance of the experience for a full refund.",
            "itinerary": {
                "introduction": "Your day begins with departure from your Lisbon hotel or a nearby meeting point.",
                "stops": [
                    {
                        "name": "Centro Historico de Sintra",
                        "duration_minutes": 60,
                        "latitude": 38.797054,
                        "longitude": -9.390568,
                        "admission": "free"
                    }
                ]
            },
            "departure_locations": [
                {
                    "address": "Av. da Liberdade 2, 1250-144 Lisboa, Portugal",
                    "instructions": "Metro Station Restauradores, green line subway"
                }
            ],
            "images": [
                "https://media.tacdn.com/media/attractions-splice-spp-674x446/r/32/b1/71/7e/caption.jpg"
            ]
        }
    },
    "meta": {
        "endpoint_family": "product",
        "billable": true
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A required query parameter is missing or invalid. No upstream call is made and the response is not billable. |
| 404 | Not Found | No Viator product has this product code. This response is not billable. |
| 503 | Invalid Source Response | The upstream answered with a shape that no longer matches the documented contract. This response is not billable. |
| 503 | Service Unavailable | Viator could not be reached or blocked the request on every attempt. This response is not billable. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)