Theguinessmap APItheguinessmap.com ↗
Access ~5,000 Guinness-serving locations worldwide via the Guinness Map API. Filter by country and city to get names, addresses, coordinates, ratings, and more.
What is the Theguinessmap API?
The Guinness Map API exposes a single list_places endpoint that returns up to ~5,000 venues serving Guinness across multiple countries. Each place record includes 12 fields: name, address, city, country, slug, latitude, longitude, price tier, rating, review count, and badges. Filter results by country (required) and optionally by city to narrow the dataset to a specific locale.
curl -X GET 'https://api.parse.bot/scraper/0ea4f59b-746b-4c0d-871d-a8c617aec3c0/list_places?city=Dublin&country=Ireland' \ -H 'X-API-Key: $PARSE_API_KEY'
List all places serving Guinness, filtered by country and optionally by city. Returns the full set of matching locations in a single response with details including name, address, rating, price, review count, and coordinates. The upstream dataset contains ~5000 locations across ~56 countries; filtering is applied locally after fetching the full dataset (one cached upstream call). When both country and city are provided, results are narrowed to that city within that country. When only country is provided, all places in that country are returned. Matching is case-insensitive.
| Param | Type | Description |
|---|---|---|
| city | string | City name to filter by within the specified country, e.g. 'Dublin', 'London', 'New York'. Case-insensitive. When omitted, all places in the country are returned. |
| countryrequired | string | Country name to filter by, e.g. 'Ireland', 'United Kingdom', 'United States'. Must match the country name as listed on The Guinness Map (case-insensitive). |
{
"type": "object",
"fields": {
"total": "integer count of matching places",
"places": "array of place objects, each with id, name, address, city, country, slug, latitude, longitude, price, rating, review_count, badges, has_guinness_zero, website_url, description"
},
"sample": {
"data": {
"total": 190,
"places": [
{
"id": "2dfef67f-56a5-477d-9a33-73472f98dcea",
"city": "Dublin",
"name": "The Palace Bar",
"slug": "the-palace-bar-21-fleet-st-dublin",
"price": 7.23,
"badges": [],
"rating": 4.7,
"address": "21 Fleet St",
"country": "Ireland",
"latitude": 53.345832,
"longitude": -6.259569,
"description": null,
"website_url": null,
"review_count": 9,
"has_guinness_zero": true
}
]
},
"status": "success"
}
}About the Theguinessmap API
What the API Returns
The list_places endpoint returns a total integer and a places array. Each object in the array carries a unique id and slug, human-readable name and address, structured city and country fields, decimal latitude and longitude coordinates, a price tier indicator, a numeric rating, a review_count, and a badges field that surfaces any special designations attached to the venue.
Filtering and Coverage
Two parameters control the result set. country is required and must match the country name as stored in the dataset — for example, 'Ireland', 'United Kingdom', or 'United States'. city is optional and case-insensitive; supplying it restricts results to venues in that city within the chosen country. The entire matching set is returned in a single response with no pagination; total tells you how many records came back.
Data Shape and Coordinates
Latitude and longitude on each place record make the dataset straightforward to plot on a map or feed into distance calculations. The price field gives a relative cost indicator rather than an exact currency figure. rating and review_count reflect the venue's standing as captured in the source dataset, and badges can indicate whether a location has been flagged or recognized in some way on The Guinness Map.
The Theguinessmap API is a managed, monitored endpoint for theguinessmap.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when theguinessmap.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official theguinessmap.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a city-level pub finder showing Guinness venues on an interactive map using latitude/longitude fields
- Rank bars in a country by rating and review_count to surface the most-reviewed Guinness spots
- Filter venues by price tier to help budget-conscious travelers find affordable pubs in a given city
- Generate a country-by-country comparison of Guinness venue density using the total count per query
- Power a travel itinerary tool that suggests top-rated Guinness pubs near a user's planned stops
- Identify badge-holding venues in a specific city for curated 'best of' pub guide content
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.