The SafeGraph Developer Hub

Welcome to the SafeGraph developer hub. You'll find comprehensive guides and documentation to help you start working with SafeGraph as quickly as possible, as well as support if you get stuck. Let's jump right in!

Get Started    

Neighborhood Patterns

Overview

SafeGraph Neighborhood Patterns contains aggregated footfall data for each census block group. Use the data to answers:

  • Which day of the week is this CBG busiest?
  • When during the day is this CBG busy?
  • What brands are popular in this CBG?
  • Where do people who visit this CBG travel from?

This data is ideal for site-selection use cases and other use cases where you need to understand how busy an area is and when it is busy.

One month of data (covering October 2018) is available for download for free at the SafeGraph Neighborhood Patterns page.

Schema

The SafeGraph Neighborhood Patterns dataset follows a similar format to the SafeGraph Places Patterns dataset.

Column Name Description Type Example
census_block_group The unique 12-digit FIPS code for the Census Block Group. Please note that some CBGs have leading zeroes. String 130890212151
date_range_start Start time for measurement period as a timestamp in UTC seconds. Long 1538352000
date_range_end End time for measurement period as a timestamp in UTC seconds. Long 1541030400
raw_visit_count Number of visits seen by our panel to this CBG during the date range. Integer 428840
raw_visitor_count Number of unique visitors seen by our panel to this POI during the date range. Integer 109161
visitor_home_cbgs This column lists all the origin home CBGs for devices that visited a destination in the CBG listed in the column census_block_group (the destination CBG). The number mapped to each home CBG indicates the number of visitors observed from this home CBG that visited census_block_group during this time period. Home CBGs with less than 50 visitors to census_block_group are not included. JSON {String:Int} {"130890212162":291,"131210101101":272,"131350502123":207,"131350506063":199,"130890212142":188,"131210115033":187,"130890211011":182,"130890212103":177,"131350505461":170,"131350506071":170,"130890212163":169,"131350501081":169,"131350502171":167,"131210101082":163,"130890212132":162,"130890212021":158,"130670313131":152,"131350502132":151,"131350506082":148,"130890212023":144,"132231201011":144,"131210101151":141,"131210102093":140,"131350506081":140,"131210102102":138,"130570905021":136,"131350506092":135,"132231201032":135,"131210101181":135, ..., ...,"130890222041":50}`
visitor_work_cbgs This column lists all the work-location CBGs for devices that visited a destination in the CBG listed in the column census_block_group (the destination CBG). The number mapped to each work CBG indicates the number of visitors observed with this work CBG that visited census_block_group during this time period. Work CBGs with less than 50 visitors to census_block_group are not included. JSON {String:Int} {"131210101101":987,"131210119002":450,"131210101151":447,"130890212163":396,"131210116211":300,"130670302292":282,"130590004023":278,"131350503103":261,"131210100011":251,"130890212023":247,"131210019002":246,"131210116113":230,"131350503082":207,"130890212103":206,"131210101233":201,"131210116153":198,"131210010012":185,"130890224022":185,"131350503061":183,"131210102043":182,"130890212092":182,"131210010021":177,"131210101222":169,"131210101211":167,"131210100023":166,"131350502121":156,"131210115031":143,"131210102062":142,"130670303321":141,"131210101133":138,"131210116143":137,"130890212091":136,"130670303201":136,"131350502151":131,"131210005001":129,"131210116253":124,"130670303391":124,"131210114211":122,"130670308002":120, ... , ... ,"131350502131":50}
distance_from_home Median distance from home traveled to CBG by visitors (of visitors whose home we have identified) in meters. Integer 29385
related_same_day_brand Brands that the visitors to this CBG visited on the same day as their visit to the CBG where customer overlap differs by at least 5% from the SafeGraph national average to these brands. Order by strength of difference and limited to top ten brands. Array ["QuikTrip","Chick-fil-A"]
related_same_month_brand Brands that the visitors to this CBG visited on the same month as their visit to the CBG where customer overlap differs by at least 5% from the SafeGraph national average. Order by strength of difference and limited to top ten brands. Array ["Chick-fil-A","QuikTrip","walmart","mcdonalds","starbucks","Shell Oil","Publix Super Markets","Waffle House","BP","Chevron"]
top_brands A list of the the top brands visited in the CBG during the time period. Limited to top 10 brands. Array ["Target","The Men's Wearhouse","Tommy Hilfiger","mcdonalds","T.J. Maxx","Embassy Suites Hotels","Seasons 52","Nordstrom Rack","PetSmart","Ross Stores"]
popularity_by_hour A mapping of hour of the day to the number of visits in each hour over the course of the date range in local time. Array [9877,8233,7520,7512,7992,11259,19885,29153,31278,34235,36753,41983,48438,48909,47167,48258,48485,47134,43544,37033,29193,22308,16456,12628]`
popularity_by_day A mapping of day of week to the number of visits on each day (local time) in the course of the date range. JSON {String:Integer} {"Monday":67078,"Tuesday":69055,"Wednesday":69458,"Thursday":56949,"Friday":60746,"Saturday":58506,"Sunday":47048}

Terms of Use

The one month sample of SafeGraph Neighborhood Patterns data is made available under the CC BY-SA 4.0 license.

Neighborhood Patterns


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.