US Census data

~2 credits / query (up to 6)

Retrieves official US demographic and economic figures at the state, county, or census tract level, covering population counts, median household income, housing values, employment, and more. Draws from the American Community Survey and decennial census datasets.

Use when

You need official US sub-national figures by geography from a Census survey.

Not for

Country-level economic indicators, or any geography outside the United States.

Cost

~2 credits / query (up to 6)

A few variables for a set of geographies is the usual case; every county or tract returns more rows.

Estimated; the actual charge depends on your input and is shown in the response.

What it accepts

Set these inside the intent when you run it.

metricrequired

The demographic or economic figure you want, described in plain words.

placerequired

The US state, county, or census tract to retrieve data for.

periodoptional

The survey year to use. Defaults to the most recent available year.

What you get back

A table of demographic values for the requested geography, variable, and survey year.

Run it

Run this sub-skill directly: pin it with operation and pass its inputs in the intent. (Omit operation and the Economic & Demographic Data skill will route from your intent instead.)

curl -X POST "https://skill.askfaro.com/skills/economic-data/run" \
  -H "Authorization: Bearer $FARO_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"intent":{"operation":"census_query","metric":"median household income","place":"Cook County, Illinois","period":2022}}'

Example requests

  • What is the median household income in Travis County, Texas?
  • What is the population of each county in California?
  • What is the median home value in Washington state?