US Census (ACS): Income, Age, Housing and Population by Location

Overview
API Explorer
API Documentation beta
App Gallery

Overview

The 2009 American Community Survey (ACS) Topline API provides basic demographic data based on your geographically defined query. This geo to ACS data API searches by lat/long coordinates to retrieve ACS data about a geographical area, including education levels, household income, race statistics, household size, gender and age groups.

For more information about the American Community Survey, check out this wikipedia article.

This API is part of the Infochimps Geo API.

Quick Reference Geolocators:

Infochimps Office in Austin, TX: g.latitude=30.273054&g.longitude=-97.757598&g.radius=1000
San Francisco, CA: g.latitude=37.776115&g.longitude=-122.412768&g.radius=1000
Oakland, CA Bounding Box: g.bbox=37.7993,-122.2777,37.8077,-122.2682
Marfa, TX: g.latitude=30.311863&g.longitude=-104.024779&g.radius=10000
San Francisco, CA Quadkey: &quad_key=0230102
Downtown & South Austin, TX Google Tile: g.latitude=30.221101852485983&g.longitude=-97.822265625&g.zoom_level=12

GET
/search

GET

apikey

Geolocator

Select a geolocator type to query

g.radius

in meters

g.latitude

g.longitude

g.address_text

g.zoom_level

g.tile_x

g.tile_y

g.bbox

SW latitude, SW longitude, NE latitude, NE longitude

g.ip_address

f.q

Generic filter to query all fields

f.md5id

An md5 hex digest that together with the domain uniquely identifies this record.

f.geography_name

f.census_logrecno

Logical Record Number (LOGRECNO) areas developed by the U.S. Census Bureau, a concatenation of the 2 letter USPS state abbreviation and the numeric logical record number for this region.

f.geo_geometry_type

Equivalent to geometry type in GeoJSON.

f._type

Type

f.race

Race, divided into the percentage of the population that is White Alone, Black or African American Alone, American Indian and Alaska Native Alone, Asian Alone, Native Hawaiian and Other Pacific Islander alone, Hispanic/Latino alone, and 2 or more races. …

f.age

Age, divided into the percentage of the population ages 0 to 9 years old, 10 to 17 years old, 18 to 24 years old, 25 to 34 years old, 35 to 49 years old, 50 to 64 years old, 65 or more years old. Source: ACS table B01001;…

f.income

Household Income in the Past 12 Months, divided into the percentage of the population with income less than 25k, from 25k to 50 k, from 50k to 75k, from 75k to 100k, from 100k to 200k, and greater than 200k. Source: ACS table B19001;…

f.avg_household_size

Average Household Size. Source: ACS table B25010

f.means of transportation to work

Means of Transportation to Work, divided into the percentage of the population that drives alone, carpools, takes public transportation, takes another form of transportation, or works from home. Source: ACS table B08406;…

f.house_value

Value of Housing Unit. Source: ACS Table B25075

f.percent_housing_owned

Percentage of homes owned by occupants. Source: ACS table B25008

f.percent_housing_rented

Percentage of homes rented by occupants. Source: ACS table B25008

f.percent_female

Percentage of population that is female. Source: ACS table B01001

f.percent_male

Percentage of population that is male. Source: ACS table B01001

f.total_pop

Total population. Source: ACS table B01003

f.education

Educational Attainment For The Population 25 Years And Over, divided into percentage of the population with less than a high school diploma or GRE, with only a high school diploma or GRE, and with a Bachelor’s degree or above. Source:" ACS table B15002" …

Add filter field

Select field to add as filter

GET api.infochimps.com/social/demographics/us_census/topline/search

Sample Visualization

GET
/search

GET

apikey

Geolocator

Select a geolocator type to query

g.radius

in meters

g.latitude

g.longitude

g.address_text

g.zoom_level

g.tile_x

g.tile_y

g.bbox

SW latitude, SW longitude, NE latitude, NE longitude

g.ip_address

f.q

Generic filter to query all fields

f.md5id

An md5 hex digest that together with the domain uniquely identifies this record.

f.geography_name

f.census_logrecno

Logical Record Number (LOGRECNO) areas developed by the U.S. Census Bureau, a concatenation of the 2 letter USPS state abbreviation and the numeric logical record number for this region.

f.geo_geometry_type

Equivalent to geometry type in GeoJSON.

f._type

Type

f.race

f.age

f.income

f.avg_household_size

Average Household Size. Source: ACS table B25010

f.means of transportation to work

f.house_value

Value of Housing Unit. Source: ACS Table B25075

f.percent_housing_owned

Percentage of homes owned by occupants. Source: ACS table B25008

f.percent_housing_rented

Percentage of homes rented by occupants. Source: ACS table B25008

f.percent_female

Percentage of population that is female. Source: ACS table B01001

f.percent_male

Percentage of population that is male. Source: ACS table B01001

f.total_pop

Total population. Source: ACS table B01003

f.education

Add filter field

Select field to add as filter

GET api.infochimps.com/social/demographics/us_census/topline/search

Sample Visualization

API Documentation

Check out our Quickstart Tutorial and Code Examples, or peruse the documentation specific to this API below.

GET /search

http://api.infochimps.com/social/demographics/us_census/topline/search

Request

Geolocator

Select one geolocator from this list.

Geolocator	Description	Example
Point with radius	radius + latitude + longitude in meters	`?g.radius=1000&g.latitude=30.3&g.longitude=-97.75`
Address text	address_text + radius in meters	`?g.address_text=1214+W+6th+St.+Suite+202+Austin%2C+TX+78703&g.radius=1000`
Tile x y zoom	zoom_level + tile_x + tile_y	`?g.zoom_level=9&g.tile_x=23&g.tile_y=58`
Bounding box	bbox SW latitude, SW longitude, NE latitude, NE longitude	`?g.bbox=30.2%2C-97.85%2C30.4%2C-97.65`
Ip address	ip_address + radius in meters	`?g.ip_address=&g.radius=1000`

Filter

Include query filters to limit / specify your results

Filter	Description	Example
General Filter	A general query on all fields	`?f.q=`
Specific Filter	Perform a search on a specific field by using the "f.FIELD_NAME" syntax. This works on all the top level fields. Please see the response documentation to see all available fields to search.	`?f.name=`

Response

Parameter	Description	Type
md5id	An md5 hex digest that together with the domain uniquely identifies this record.	Md5 hexdigest
geography_name		String
census_logrecno	Logical Record Number (LOGRECNO) areas developed by the U.S. Census Bureau, a concatenation of the 2 letter USPS state abbreviation and the numeric logical record number for this region.	String
geo_geometry_type	Equivalent to geometry type in GeoJSON.	String
_type	Type	String
race	Race, divided into the percentage of the population that is White Alone, Black or African American Alone, American Indian and Alaska Native Alone, Asian Alone, Native Hawaiian and Other Pacific Islander alone, Hispanic/Latino alone, and 2 or more races. Source: ACS table B02001	array of String
age	Age, divided into the percentage of the population ages 0 to 9 years old, 10 to 17 years old, 18 to 24 years old, 25 to 34 years old, 35 to 49 years old, 50 to 64 years old, 65 or more years old. Source: ACS table B01001	array of String
income	Household Income in the Past 12 Months, divided into the percentage of the population with income less than 25k, from 25k to 50 k, from 50k to 75k, from 75k to 100k, from 100k to 200k, and greater than 200k. Source: ACS table B19001	array of String
avg_household_size	Average Household Size. Source: ACS table B25010	String
means of transportation to work	Means of Transportation to Work, divided into the percentage of the population that drives alone, carpools, takes public transportation, takes another form of transportation, or works from home. Source: ACS table B08406	array of String
house_value	Value of Housing Unit. Source: ACS Table B25075	array of String
percent_housing_owned	Percentage of homes owned by occupants. Source: ACS table B25008	Float
percent_housing_rented	Percentage of homes rented by occupants. Source: ACS table B25008	Float
percent_female	Percentage of population that is female. Source: ACS table B01001	Float
percent_male	Percentage of population that is male. Source: ACS table B01001	Float
total_pop	Total population. Source: ACS table B01003	Integer
education	Educational Attainment For The Population 25 Years And Over, divided into percentage of the population with less than a high school diploma or GRE, with only a high school diploma or GRE, and with a Bachelor’s degree or above. Source: ACS table B15002	array of String

Application Gallery

Do you have an application, visualization or otherwise great use of this data?
Submit it now, and be featured here!

Get the API

Access this data set via the API! Easy, instant, simple answers to hard questions.

Infochimps Platform

Use this data on the Infochimps Big Data Platform to unlock:

Advanced analytical capabilities
Hosting for customer databases
Access to tools such as Hadoop, Pig, and R
…and more to come!

Learn More »

Stats

Added by:	Infochimps
Link:
Created:	9 months ago
Updated:	3 months ago

Sample Visualization

Sample Visualization

GET /search

Request

Geolocator

Geolocator

Description

Example

Point with radius

Address text

Tile x y zoom

Bounding box

Ip address

Filter

Filter

Description

Example

General Filter

Specific Filter

Response

Parameter

Description

Type

md5id

geography_name

census_logrecno

geo_geometry_type

_type

race

age

income

avg_household_size

means of transportation to work

house_value

percent_housing_owned

percent_housing_rented

percent_female

percent_male

total_pop

education

Application Gallery

Tags

Stats

Share