BetterCacher API

documentation

terms of use

You can use our API under CC BY-NC-SA.

View License Deed | View Legal Code

For exceptions you can contact us: info@bettercacher.org


single query

Just replace 'GCCODE' with the gccode of the cache you want to query.
Archived geocaches are outputted.
api.bettercacher.org/V2/GCCODE


multiple queries

Replace 'GCTEST,GCTEST2,GCTEST3' with the gccodes of the caches you want to query.
Attention: Do not enter spaces.
Archived geocaches are outputted.
api.bettercacher.org/V2/GCTEST,GCTEST2,GCTEST3


queries with coordinates

Replace with the coordinates and the distance of the caches you want to query.
Separate with a comma, like '52.000000,9.000000,50'.
If you don't enter a distance, we will use 100km as distance.
Archived geocaches are NOT outputted.
api.bettercacher.org/V2/52.000000,9.000000,50


output

You will get a similar output:
{

"geocaches": [
{
"id":"1000",
"name":"TEST CACHE",
"lat":"52.000000",
"lng":"9.000000",
"type":"tradi",
"difficulty":"2_5",
"terrain":"1_5",
"size":"small",
"gccode":"GCTEST",
"logs": [
{
"user": "janole 174",
"text": "This geocache is really something special."
},
{
"user": "Lady Allista",
"text": "I love this cache."
}
],
"platform":"gc",
"state":"Germany",
"county":"Niedersachsen",
"add":"2019-01-15 12:00:00",
"parel":""
},
{
"id":"1001",
"name":"TEST CACHE 2",
"lat":"54.000000",
"lng":"8.000000",
"type":"multi",
"difficulty":"1_5",
"terrain":"4",
"size":"regular",
"gccode":"GCTES2,
"logs": [
{
"user": "example user",
"text": "This geocache is very nice."
}
],
"platform":"gc",
"state":"United States",
"county":"Oregon",
"add":"2021-06-01 12:00:00",
"parel":"",
"status":"0"
}

]

}


classification


variable classification
id BetterCacher ID of the cache
name cache-name
lat latitude
lng longitude
type cache type like traditional, multi, unknown, earthcache, wherigo, virtual, letter
difficulty the difficulty of the cache; like 1, 1_5, 2, ...
terrain the terrain of the cache; like 1, 1_5, 2, ...
size size of the cache like micro, small, regular, large, other, v (virtual)
gccode gc-code of the cache
logs contains log information
user username of the user
text text of the log
platform platform where the cache is listed; geocaching.com or opencaching.de
country country in which the cache is hidden
state state in which the cache is hidden
add date and time at which the cache was added
parel if the cache is a parel in the netherlands (=nl) or a jewel in belgium (=bl)
status geocache status. Active = 0, archived = 1. Only outputted for the single and multiple query.


any questions?

Feel free to write us an email.