{
  "openapi": "3.0.1",
  "info": {
    "title": "US Economic Data Releases: CPI, Jobs, GDP, PCE",
    "description": "Latest official US macro numbers from BLS and BEA: CPI and core CPI with components, nonfarm payrolls, unemployment, wages, PPI, JOLTS, GDP, PCE and core PCE, with month-over-month and year-over-year changes and exact release timestamps.",
    "version": "1.0",
    "x-build-id": "DedewOLxhU3xc5QAO"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/pushbuild~us-economic-releases/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-pushbuild-us-economic-releases",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/pushbuild~us-economic-releases/runs": {
      "post": {
        "operationId": "runs-sync-pushbuild-us-economic-releases",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/pushbuild~us-economic-releases/run-sync": {
      "post": {
        "operationId": "run-sync-pushbuild-us-economic-releases",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "properties": {
          "indicators": {
            "title": "Indicators",
            "type": "array",
            "description": "Which indicators to return. Default: all 28.",
            "items": {
              "type": "string",
              "enum": [
                "cpi",
                "cpi_core",
                "cpi_nsa",
                "cpi_core_nsa",
                "cpi_food",
                "cpi_energy",
                "cpi_shelter",
                "cpi_services_ex_energy",
                "cpi_core_goods",
                "payrolls",
                "payrolls_private",
                "avg_hourly_earnings",
                "avg_weekly_hours",
                "unemployment_rate",
                "u6_rate",
                "participation_rate",
                "ppi_final_demand",
                "ppi_core",
                "jolts_openings",
                "jolts_quits",
                "jolts_hires",
                "gdp_growth",
                "gdp_real",
                "pce_price",
                "pce_core_price",
                "personal_income",
                "pce_nominal",
                "saving_rate"
              ],
              "enumTitles": [
                "CPI-U all items, SA",
                "CPI-U less food and energy, SA",
                "CPI-U all items, NSA",
                "CPI-U less food and energy, NSA",
                "CPI-U food, SA",
                "CPI-U energy, SA",
                "CPI-U shelter, SA",
                "CPI-U services less energy services, SA",
                "CPI-U commodities less food and energy, SA",
                "Total nonfarm payrolls, SA",
                "Total private payrolls, SA",
                "Average hourly earnings, private, SA",
                "Average weekly hours, private, SA",
                "Unemployment rate (U-3), SA",
                "U-6 underemployment rate, SA",
                "Labor force participation rate, SA",
                "PPI final demand, SA",
                "PPI final demand less foods, energy and trade, SA",
                "JOLTS job openings, total nonfarm, SA",
                "JOLTS quits, total nonfarm, SA",
                "JOLTS hires, total nonfarm, SA",
                "Real GDP, % change at annual rate, SA",
                "Real GDP, chained 2017 dollars, SAAR",
                "PCE price index",
                "Core PCE price index (ex food and energy)",
                "Personal income, SAAR",
                "Personal consumption expenditures, SAAR",
                "Personal saving rate"
              ]
            }
          },
          "latestOnly": {
            "title": "Latest value only",
            "type": "boolean",
            "description": "Return only the most recent period of each indicator. Defaults on unless a start date is given.",
            "default": true
          },
          "periods": {
            "title": "Periods per indicator",
            "minimum": 1,
            "maximum": 240,
            "type": "integer",
            "description": "With latest only off: how many recent periods to return per indicator. Default 24.",
            "default": 24
          },
          "dateFrom": {
            "title": "From period",
            "type": "string",
            "description": "Return periods starting on or after this date (YYYY-MM-DD). Up to about 10 years for BLS monthly series; BEA goes back to 1947."
          },
          "maxItems": {
            "title": "Max values",
            "minimum": 1,
            "maximum": 10000,
            "type": "integer",
            "description": "Maximum number of values to return.",
            "default": 5000
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}