아파트 실거래봇 (+국토부 API 연동) · Actions GPT

{
  "openapi": "3.1.0",
  "info": {
    "title": "Real Estate Transaction Data Proxy API",
    "description": "Proxy API for accessing real estate transaction data from public data portal.",
    "version": "v1.0.0"
  },
  "servers": [
    {
      "url": "https://port-0-proxyapi-azyqdr152alroasid5.sel5.cloudtype.app"
    }
  ],
  "paths": {
    "/realestate": {
      "get": {
        "summary": "Get real estate transaction data",
        "description": "Retrieves real estate transaction data based on provided parameters.",
        "operationId": "getEstateInfo",
        "parameters": [
          {
            "in": "query",
            "name": "pageNo",
            "required": false,
            "description": "Page number of the results",
            "schema": {
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "numOfRows",
            "required": false,
            "description": "Number of rows per page",
            "schema": {
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "LAWD_CD",
            "required": true,
            "description": "Regional code",
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "DEAL_YMD",
            "required": true,
            "description": "Contract month in YYYYMM format",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response containing real estate transaction data",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "resultCode": {
                      "type": "string",
                      "description": "Result code of the API call"
                    },
                    "resultMsg": {
                      "type": "string",
                      "description": "Result message of the API call"
                    },
                    "numOfRows": {
                      "type": "integer",
                      "description": "Number of rows per page"
                    },
                    "pageNo": {
                      "type": "integer",
                      "description": "Page number of the results"
                    },
                    "totalCount": {
                      "type": "integer",
                      "description": "Total number of results"
                    },
                    "DealAmount": {
                      "type": "string",
                      "description": "Transaction amount in 10,000 KRW units"
                    },
                    "BuildYear": {
                      "type": "string",
                      "description": "Year of construction"
                    },
                    "DealYear": {
                      "type": "string",
                      "description": "Year of the contract"
                    },
                    "RoadName": {
                      "type": "string",
                      "description": "Road name"
                    },
                    "RoadNameBonbun": {
                      "type": "string",
                      "description": "Road name building main number"
                    },
                    "RoadNameBubun": {
                      "type": "string",
                      "description": "Road name building sub number"
                    },
                    "RoadNameSigunguCode": {
                      "type": "string",
                      "description": "Road name district code"
                    },
                    "RoadNameSeq": {
                      "type": "string",
                      "description": "Road name sequence code"
                    },
                    "RoadNameBasementCode": {
                      "type": "string",
                      "description": "Road name above/below ground code"
                    },
                    "RoadNameCode": {
                      "type": "string",
                      "description": "Road name code"
                    },
                    "Dong": {
                      "type": "string",
                      "description": "Legal town name"
                    },
                    "Bonbun": {
                      "type": "string",
                      "description": "Legal town main number"
                    },
                    "Bubun": {
                      "type": "string",
                      "description": "Legal town sub number"
                    },
                    "SigunguCode": {
                      "type": "string",
                      "description": "Legal district code"
                    },
                    "EubmyundongCode": {
                      "type": "string",
                      "description": "Legal town, township, neighborhood code"
                    },
                    "LandCode": {
                      "type": "string",
                      "description": "Legal land number code"
                    },
                    "ApartmentName": {
                      "type": "string",
                      "description": "Apartment name"
                    },
                    "DealMonth": {
                      "type": "string",
                      "description": "Month of the contract"
                    },
                    "DealDay": {
                      "type": "string",
                      "description": "Day of the contract"
                    },
                    "SerialNumber": {
                      "type": "string",
                      "description": "Serial number of the record"
                    },
                    "AreaForExclusiveUse": {
                      "type": "string",
                      "description": "Area for exclusive use in square meters"
                    },
                    "Jibun": {
                      "type": "string",
                      "description": "Land lot number"
                    },
                    "RegionalCode": {
                      "type": "string",
                      "description": "Regional code"
                    },
                    "Floor": {
                      "type": "string",
                      "description": "Floor number"
                    },
                    "CancelDealType": {
                      "type": "string",
                      "description": "Type of deal cancellation"
                    },
                    "CancelDealDay": {
                      "type": "string",
                      "description": "Date of deal cancellation reason occurrence"
                    },
                    "REQ_GBN": {
                      "type": "string",
                      "description": "Transaction type (brokerage or direct deal)"
                    },
                    "RdealerLawdnm": {
                      "type": "string",
                      "description": "Location of real estate dealer (district level)"
                    },
                    "RegistrationDate": {
                      "type": "string",
                      "description": "Registration date of the record"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad request due to invalid parameters or missing required parameters"
          },
          "500": {
            "description": "Server error"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {}
  }
}