# GetYourGuide Activity Scraper

> GetYourGuide Activity Scraper is a paid API for AI agents from api.scrapeforagents.tech, paid per call via x402, $0.25/call, status unknown (last checked 2026-10-02).

Scrapes structured activity listings, prices, ratings, and reviews from GetYourGuide destination and search pages

## Facts

- Endpoint: POST https://api.scrapeforagents.tech/v1/getyourguide?utm_source=zero.xyz
- Price: $0.25/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/getyourguide-activity-scraper-2d4f17dd
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_59j6WO9miByJk6e3xlAHI

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 getyourguide-activity-scraper-2d4f17dd -d '<json body>'
```

Example prompt: Search GetYourGuide for activities in Barcelona, return up to 50 results in English priced between $20 and $100, with a minimum rating of 4.0 and at least 10 reviews, including any available reviews for each activity.

## When to prefer this

Use this endpoint when you need structured, filterable activity data from GetYourGuide at scale — including prices, ratings, reviews, and supplier details — without building your own scraper. Prefer this over manual browsing or generic web scrapers when you need clean JSON output with built-in filtering by price, rating, and review count across multiple destinations or search queries.

## Known failure modes

- Empty result set if URLs are invalid or destination has no listings — not charged
- Network timeout if GetYourGuide is slow or rate-limiting
- Filter combination too restrictive returns zero results
- Unsupported language code falls back or errors
- Malformed startUrls or activityUrls cause classification failure
- GetYourGuide page structure changes may break extraction

## How this service works

Pay-per-call structured web data. Failed or empty runs are not charged.

## Output

Returns a JSON object with a count of matched items and an array of activity records, each containing the activity URL, title, ID, price, original price, description, source, and type. Optionally includes embedded review records and supplier summaries per activity.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "currency": {
   "type": "string",
   "default": "USD",
   "description": "Three-letter currency code requested from the site; priceCurrency records the currency actually returned."
  },
  "language": {
   "type": "string",
   "default": "en",
   "description": "Language code for localized pages. Supported: en, de, es, fr, it, pt, nl, ja, ko, tr."
  },
  "maxPrice": {
   "type": "number",
   "default": 0,
   "minimum": 0,
   "description": "Keep activities priced at or below this amount in the returned currency; zero disables the filter."
  },
  "minPrice": {
   "type": "number",
   "default": 0,
   "minimum": 0,
   "description": "Keep activities priced at or above this amount in the returned currency; zero disables the filter."
  },
  "minRating": {
   "type": "number",
   "default": 0,
   "maximum": 5,
   "minimum": 0,
   "description": "Keep activities at or above this rating; zero disables the filter."
  },
  "startUrls": {
   "type": "array",
   "description": "Search, destination, or activity URLs; each URL is classified automatically."
  },
  "maxResults": {
   "type": "integer",
   "default": 100,
   "minimum": 1,
   "description": "Maximum unique activity records across all sources. Optional review and supplier records are extra."
  },
  "minReviews": {
   "type": "integer",
   "default": 0,
   "minimum": 0,
   "description": "Keep activities with at least this many reviews; zero disables the filter."
  },
  "activityUrls": {
   "type": "array",
   "description": "Direct public activity URLs ending in a tour ID."
  },
  "locationUrls": {
   "type": "array",
   "description": "Destination listing URLs such as https://www.getyourguide.com/rome-l33/."
  },
  "searchQueries": {
   "type": "array",
   "description": "Cities, attractions, or themes to search across result pages."
  },
  "includeReviews": {
   "type": "boolean",
   "default": false,
   "description": "Emit public reviews embedded on activity pages as separate records."
  },
  "maxResultsPerSearch": {
   "type": "integer",
   "default": 60,
   "minimum": 1,
   "description": "Maximum unique activities collected from each search or destination."
  },
  "deduplicateSuppliers": {
   "type": "boolean",
   "default": false,
   "description": "Emit one summary for each activity provider found in the run."
  },
  "freeCancellationOnly": {
   "type": "boolean",
   "default": false,
   "description": "Keep only activities whose detail page explicitly shows 
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "items": [
   {
    "url": null,
    "type": null,
    "title": null,
    "source": null,
    "priceFrom": null,
    "activityId": null,
    "description": null,
    "originalPrice": null
   }
  ],
  "product": "getyourguide"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/getyourguide-activity-scraper-2d4f17dd/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.scrapeforagents.tech](https://www.zero.xyz/host/api.scrapeforagents.tech/llms.txt)