Realtor Mentor Pro

Realtor Mentor Pro · GPT アクション

Zillow Listings API

API for accessing Zillow listings.

  • GET /listingsForUserGet Zillow listings for a user

    This endpoint is used to retrieve Zillow listings for a specific user. Use the returned listings to map to your internal list of properties. You will need the zgListingId for your listings when using other APIs from Zillow Group.

元の API スキーマ
{
  "openapi": "3.0.0",
  "info": {
    "title": "Zillow Listings API",
    "version": "1.0.0",
    "description": "API for accessing Zillow listings."
  },
  "servers": [
    {
      "url": "https://rentalsapi.zillowgroup.com/listings/v1",
      "description": "Zillow Listings API server"
    }
  ],
  "paths": {
    "/listingsForUser": {
      "get": {
        "operationId": "getZillowListings",
        "summary": "Get Zillow listings for a user",
        "description": "This endpoint is used to retrieve Zillow listings for a specific user. Use the returned listings to map to your internal list of properties. You will need the zgListingId for your listings when using other APIs from Zillow Group.\n",
        "responses": {
          "200": {
            "description": "Successful response with Zillow listings",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "listings": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/ZillowListing"
                      }
                    },
                    "totalListings": {
                      "type": "integer"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad request"
          },
          "401": {
            "description": "Unauthorized access"
          },
          "403": {
            "description": "Forbidden, possibly due to rate limits"
          },
          "500": {
            "description": "Internal server error"
          }
        }
      }
    }
  },
  "security": [
    {
      "ApiKeyAuth": []
    }
  ],
  "components": {
    "securitySchemes": {
      "ApiKeyAuth": {
        "type": "apiKey",
        "in": "header",
        "name": "API_KEY"
      }
    },
    "schemas": {
      "ZillowListing": {
        "type": "object",
        "properties": {
          "zgListingId": {
            "type": "string"
          },
          "address": {
            "type": "string"
          },
          "price": {
            "type": "number"
          },
          "bedrooms": {
            "type": "integer"
          },
          "bathrooms": {
            "type": "number"
          },
          "squareFeet": {
            "type": "integer"
          },
          "imageUrl": {
            "type": "string"
          }
        }
      }
    }
  }
}