BetterCacher API

terms of use

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

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":"false",

        "status":"0"

		"catmystery": "false",

		"catgadget": "false",

		"catnature": "false",

		"cathiking": "false",

		"catlocation": "false",

		"catother": "false",

		"catrecommendation": "false"

		}


        ]

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) or not (=false) More information on parels (on our faq page): visit link
status	geocache status. (active=0, archived=1). Only outputted for the single and multiple query.
catmystery	Category mystery. (fase or true). More information on categorys: visit link
catgadget	Category gadget. (fase or true). More information on categorys: visit link
catnature	Category nature. (fase or true). More information on categorys: visit link
cathiking	Category hiking. (fase or true). More information on categorys: visit link
catlocation	Category location. (fase or true). More information on categorys: visit link
catother	Category other. (fase or true). More information on categorys: visit link
catrecommendation	Category recommendation. (fase or true). More information on categorys: visit link

any questions?

Feel free to write us an email.