{ "openapi": "3.0.1", "info": { "title": "US Census Bureau Demographics & Population Data API", "description": "Access comprehensive US Census Bureau data including American Community Survey (ACS) demographics, population estimates, economic indicators, business statistics, and geographic data. Get population, income, education, housing, employment, and health data for any US location.", "version": "1.0", "x-build-id": "j7l7jNuDUUsER3MRR" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/alizarin_refrigerator-owner~us-census-bureau-demographics-population-data-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-alizarin_refrigerator-owner-us-census-bureau-demographics-population-data-api", "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/alizarin_refrigerator-owner~us-census-bureau-demographics-population-data-api/runs": { "post": { "operationId": "runs-sync-alizarin_refrigerator-owner-us-census-bureau-demographics-population-data-api", "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/alizarin_refrigerator-owner~us-census-bureau-demographics-population-data-api/run-sync": { "post": { "operationId": "run-sync-alizarin_refrigerator-owner-us-census-bureau-demographics-population-data-api", "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", "required": [ "task" ], "properties": { "task": { "title": "Task", "enum": [ "get_population", "get_demographics", "get_income", "get_housing", "get_education", "get_employment", "get_business_stats", "get_poverty", "get_health_insurance", "get_commuting", "get_migration", "compare_locations", "get_zip_profile", "get_county_profile", "get_state_profile", "custom_query" ], "type": "string", "description": "Operation to perform", "default": "get_population" }, "apiKey": { "title": "Census API Key", "type": "string", "description": "Free API key from census.gov/developers (optional for limited use)" }, "dataset": { "title": "Dataset", "enum": [ "acs5", "acs1", "pep", "dec", "cbp", "abs" ], "type": "string", "description": "Census dataset to query", "default": "acs5" }, "year": { "title": "Year", "minimum": 2000, "maximum": 2025, "type": "integer", "description": "Data year (e.g., 2023)", "default": 2023 }, "state": { "title": "State FIPS Code", "type": "string", "description": "2-digit state FIPS code (e.g., 06 for California, 36 for New York)" }, "county": { "title": "County FIPS Code", "type": "string", "description": "3-digit county FIPS code within state" }, "place": { "title": "Place FIPS Code", "type": "string", "description": "Place (city/town) FIPS code" }, "zipCode": { "title": "ZIP Code", "type": "string", "description": "5-digit ZIP code (ZCTA)" }, "tract": { "title": "Census Tract", "type": "string", "description": "6-digit census tract code" }, "stateName": { "title": "State Name", "type": "string", "description": "State name (alternative to FIPS code)" }, "variables": { "title": "Variables", "type": "string", "description": "Comma-separated Census variable codes (e.g., B01001_001E,B01002_001E)" }, "tableGroup": { "title": "Table Group", "type": "string", "description": "Census table group (e.g., B01001 for Sex by Age)" }, "compareStates": { "title": "Compare States", "type": "string", "description": "Comma-separated state FIPS codes to compare" }, "naicsCode": { "title": "NAICS Code", "type": "string", "description": "Industry code for business statistics" }, "webhookUrl": { "title": "Webhook URL", "type": "string", "description": "URL to send results to (Zapier, Make, n8n, etc.)" }, "demoMode": { "title": "Demo Mode", "type": "boolean", "description": "Run with sample data (no API key required)", "default": true } } }, "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 } } } } } } } } } }