Retail Services Python Library

From the CORGIS Dataset Project

By Austin Cory Bart acbart@vt.edu
Version 2.0.0, created 3/22/2016
Tags: retail, services, government, united states, usa, us, trade, food, services

Overview

The Advance Monthly and Monthly Retail Trade Surveys (MARTS and MRTS), the Annual Retail Trade Survey (ARTS), and the Quarterly E-Commerce Report work together to produce the most comprehensive data available on retail economic activity in the United States. More detailed descriptions of these programs can be found by choosing one of the links to the left. Regular quality control and verification takes place between MARTS, MRTS, and ARTS annually and between these programs and the Economic Census of Retail Trade every five years. Each year when annual data become available, we compare and resolve differences between the data collected on the monthly and annual surveys. We refer to this process as the monthly-to-annual reconciliation. At the same time, we benchmark the monthly estimates using results of the annual survey. ARTS estimates are then benchmarked to data maintained by the Economic Census of Retail Trade. This process of benchmarking retail data over all four programs ensures consistency in our estimates. The Business Expenses Supplement is an addition to the 2007 Annual Retail Trade Survey. Its purpose is to compile statistics on detailed business operating expenses. The United States Code, Title 13, authorizes this program as part of the Economic Census. This coverage was previously part of the predecessor Business Expenses Survey. Detailed expenses are collected every five years.

http://www.census.gov/retail/about_the_surveys.html

Explore Structure

Each row represents $MISSING_FIELD.

Index	Type	Example Value
0	dict	{ }
1	dict	(same structure)
2	dict	(same structure)
...	...	...

Key	Type	Example Value	Description
`"time"`	dict	{ }
`"data"`	dict	{ }

Key	Type	Example Value	Description
`"index"`	int	`1`	$MISSING_FIELD
`"month"`	int	`1`	$MISSING_FIELD
`"month name"`	str	`"Jan"`	$MISSING_FIELD
`"period"`	str	`"Jan1992"`	$MISSING_FIELD
`"year"`	int	`1992`	$MISSING_FIELD

Key	Type	Example Value
`"inventories"`	dict	{ }
`"ratio"`	dict	{ }
`"sales"`	dict	{ }

Key	Type	Example Value	Description
`"all department stores"`	int	`0`	$MISSING_FIELD
`"all other home furnishings stores"`	int	`0`	$MISSING_FIELD
`"all other merchandise stores"`	int	`0`	$MISSING_FIELD
`"appliances and other electronics stores"`	int	`0`	$MISSING_FIELD
`"auto and other motor vehicles"`	int	`0`	$MISSING_FIELD
`"automobile dealers"`	int	`0`	$MISSING_FIELD
`"automotive parts and tire stores"`	int	`0`	$MISSING_FIELD
`"beer, wine, and liquor stores"`	int	`0`	$MISSING_FIELD
`"book stores"`	int	`0`	$MISSING_FIELD
`"building materials and garden supplies dealers"`	int	`19545`	$MISSING_FIELD
`"building supplies dealers"`	int	`0`	$MISSING_FIELD
`"clothing stores"`	int	`22622`	$MISSING_FIELD
`"computer and software stores"`	int	`0`	$MISSING_FIELD
`"discount department stores"`	int	`0`	$MISSING_FIELD
`"drinking places"`	int	`0`	$MISSING_FIELD
`"electronic shopping and mail-order houses"`	int	`0`	$MISSING_FIELD
`"electronics and appliance stores"`	int	`0`	$MISSING_FIELD
`"family clothing stores"`	int	`0`	$MISSING_FIELD
`"floor covering stores"`	int	`0`	$MISSING_FIELD
`"food and beverage stores"`	int	`26963`	$MISSING_FIELD
`"food services and drinking places"`	int	`0`	$MISSING_FIELD
`"fuel dealers"`	int	`0`	$MISSING_FIELD
`"full service restaurants"`	int	`0`	$MISSING_FIELD
`"furniture and home furnishings stores"`	int	`0`	$MISSING_FIELD
`"furniture stores"`	int	`0`	$MISSING_FIELD
`"furniture, home furn, electronics, and appliance stores"`	int	`13850`	$MISSING_FIELD
`"gafo"`	int	`0`	$MISSING_FIELD
`"gasoline stations"`	int	`0`	$MISSING_FIELD
`"general merchandise stores"`	int	`43750`	$MISSING_FIELD
`"gift, novelty, and souvenir stores"`	int	`0`	$MISSING_FIELD
`"grocery stores"`	int	`0`	$MISSING_FIELD
`"hardware stores"`	int	`0`	$MISSING_FIELD
`"health and personal care stores"`	int	`0`	$MISSING_FIELD
`"hobby, toy, and game stores"`	int	`0`	$MISSING_FIELD
`"home furnishings stores"`	int	`0`	$MISSING_FIELD
`"household appliance stores"`	int	`0`	$MISSING_FIELD
`"jewelry stores"`	int	`0`	$MISSING_FIELD
`"limited service eating places"`	int	`0`	$MISSING_FIELD
`"men's clothing stores"`	int	`0`	$MISSING_FIELD
`"miscellaneous store retailers"`	int	`0`	$MISSING_FIELD
`"motor vehicle and parts dealers"`	int	`62619`	$MISSING_FIELD
`"new car dealers"`	int	`0`	$MISSING_FIELD
`"non-discount department stores"`	int	`0`	$MISSING_FIELD
`"non-leased department stores"`	int	`33798`	$MISSING_FIELD
`"nonstore retailers"`	int	`0`	$MISSING_FIELD
`"office supplies and stationery stores"`	int	`0`	$MISSING_FIELD
`"office supplies, stationery, and gift stores"`	int	`0`	$MISSING_FIELD
`"other clothing stores"`	int	`0`	$MISSING_FIELD
`"other general merchandise stores"`	int	`0`	$MISSING_FIELD
`"paint and wallpaper stores"`	int	`0`	$MISSING_FIELD
`"pharmacies and drug stores"`	int	`0`	$MISSING_FIELD
`"radio, TV, and electronics stores"`	int	`0`	$MISSING_FIELD
`"retail trade"`	int	`235509`	$MISSING_FIELD
`"retail trade and food services"`	int	`0`	$MISSING_FIELD
`"retail trade and food services, ex auto"`	int	`0`	$MISSING_FIELD
`"retail trade, ex auto"`	int	`172890`	$MISSING_FIELD
`"shoe stores"`	int	`0`	$MISSING_FIELD
`"sporting goods stores"`	int	`0`	$MISSING_FIELD
`"sporting goods, hobby, book, and music stores"`	int	`0`	$MISSING_FIELD
`"supermarkets and other grocery (except convenience) stores"`	int	`0`	$MISSING_FIELD
`"used car dealers"`	int	`0`	$MISSING_FIELD
`"used merchandise stores"`	int	`0`	$MISSING_FIELD
`"warehouse clubs and superstores"`	int	`0`	$MISSING_FIELD
`"women's clothing stores"`	int	`0`	$MISSING_FIELD

Key	Type	Example Value	Description
`"all department stores"`	int	`0`	$MISSING_FIELD
`"all other home furnishings stores"`	int	`0`	$MISSING_FIELD
`"all other merchandise stores"`	int	`0`	$MISSING_FIELD
`"appliances and other electronics stores"`	int	`0`	$MISSING_FIELD
`"auto and other motor vehicles"`	int	`0`	$MISSING_FIELD
`"automobile dealers"`	int	`0`	$MISSING_FIELD
`"automotive parts and tire stores"`	int	`0`	$MISSING_FIELD
`"beer, wine, and liquor stores"`	int	`0`	$MISSING_FIELD
`"book stores"`	int	`0`	$MISSING_FIELD
`"building materials and garden supplies dealers"`	float	`2.18`	$MISSING_FIELD
`"building supplies dealers"`	int	`0`	$MISSING_FIELD
`"clothing stores"`	float	`3.26`	$MISSING_FIELD
`"computer and software stores"`	int	`0`	$MISSING_FIELD
`"discount department stores"`	int	`0`	$MISSING_FIELD
`"drinking places"`	int	`0`	$MISSING_FIELD
`"electronic shopping and mail-order houses"`	int	`0`	$MISSING_FIELD
`"electronics and appliance stores"`	int	`0`	$MISSING_FIELD
`"family clothing stores"`	int	`0`	$MISSING_FIELD
`"floor covering stores"`	int	`0`	$MISSING_FIELD
`"food and beverage stores"`	float	`0.91`	$MISSING_FIELD
`"food services and drinking places"`	int	`0`	$MISSING_FIELD
`"fuel dealers"`	int	`0`	$MISSING_FIELD
`"full service restaurants"`	int	`0`	$MISSING_FIELD
`"furniture and home furnishings stores"`	int	`0`	$MISSING_FIELD
`"furniture stores"`	int	`0`	$MISSING_FIELD
`"furniture, home furn, electronics, and appliance stores"`	float	`1.95`	$MISSING_FIELD
`"gafo"`	int	`0`	$MISSING_FIELD
`"gasoline stations"`	int	`0`	$MISSING_FIELD
`"general merchandise stores"`	float	`2.92`	$MISSING_FIELD
`"gift, novelty, and souvenir stores"`	int	`0`	$MISSING_FIELD
`"grocery stores"`	int	`0`	$MISSING_FIELD
`"hardware stores"`	int	`0`	$MISSING_FIELD
`"health and personal care stores"`	int	`0`	$MISSING_FIELD
`"hobby, toy, and game stores"`	int	`0`	$MISSING_FIELD
`"home furnishings stores"`	int	`0`	$MISSING_FIELD
`"household appliance stores"`	int	`0`	$MISSING_FIELD
`"jewelry stores"`	int	`0`	$MISSING_FIELD
`"limited service eating places"`	int	`0`	$MISSING_FIELD
`"men's clothing stores"`	int	`0`	$MISSING_FIELD
`"miscellaneous store retailers"`	int	`0`	$MISSING_FIELD
`"motor vehicle and parts dealers"`	float	`2.1`	$MISSING_FIELD
`"new car dealers"`	int	`0`	$MISSING_FIELD
`"non-discount department stores"`	int	`0`	$MISSING_FIELD
`"non-leased department stores"`	float	`3.28`	$MISSING_FIELD
`"nonstore retailers"`	int	`0`	$MISSING_FIELD
`"office supplies and stationery stores"`	int	`0`	$MISSING_FIELD
`"office supplies, stationery, and gift stores"`	int	`0`	$MISSING_FIELD
`"other clothing stores"`	int	`0`	$MISSING_FIELD
`"other general merchandise stores"`	int	`0`	$MISSING_FIELD
`"paint and wallpaper stores"`	int	`0`	$MISSING_FIELD
`"pharmacies and drug stores"`	int	`0`	$MISSING_FIELD
`"radio, TV, and electronics stores"`	int	`0`	$MISSING_FIELD
`"retail trade"`	float	`1.8`	$MISSING_FIELD
`"retail trade and food services"`	int	`0`	$MISSING_FIELD
`"retail trade and food services, ex auto"`	int	`0`	$MISSING_FIELD
`"retail trade, ex auto"`	float	`1.71`	$MISSING_FIELD
`"shoe stores"`	int	`0`	$MISSING_FIELD
`"sporting goods stores"`	int	`0`	$MISSING_FIELD
`"sporting goods, hobby, book, and music stores"`	int	`0`	$MISSING_FIELD
`"supermarkets and other grocery (except convenience) stores"`	int	`0`	$MISSING_FIELD
`"used car dealers"`	int	`0`	$MISSING_FIELD
`"used merchandise stores"`	int	`0`	$MISSING_FIELD
`"warehouse clubs and superstores"`	int	`0`	$MISSING_FIELD
`"women's clothing stores"`	int	`0`	$MISSING_FIELD

Key	Type	Example Value	Description
`"all department stores"`	int	`10560`	$MISSING_FIELD
`"all other home furnishings stores"`	int	`0`	$MISSING_FIELD
`"all other merchandise stores"`	int	`2111`	$MISSING_FIELD
`"appliances and other electronics stores"`	int	`2142`	$MISSING_FIELD
`"auto and other motor vehicles"`	int	`26788`	$MISSING_FIELD
`"automobile dealers"`	int	`25800`	$MISSING_FIELD
`"automotive parts and tire stores"`	int	`3023`	$MISSING_FIELD
`"beer, wine, and liquor stores"`	int	`1509`	$MISSING_FIELD
`"book stores"`	int	`790`	$MISSING_FIELD
`"building materials and garden supplies dealers"`	int	`8964`	$MISSING_FIELD
`"building supplies dealers"`	int	`7637`	$MISSING_FIELD
`"clothing stores"`	int	`4852`	$MISSING_FIELD
`"computer and software stores"`	int	`933`	$MISSING_FIELD
`"discount department stores"`	int	`5601`	$MISSING_FIELD
`"drinking places"`	int	`1049`	$MISSING_FIELD
`"electronic shopping and mail-order houses"`	int	`2692`	$MISSING_FIELD
`"electronics and appliance stores"`	int	`3241`	$MISSING_FIELD
`"family clothing stores"`	int	`1649`	$MISSING_FIELD
`"floor covering stores"`	int	`728`	$MISSING_FIELD
`"food and beverage stores"`	int	`29589`	$MISSING_FIELD
`"food services and drinking places"`	int	`15693`	$MISSING_FIELD
`"fuel dealers"`	int	`1916`	$MISSING_FIELD
`"full service restaurants"`	int	`6887`	$MISSING_FIELD
`"furniture and home furnishings stores"`	int	`3846`	$MISSING_FIELD
`"furniture stores"`	int	`2392`	$MISSING_FIELD
`"furniture, home furn, electronics, and appliance stores"`	int	`7087`	$MISSING_FIELD
`"gafo"`	int	`33906`	$MISSING_FIELD
`"gasoline stations"`	int	`12099`	$MISSING_FIELD
`"general merchandise stores"`	int	`14996`	$MISSING_FIELD
`"gift, novelty, and souvenir stores"`	int	`658`	$MISSING_FIELD
`"grocery stores"`	int	`27306`	$MISSING_FIELD
`"hardware stores"`	int	`842`	$MISSING_FIELD
`"health and personal care stores"`	int	`7258`	$MISSING_FIELD
`"hobby, toy, and game stores"`	int	`620`	$MISSING_FIELD
`"home furnishings stores"`	int	`1454`	$MISSING_FIELD
`"household appliance stores"`	int	`601`	$MISSING_FIELD
`"jewelry stores"`	int	`796`	$MISSING_FIELD
`"limited service eating places"`	int	`6438`	$MISSING_FIELD
`"men's clothing stores"`	int	`701`	$MISSING_FIELD
`"miscellaneous store retailers"`	int	`3642`	$MISSING_FIELD
`"motor vehicle and parts dealers"`	int	`29811`	$MISSING_FIELD
`"new car dealers"`	int	`24056`	$MISSING_FIELD
`"non-discount department stores"`	int	`4959`	$MISSING_FIELD
`"non-leased department stores"`	int	`10306`	$MISSING_FIELD
`"nonstore retailers"`	int	`6860`	$MISSING_FIELD
`"office supplies and stationery stores"`	int	`788`	$MISSING_FIELD
`"office supplies, stationery, and gift stores"`	int	`1446`	$MISSING_FIELD
`"other clothing stores"`	int	`0`	$MISSING_FIELD
`"other general merchandise stores"`	int	`4690`	$MISSING_FIELD
`"paint and wallpaper stores"`	int	`0`	$MISSING_FIELD
`"pharmacies and drug stores"`	int	`6358`	$MISSING_FIELD
`"radio, TV, and electronics stores"`	int	`1541`	$MISSING_FIELD
`"retail trade"`	int	`130683`	$MISSING_FIELD
`"retail trade and food services"`	int	`146376`	$MISSING_FIELD
`"retail trade and food services, ex auto"`	int	`116565`	$MISSING_FIELD
`"retail trade, ex auto"`	int	`100872`	$MISSING_FIELD
`"shoe stores"`	int	`1206`	$MISSING_FIELD
`"sporting goods stores"`	int	`972`	$MISSING_FIELD
`"sporting goods, hobby, book, and music stores"`	int	`3439`	$MISSING_FIELD
`"supermarkets and other grocery (except convenience) stores"`	int	`0`	$MISSING_FIELD
`"used car dealers"`	int	`1744`	$MISSING_FIELD
`"used merchandise stores"`	int	`371`	$MISSING_FIELD
`"warehouse clubs and superstores"`	int	`2579`	$MISSING_FIELD
`"women's clothing stores"`	int	`1873`	$MISSING_FIELD

Downloads

Download all of the following files.

Usage

import retail_services
report = retail_services.get_report()

Documentation

get_report(): Returns a list of dictionaries representing report.