DataExport API

This API allows you to export data in CSV and JSON formats. Below are some quick examples on exporting data.

JSON Export

Call Structure

 GET http://cache.getdata.io/:DATA_SOURCE_UNIQUE_ID/:TIMESTAMP_page_:PAGE.json

Supported Params

DATA_SOURCE_UNIQUE_ID Required String The unique identifier of a data source
TIMESTAMP RequiredString The unique key for the batch of data to export. The following 2 formats are supported:
  • Alias for latest batch - latest
  • UTC Time Stamp - 1504672889
If you are integrating your application via the webhook API, this value would correspond to the batch_time_sec value in the POST request
PAGE Requiredinteger Starts from 1. This call retrieves 100 records per page

Sample JSON Request - latest

 GET http://cache.getdata.io/n4076_6aed56fa5e69cf09baf536360ec06f95eses/latest_page_1.json

Sample JSON Response

{
  "total": 300,
  "timestamp": "2017-09-06 04:41:29 UTC",
  "pagination": {
    "current_page": 2,
    "per_page": 3,
    "total_pages": 100,
    "next_page": "http://cache.getdata.io/n3647_8e3b0a7ffba377a7eddd5419034adc5feses/latest_page_1.json",
    "prev_page": "http://cache.getdata.io/n3647_8e3b0a7ffba377a7eddd5419034adc5feses/latest_page_3.json"
  },
  "results": [{
    "address": "2402 E Esplanade Ln, Phoenix, AZ 85016 ",
    "neighborhood": "Camelback East",
    "origin_pattern": "https://www.zillow.com/homedetails/2402-E-Esplanade-Ln-Phoenix-AZ-85016/59267938_zpid/",
    "createdAt": "2017-09-06 04:41:29 UTC",
    "updatedAt": "2017-09-06 04:41:29 UTC",
    "pingedAt": "2017-09-06 04:41:29 UTC"
  }, {
    "address": "251 E Esplanade Ln, Phoenix, AZ 85016 ",
    "neighborhood": "Camelback East",
    "origin_pattern": "https://www.zillow.com/homedetails/2402-E-Esplanade-Ln-Phoenix-AZ-85016/59267938_zpid/",
    "createdAt": "2017-09-06 04:41:29 UTC",
    "updatedAt": "2017-09-06 04:41:29 UTC",
    "pingedAt": "2017-09-06 04:41:29 UTC"
  }, {
    "address": "300 E Esplanade Ln, Phoenix, AZ 85016 ",
    "neighborhood": "Camelback East",
    "origin_pattern": "https://www.zillow.com/homedetails/2402-E-Esplanade-Ln-Phoenix-AZ-85016/59267938_zpid/",
    "createdAt": "2017-09-06 04:41:29 UTC",
    "updatedAt": "2017-09-06 04:41:29 UTC",
    "pingedAt": "2017-09-06 04:41:29 UTC"
  },
  ...]
}


Sample JSON Request - UTC Time Stamp

 GET http://cache.getdata.io/n4076_6aed56fa5e69cf09baf536360ec06f95eses/1504672889_page_1.json

Sample JSON Response

{
  "total": 300,
  "timestamp": "2017-09-06 04:41:29 UTC",
  "pagination": {
    "current_page": 2,
    "per_page": 3,
    "total_pages": 100,
    "next_page": "http://cache.getdata.io/n3647_8e3b0a7ffba377a7eddd5419034adc5feses/1504672889_page_1.json",
    "prev_page": "http://cache.getdata.io/n3647_8e3b0a7ffba377a7eddd5419034adc5feses/1504672889_page_3.json"
  },
  "results": [{
    "address": "2402 E Esplanade Ln, Phoenix, AZ 85016 ",
    "neighborhood": "Camelback East",
    "origin_pattern": "https://www.zillow.com/homedetails/2402-E-Esplanade-Ln-Phoenix-AZ-85016/59267938_zpid/",
    "createdAt": "2017-09-06 04:41:29 UTC",
    "updatedAt": "2017-09-06 04:41:29 UTC",
    "pingedAt": "2017-09-06 04:41:29 UTC"
  }, {
    "address": "251 E Esplanade Ln, Phoenix, AZ 85016 ",
    "neighborhood": "Camelback East",
    "origin_pattern": "https://www.zillow.com/homedetails/2402-E-Esplanade-Ln-Phoenix-AZ-85016/59267938_zpid/",
    "createdAt": "2017-09-06 04:41:29 UTC",
    "updatedAt": "2017-09-06 04:41:29 UTC",
    "pingedAt": "2017-09-06 04:41:29 UTC"
  }, {
    "address": "300 E Esplanade Ln, Phoenix, AZ 85016 ",
    "neighborhood": "Camelback East",
    "origin_pattern": "https://www.zillow.com/homedetails/2402-E-Esplanade-Ln-Phoenix-AZ-85016/59267938_zpid/",
    "createdAt": "2017-09-06 04:41:29 UTC",
    "updatedAt": "2017-09-06 04:41:29 UTC",
    "pingedAt": "2017-09-06 04:41:29 UTC"
  },
  ...]
}

CSV Export

Call Structure

 GET http://cache.getdata.io/:DATA_SOURCE_UNIQUE_ID/:TIMESTAMP_all.csv

Supported Params

DATA_SOURCE_UNIQUE_ID Required String The unique identifier of a data source
TIMESTAMP RequiredString The unique key for the batch of data to export. The following 2 formats are supported:
  • Alias for latest batch - latest
  • UTC Time Stamp - 1504672889
If you are integrating your application via the webhook API, this value would correspond to the batch_time_sec value in the POST request

Sample CSV Request - latest

GET http://cache.getdata.io/n4076_6aed56fa5e69cf09baf536360ec06f95eses/latest_all.csv

Sample CSV Response

address,neighborhood,createdAt,updatedAt,pingedAt
"2402 E Esplanade Ln, Phoenix, AZ 85016 ",Bay Area,2017-09-06 04:41:29 UTC,2017-09-06 04:41:29 UTC,2017-09-06 04:41:29 UTC
1101 Valencia Road San Francisco,Bay Area,2017-09-06 04:41:29 UTC,2017-09-06 04:41:29 UTC,2017-09-06 04:41:29 UTC
"333 King Street, New Jersey",Bay Area,2017-09-06 04:41:29 UTC,2017-09-06 04:41:29 UTC,2017-09-06 04:41:29 UTC
"256 Cupertino Road, Cupertino",Bay Area,2017-09-06 04:41:29 UTC,2017-09-06 04:41:29 UTC,2017-09-06 04:41:29 UTC
111 Union Square,Bay Area,2017-09-06 04:41:29 UTC,2017-09-06 04:41:29 UTC,2017-09-06 04:41:29 UTC


Sample CSV Request - UTC Time Stamp

GET http://cache.getdata.io/n4076_6aed56fa5e69cf09baf536360ec06f95eses/1504672889_all.csv

Sample CSV Response

address,neighborhood,createdAt,updatedAt,pingedAt
"2402 E Esplanade Ln, Phoenix, AZ 85016 ",Bay Area,2017-09-06 04:41:29 UTC,2017-09-06 04:41:29 UTC,2017-09-06 04:41:29 UTC
1101 Valencia Road San Francisco,Bay Area,2017-09-06 04:41:29 UTC,2017-09-06 04:41:29 UTC,2017-09-06 04:41:29 UTC
"333 King Street, New Jersey",Bay Area,2017-09-06 04:41:29 UTC,2017-09-06 04:41:29 UTC,2017-09-06 04:41:29 UTC
"256 Cupertino Road, Cupertino",Bay Area,2017-09-06 04:41:29 UTC,2017-09-06 04:41:29 UTC,2017-09-06 04:41:29 UTC
111 Union Square,Bay Area,2017-09-06 04:41:29 UTC,2017-09-06 04:41:29 UTC,2017-09-06 04:41:29 UTC

More resources

To find out more about how GetData.IO works