Jentic OSThe workplace. An in-house AI platform for every employeeJentic OneSafe access. Agents reach your systems without holding keysJentic AIRThe foundation. Gets your existing platforms ready for AI
Pricing

GET STARTED

API DirectoryBrowse 10,000+ APIs ready for AI agent integrationDocumentationGuides and API reference

TOOLS

API ScoringCheck your AI readiness using our scorecardArazzo UIVisualize Arazzo workflows as interactive documentationArazzo EditorBuild and edit multi-step API workflows visually

COMMUNITY

GitHubOpen source projects and examplesOpen StandardsBuilt on open specs. Never locked in.
All ResourcesEverything in one placeBlogLatest articles and insightsTech Talk NewsletterAPIs, AI agents, architecture and strategyWebinarsLive sessions and on-demand recordingsReports & WhitepapersOriginal research on enterprise AI
About UsOur mission and teamCareersJoin our teamContactGet in touch
Try it now
Jentic OSJentic OneJentic AIR
Pricing
API DirectoryDocumentationAPI ScoringArazzo UIArazzo EditorGitHubOpen Standards
All ResourcesBlogTech Talk NewsletterWebinarsReports & Whitepapers
About UsCareersContact
Try it now
JenticJentic
Products
  • Jentic OS
  • Jentic One
  • Jentic AIR
For Developers
  • API Directory
  • Documentation
  • GitHub
Company
  • About Jentic
  • Careers
  • Contact Us
  • Trust Centre
ISO/IEC 27001:2022 certification badge issued by Prescient SecurityISO/IEC 27001:2022 certification badge issued by Prescient Security

Information Security Management System

Certified to ISO/IEC 27001:2022 by Prescient Security

AICPA SOC for Service Organizations logoAICPA SOC for Service Organizations logo

SOC 2® Type 1 report

Audited by Prescient Assurance

Terms & Conditions•Privacy Policy•
© 2026 Jentic Technology Ltd. All rights reserved.
2 Grattan Court East, Dublin, D02 VX86, Ireland
Switch to light modeSwitch to dark mode
APIs / Maps Geolocation / Roadgoat / RoadGoat Cities API
RoadGoat Cities API logo

RoadGoat Cities API

Browse all Roadgoat APIs
Official vendor OpenAPI document · agent-readyMaps GeolocationPlaces Searchbasic3 EndpointsREST

For Agents

Find a city with RoadGoat search or auto-complete, then read its budget, safety, known-for tags, walk and bike scores, photos, and nearby destinations.

Use for: Search for destinations matching Lisbon, Get the budget and safety scores for Barcelona, Find all nearby destinations for Kyoto, What is Amsterdam known for?

Not supported: Does not book flights or hotels, give turn-by-turn directions, or list individual venues. Use for city and destination travel content only.

The RoadGoat Cities API returns travel content for cities and destinations worldwide in JSON:API format. A keyword search or auto-complete call finds a destination, and the detail call returns its descriptions, latitude and longitude, population, budget and safety scores, walk_score and bike_score, known_for tags, average rating, photos, and nearby destinations. Related photos and destinations arrive as sideloaded resources in the included array.

Jentic One on GithubView OpenAPI Document

Install Jentic One Beta

Connect the RoadGoat Cities API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the RoadGoat Cities API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

1

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Froadgoat.com%2Froadgoat-cities" | sh
2

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Froadgoat.com%2Froadgoat-cities" | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with RoadGoat Cities API.

Search destinations by city name or country with the q parameter

Auto-complete partial destination names for a travel search box

Read a destination's budget value and safety score with their text labels

Return known_for tags with scores, such as food or nightlife, for a city

Get walk_score, bike_score, population, and coordinates for a destination

Load related photos and nearby_destinations from the JSON:API included array

Use Cases

Patterns agents use RoadGoat Cities API for, with concrete tasks.

★ AI trip-planning assistant

A travel agent built on an LLM needs facts about a city rather than its own recollection. Through Jentic it searches for 'city travel info', calls RoadGoat's GET /destinations with q set to the city, then GET /destinations/{id} for the match, with HTTP Basic credentials added by the developer's own instance. It answers with the city's budget text, safety text, and top known_for tags.

Call GET /destinations with q 'Lisbon', take the first result's id, call GET /destinations/{id}, and report budget.text, safety.text, and the three highest-scoring known_for tags

Destination comparison for travellers

A traveller choosing between cities wants a side-by-side view. GET /destinations/{id} returns budget and safety objects with numeric values and text labels, along with walk_score, bike_score, average_rating, and reviews_count, so an app can rank candidate cities on cost, safety, and getting around on foot or by bike.

Call GET /destinations/{id} for three destination ids and rank them by safety.value, then by budget.value

Search box auto-complete

Travel booking forms need fast suggestions while a user types. GET /destinations/auto_complete takes a partial q string and returns matching destinations, and the chosen id can be passed straight to GET /destinations/{id} for the full record.

Call GET /destinations/auto_complete with q 'San Fr' and return the destination names and ids

Key Endpoints

3 endpoints — the roadgoat cities api returns travel content for cities and destinations worldwide in json:api format.

METHOD

PATH

DESCRIPTION

GET

/destinations

Search destinations by keyword

GET

/destinations/auto_complete

Auto-complete destination names

GET

/destinations/{id}

Get a destination's full record

GET

/destinations

Search destinations by keyword

GET

/destinations/auto_complete

Auto-complete destination names

GET

/destinations/{id}

Get a destination's full record

Why Jentic?

What agents get from Jentic-routed access to this vendor.

Setup

Wiring RoadGoat by hand means encoding the API key and secret as an HTTP Basic header and parsing JSON:API responses where photos and nearby destinations sit in a separate included array. Through Jentic you install once, import RoadGoat Cities from the API Directory, store the credential once, and your agent calls it.

Permission scoping

RoadGoat exposes three read operations, and the destination id sits in the URL path (/destinations/{id}), so a rule can bound your agent to search only, auto-complete only, or detail lookups. You choose which of these operations it may call.

Credential isolation

Your RoadGoat key and secret are stored once, encrypted, by your own Jentic One instance and injected at execution time. They never enter the agent's prompt, logs, or context.

Intent-based discovery

Agents search Jentic by intent such as 'find a city' or 'get destination safety score', and Jentic returns the matching RoadGoat operation with its input schema so the agent passes q or id correctly.

Related APIs

Alternatives and complements available in the Jentic catalogue.

Alternative

OpenTripMap

→

Tourist attractions and points of interest near a location

Choose OpenTripMap for attractions within a city; choose RoadGoat for city-level budget, safety, and known-for summaries

Alternative

Amadeus Safe Place

→

Neighbourhood safety ratings for travellers

Choose Amadeus Safe Place for neighbourhood-level safety detail; choose RoadGoat for a single safety score alongside budget and known-for tags

Complementary

Foursquare

→

Venue and place search within a destination

Use RoadGoat to pick the city, then Foursquare to find restaurants and venues inside it

Complementary

OpenWeatherMap

→

Current weather and forecasts by coordinates

Pass RoadGoat's latitude and longitude to OpenWeatherMap to add a forecast to a destination summary

FAQs

Specific to using RoadGoat Cities API through Jentic.

What authentication does the RoadGoat Cities API use?

Per its OpenAPI spec, the RoadGoat Cities API uses HTTP Basic authentication, with your RoadGoat API key as the username and your secret as the password. Through Jentic both values are held by your own instance and combined into the Basic header at call time, so the agent never sees them.

What data does a RoadGoat destination record include?

GET /destinations/{id} returns name, slug, short_description, description, long_description, latitude, longitude, population, budget, safety, known_for, walk_score, bike_score, average_rating, reviews_count, wikipedia_url, and website. Relationships point to photos and nearby_destinations, which are sideloaded in the included array.

What are the rate limits for the RoadGoat Cities API?

The OpenAPI spec documents a 429 rate-limit response on destination search but does not state a numeric limit. Check https://www.roadgoat.com/business/cities-api for the current limits on your plan.

Is there a RoadGoat MCP server?

You do not need an MCP server to give your agent RoadGoat. Jentic connects it directly from the API Directory: import it, store your credential once, and your agent calls the search, auto-complete, and destination detail operations when it needs them.

How do I look up a city through Jentic?

Search Jentic for 'get travel info for a city', load the searchDestinations operation (GET /destinations), and pass the city name as q. Then call getDestination with the returned id for the full record. To run it on your own infrastructure, install Jentic One from its GitHub repo.

Can I limit what my agent is allowed to do with the RoadGoat Cities API?

Yes, though all three operations are reads. A rule that allows only GET /destinations/auto_complete keeps a search-box helper from pulling full destination records, and adding GET /destinations/{id} widens it to detail lookups. Every call the agent makes is logged.

GET STARTED

Start building with RoadGoat Cities API

Explore with Jentic One
View OpenAPI Document