Delivery File Structure

Places File Delivery

Once we receive the name of your configured S3 bucket, SafeGraph will begin to deliver data once per month formatted per the SafeGraph Places schema. Please note we may push updates more frequently on occasion in the case of an urgent bug fix.

  • If you are an enterprise customer, SafeGraph products are delivered (together) by 7th of the month. But we target the 1st if its a business day.
    • Up to 5 file paths will be delivered with the following structure: s3://customer-bucket/customer-prefix/{{sg-file-name}}/yyyy/mm/dd/hh/*.csv.gz. {{sg-file-name}} is one of the following:
      • core_poi, geometry, or some combination like core_poi-geometry (depending on your subscription) includes all of the following to which you are subscribed: Places, Geometry,.
      • brand_info (if subscribed to Places)

The files are sent as gzipped CSVs. Given that our data deliveries contain a lot of data we break up the delivery into multiple small files. Let us know if this doesn't make the process easier on your side!

See also Column Ordering.

Delivery Frequency

  • Customers who license Places or Geometry get monthly deliveries