# Hotel Photo Library by Property Token

> Hotel Photo Library by Property Token is a paid API for AI agents from hotels.use.x402atlas.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-14).

Returns a hotel's full photo library grouped into themed sections, with full-size URLs, thumbnails, dimensions, and pagination support.

## Facts

- Endpoint: GET https://hotels.use.x402atlas.com/photos
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hotel-photo-library-by-property-token-23729dde
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Z-IR7MT99EzSo97FSTkVn

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 hotel-photo-library-by-property-token-23729dde
```

Example prompt: Can you pull up all the photos for the Marriott Times Square — I have its property token ChIJ0X31pIlZwokRUAqhJbNmFVo — grouped by theme so I can see rooms, pool, and exterior separately?

## When to prefer this

Use this endpoint when you need visual media (photos, thumbnails, dimensions) for a specific hotel identified by a property token. It is purpose-built for retrieving structured photo galleries with themed sections and pagination — prefer it over general hotel detail or search endpoints when image content is the primary need.

## Known failure modes

- Missing or invalid property_token returns an error or empty result
- property_token from an expired or unrelated search may return no photos
- Sections with zero photos may be omitted from the response
- next_page_token expiry causes pagination to fail if used after too long
- Rate limits or upstream hotel data provider outages may return partial or empty results

## How this service works

Hotel photos — a hotel's photo library by property token, grouped into themed sections with full-size URLs, thumbnails, dimensions & paging.

## Output

Returns an array of themed photo sections (e.g. Rooms, Pool, Exterior, Dining), each containing: section title, total photo count, an array of photo objects with full-size URL, thumbnail URL, width, height, source, and posting date, plus a next_page_token for paging within that section. Also includes the property_token and queried_at timestamp.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "property_token"
     ],
     "properties": {
      "property_token": {
       "type": "string",
       "minLength": 1,
       "description": "Property token from a /hotels/search result"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "queried_at",
      "property_token",
      "sections"
     ],
     "properties": {
      "sections": {
       "type": "array",
       "items": {
        "type": "object",
        "properties": {
         "title": {
          "type": "string",
          "description": "Theme of the section"
         },
         "total": {
          "type": "integer",
          "description": "Photos available in this section"
         },
         "photos": {
          "type": "array",
          "items": {
           "type": "object",
           "properties": {
            "width": {
             "type": "integer"
            },
            "height": {
             "type": "integer"
            },
            "source": {
             "type": "string"
            },
            "photo_url": {
             "type": "string"
            },
            "posted_on": {
             "type": "string"
            },
            "source_url": {
             "type": "string"
            },
            "thumbnail_url": {
             "type": "string"
            }
           }
          }
         },
         "next_page_token": {
          "type": "string",
          "description": "Pass back as next_page_token to page this section"
         }
        }
       }
      },
      "queried_at": {
       "type": "string",
       "format": "date-time",
       "description": "Time the lookup ran (UTC)"
      },
      "property_token": {
       "type": "string"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "sections": [
   {
    "title": "At a glance",
    "total": 201,
    "photos": [
     {
      "width": 5059,
      "height": 3808,
      "source": "Owner Submitted",
      "photo_url": "https://lh3.googleusercontent.com/gps-cs-s/AHRPTWlmfVGuxcjg0adrdBKKM7-nVLzU-WTpVO3W_5piuLWb5QnRaDzSEGz0epxpA6li2WTSuKL3qJteiEZRP8rXMOIJA5m30YWVcvETuiPzlz1yCw9GC4ygfY3c8G74_28mXNu3l6j0-w_fiiU=s5059",
      "posted_on": "2025-08-19",
      "source_url": "https://maps.google.com/maps/contrib/117464852068129788026",
      "thumbnail_url": "https://lh3.googleusercontent.com/gps-cs-s/AHRPTWlmfVGuxcjg0adrdBKKM7-nVLzU-WTpVO3W_5piuLWb5QnRaDzSEGz0epxpA6li2WTSuKL3qJteiEZRP8rXMOIJA5m30YWVcvETuiPzlz1yCw9GC4ygfY3c8G74_28mXNu3l6j0-w_fiiU=w253-h190-k-no"
     }
    ]
   }
  ],
  "queried_at": "2026-07-25T12:00:00Z",
  "property_token": "ChkI0Nqb_63cnPoTGg0vZy8xMWJ4ZjNoMXloEAE"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hotel-photo-library-by-property-token-23729dde/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from hotels.use.x402atlas.com](https://www.zero.xyz/host/hotels.use.x402atlas.com/llms.txt)