v2.1 Bulk Query Data

Use Case: Using Geopath Saved Queries to download bulk data

The Geopath API also provides a bulk file download option that provides the full inventory/search response as a single JSON file for a set of pre-determined measures. Below is a list of current files and how to retrieve them.

• You will need to provide your Geopath API key in the header of your request to the URL. The query id, which can be used within the GET /inventory/search/{search_id}, is within the URLs below after the “/datasets” portion of the URL.

• You will need to stream and download the results of the request, as it will be too large for most programs.

  • In CURL, you can use the -O option to send the result to a specified file name. A full CURL sample:

    curl -X GET https://assets.geopath.io/datasets/BCB35ADFA030782E08699E57631093C6.json.zip -H "Cache-Control: no-cache" -H "Content-Type: application/json" -H "Geopath-API-Key: YOURAPIKEY" -o /DOWNLOAD/PATH/Folder/all_classification_published_nomeasures_2022_02_21.json.zip

  • In Postman, you can use the "Send and Download" option to download the zip file. 

• The description below details what's included within the inventory search and the date it was made. These are the current to the most recent measures release. 

• For more information on the difference between the PopFacts and Transport Foundry base data, please read this Geopath announcement. 

• The following bulk files contain data for the 2021 Mid Year Forecast ("2021r1") using the PopFacts data. 

  • all_classification_published_nomeasures
    https://assets.geopath.io/datasets/BCB35ADFA030782E08699E57631093C6.json.zip

  • all_classification_published_0plus_2021R1
    https://assets.geopath.io/datasets/1C5B978842C531CD7B7835A1BF9E854E.json.zip

  • all_classification_published_0plus_2021R1(LOCAL DMA TARGET MARKET)
    https://assets.geopath.io/datasets/E0D498EB924644A24883648188728EBD.json.zip

  • all_classification_published_5plus_2021R1
    https://assets.geopath.io/datasets/AF2FA7D100148F35BCE0648D4F3C937D.json.zip

  • all_classification_published_5plus_2021R1 (LOCAL DMA TARGET MARKET)
    https://assets.geopath.io/datasets/6DC551DFC82660D508406BE2B07B2888.json.zip

  • all_classification_published_18plus_2021R1
    https://assets.geopath.io/datasets/58D206FF7A3D8BB8F31BC0DDF36AEE5B.json.zip

  • all_classification_published_18plus_2021R1 (LOCAL DMA TARGET MARKET)
    https://assets.geopath.io/datasets/A15D06892FB869C57502CE4D6A774B0D.json.zip

  • all_classification_published_18plus_2021R1 (LOCAL DMA TARGET MARKET) (14 DAY PERIOD)
    https://assets.geopath.io/datasets/7B6AB459A6EC03DA8B7F775BE62A392B.json.zip

  • all_classification_published_18plus_2021R1 (LOCAL DMA TARGET MARKET) (84 DAY PERIOD)
    https://assets.geopath.io/datasets/0F307B56ED85521B8CACDEF99EB8C22D.json.zip

  • all_classification_published_21plus_2021R1 
    https://assets.geopath.io/datasets/C5FEC446EC322EF2578A614681DCB6FF.json.zip

  • all_classification_published_21plus_2021R1 (LOCAL DMA TARGET MARKET)
    https://assets.geopath.io/datasets/6346548DB32348900FDD246579439D89.json.zip

  • all_classification_published_21plus_2021R1 (LOCAL DMA TARGET MARKET) (14 DAY PERIOD)
    https://assets.geopath.io/datasets/087F700BA2D4486087F3E8A1E33AC1C7.json.zip

  • all_classification_published_21plus_2021R1 (LOCAL DMA TARGET MARKET) (84 DAY PERIOD)
    https://assets.geopath.io/datasets/8310662EA3FACE9A4064343AA49EC89F.json.zip

• The following bulk files contain data for the 2021 Mid Year Forecast ("2021r1") using the Transport Foundry combined demographic data. 

  • all_classification_published_0plus_2021R1_EXCLUDES_GROUP_QUARTERS
    https://assets.geopath.io/datasets/FAA4030342CD5FF62C917266211E54BF.json.zip

  • all_classification_published_0plus_2021R1_EXCLUDES_GROUP_QUARTERS (LOCAL DMA TARGET MARKET)
    https://assets.geopath.io/datasets/9F419978D903B80893232BD39E61F489.json.zip

  • all_classification_published_5plus_2021R1_EXCLUDES_GROUP_QUARTERS
    https://assets.geopath.io/datasets/28ED672153ECB7F76C576DDF78620EDD.json.zip

  • all_classification_published_5plus_2021R1_EXCLUDES_GROUP_QUARTERS (LOCAL DMA TARGET MARKET)
    https://assets.geopath.io/datasets/468A3E3994F2F99FD47AFC3047E3EA02.json.zip

  • all_classification_published_18plus_2021R1_EXCLUDES_GROUP_QUARTERS
    https://assets.geopath.io/datasets/3919F4AC35061911339421406A984891.json.zip

  • all_classification_published_18plus_2021R1_EXCLUDES_GROUP_QUARTERS (LOCAL DMA TARGET MARKET)
    https://assets.geopath.io/datasets/68EE6D4DEA60A6ACAC0BF56BF1FDEFCB.json.zip

  • all_classification_published_18plus_2021R1_EXCLUDES_GROUP_QUARTERS (LOCAL DMA TARGET MARKET) (14 DAY PERIOD)
    https://assets.geopath.io/datasets/FF3458B143513E13576E5297D96E8CAC.json.zip

  • all_classification_published_18plus_2021R1_EXCLUDES_GROUP_QUARTERS (LOCAL DMA TARGET MARKET) (84 DAY PERIOD)
    https://assets.geopath.io/datasets/D2EDE2887337C215949355426BD08BBA.json.zip

  • all_classification_published_21plus_2021R1_EXCLUDES_GROUP_QUARTERS
    https://assets.geopath.io/datasets/FD9E64ABED042863BFDA276496527ED5.json.zip

  • all_classification_published_21plus_2021R1_EXCLUDES_GROUP_QUARTERS (LOCAL DMA TARGET MARKET)
    https://assets.geopath.io/datasets/0286EA3354A458EE3F946EDEE2A7D70C.json.zip

  • all_classification_published_21plus_2021R1_EXCLUDES_GROUP_QUARTERS (LOCAL DMA TARGET MARKET) (14 DAY PERIOD)
    https://assets.geopath.io/datasets/B6E4E62F562C2AC3D798A3CB6785039B.json.zip

  • all_classification_published_21plus_2021R1_EXCLUDES_GROUP_QUARTERS (LOCAL DMA TARGET MARKET) (84 DAY PERIOD)
    https://assets.geopath.io/datasets/7F85A43C11ADF5A1CCA065AB1E4A2C0E.json.zip

• Note: the 2021 Midyear forecast became the default API response on 6/21/2021.