> ## Documentation Index > Fetch the complete documentation index at: https://docs.propertydata.dev/llms.txt > Use this file to discover all available pages before exploring further. # Get Property Comparable Homes > Get Property Comparable Homes ## OpenAPI ````yaml api-reference/zillow/openapi.json get /api/v1/property/comparable-homes openapi: 3.1.0 info: title: US Property Data description: US Property Data Documentation version: 1.0.0 servers: - url: https://us-property-data.p.rapidapi.com description: RapiAPI security: [] paths: /api/v1/property/comparable-homes: get: tags: - Property summary: Get Property Comparable Homes description: Get Property Comparable Homes operationId: getApiV1PropertyComparable-homes parameters: - in: query name: zpid schema: type: string pattern: ^\d+$ minLength: 1 description: Unique Zillow Property ID (ZPID) used to identify the property example: '58916071' required: true responses: '200': description: Success content: application/json: schema: type: object properties: success: type: boolean example: true cost: type: number description: Cost of the request example: 1 data: type: array items: type: object properties: miniCardPhotos: type: array items: type: object properties: url: type: string description: >- URL of a thumbnail or preview image representing the comparable property. example: >- https://photos.zillowstatic.com/fp/78a290c2dff6e873d114c09c2395737d-p_c.jpg description: >- List of preview photos displayed for the comparable home card. price: type: number description: >- Final or listed sale price of the comparable property. example: 380000 currency: type: string description: Currency code used for the property price. example: USD bedrooms: type: number description: Number of bedrooms in the comparable property. example: 3 bathrooms: type: number description: Number of bathrooms in the comparable property. example: 2 livingArea: type: number description: >- Total interior living area size of the comparable property. example: 1470 livingAreaValue: type: number description: Numeric value of the living area size. example: 1470 livingAreaUnits: type: string description: Unit of measurement for the living area. example: Square Feet livingAreaUnitsShort: type: string description: Abbreviated unit of measurement for the living area. example: sqft lotSize: type: number description: Lot size of the comparable property in square units. example: 11761 lotAreaValue: type: number description: Numeric value of the lot area. example: 0.27 lotAreaUnits: type: string description: Unit of measurement for the lot area. example: Acres address: type: object properties: streetAddress: type: string description: Street address of the comparable property. example: 23 Parkview Avenue city: type: string description: City where the comparable property is located. example: Meriden state: type: string description: >- State or province where the comparable property is located. example: CT zipcode: type: string description: Postal or ZIP code of the comparable property. example: '06451' description: Address information for the comparable property. parentRegion: type: object properties: name: type: string description: >- Name or identifier of the parent geographic region. example: '06451' description: >- Parent region or area grouping for the comparable property. formattedChip: type: object properties: location: type: array items: type: object properties: fullValue: type: string description: >- Formatted full address string used for display. example: 23 Parkview Avenue description: >- Formatted location display values for UI chips or labels. latitude: type: number description: >- Latitude coordinate of the comparable property location. example: 41.54669 longitude: type: number description: >- Longitude coordinate of the comparable property location. example: -72.8275 zpid: type: number description: >- Unique Zillow property identifier (ZPID) for the comparable home. example: 57930472 homeStatus: type: string description: >- Current or final listing status of the comparable property. example: RECENTLY_SOLD homeType: type: string description: >- High-level home type classification of the comparable property. example: SINGLE_FAMILY hdpUrl: type: string description: >- Relative URL path to the property details page for the comparable home. example: >- /homedetails/23-Parkview-Ave-Meriden-CT-06451/57930472_zpid/ hdpTypeDimension: type: string description: >- Category dimension used for property detail page classification. example: RecentlySold propertyTypeDimension: type: string description: Human-readable property type category. example: Single Family listingTypeDimension: type: string description: >- Listing source or attribution type for the comparable property. example: Unknown Listed By listing_sub_type: type: object properties: is_newHome: type: boolean description: >- Indicates whether the property is a newly constructed home. example: false is_forAuction: type: boolean description: >- Indicates whether the property was listed for auction. example: false is_bankOwned: type: boolean description: Indicates whether the property is bank-owned. example: false is_foreclosure: type: boolean description: >- Indicates whether the property is in foreclosure. example: false is_FSBO: type: boolean description: >- Indicates whether the property was listed for sale by owner. example: false is_comingSoon: type: boolean description: >- Indicates whether the property was marked as coming soon. example: false is_FSBA: type: boolean description: >- Indicates whether the property was listed for sale by agent. example: false description: >- Flags describing special listing sub-types and sale conditions. providerListingID: type: - string - 'null' description: >- External provider listing identifier associated with the comparable property. example: null attributionInfo: type: object properties: mlsId: type: string description: >- MLS identifier associated with the comparable property listing. example: '24134123' mlsName: type: - string - 'null' description: >- Name of the MLS system providing the listing data. example: null providerLogo: type: string description: >- URL of the logo representing the listing data provider. example: >- https://photos.zillowstatic.com/fp/d79c34cc3fb9c13a4cbe1437a108a1d7-zillow_web_48_23.jpg agentName: type: string description: >- Name of the listing agent for the comparable property. example: Michael G. Thompson agentPhoneNumber: type: - string - 'null' description: Contact phone number of the listing agent. example: null brokerName: type: string description: Name of the brokerage representing the listing. example: LPT Realty - IConn Team brokerPhoneNumber: type: - string - 'null' description: Contact phone number of the brokerage. example: null trueStatus: type: - string - 'null' description: >- Internal or verified status of the listing attribution. example: null description: >- Attribution and listing provider information for the comparable property. isShowcaseListing: type: boolean description: >- Indicates whether the comparable property is featured as a showcase listing. example: false isPremierBuilder: type: boolean description: >- Indicates whether the comparable property is associated with a premier builder. example: false state: type: string description: State code where the comparable property is located. example: CT newConstructionType: type: - string - 'null' description: Type or category of new construction, if applicable. example: null '400': description: Bad Request content: application/json: schema: type: object properties: message: type: string example: Bad request '401': description: Unauthorized content: application/json: schema: type: object properties: message: type: string example: >- Invalid API key. Go to https://docs.rapidapi.com/docs/keys for more info. '403': description: Not Found content: application/json: schema: type: object properties: message: type: string example: You are not subscribed to this API. '500': description: Internal Server Error content: application/json: schema: type: object properties: success: type: boolean example: false message: type: string example: 'Request failed with status 500: Internal Server Error' status_code: type: number example: 500 cost: type: number example: 0 explain: type: string example: >- Oops, it looks like there was an issue processing your request. Don't worry, you won't be charged for this request security: - apiKeyAuth: [] components: securitySchemes: apiKeyAuth: type: apiKey in: header name: x-rapidapi-key description: Rapid API Key ````