> **For coding agents and LLMs:** This is one page from the Social Fetch docs (markdown export). For curated orientation and workflow guidance, start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for agent onboarding and crawl rules, use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for the full endpoint list with links to pages like this one, use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt); for one platform's parameters and curls, use [`/llms-{platform}.txt`](https://www.socialfetch.dev/llms-tiktok.txt); use [`/llms.json`](https://www.socialfetch.dev/llms.json) when you need structured JSON for tool registration.

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/docs/api/v1/booking/property/get>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/docs/api/v1/booking/property/get.mdx>

## API base URL and authentication

- **API origin (from OpenAPI `servers`):** `https://api.socialfetch.dev`
- **Authentication:** send `x-api-key: sfk_...` on `/v1/**` and `/v2/**` routes unless the operation is explicitly anonymous (check OpenAPI `security`, the [API reference hub](https://www.socialfetch.dev/docs/api.mdx), [`/llms.txt`](https://www.socialfetch.dev/llms.txt), or [`/llms.json`](https://www.socialfetch.dev/llms.json) for each route).
- **OpenAPI JSON:** <https://www.socialfetch.dev/openapi.json>

## Recommended docs entrypoints (this site)

- [Documentation overview](https://www.socialfetch.dev/docs.mdx) — top-level orientation (markdown).
- [Quickstart](https://www.socialfetch.dev/docs/quickstart.mdx) — authenticate with `x-api-key`, validate auth with `whoami`, and understand the JSON envelope.
- [SDK](https://www.socialfetch.dev/docs/sdk.mdx) — official TypeScript SDK guide, including `SocialFetchClient`, `Result`, and `unwrap()`.
- [Capability matrix](https://www.socialfetch.dev/docs/capability-matrix.mdx) — every operation with identifiers, pagination, outcomes, media download, credits, and its SDK method. Generated from OpenAPI, so use it for route selection instead of scanning individual pages.
- [Recipes](https://www.socialfetch.dev/docs/recipes.mdx) — copyable workflows (brand monitoring, transcripts, Ad Library, creator scoring, Reddit research) with credit callouts and SDK examples.
- [Integrations](https://www.socialfetch.dev/docs/integrations.mdx) — MCP for AI clients, n8n verified node, Apify Store Actors, Make custom app, SDK, and REST API connection paths.
- [MCP product page](https://www.socialfetch.dev/mcp) — hosted MCP overview, OAuth, Skills install.
- [MCP integration](https://www.socialfetch.dev/docs/integrations/mcp.mdx) — hosted `/mcp` server, OAuth, Cursor/VS Code/Claude install snippets, 1112 endpoint tools, plus docs_search/docs_read for implementation help.
- [n8n integration](https://www.socialfetch.dev/docs/integrations/n8n.mdx) — install `n8n-nodes-socialfetch`, credentials, and workflow examples.
- [Apify integration](https://www.socialfetch.dev/docs/integrations/apify.mdx) — Store Actors under @social-fetch, PPE billing, dataset export, and quick start.
- [Make integration](https://www.socialfetch.dev/docs/integrations/make.mdx) — custom app modules for Make scenarios, API key credentials, and module catalog.
- [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt) — every documented operation with a direct link to that route's agent-readable markdown page (prefer this over parsing OpenAPI).
- [`/llms-{platform}.txt`](https://www.socialfetch.dev/llms-tiktok.txt) — per-platform endpoint files generated from OpenAPI (parameters, credits, curls).
- [`/agents.txt`](https://www.socialfetch.dev/agents.txt) — agent crawl/onboarding file with capabilities, auth rules, and allowlist.
- [`/llms.json`](https://www.socialfetch.dev/llms.json) — structured machine-readable operation inventory with parameter names, pagination, outcomes, credits, and SDK mapping.
- [API reference hub](https://www.socialfetch.dev/docs/api.mdx) — human-friendly index of operations with links into generated pages.
- [Errors](https://www.socialfetch.dev/docs/errors.mdx) — shared error envelope and HTTP status guidance.
- [Credits](https://www.socialfetch.dev/docs/credits.mdx) — metering, `402`, and planning batch jobs.
- Outcome semantics such as `found`, `not_found`, and `private` are documented in [Errors](https://www.socialfetch.dev/docs/errors.mdx) and on operation pages when present in the OpenAPI contract.

## Markdown docs convention

- Every docs page has a markdown twin: append **`.mdx`** to the docs pathname (for example `/docs/quickstart` → `/docs/quickstart.mdx`).
- Agents that send `Accept: text/markdown` on `/docs/**` HTML URLs may receive markdown directly (same URL, `Vary: Accept`).
- Published blog posts use the same convention: `/blog/{slug}` → `/blog/{slug}.mdx`, or `Accept: text/markdown` on the HTML URL (`Vary: Accept`).

---
# Get a Booking.com property (https://www.socialfetch.dev/docs/api/v1/booking/property/get)

## Summary

Get a Booking.com property's details: rooms, facilities, meals, photos, house rules, guest questions and review scores.

**Tags:** `Booking.com`

## HTTP

- **Method:** GET
- **Path:** `/v1/booking/property`
- **Base URL:** `https://api.socialfetch.dev`

## Capability summary

- **SDK mapping:** `client.booking.getProperty({ url: "https://www.booking.com/hotel/gb/shangri-la-at-the-shard-london.html" })`
- **Accepted identifiers:** `url` (query)
- **Pagination:** none
- **Business outcome field:** `data.lookupStatus` with values `found`, `not_found`

## Credits

- 1 credit
- Failed requests are free
- A not-found answer is still charged

## Authentication

- **`x-api-key`**: API key (`sfk_...`)

## Parameters

### `url` (query)

- **Required:** yes
- **Constraints:** type `string`; maxLength: 2048; pattern: `^(?:[Hh][Tt][Tt][Pp][Ss]?:\/\/)?(?:[A-Za-z0-9-]+\.)?[Bb][Oo][Oo][Kk][Ii][Nn][…`
- **Description:** Booking.com property page URL, e.g. `https://www.booking.com/hotel/gb/the-savoy.html`: `url` from the property search endpoint. A language suffix and query string are ignored.

### `language` (query)

- **Required:** no
- **Constraints:** type `string`; default: `en-us`
- **Description:** Language of names, labels and descriptions, as the site's own code: `en-us`, `en-gb`, `de`, `fr`, `es`, `it`, `ja`, `zh-cn` and so on. Default `en-us`.

### `currency` (query)

- **Required:** no
- **Constraints:** type `string`; default: `USD`
- **Description:** Currency of the prices the page shows (meals, extra beds), as a three-letter code such as `USD`, `EUR`, `GBP` or `JPY`. Default `USD`.

## Responses (status codes)

- **200**: Booking.com property details.
- **400**: Invalid request
- **401**: Missing or invalid API key
- **402**: Insufficient credits
- **500**: Unexpected or billing error
- **502**: Lookup could not be completed.
- **503**: Service temporarily unavailable; safe to retry with backoff.

## Response body (200)

Booking.com property details.

### Field outline

- **data** (required) — type `object`. Endpoint-specific response payload.
  - **lookupStatus** (required) — type `string`; enum: found, not_found. `not_found` when the site has no property at this URL.
  - **property** (required) — type `object`; nullable. The property; null when not found.
    - **id** (required) — type `integer`. Property id. Pass it as `propertyId` to the property reviews endpoint.
    - **name** (required) — type `string`. Property name.
    - **url** (required) — type `string`. Property page URL.
    - **pageName** (required) — type `string`. The property's page name in its URL, e.g. `the-savoy`.
    - **accommodationType** (required) — type `string`; nullable. Kind of property: `hotel`, `apartment`, `hostel`, `guest_house` and so on; null when unknown.
    - **accommodationTypeId** (required) — type `integer`; nullable. The site's id for the kind of property.
    - **stars** (required) — type `number`; nullable. Star or quality rating, 1 to 5; null when none.
    - **starsType** (required) — type `string`; enum: stars, squares, other, null; nullable. `stars` for an official or property-provided star rating, `squares` for the site's own quality rating of homes.
    - **description** (required) — type `string`; nullable. The property's description in `language`, as the page shows it: the site translates it where the property wrote none in that language.
    - **finePrint** (required) — type `string`; nullable. Must-know information the property adds for guests.
    - **address** (required) — type `string`; nullable. Street address.
    - **city** (required) — type `string`; nullable. City.
    - **postalCode** (required) — type `string`; nullable. Postal code.
    - **region** (required) — type `string`; nullable. Region or state.
    - **countryCode** (required) — type `string`. Two-letter country code, lower case.
    - **latitude** (required) — type `number`; nullable. Latitude.
    - **longitude** (required) — type `number`; nullable. Longitude.
    - **reviewScore** (required) — type `number`; nullable. Guest review score, 1 to 10; null when not shown.
    - **reviewCount** (required) — type `integer`; nullable. Guest reviews counted in the score.
    - **scores** (required) — type `array`. Guests' average score per category.
      - _items:_
    - **currency** (required) — type `string`; nullable. The property's own currency, e.g. `GBP`.
    - **brand** (required) — type `object`; nullable. The hotel brand or chain, when the property belongs to one.
      - **id** (required) — type `integer`. The site's brand id.
      - **name** (required) — type `string`. Brand name, e.g. `Shangri-La Group`.
      - **logo** (required) — type `string`; nullable. Logo URL. Link only; not hosted by Social Fetch.
    - **languagesSpoken** (required) — type `array`. Languages the staff speak, as codes such as `en` or `fr`.
      - _items:_
        - type `string`
    - **popularFacilities** (required) — type `array`. The facilities the site lists as most popular, e.g. `Free WiFi`.
      - _items:_
        - type `string`
    - **highlights** (required) — type `array`. Highlights by category, as the page groups them.
      - _items:_
    - **meals** (required) — type `array`. Meals offered; one the property does not offer is left out.
      - _items:_
    - **rooms** (required) — type `array`. Rooms and units, without prices (those depend on dates).
      - _items:_
    - **photos** (required) — type `array`. The gallery, main photo first.
      - _items:_
    - **photoCount** (required) — type `integer`. Photos in the gallery; more than `photos` holds when the gallery is longer than the list.
    - **policies** (required) — type `object`. House rules and policies.
      - **checkIn** (required) — type `object`; nullable. Check-in window.
      - **checkOut** (required) — type `object`; nullable. Check-out window.
      - **minCheckInAge** (required) — type `integer`; nullable. Youngest age a guest can check in at.
      - **pets** (required) — type `string`; nullable. Whether pets are allowed, lower case: `yes`, `no`, `upon_request`.
      - **petCharges** (required) — type `string`; nullable. Lower case, e.g. `free` or `charges_may_apply`.
      - **childrenAllowed** (required) — type `boolean`; nullable. Whether children may stay.
      - **minChildAge** (required) — type `integer`; nullable. Youngest child age allowed.
      - **cribsAllowed** (required) — type `boolean`; nullable. Whether cribs are offered.
      - **extraBedsAllowed** (required) — type `boolean`; nullable. Whether extra beds are offered.
      - **childRules** (required) — type `array`. Bed charges for children, by age band.
        - _items:_
      - **groupLimit** (required) — type `integer`; nullable. Rooms above which a booking counts as a group, with other terms.
      - **quietHours** (required) — type `object`; nullable. Quiet hours, when the property sets them.
      - **curfew** (required) — type `object`; nullable. Curfew, when the property sets one.
      - **partiesAllowed** (required) — type `boolean`; nullable. False when the property says parties are not allowed.
      - **smokingAllowed** (required) — type `boolean`; nullable. False when the property says smoking is not allowed.
      - **acceptedCards** (required) — type `array`. Cards the property accepts, e.g. `Visa`.
        - _items:_
          - type `string`
      - **acceptsCash** (required) — type `boolean`; nullable. Whether the property accepts cash.
      - **rules** (required) — type `array`. Further house rules as the site words them, e.g. a local regulation or an ID requirement.
        - _items:_
          - type `string`
    - **questions** (required) — type `array`. Guest questions with the property's answers, as the page shows them (up to 20).
      - _items:_
    - **preferredPartner** (required) — type `boolean`; nullable. Whether the site marks it a preferred partner.
    - **travelProud** (required) — type `boolean`; nullable. Whether it carries the site's LGBTQ+ friendly badge.
    - **wheelchairAccessible** (required) — type `boolean`; nullable. Whether the site marks it wheelchair accessible.
    - **sustainable** (required) — type `boolean`; nullable. Whether it has a sustainability certification on the site.
    - **newlyOpened** (required) — type `boolean`; nullable. Whether the site marks it newly opened.
- **meta** (required) — type `object`. Metadata describing the request and billing outcome.
  - **requestId** (required) — type `string`; minLength: 1. Unique request identifier for tracing this API call.
  - **creditsCharged** (required) — type `integer`; minimum: 0. Credits charged for this request.
  - **version** (required) — type `string`; enum: v1. Public API version that served the response.
  - **stale** (optional) — type `boolean`; enum: true. Present, and `true`, only when the source couldn't be reached and this is the last good answer for the same request instead, up to 24 hours old. Absent on every live answer.
  - **fetchedAt** (optional) — type `string`. When a stale answer (`stale: true`) was originally fetched (ISO 8601, UTC). Absent on every live answer.

### Example JSON (found)

```json
{
  "data": {
    "lookupStatus": "found",
    "property": {
      "id": 866147,
      "name": "Shangri-La The Shard, London",
      "url": "https://www.booking.com/hotel/gb/shangri-la-at-the-shard-london.html",
      "pageName": "shangri-la-at-the-shard-london",
      "accommodationType": "hotel",
      "accommodationTypeId": 204,
      "stars": 5,
      "starsType": "stars",
      "description": "Occupying levels 34-52, the Shangri-La Hotel The Shard, London offers 5-star luxury and breathtaking views of the capital and beyond. It features an exquisite …",
      "finePrint": "Advanced bookings for the restaurant and bar are strongly recommended. Availability at TĪNG restaurant and lounge and GŎNG cannot be guaranteed without prior b…",
      "address": "31 St Thomas Street, Southwark, London, SE1 9QU, United Kingdom",
      "city": "London",
      "postalCode": "SE1 9QU",
      "region": "Greater London",
      "countryCode": "gb",
      "latitude": 51.50411155178331,
      "longitude": -0.08686437489814125,
      "reviewScore": 9,
      "reviewCount": 1630,
      "scores": [
        {
          "category": "staff",
          "label": null,
          "score": 9.2,
          "count": 1592
        }
      ],
      "currency": "GBP",
      "brand": {
        "id": 1517,
        "name": "Shangri-La Group",
        "logo": "https://r-xx.bstatic.com/xdata/images/xphoto/max240x120/118610931.jpg?k=9982735db8ffce53552aa7ef7d4b5fd09e7e2638370067e042c36aa2aef38dd2&o="
      },
      "languagesSpoken": [
        "ar"
      ],
      "popularFacilities": [
        "Indoor swimming pool"
      ],
      "highlights": [
        {
          "category": "Excellent free Wifi",
          "items": [
            "Rated 9.0 by guests"
          ]
        }
      ],
      "meals": [
        {
          "type": "breakfast",
          "offer": "both",
          "price": "$55.38",
          "styles": [
            "Buffet"
          ],
          "cuisines": [
            "Continental"
          ],
          "dietary": [],
          "food": [
            "Bread"
          ],
          "drinks": [
            "Coffee"
          ],
          "hours": {
            "from": "07:00",
            "until": "10:30"
          },
          "score": 8.5,
          "scoreCount": 36
        }
      ],
      "rooms": [
        {
          "id": 86614701,
          "name": "Deluxe King Room with City View",
          "description": "This room has unparalleled northerly and easterly views, including some of London’s most famous landmarks. Features include a king Shangri-La Bed, a designer T…",
          "sizeM2": 32,
          "beds": [
            {
              "type": "extra_large_double_bed",
              "count": 1
            }
          ],
          "bedArrangements": 1,
          "maxGuests": 3,
          "maxAdults": 2,
          "maxChildren": 1,
          "bathrooms": null,
          "smoking": false,
          "facilities": [
            "Safety deposit box"
          ],
          "photos": [
            "https://cf.bstatic.com/xdata/images/hotel/max1024x768/295688317.jpg?k=07fa992deb08fe6efb37278699e5583e92f6bb840ccf5348dcf8c65d28280e89&o="
          ]
        }
      ],
      "photos": [
        {
          "id": 295688310,
          "url": "https://cf.bstatic.com/xdata/images/hotel/max1024x768/295688310.jpg?k=bd792d1487eebf49f687f15e26663dd3d1abd1d1e501f2a9a7b9d89330a6670a&o=",
          "caption": "a view of the city of london and the tower bridge at Shangri-La The Shard, London in London",
          "width": 3839,
          "height": 2562
        }
      ],
      "photoCount": 79,
      "policies": {
        "checkIn": {
          "from": "4:00 PM",
          "until": "12:00 AM"
        },
        "checkOut": {
          "from": "12:00 AM",
          "until": "11:00 AM"
        },
        "minCheckInAge": 18,
        "pets": "upon_request",
        "petCharges": "charges_may_apply",
        "childrenAllowed": true,
        "minChildAge": 0,
        "cribsAllowed": true,
        "extraBedsAllowed": true,
        "childRules": [
          {
            "ageFrom": 0,
            "ageTo": 11,
            "bed": "existing_bed",
            "price": "£0",
            "priceType": "free",
            "priceMode": "per_night"
          }
        ],
        "groupLimit": 9,
        "quietHours": null,
        "curfew": null,
        "partiesAllowed": null,
        "smokingAllowed": null,
        "acceptedCards": [
          "American Express"
        ],
        "acceptsCash": true,
        "rules": []
      },
      "questions": [
        {
          "id": 225130,
          "question": "Can we use a swiming pool if we get a room for 1 night",
          "answer": "Good Afternoon,\n\nThank you very much for your email.\n\nAs an in house guest, you will be more than welcome to use all of the Hotel Facilities including the Infi…",
          "askedOn": "July 25, 2019",
          "answeredOn": "November 30, 2019"
        }
      ],
      "preferredPartner": true,
      "travelProud": true,
      "wheelchairAccessible": true,
      "sustainable": false,
      "newlyOpened": false
    }
  },
  "meta": {
    "requestId": "req_01example_v1_booking_property",
    "creditsCharged": 1,
    "version": "v1"
  }
}
```

### Machine-readable error codes

When an error JSON body is returned, it may include one of these `error.code` values (derived from the OpenAPI schemas for this operation; additional codes may exist at runtime):

- `bad_request`

## Error handling & retries

Interpret HTTP status codes using the descriptions below. Do not assume a JSON body unless the OpenAPI schema defines one for that status.

- **400**: Invalid request **Retry:** Fix the request; retrying the same invalid payload will not help.
- **401**: Missing or invalid API key **Retry:** Fix the API key first; retrying without changes will not help.
- **402**: Insufficient credits **Retry:** Do not retry without resolving billing/credits (retrying the same request will not help).
- **500**: Unexpected or billing error
- **502**: Lookup could not be completed. **Retry:** May be transient; a few retries with backoff are reasonable.
- **503**: Service temporarily unavailable; safe to retry with backoff. **Retry:** Usually safe to retry with exponential backoff and jitter.

### Suggested client defaults

- Send the API key using the `x-api-key` header on every request.
- On `503` (and sometimes `502`), retry with backoff; cap retries and surface a clear error to the user.
- On `402`, surface an actionable billing message rather than blind retries.

## Examples

### TypeScript SDK

```typescript
import { SocialFetchClient } from "@socialfetch/sdk";

const client = new SocialFetchClient({
  apiKey: process.env.SOCIALFETCH_API_KEY!,
});

const result = await client.booking.getProperty({
  url: "https://www.booking.com/hotel/gb/shangri-la-at-the-shard-london.html",
});

if (!result.ok) {
  console.error(result.error);
} else {
  console.log(result.value.data);
}
```

### Node.js

```javascript
const response = await fetch(
  "https://api.socialfetch.dev/v1/booking/property?url=https://www.booking.com/hotel/gb/shangri-la-at-the-shard-london.html",
  {
    headers: {
      "x-api-key": "YOUR_API_KEY"
    }
  }
);

const data = await response.json();
console.log(data);
```

### cURL

```bash
curl "https://api.socialfetch.dev/v1/booking/property?url=https://www.booking.com/hotel/gb/shangri-la-at-the-shard-london.html" \
  -H "x-api-key: YOUR_API_KEY"
```

### Python

```python
import requests

response = requests.get(
    "https://api.socialfetch.dev/v1/booking/property?url=https://www.booking.com/hotel/gb/shangri-la-at-the-shard-london.html",
    headers={"x-api-key": "YOUR_API_KEY"},
)
data = response.json()
print(data)
```