# REST Resource: accounts.listings

- [Resource: ParsedListing](https://developers.google.com/hotels/hotel-prices/api-reference/rest/v3/accounts.listings#ParsedListing)
  - [JSON representation](https://developers.google.com/hotels/hotel-prices/api-reference/rest/v3/accounts.listings#ParsedListing.SCHEMA_REPRESENTATION)
- [LatLng](https://developers.google.com/hotels/hotel-prices/api-reference/rest/v3/accounts.listings#LatLng)
  - [JSON representation](https://developers.google.com/hotels/hotel-prices/api-reference/rest/v3/accounts.listings#LatLng.SCHEMA_REPRESENTATION)
- [Review](https://developers.google.com/hotels/hotel-prices/api-reference/rest/v3/accounts.listings#Review)
  - [JSON representation](https://developers.google.com/hotels/hotel-prices/api-reference/rest/v3/accounts.listings#Review.SCHEMA_REPRESENTATION)
- [Type](https://developers.google.com/hotels/hotel-prices/api-reference/rest/v3/accounts.listings#Type)
- [Rating](https://developers.google.com/hotels/hotel-prices/api-reference/rest/v3/accounts.listings#Rating)
  - [JSON representation](https://developers.google.com/hotels/hotel-prices/api-reference/rest/v3/accounts.listings#Rating.SCHEMA_REPRESENTATION)
- [Type](https://developers.google.com/hotels/hotel-prices/api-reference/rest/v3/accounts.listings#Type_1)
- [Image](https://developers.google.com/hotels/hotel-prices/api-reference/rest/v3/accounts.listings#Image)
  - [JSON representation](https://developers.google.com/hotels/hotel-prices/api-reference/rest/v3/accounts.listings#Image.SCHEMA_REPRESENTATION)
- [Methods](https://developers.google.com/hotels/hotel-prices/api-reference/rest/v3/accounts.listings#METHODS_SUMMARY)

## Resource: ParsedListing

A parsed listing

| JSON representation |
|---|
| ``` { "unitAttributes": { string: string, ... }, "listingName": [ { object (`https://developers.google.com/hotels/hotel-prices/api-reference/rest/v3/LocalizedText`) } ], "description": [ { object (`https://developers.google.com/hotels/hotel-prices/api-reference/rest/v3/LocalizedText`) } ], "category": [ { object (`https://developers.google.com/hotels/hotel-prices/api-reference/rest/v3/LocalizedText`) } ], "review": [ { object (`https://developers.google.com/hotels/hotel-prices/api-reference/rest/v3/accounts.listings#Review`) } ], "dataIssueDetail": [ { object (`https://developers.google.com/hotels/hotel-prices/api-reference/rest/v3/DataIssueDetail`) } ], "image": [ { object (`https://developers.google.com/hotels/hotel-prices/api-reference/rest/v3/accounts.listings#Image`) } ], "isServed": boolean, "partnerListId": string, "brand": string, "regionCode": string, "location": { object (`https://developers.google.com/hotels/hotel-prices/api-reference/rest/v3/accounts.listings#LatLng`) }, "imprecisionRadiusMeters": integer } ``` |

| Fields ||
|---|---|
| `unitAttributes` | `map (key: string, value: string)` VR List attribute. An object containing a list of `"key": value` pairs. Example: `{ "name": "wrench", "mass": "1.3kg", "count": "3" }`. |
| `listingName[]` | ``object (`https://developers.google.com/hotels/hotel-prices/api-reference/rest/v3/LocalizedText`)`` List of localized names. |
| `description[]` | ``object (`https://developers.google.com/hotels/hotel-prices/api-reference/rest/v3/LocalizedText`)`` Description of the property. |
| `category[]` | ``object (`https://developers.google.com/hotels/hotel-prices/api-reference/rest/v3/LocalizedText`)`` The partner provided category (accommodation type) of the property. |
| `review[]` | ``object (`https://developers.google.com/hotels/hotel-prices/api-reference/rest/v3/accounts.listings#Review`)`` Reviews associated with this listing. Each review has a single language attached to it. |
| `dataIssueDetail[]` | ``object (`https://developers.google.com/hotels/hotel-prices/api-reference/rest/v3/DataIssueDetail`)`` Data issues about this listing |
| `image[]` | ``object (`https://developers.google.com/hotels/hotel-prices/api-reference/rest/v3/accounts.listings#Image`)`` Images associated with this listing, localized. |
| `isServed` | `boolean` Whether the listing can be served based on non image data alone. |
| `partnerListId` | `string` The list ID on partner LEC feed, provided by partner. |
| `brand` | `string` If not empty, it indicates that this listing belongs to a brand of the feed. |
| `regionCode` | `string` The country code where the listing is located. |
| `location` | ``object (`https://developers.google.com/hotels/hotel-prices/api-reference/rest/v3/accounts.listings#LatLng`)`` Location of listing using latitude and longitude (degrees). |
| `imprecisionRadiusMeters` | `integer` Represents the accuracy of the location. The listing can be anywhere within the defined circular area. |

## LatLng

An object that represents a latitude/longitude pair. This is expressed as a pair of doubles to represent degrees latitude and degrees longitude. Unless specified otherwise, this object must conform to the [WGS84 standard](https://en.wikipedia.org/wiki/World_Geodetic_System#1984_version). Values must be within normalized ranges.

| JSON representation |
|---|
| ``` { "latitude": number, "longitude": number } ``` |

| Fields ||
|---|---|
| `latitude` | `number` The latitude in degrees. It must be in the range \[-90.0, +90.0\]. |
| `longitude` | `number` The longitude in degrees. It must be in the range \[-180.0, +180.0\]. |

## Review

A single review in a VR Listing.

NEXT ID: 10

| JSON representation |
|---|
| ``` { "rating": [ { object (`https://developers.google.com/hotels/hotel-prices/api-reference/rest/v3/accounts.listings#Rating`) } ], "languageCode": string, "type": enum (`https://developers.google.com/hotels/hotel-prices/api-reference/rest/v3/accounts.listings#Type`), "link": string, "title": string, "body": string, "author": string, "reviewTime": string, "visitTime": string } ``` |

| Fields ||
|---|---|
| `rating[]` | ``object (`https://developers.google.com/hotels/hotel-prices/api-reference/rest/v3/accounts.listings#Rating`)`` Any ratings associated with this review. This is repeated because reviews can include ratings on different aspects of a listing, e.g. location, cleanliness, etc. |
| `languageCode` | `string` Language of the review in ISO639 format, such as "en", "de", etc. |
| `type` | ``enum (`https://developers.google.com/hotels/hotel-prices/api-reference/rest/v3/accounts.listings#Type`)`` The type of the review. |
| `link` | `string` The url of the review. |
| `title` | `string` The title of the review, for example: Great three bedrooms. |
| `body` | `string` The body of the review. |
| `author` | `string` The author of the review. |
| `reviewTime` | ``string (`https://protobuf.dev/reference/protobuf/google.protobuf#timestamp` format)`` Unix timestamp (in seconds) of the review, in UTC+0. Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: `"2014-10-02T15:01:23Z"`, `"2014-10-02T15:01:23.045123456Z"` or `"2014-10-02T15:01:23+05:30"`. |
| `visitTime` | ``string (`https://protobuf.dev/reference/protobuf/google.protobuf#timestamp` format)`` Unix timestamp (in seconds) of when the stay was, in UTC+0. Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: `"2014-10-02T15:01:23Z"`, `"2014-10-02T15:01:23.045123456Z"` or `"2014-10-02T15:01:23+05:30"`. |

## Type

Enum for review type.

| Enums ||
|---|---|
| `UNKNOWN` | Review type is unknown. |
| `EDITORIAL` | Review is of editorial type. |
| `USER` | Review is of user type. |

## Rating

A rating for a vacation rentals listing.

NEXT ID: 4

| JSON representation |
|---|
| ``` { "type": enum (`https://developers.google.com/hotels/hotel-prices/api-reference/rest/v3/accounts.listings#Type_1`), "score": number, "ratingScale": integer } ``` |

| Fields ||
|---|---|
| `type` | ``enum (`https://developers.google.com/hotels/hotel-prices/api-reference/rest/v3/accounts.listings#Type_1`)`` The type of the rating. |
| `score` | `number` The rating score. (e.g. 8.5) |
| `ratingScale` | `integer` Maximum rating possible. |

## Type

The type of a vacation rentals listing rating.

| Enums ||
|---|---|
| `TYPE_UNSPECIFIED` | Rating type is unspecified. |
| `OVERALL` | Rating is of overall type. |

## Image

A single image in a VR Listing. Title and gallery URL are stored per locale.

NEXT ID: 4

| JSON representation |
|---|
| ``` { "galleryUri": [ { object (`https://developers.google.com/hotels/hotel-prices/api-reference/rest/v3/LocalizedText`) } ], "title": [ { object (`https://developers.google.com/hotels/hotel-prices/api-reference/rest/v3/LocalizedText`) } ], "uri": string } ``` |

| Fields ||
|---|---|
| `galleryUri[]` | ``object (`https://developers.google.com/hotels/hotel-prices/api-reference/rest/v3/LocalizedText`)`` URL that is deeplink to the image in a gallery (or a webpage). |
| `title[]` | ``object (`https://developers.google.com/hotels/hotel-prices/api-reference/rest/v3/LocalizedText`)`` Title of the image. |
| `uri` | `string` URL that points to the binary image content directly. |

| ## Methods ||
|---|---|
| ### `https://developers.google.com/hotels/hotel-prices/api-reference/rest/v3/accounts.listings/verify` | Returns verified listings with data issues and serving eligibilities for VR partners only. |