crawlbaseDocs
Anmelden

API-Nutzung

Fügen Sie &scraper=booking-serp zu einem Crawling API-Request hinzu. URL-kodieren Sie die Ziel-URL im url-Parameter.

curl 'https://api.crawlbase.com/?token=YOUR_TOKEN' \
  --data-urlencode 'url=https://www.booking.com/searchresults.html?ss=Amsterdam' \
  --data-urlencode 'scraper=booking-serp' -G
from crawlbase import CrawlingAPI

api = CrawlingAPI({'token': 'YOUR_TOKEN'})
res = api.get(
    'https://www.booking.com/searchresults.html?ss=Amsterdam',
    {'scraper': 'booking-serp'}
)

import json
data = json.loads(res['body'])
const { CrawlingAPI } = require('crawlbase');
const api = new CrawlingAPI({ token: 'YOUR_TOKEN' });

const res = await api.get(
  'https://www.booking.com/searchresults.html?ss=Amsterdam',
  { scraper: 'booking-serp' }
);
const data = JSON.parse(res.body);
require 'crawlbase'
api = Crawlbase::API.new(token: 'YOUR_TOKEN')

res = api.get('https://www.booking.com/searchresults.html?ss=Amsterdam', scraper: 'booking-serp')
data = JSON.parse(res.body)

Beispiel-Eingabe-URL

Die im url-Parameter übergebene URL (zur besseren Lesbarkeit URL-dekodiert):

https://www.booking.com/searchresults.html?ss=Amsterdam

Response-Struktur

JSON-Response-Body. Feldtypen können null sein, wenn die Quellseite den Wert nicht enthält.

searchUrl
string
Kanonische Suchergebnis-URL.
destination
string
Reiseziel, für das die Suche ausgeführt wurde.
propertyCount
integer
Anzahl der in properties zurückgegebenen Unterkünfte.
properties
array
Zur Suche passende Unterkünfte, in der von Booking.com zurückgegebenen Reihenfolge.
properties[].name
string
Name der Unterkunft.
properties[].url
string
Kanonische Booking.com-URL der Unterkunft.
properties[].address
string
Adresse der Unterkunft.
properties[].distance
string | null
Entfernung vom Zentrum des Reiseziels, sofern vorhanden.
properties[].price
string
Formatierter Preistext, wie im Listing angezeigt.
properties[].priceAmount
number | null
Numerischer Preiswert oder null, wenn er nicht geparst werden kann.
properties[].currency
string | null
Währungscode des Preises, sofern vorhanden.
properties[].reviewScore
number | null
Durchschnittlicher Review-Score oder null, wenn keine Bewertungen vorliegen.
properties[].reviewCount
integer | null
Anzahl der Bewertungen oder null, wenn keine Bewertungen vorliegen.
properties[].rating
integer | null
Sterne-Rating der Unterkunft oder null, wenn nicht bewertet.
properties[].image
string | null
URL des Vorschaubilds, sofern vorhanden.

Beispiel-Response

{
  "searchUrl": "https://www.booking.com/searchresults.html?ss=Amsterdam",
  "destination": "Amsterdam",
  "propertyCount": 2,
  "properties": [
    {
      "name": "Canal House Amsterdam",
      "url": "https://www.booking.com/hotel/nl/canal-house-amsterdam.html",
      "address": "Keizersgracht 148, Amsterdam City Center, 1015 CX Amsterdam",
      "distance": "0.8 km from centre",
      "price": "€ 245",
      "priceAmount": 245,
      "currency": "EUR",
      "reviewScore": 9.1,
      "reviewCount": 1284,
      "rating": 4,
      "image": "https://cf.bstatic.com/xdata/images/hotel/canal-house.jpg"
    },
    {
      "name": "Jordaan Boutique Stay",
      "url": "https://www.booking.com/hotel/nl/jordaan-boutique-stay.html",
      "address": "Prinsengracht 302, Jordaan, 1016 HX Amsterdam",
      "distance": "1.2 km from centre",
      "price": "€ 189",
      "priceAmount": 189,
      "currency": "EUR",
      "reviewScore": 8.7,
      "reviewCount": 642,
      "rating": 3,
      "image": null
    }
  ]
}