📊 US Census Bureau Scraper

🚀 Extract demographic and economic data from the US Census Bureau in minutes. Search by keyword, filter by year, dataset, and geography. No coding, no API keys required.

🕒 Last updated: 2026-04-23 · 📊 13 fields · 🗂️ Supports ACS, Decennial, Economic Census · 🌍 17 geography levels

The US Census Bureau holds the largest collection of demographic, economic, and housing data in the United States. Whether you need population estimates, income distributions, or housing statistics, this scraper connects directly to the Census Bureau's public API and returns structured, clean data. It supports 17 geography levels from national down to ZIP code, covers multiple survey programs including ACS 1-Year, ACS 5-Year, and Decennial Census, and outputs up to 1,000,000 tables per run for paid users.

Instead of navigating data.census.gov manually and downloading tables one at a time, this actor lets you search by keyword and collect all matching tables with their full metadata, variables, and actual data values. Every record includes the table ID, title, survey type, universe, year, vintage, geography, description, variables with definitions, and statistical values. The data arrives in JSON, CSV, or Excel format, ready for analysis in any tool.

🎯 Target Audience	💡 Use Cases
Government analysts	Track population changes across counties and states
Academic researchers	Build custom datasets for demographic studies
Urban planners	Analyze housing and commuting patterns by census tract
Data journalists	Compare income and poverty statistics across regions
Nonprofits	Identify underserved communities using economic data
Business strategists	Evaluate market size and consumer demographics by ZIP code

---

📋 What the US Census Bureau Scraper does

• 🔍 Keyword search across all Census tables to find population, income, housing, and education data
• 📅 Year filtering to collect data from specific vintages like 2021, 2022, or 2023
• 🗂️ Dataset selection for ACS 1-Year, ACS 5-Year, Decennial Census, Economic Census, and more
• 🌍 Geography filtering across 17 levels from national to block group
• 🔢 Variable extraction with complete definitions and statistical values
• 📊 Bulk collection of up to 1,000,000 tables per run with structured output

The scraper sends your keyword to the Census Bureau's discovery API, retrieves matching table metadata, then fetches detailed variable definitions and actual data values for each table. Results include the full table title, survey type, universe description, geographic coverage, and every variable with its label and data points. Each record is timestamped so you know exactly when it was collected.

💡 Why it matters: The Census Bureau publishes thousands of tables across dozens of surveys. Manually searching, filtering, and downloading takes hours. This scraper automates the entire process and delivers structured data ready for analysis, dashboards, or integration with other systems.

---

🎬 Full Demo

🚧 Coming soon...

---

⚙️ Input

Field	Type	Required	Description
searchQuery	string	Yes	Keyword to find Census tables (e.g., "population", "income", "housing")
maxItems	integer	No	Max tables to collect. Free: up to 10. Paid: up to 1,000,000
year	string	No	Filter by year or vintage (e.g., "2021", "2023")
dataset	string	No	Filter by survey type: acs/acs1, acs/acs5, dec/pl, cbp, and more
geography	string	No	Filter by geography level: us, state, county, tract, zip code, and more

Example 1: Basic keyword search

{
  "searchQuery": "population",
  "maxItems": 10
}

Example 2: Filtered search with year, dataset, and geography

{
  "searchQuery": "income",
  "maxItems": 50,
  "year": "2021",
  "dataset": "acs/acs5",
  "geography": "county"
}

⚠️ Good to Know: Some geography levels (like census tract or block group) require a state parameter in the underlying API. If you get fewer results than expected, try a broader geography level like "state" or "county".

---

📊 Output

🧾 Schema

Emoji	Field	Type	Description
🆔	tableId	string	Unique Census table identifier
📝	title	string	Official Census table name
🔗	url	string	Direct link to view the table on data.census.gov
📊	surveyType	string	Which Census survey the table comes from
👥	universe	string	Population or entity group being measured
📅	year	string	Data collection year
📅	vintage	string	Data release vintage
🌍	geography	string	Available geography levels
📋	description	string	Full text explanation of the table contents
🔢	variables	array	List of measures and dimensions with definitions
📈	data	object	Actual statistical values and cross-tabulations
⏰	scrapedAt	string	Timestamp of when the record was collected
⚠️	error	string	Error message if processing failed

📦 Sample records

---

✨ Why choose this Actor

Feature	Details
🔍 Keyword search	Find any Census table by topic across all surveys
🗂️ Multi-survey support	ACS 1-Year, ACS 5-Year, Decennial, Economic Census, and more
🌍 17 geography levels	National, state, county, tract, ZIP code, congressional district, and more
📅 Year filtering	Target specific data vintages from 2000 to 2023
🔢 Full variable extraction	Every measure and dimension with labels and definitions
📈 Actual data values	Statistical values included, not just metadata
📦 Flexible export	JSON, CSV, or Excel output for any analytics tool

📊 Collect up to 1,000,000 Census tables per run with full metadata, variables, and data values.

---

📈 How it compares to alternatives

Feature	This Actor	Manual Download	Generic Scrapers
Keyword search across all surveys	✅	❌	❌
Variable definitions included	✅	Partial	❌
17 geography levels	✅	✅	❌
Bulk collection (1M+ tables)	✅	❌	❌
Structured JSON/CSV output	✅	CSV only	Varies
No coding required	✅	✅	❌
Scheduled runs	✅	❌	❌

Skip the manual table-by-table downloads and get all the Census data you need in one run.

---

🚀 How to use

1. Create an Apify account - Sign up free with $5 credit
2. Open the US Census Bureau Scraper - Navigate to the actor page on Apify
3. Enter your search keyword - Type a topic like "population", "income", or "housing"
4. Add optional filters - Set year, dataset, and geography to narrow results
5. Click Start - The actor collects matching tables and delivers structured data

⏱️ A typical run with 10 tables completes in under 1 minute.

---

💼 Business use cases

📊 Government & Policy Track population changes across districts Analyze poverty rates by county for resource allocation Monitor housing occupancy trends for urban planning Compare economic indicators across states	🎓 Academic Research Build datasets for demographic studies Cross-reference census data with survey results Analyze migration patterns using multi-year data Track educational attainment trends by region
💼 Business Intelligence Evaluate market size by ZIP code for expansion planning Segment consumers by income and age demographics Identify high-growth areas using population estimates Benchmark regional economic performance	📰 Data Journalism Visualize income inequality across neighborhoods Compare demographic shifts between census years Map commuting patterns using transportation data Report on housing affordability by metro area

---

---

🌟 Beyond business use cases

Data like this powers more than commercial workflows. The same structured records support research, education, civic projects, and personal initiatives.

🎓 Research and academia Empirical datasets for papers, thesis work, and coursework Longitudinal studies tracking changes across snapshots Reproducible research with cited, versioned data pulls Classroom exercises on data analysis and ethical scraping	🎨 Personal and creative Side projects, portfolio demos, and indie app launches Data visualizations, dashboards, and infographics Content research for bloggers, YouTubers, and podcasters Hobbyist collections and personal trackers
🤝 Non-profit and civic Transparency reporting and accountability projects Advocacy campaigns backed by public-interest data Community-run databases for local issues Investigative journalism on public records	🧪 Experimentation Prototype AI and machine-learning pipelines with real data Validate product-market hypotheses before engineering spend Train small domain-specific models on niche corpora Test dashboard concepts with live input

🤖 Ask an AI assistant about this scraper

Open a ready-to-send prompt about this ParseForge actor in the AI of your choice:

• 💬 ChatGPT
• 🧠 Claude
• 🔍 Perplexity
• 🅒 Copilot

❓ Frequently Asked Questions

💳 Do I need a paid Apify plan to run this actor?

No. You can start right now on the free Apify plan, which includes $5 in free monthly credit. That is enough to run this actor several times and explore the output before committing to anything. Paid plans unlock higher limits, more concurrent runs, and larger datasets. Create a free Apify account here to get started.

🚨 What happens if my run fails or returns no results?

Failed runs are not charged. If the source site changes, proxies get rate-limited, or a specific input matches nothing, re-run the actor or open our contact form and we will investigate. You can also check the run log in the Apify console to see why the run stopped.

📏 How many items can I scrape per run?

Free users are limited to 10 items per run so you can preview the output and confirm the actor works for your use case. Paid users can raise maxItems up to 1,000,000 per run. Upgrade here if you need full scale.

🕒 How fresh is the data?

Every run fetches live data at the moment of execution. There is no cache or delay: the records you get reflect what the source returned at that moment. Schedule the actor to maintain a rolling snapshot of the data you need.

🧑‍💻 Can I call this actor from my own code?

Yes. Apify exposes every actor as a REST endpoint and ships first-class SDKs for Node.js and Python. You can start a run, read the dataset, and handle webhooks from your own app in a few lines. All you need is your Apify API token.

📤 How do I export the data?

Every Apify dataset can be downloaded in one click from the console as CSV, JSON, JSONL, Excel, HTML, XML, or RSS. You can also pull results programmatically via the Apify API or stream them into BigQuery, S3, and other destinations through built-in integrations.

📅 Can I schedule the actor to run automatically?

Yes. Use the Apify scheduler to run the actor on any cadence, from hourly to monthly. Results are saved to your dataset and can be delivered to webhooks, email, Slack, cloud storage, or automation tools such as Zapier and Make.

---

🔌 Automating US Census Bureau Scraper

Integrate the US Census Bureau Scraper into your workflow using the Apify API or client libraries.

Node.js:

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'YOUR_API_TOKEN' });
const run = await client.actor("parseforge/us-census-bureau-scraper").call({
  searchQuery: "population",
  maxItems: 50,
  year: "2021",
  geography: "state"
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

Python:

from apify_client import ApifyClient

client = ApifyClient("YOUR_API_TOKEN")
run = client.actor("parseforge/us-census-bureau-scraper").call(run_input={
    "searchQuery": "population",
    "maxItems": 50,
    "year": "2021",
    "geography": "state"
})
items = list(client.dataset(run["defaultDatasetId"]).iterate_items())
print(items)

• 📖 Apify API reference
• 🐍 Python client docs
• 📦 Node.js client docs

Schedules: Set up automatic runs on a daily, weekly, or monthly schedule to track Census data changes over time. Configure schedules directly from the Apify Console to build historical datasets without manual intervention.

🔌 Integrate with any app

• 🔗 Make (Integromat) - Connect Census data to Google Sheets, Slack, or any of 1,500+ apps
• 🔗 Zapier - Trigger workflows when new Census data is collected
• 🔗 Slack - Get notified in your channel when a Census data run completes
• 🔗 Airbyte - Stream Census data into your data warehouse
• 🔗 GitHub - Store Census datasets in repositories for version control
• 🔗 Google Drive - Automatically save CSV exports to shared folders

---

🔗 Recommended Actors

Actor	Description
PubMed Citation Scraper	Extract publication metadata from PubMed for research analysis
NASA Reports Scraper	Collect technical reports from NASA's NTRS database
Open Library Scraper	Search and download book data from the Internet Archive
Crossref Scraper	Extract DOI metadata for 155M+ research publications
ROR Scraper	Collect research organization data from the Research Organization Registry

💡 Pro Tip: Combine the US Census Bureau Scraper with other data actors to build rich, multi-source datasets for research and analysis.

---

🆘 Need Help? Open our contact form and we will get back to you within 24 hours. We are happy to help with custom setups, integrations, or feature requests.

---

Disclaimer: This actor is not affiliated with, endorsed by, or connected to the US Census Bureau. It accesses publicly available data through the Census Bureau's public API. Use responsibly and in accordance with applicable terms of service.