Fin · GPT 작업

{
  "openapi": "3.1.0",
  "info": {
    "title": "U.S. Census SOMA Data API",
    "description": "This API retrieves quarterly data from the U.S. Census Bureau's Survey of Market Absorption (SOMA) dataset.\nIt returns apartment absorption and rent characteristics for the United States, filtered by time period.\n",
    "version": "1.0.0"
  },
  "servers": [
    {
      "url": "https://api.census.gov",
      "description": "U.S. Census Bureau API Server"
    }
  ],
  "paths": {
    "/data/timeseries/soma": {
      "get": {
        "operationId": "getSomaQuarterlyData",
        "summary": "Retrieve SOMA data for a specific quarter.",
        "description": "Retrieves survey data for apartment completions and absorptions for the specified quarter and year.\n",
        "parameters": [
          {
            "name": "get",
            "in": "query",
            "required": true,
            "description": "Comma-separated list of fields to return",
            "example": "COMP_YEAR,COMP_QTR,NAME,...",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "for",
            "in": "query",
            "required": true,
            "example": "us:*",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "time",
            "in": "query",
            "required": true,
            "example": "2024-Q1",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "key",
            "in": "query",
            "required": true,
            "example": "3393b35d5307effb335668ab350097aa830ad3f9",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response with SOMA data",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}