Monthly Patterns corresponds to the SafeGraph Patterns dataset. It represents the place traffic and demographic aggregations that answer questions like "how often people visit", "how long they stay", "where they came from", "where else they go", and more. Available for ~4.4MM POI.

The API currently returns the most recent month of patterns data for the POI in your query.

query {
  lookup(placekey: "[email protected]") {
    safegraph_monthly_patterns {
      placekey
      parent_placekey
      location_name
      street_address
      city
      region
      postal_code
      iso_country_code
      brands {
        brand_id
        brand_name
      }
      date_range_start
      date_range_end
      raw_visit_counts
      raw_visitor_counts
      visits_by_day
      poi_cbg
      popularity_by_hour
      visitor_home_cbgs
      visitor_home_aggregation
      visitor_daytime_cbgs
      visitor_country_of_origin
      distance_from_home
      bucketed_dwell_times
      median_dwell
      related_same_day_brand
      related_same_month_brand
      popularity_by_day
      device_type
    }
  }
}
{
  "data": {
    "lookup": {
      "safegraph_monthly_patterns": {
        "placekey": "[email protected]",
        "parent_placekey": null,
        "location_name": "McDonald's",
        "street_address": "1100 Fillmore St",
        "city": "San Francisco",
        "region": "CA",
        "postal_code": "94115",
        "iso_country_code": "US",
        "brands": [
          {
            "brand_id": "SG_BRAND_5179b21fc1d50950b99b4eecaa48c614",
            "brand_name": "mcdonalds restaurants"
          }
        ],
        "date_range_start": "2021-10-01T00:00:00-07:00",
        "date_range_end": "2021-11-01T00:00:00-07:00",
        "raw_visit_counts": 626,
        "raw_visitor_counts": 403,
        "visits_by_day": [
          21,
          37,
          19,
          16,
          11,
          15,
          15,
          16,
          26,
          18,
          14,
          14,
          11,
          16,
          26,
          18,
          19,
          23,
          25,
          13,
          21,
          29,
          31,
          19,
          14,
          21,
          15,
          19,
          26,
          28,
          30
        ],
        "poi_cbg": "060750161003",
        "popularity_by_hour": [
          54,
          48,
          31,
          29,
          19,
          17,
          13,
          24,
          50,
          49,
          61,
          43,
          48,
          48,
          33,
          31,
          34,
          48,
          53,
          37,
          39,
          43,
          42,
          51
        ],
        "visitor_home_cbgs": {
          "060750161004": 13,
          "060750157004": 8,
          "060759806001": 7,
          "370210032023": 6,
          "060750178021": 6,
          "060750161002": 5,
          "060372966003": 5,
          "060990009101": 5,
          "060750427001": 5,
          "530330303083": 4,
          "060750326021": 4,
          "060816026003": 4,
          "060133310002": 4,
          "060750126011": 4,
          "061150408001": 4,
          "060750230031": 4,
          "060133451121": 4,
          "060750353006": 4,
          "060750134002": 4,
          "060190050002": 4,
          "060014094003": 4,
          "210930004003": 4,
          "060750426023": 4,
          "060816085014": 4,
          "060133591051": 4,
          "060750163003": 4,
          "270531099002": 4,
          "060750231021": 4,
          "060750601001": 4,
          "060530004001": 4,
          "060750302022": 4,
          "060750206001": 4,
          "060133760004": 4,
          "060816060001": 4,
          "060014416013": 4,
          "060750615001": 4,
          "060730150003": 4,
          "060750478021": 4,
          "060014062023": 4,
          "060014054013": 4,
          "060290031232": 4,
          "060750228011": 4,
          "060670074281": 4,
          "061130105081": 4,
          "530630131002": 4,
          "060750301013": 4,
          "060855044102": 4,
          "060014088001": 4,
          "060816024002": 4,
          "060750121001": 4,
          "060371043203": 4,
          "060855031183": 4,
          "120950171032": 4,
          "060750451001": 4,
          "060750179021": 4,
          "060750158013": 4,
          "060952506013": 4,
          "060133072051": 4,
          "060750157003": 4,
          "060750234002": 4,
          "060378004101": 4,
          "060750176012": 4,
          "060133362011": 4,
          "060816011004": 4,
          "060710100222": 4,
          "060750158011": 4,
          "060750301011": 4,
          "060014061002": 4,
          "060816010003": 4,
          "060750159001": 4,
          "060750161003": 4,
          "060750226001": 4,
          "060750161001": 4,
          "060750158012": 4,
          "060750452002": 4,
          "060014066011": 4
        },
        "visitor_home_aggregation": {
          "06075016100": 20,
          "06075015801": 10,
          "06075015700": 9,
          "06081602600": 7,
          "06075017601": 7,
          "06013340002": 6,
          "06075023400": 6,
          "06073018610": 5,
          "06099002702": 5,
          "06075045100": 5,
          "06075035201": 5,
          "04013113700": 4,
          "06081606000": 4,
          "06001406601": 4,
          "04013422606": 4,
          "21093000400": 4,
          "06085500600": 4,
          "06067008144": 4,
          "06075010800": 4,
          "06001432400": 4,
          "06075033204": 4,
          "06001405100": 4,
          "06075061400": 4,
          "06075012601": 4,
          "06001436300": 4,
          "06001408800": 4,
          "06075030101": 4,
          "06013376000": 4,
          "06075023003": 4,
          "06095250601": 4,
          "06081608501": 4,
          "06075042700": 4,
          "06071010022": 4,
          "06001401100": 4,
          "06075016300": 4,
          "06115040800": 4,
          "06075016000": 4,
          "06019005000": 4,
          "06001451404": 4,
          "06013382000": 4,
          "06075017902": 4,
          "06075015900": 4,
          "06001402700": 4,
          "06075010900": 4,
          "49035113701": 4,
          "06053000400": 4,
          "06013371000": 4,
          "06075032601": 4,
          "06075015300": 4,
          "53033030308": 4,
          "06075045200": 4,
          "06001422800": 4,
          "15007040205": 4,
          "06067007428": 4,
          "06075030301": 4,
          "06099000404": 4,
          "06075017700": 4,
          "06073015704": 4,
          "06067007007": 4,
          "06085503337": 4,
          "06001409400": 4,
          "06081605300": 4,
          "06075016900": 4,
          "06075033201": 4,
          "06085501600": 4,
          "06075012502": 4,
          "06075013400": 4,
          "06075015400": 4,
          "06037296600": 4,
          "06001403502": 4,
          "06075012302": 4,
          "06075040200": 4,
          "06037571102": 4,
          "06013314103": 4,
          "06075020600": 4,
          "06081600500": 4,
          "06075040100": 4,
          "06075060400": 4,
          "06095250105": 4
        },
        "visitor_daytime_cbgs": {
          "060750161004": 10,
          "060816038022": 9,
          "060750158013": 7,
          "060855005002": 6,
          "060750157003": 6,
          "060750161003": 6,
          "060411290002": 6,
          "060750427001": 6,
          "060750105001": 6,
          "482015205003": 5,
          "060816083001": 5,
          "060750451001": 5,
          "060750332011": 5,
          "060750157004": 5,
          "060750158012": 5,
          "060855050062": 4,
          "060014051003": 4,
          "060750206001": 4,
          "060670074242": 4,
          "060750178022": 4,
          "060750121001": 4,
          "060670084031": 4,
          "060750159002": 4,
          "060855052031": 4,
          "060750134003": 4,
          "060750302022": 4,
          "060816009001": 4,
          "060750161001": 4,
          "060133080013": 4,
          "060133640023": 4,
          "060990008033": 4,
          "060750122021": 4,
          "060014321002": 4,
          "060750601001": 4,
          "060750604001": 4,
          "060816053004": 4,
          "060750157001": 4,
          "060014035021": 4,
          "060816026003": 4,
          "060750201001": 4,
          "060133451121": 4,
          "060855085042": 4,
          "060750230031": 4,
          "060750124022": 4,
          "060014225003": 4,
          "060816042003": 4,
          "060133592043": 4,
          "060750452002": 4,
          "040134226063": 4,
          "060290031231": 4,
          "060750353006": 4,
          "060450116002": 4,
          "060372966003": 4,
          "060750202003": 4,
          "060290038042": 4,
          "060019832001": 4,
          "060750105002": 4,
          "060750153002": 4,
          "060014363002": 4,
          "060014088003": 4,
          "060816022002": 4,
          "060750133003": 4,
          "530330303083": 4,
          "060750176012": 4,
          "060133591051": 4,
          "060014093003": 4,
          "060750478011": 4,
          "060750166001": 4,
          "060750121002": 4,
          "060750234002": 4,
          "060014062023": 4,
          "060750162002": 4,
          "060750110002": 4,
          "210930004003": 4,
          "060816044002": 4,
          "060750176015": 4,
          "060750101002": 4,
          "060750479012": 4,
          "060670081442": 4,
          "550630101023": 4,
          "060750125021": 4
        },
        "visitor_country_of_origin": {
          "US": 380
        },
        "distance_from_home": 8487,
        "bucketed_dwell_times": {
          "<5": 26,
          "5-10": 406,
          "11-20": 79,
          "21-60": 77,
          "61-120": 15,
          "121-240": 9,
          ">240": 14
        },
        "median_dwell": 9,
        "related_same_day_brand": {
          "ARCO": 6,
          "Shell Oil": 5,
          "Chevron": 5,
          "Starbucks": 5,
          "Target": 4,
          "Safeway": 4,
          "ampm": 3,
          "Popeyes Louisiana Kitchen": 3,
          "Safeway Pharmacy": 3,
          "Costco": 2,
          "Chevron Extra Mile": 2,
          "7-Eleven": 2,
          "Walgreens": 2,
          "Peet's Coffee and Tea": 1,
          "Travelodge": 1,
          "Walgreens Pharmacy": 1,
          "Jack in the Box": 1,
          "Subway": 1,
          "Ross Stores": 1,
          "KFC": 1
        },
        "related_same_month_brand": {
          "Starbucks": 48,
          "Chevron": 42,
          "Shell Oil": 42,
          "Target": 38,
          "ARCO": 36,
          "Costco": 35,
          "Safeway": 30,
          "Jack in the Box": 29,
          "Walmart": 25,
          "In-N-Out Burger": 23,
          "7-Eleven": 22,
          "Ross Stores": 22,
          "Burger King": 22,
          "Safeway Pharmacy": 22,
          "Subway": 21,
          "Popeyes Louisiana Kitchen": 21,
          "Taco Bell": 20,
          "Chevron Extra Mile": 20,
          "Walgreens Pharmacy": 19,
          "Walgreens": 19
        },
        "popularity_by_day": {
          "Monday": 67,
          "Tuesday": 71,
          "Wednesday": 54,
          "Thursday": 71,
          "Friday": 118,
          "Saturday": 140,
          "Sunday": 105
        },
        "device_type": {
          "android": 153,
          "ios": 249
        }
      }
    }
  },
  "extensions": {
    "row_count": 1,
    "version_date": "1635494405__2021_10"
  }
}