Using the Data Viewer API

This feature is only available as a part of the Connections Add-on

The Data Viewer API allows you to stream data out of Landscape in .json format for use in other programs using Data Viewer. For example, you could feed new contact entries to your CRM platform, or use a program like Zapier to set up custom email alerts to your team whenever a new site visit is performed or task is added.

There is no API currently available for writing data to Landscape from a third party platform.

Setting it up

Once the Connections Add-on has been enabled for your account, you will be able to immediately use the feature. Contact support to enable a trial period if you'd like to explore whether you can make good use of it.

API Safety

Streaming data out of Landscape creates a direct link to your account data. Anyone with access to that link can then have access to that data. Be sure you understand the system you are linking to and exercise caution when utilizing this feature.

You should also rotate your API key on a regularly scheduled basis from the API menu in Settings > Integrations. This will require that you get new API urls using the method described below.

Using the API generator

First create or navigate to the view that you want to use. You can use this feature on any view that you create in Landscape.

Click on the three dots next to the 'Save' menu and select 'Get Landscape API Url'. Then click the 'Table Data' button provided to copy the url to your clipboard.

Any changes made to that view, such as adding fields, will be reflected in the url - no need to get a new one.

Tip: If you're using a program like Zapier to detect added records and send alerts, then you probably want to limit your view to only recently added objects by placing a floating date filter on the 'Created Date' field. Alternatively you could set the sort to have new results at the top. If new results are at the bottom of the list and the list is over 100 objects long, Zapier won't detect the change.

Technical details

Data is returned in the following manner

{
  "total": ###,
  "results": [
    {
      "Id": "5e440238a81d195b7cd86887",
      "[[Field1]]": "[[String]]",
      "[[Field2]]": "[[String]]",
      ...
    }
  ],
  "continuation": null or a 24 digit number
}

Pagination

Only the first 100 results will be returned from the first call to the API. If the total field indicates that there are more than 100, you can use the the Id in the continuation field to get the next set of 100 by calling the URL again and appending a query parameter named "c", followed by the continuation Id.

For example:

https://api.landconservationsoftware.com/viewdata/1234/5678?apiKey=12345678&c=12345678