Linking to lists of walks
You're most welcome to link to subsets of walks relevant to your own website. This page describes how to construct the appropriate URLs.
Individual walks
URLs should either be of the form:
/walk/{name}
For example:
/walk/bedruthan_steps
Or using the short form with a numerical ID:
/w/{id}
For example:
/w/40
Lists of walks
Walks by locality
Lists of walks can be returned just for a particular locality. URLs should be of the form:
/walks/near/{locality}
For example:
/walks/near/boscastle
See the bottom of this page for the full list of localities currently available.
Walks in larger regions
If you want walks in one of the four (north, southeast, mid, west) regions of Cornwall, use:
/walks/in/west_cornwall
For AONB regions, use:
/walks/aonb/trevose_head_to_stepper_point
Walks by type
URLs should be of the form:
/walks/featuring/{type}
For example:
/walks/featuring/beach
Types can be combined with a locality, but must come afterwards, for example:
/walks/near/tintagel/featuring/beach
See below for the list of walk types.
Sorting results
By default, walks are sorted by grade and then distance. You can change this by adding the following to the URL:
/by/title
- by walk title/by/distance
- by length of walk/latest
- most recent walks first
For example:
/walks/near/padstow/latest
/walks/in/north_cornwall/featuring/beach/by/title
Searches by multiple criteria
/walks/search?{query-string}
For example for unstrenous walks near Boscastle:
/walks/search?locality=boscastle&max-grade=3
Available query string parameters are:
- locality - name of locality (see below for a list)
- type - type of walk (see below for a list)
- max-grade - max steepness grade e.g. 4
- min-miles - minimum distance in miles e.g. 2.5
- max-miles - maximum distance in miles e.g. 5.5
Although you can have multiple criteria, only single values for each criterion are currently supported (e.g. you can only search for one locality at a time).
Available walk types
The current list of walk types is:
- autumn_colours
- beach
- bus
- cafe
- caradon_trail
- church
- circular
- clay_trails
- coast
- evening
- ferry
- fishing_village
- gardens
- heritage
- holy_well
- house_of_the_dragon
- lighthouse
- mining_heritage
- mining_trails
- moorland
- off_the_beaten_track
- one_way
- poldark
- prehistoric_remains
- pub
- river
- rosamunde_pilcher
- saints_way
- shade
- shipwreck
- shorten
- st_micheals_way
- town
- train
- wet_weather
- wildlife
- woodland
Available localities
The current list of localities is:
- altarnun
- bedruthan_steps
- blisland
- bodmin
- bodmin_moor
- boscastle
- bossiney
- bude
- callington
- calstock
- camborne
- camel_estuary
- camelford
- cotehele
- coverack
- crackington
- cubert
- davidstow
- delabole
- eden
- falmouth
- fowey
- golitha_falls
- goonhavern
- hayle
- helford
- helland
- helston
- jacobstow
- laneast
- lanhydrock
- launceston
- lerryn
- lesnewth
- liskeard
- looe
- lostwithiel
- luxulyan_valley
- mawgan_porth
- mevagissey
- millook
- minions
- morwenstow
- mounts_bay
- mousehole
- mullion
- newquay
- north_hill
- padstow
- par
- pencarrow_house
- pentewan
- penzance
- perranporth
- polperro
- polruan
- polzeath
- port_gaverne
- porthallow
- porthcothan
- porthcurno
- porthleven
- port_isaac
- port_isaac_bay
- portloe
- port_quin
- portreath
- portscatho
- poundstock
- predannack
- redruth
- rock
- rocky_valley
- saltash
- seven_bays
- st_agnes
- st_austell
- st_breward
- st_clether
- st_columb
- st_ives
- st_just
- st_keverne
- st_kew
- st_mabyn
- st_minver
- st_nectans_glen
- st_neot
- st_tudy
- tehidy
- the_camel_trail
- the_lizard
- the_roseland
- the_tamar_valley
- tin_coast
- tintagel
- torpoint
- trebarwith_valley
- tregardock
- trevalga
- trevone
- trewarmett
- truro
- veryan
- wadebridge
- warbstow
- week_st_mary
- west_penwith
- zennor
We aim to add to this over time as we create new walks.