Skip to content
RocketyardRocketyard

Hotel Details Scraper - Address, Stars & Amenities

Rocketyard’s Hotel Details Scraper extracts hotel data from any website that publishes schema.org Hotel markup and returns one clean record per hotel: name, description, website, image, telephone, email and more. It runs on the Apify platform, so you can start it from the Apify Console, the REST API, an AI agent or a no-code tool.

Run it on Apify$1.35 per 1,000 results, no subscription. You run it with your own Apify account, and Apify handles billing.

Who it’s for

Section titled “Who it’s for”
  • Travel startups and meta-search builders needing hotel master data
  • Hospitality consultants and revenue managers benchmarking competitor hotels
  • Lead-gen agencies selling to hotels and resorts

What you can do with it

Section titled “What you can do with it”
  • Collect name, address, coordinates, star rating, rooms and amenities of hotel pages from any chain site
  • Monitor new openings and changes of competing hotels
  • Feed lodging data into a map, CRM or AI pipeline

How it works

Section titled “How it works”

Websites publish schema.org Hotel markup (JSON-LD or microdata) so search engines can show rich results. The Actor fetches each page over plain HTTP without a browser, honours robots.txt and crawl-delay, reads that markup and maps it to the fields below. Because it reads the markup rather than the page layout, one Actor works across many sites and keeps working through redesigns. Give it a list of URLs, or a start page and let it crawl links on the same site.

Example output

Section titled “Example output”

A real record from a test run on langhamhotels.com on 2026-11-11. Fields the page didn’t publish are left out here; the Actor returns them as null. The same test also read mandarinoriental.com.

{
  "url": "https://www.langhamhotels.com/en/the-langham/london/",
  "type": "Hotel",
  "name": "The Langham, London",
  "description": "The Langham, London is Europe's first grand hotel, opened in 1865. Located in the heart of the West End, it offers 380 rooms and suites, six dining venues including Palm Court and Artesian, the award-winning Chuan Spa, and 23 event venues spanning 2,509 square metres. Holder of Two Michelin Keys…",
  "website": "https://www.langhamhotels.com/en/the-langham/london/",
  "image": [
    "https://www.langhamhotels.com/content/dam/langhamhotels/europe-middle-east/london/tllon-exterior-building-hero.jpg"
  ],
  "telephone": "+44 (0) 20 7636 1000",
  "email": "tllon.info@langhamhotels.com",
  "street": "1c Portland Place, Regent Street",
  "city": "London",
  "region": "England",
  "postalCode": "W1B 1JA",
  "country": "GB",
  "latitude": 51.5186,
  "longitude": -0.1441,
  "starRating": "5",
  "priceRange": "$$$$",
  "checkinTime": "15:00",
  "checkoutTime": "12:00",
  "numberOfRooms": 380,
  "amenities": [
    "Swimming Pool",
    "Spa",
    "Fitness Centre",
    "Restaurant",
    "Bar",
    "Afternoon Tea",
    "Event Venues",
    "Concierge",
    "Room Service",
    "Valet Parking",
    "Private Transfers"
  ],
  "scrapedAt": "2026-11-11T17:58:29.294Z"
}

Fields

Section titled “Fields”
Field Read from (schema.org) Filled in latest test
name name 100%
description description 100%
website url 100%
image image.url, image 100%
telephone telephone 100%
email email 100%
street address.streetAddress 100%
city address.addressLocality 100%
region address.addressRegion 100%
postalCode address.postalCode 100%
country address.addressCountry 100%
latitude geo.latitude 100%
longitude geo.longitude 100%
starRating starRating.ratingValue 50%
priceRange priceRange 50%
checkinTime checkinTime, checkInTime 100%
checkoutTime checkoutTime, checkOutTime 100%
numberOfRooms numberOfRooms.value, numberOfRooms 50%
amenities amenityFeature.name 50%
ratingValue aggregateRating.ratingValue 0%
reviewCount aggregateRating.reviewCount, aggregateRating.ratingCount 0%
url the page the record came from 100%
scrapedAt ISO timestamp of the extraction 100%

A field is filled when the source publishes it. The Actor never guesses a value: a missing field comes back as null. “Filled in latest test” is the share of records from the latest test run (langhamhotels.com and mandarinoriental.com) that had the field; other sources publish more or less.

Pricing

Section titled “Pricing”

You pay $1.35 per 1,000 results, plus a start fee of $0.00005 per run. Pages without Hotel markup produce a free error item instead of a record.

Results Cost
1,000 $1.35
10,000 $13.50
100,000 $135.00

Set maxItems or the run’s Maximum cost per run in Apify to cap spending.

API

Section titled “API”

Call it from any language with the Apify REST API, or with Apify’s JavaScript and Python clients. You need an Apify API token.

Terminal window
curl -s -X POST "https://api.apify.com/v2/acts/rocketyard~hotel-schema-scraper/run-sync-get-dataset-items" \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H 'content-type: application/json' \
  -d '{"startUrls":[{"url":"https://www.langhamhotels.com/en/the-langham/london/"}],"maxItems":100}'
import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('rocketyard/hotel-schema-scraper').call({"startUrls":[{"url":"https://www.langhamhotels.com/en/the-langham/london/"}],"maxItems":100});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
from apify_client import ApifyClient
client = ApifyClient("<APIFY_TOKEN>")
run = client.actor("rocketyard/hotel-schema-scraper").call(run_input={"startUrls":[{"url":"https://www.langhamhotels.com/en/the-langham/london/"}],"maxItems":100})
items = client.dataset(run["defaultDatasetId"]).list_items().items

The synchronous endpoint returns the records directly. For long crawls, start the run asynchronously and read the dataset when it finishes.

MCP

Section titled “MCP”

Apify’s MCP server exposes this Actor as a tool to Claude, Cursor and other MCP clients. Open this Actor’s MCP setup page for setup steps per client, or connect it with this URL:

https://mcp.apify.com?tools=rocketyard/hotel-schema-scraper

Claude Code:

Terminal window
claude mcp add --transport http apify "https://mcp.apify.com?tools=rocketyard/hotel-schema-scraper"

Cursor (.cursor/mcp.json) and other clients that read an mcpServers config:

{
  "mcpServers": {
    "apify": { "url": "https://mcp.apify.com?tools=rocketyard/hotel-schema-scraper" }
  }
}

On first use your browser opens so you can sign in to Apify. Then ask the agent, for example: “Collect name, address, coordinates, star rating, rooms and amenities of hotel pages from any chain site”. The tool returns JSON records, and the runs are billed to that Apify account at $1.35 per 1,000 results.

Automation

Section titled “Automation”

n8n, Make and Zapier all connect to Apify. Each example below uses Actor rocketyard/hotel-schema-scraper with this input:

{
  "startUrls": [
    {
      "url": "https://www.langhamhotels.com/en/the-langham/london/"
    }
  ],
  "maxItems": 100
}

n8n

Section titled “n8n”

Copy this workflow and paste it onto an n8n canvas. It runs the Actor every morning through an HTTP Request node and returns the records as n8n items.

{
  "name": "Hotel Details Scraper daily",
  "nodes": [
    {
      "parameters": {
        "rule": {
          "interval": [
            {
              "field": "days",
              "daysInterval": 1,
              "triggerAtHour": 7
            }
          ]
        }
      },
      "id": "c1f6a2d0-4a57-4b5e-9d7a-0a1b2c3d4e01",
      "name": "Every day at 07:00",
      "type": "n8n-nodes-base.scheduleTrigger",
      "typeVersion": 1.2,
      "position": [
        0,
        0
      ]
    },
    {
      "parameters": {
        "method": "POST",
        "url": "https://api.apify.com/v2/acts/rocketyard~hotel-schema-scraper/run-sync-get-dataset-items",
        "authentication": "genericCredentialType",
        "genericAuthType": "httpBearerAuth",
        "sendBody": true,
        "specifyBody": "json",
        "jsonBody": "{\n  \"startUrls\": [\n    {\n      \"url\": \"https://www.langhamhotels.com/en/the-langham/london/\"\n    }\n  ],\n  \"maxItems\": 100\n}",
        "options": {
          "timeout": 300000
        }
      },
      "id": "c1f6a2d0-4a57-4b5e-9d7a-0a1b2c3d4e02",
      "name": "Run Hotel Details Scraper",
      "type": "n8n-nodes-base.httpRequest",
      "typeVersion": 4.2,
      "position": [
        260,
        0
      ],
      "credentials": {
        "httpBearerAuth": {
          "name": "Apify API token"
        }
      }
    }
  ],
  "connections": {
    "Every day at 07:00": {
      "main": [
        [
          {
            "node": "Run Hotel Details Scraper",
            "type": "main",
            "index": 0
          }
        ]
      ]
    }
  },
  "settings": {}
}

Then open the HTTP Request node and create an HTTP Bearer Auth credential named Apify API token, with your token from Apify Console as the bearer token. The token stays in n8n’s credential store; the workflow only names the credential. Change the input in the node’s JSON body to your own.

The node waits up to 300 seconds, which is also the limit of Apify’s synchronous endpoint. An input that yields nothing comes back as an item with an error field, which you can drop with a Filter node. Apify also publishes a community node, @apify/n8n-nodes-apify, with a Run an Actor and get dataset operation.

Make

Section titled “Make”
  1. Add Apify’s Run an Actor module and connect your Apify account.
  2. Choose rocketyard/hotel-schema-scraper, paste the input above and set Run synchronously to Yes. Make limits how long a synchronous run can take, depending on your plan. For longer runs, start the scenario from Watch Actor Runs instead.
  3. Add Get Dataset Items with the run’s default dataset ID.
  4. Send the items wherever you need them, for example with Google Sheets Add a Row, mapping name, description, website and image.

Zapier

Section titled “Zapier”
  1. Add Apify’s Run Actor action, connect your Apify account, choose rocketyard/hotel-schema-scraper and paste the input above.
  2. Zapier stops synchronous runs after 30 seconds. For anything larger than a small run, let the run continue in the background and start a second Zap from the Finished Actor run trigger.
  3. Add Fetch dataset items with the run’s dataset ID, then map name, description, website and image into your app.
  4. Test with a small input and check that the Zap handles every record before you turn it on.

Limits

Section titled “Limits”
  • Pages without schema.org Hotel markup return no record.
  • Markup added only by JavaScript in the browser is not read: the Actor reads the HTML the server sends.
  • Pages behind a login or paywall are not accessed, and paths that robots.txt disallows are skipped.

FAQ

Section titled “FAQ”

How much does it cost?

Section titled “How much does it cost?”

$1.35 per 1,000 results plus $0.00005 per run, billed by Apify. 10,000 results cost $13.50. There is no subscription, and you can cap any run with Maximum cost per run.

Your Apify plan sets your discount tier (Platinum and Diamond are enterprise tiers):

Tier Per 1,000 results
Free $1.35
Bronze $1.35
Silver $1.08
Gold $0.88
Platinum $0.88
Diamond $0.88

How do I call it from the API?

Section titled “How do I call it from the API?”

One request starts a run and returns its results, using your Apify API token:

Terminal window
curl -X POST "https://api.apify.com/v2/acts/rocketyard~hotel-schema-scraper/run-sync-get-dataset-items" -H "Authorization: Bearer $APIFY_TOKEN" -H "Content-Type: application/json" -d '{"startUrls":[{"url":"https://www.langhamhotels.com/en/the-langham/london/"}],"maxItems":100}'

What happens when a URL fails?

Section titled “What happens when a URL fails?”

The dataset gets one free error item for it, with a code and the reason, and the other inputs in the run carry on. Error codes explains each code, whether a retry helps and what to do.

Which websites does it work on?

Section titled “Which websites does it work on?”

Any public page that publishes schema.org Hotel data in its HTML. Most modern sites add it for Google rich results.

What happens when a field is missing?

Section titled “What happens when a field is missing?”

The field comes back as null. The Actor reports what the source publishes and never fills in guesses.

Is it allowed to scrape this data?

Section titled “Is it allowed to scrape this data?”

The Actor reads public pages only, obeys robots.txt and crawl-delay, doesn’t log in or bypass protections, and doesn’t collect people’s profiles, personal emails or personal phone numbers. You are responsible for how you use the data under each site’s terms and the law (for example copyright and GDPR).

Can I use it from an AI agent?

Section titled “Can I use it from an AI agent?”

Yes. Connect Apify’s MCP server as shown in MCP, and the agent can call the Actor as a tool.

Alternatives

Section titled “Alternatives”

See how it compares with other hotel scrapers on price, users and run success, from Apify Store data. Need a field or site behaviour that isn’t covered? Open an issue on the Actor page.