SARV API

Estonian geocollections information system: public API

Brief documentation

1. Get an individual data object by record ID

Main syntax: http://api.geokogud.info/$table/$id[.xml | .json | .jsonp | .csv | .api]

Examples:

  • http://api.geokogud.info/locality/10230
  • http://api.geokogud.info/locality/10230.json
  • http://api.geokogud.info/sample/77508
  • http://api.geokogud.info/taxon/4085
  • http://api.geokogud.info/stratigraphy/123


  • 2. Search and/or get a list of records

    Main syntax: http://api.geokogud.info/$table

    Optional parameters:

  • to specify output format: ?format=json|xml|jsonp|csv|api
  • to specify page: ?page=$page
  • to specify list of fields to retrieve: ?fields=["$field1","$field2","..."]
  • to specify search criteria: ?fp={"$field":[{"$lookuptype":"$search_string"}]} (where $lookuptype is one of: startswith, endswith, istartswith, iendswith, contains, icontains, exact, gt, lt)
  • Examples:

  • http://api.geokogud.info/taxon
  • http://api.geokogud.info/taxon?page=10
  • http://api.geokogud.info/taxon/?format=json&fields=["taxon","id"]&fp={"taxon":[{"istartswith":"Asaphus"}]}
  • http://api.geokogud.info/sample/?fp={"number":[{"istartswith":"OM6"}]}
  • http://api.geokogud.info/analysis_results/?fp={"name":[{"exact":"U (ppm)"}],"value":[{"gt":"100"}]}
  • http://api.geokogud.info/reference/?fp={"author":[{"icontains":"oja, t"}]}


  • 3. List of tables and fields that can currently be accessed