{ "openapi": "3.0.1", "info": { "title": "FRED Economic Data Scraper", "description": "Scrape economic data from the Federal Reserve’s FRED API, including series details, observations, categories, and metadata. Access indicators like CPI, GDP, unemployment rates, and thousands more. Ideal for economists, researchers, and analysts needing automated, up-to-date economic intelligence.", "version": "1.0", "x-build-id": "qs226AXRMdgsJcZRD" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parseforge~fred-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parseforge-fred-scraper", "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/parseforge~fred-scraper/runs": { "post": { "operationId": "runs-sync-parseforge-fred-scraper", "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/parseforge~fred-scraper/run-sync": { "post": { "operationId": "run-sync-parseforge-fred-scraper", "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": { "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Maximum number of series to collect. Free users: Limited to 100. Paid users: Optional, max 1,000,000. Leave empty for unlimited (paid users only)." }, "searchText": { "title": "Search Text", "type": "string", "description": "Full-text search query to find economic data series. Searches across series titles, units, frequency, and tags. Example: 'cpi', 'unemployment', 'gdp'" }, "categoryId": { "title": "Category ID", "type": "integer", "description": "Filter results by FRED category ID. Example: 10 (National Accounts), 1 (Production & Business Activity)" }, "frequency": { "title": "Frequency", "enum": [ "Daily", "Weekly", "Biweekly", "Monthly", "Quarterly", "Semiannual", "Annual" ], "type": "string", "description": "Filter by data frequency" }, "units": { "title": "Units", "enum": [ "Percent", "Index", "Dollars", "Thousands", "Millions", "Billions", "Ratio", "Number", "Rate", "Index 1982-1984=100", "Index 2012=100", "Index 2015=100", "Index 2017=100" ], "type": "string", "description": "Filter by units of measurement" }, "seasonalAdjustment": { "title": "Seasonal Adjustment", "enum": [ "Seasonally Adjusted", "Not Seasonally Adjusted" ], "type": "string", "description": "Filter by seasonal adjustment" }, "includeObservations": { "title": "Include Observations", "type": "boolean", "description": "Whether to include observation data (date-value pairs) for each series. ⚠️ WARNING: This will significantly increase processing time and cost. The scraper fetches all historical observations for each series, which requires additional API requests and may take several minutes for large datasets.", "default": false }, "sortOrder": { "title": "Sort Order", "enum": [ "search_rank", "series_id", "title", "units", "frequency", "seasonal_adjustment", "realtime_start", "realtime_end", "last_updated", "observation_start", "observation_end", "popularity", "group_popularity" ], "type": "string", "description": "Field to sort results by", "default": "search_rank" }, "orderBy": { "title": "Order By", "enum": [ "asc", "desc" ], "type": "string", "description": "Sort order direction", "default": "desc" } } }, "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 } } }, "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 } } } } } } } } } }