---
title: Compare Beaches Around the World
slug: beaches-information
url: https://apyhub.com/ryanvinson/service/beaches-information
provider: Ryan Vinson
categories: [Geolocation, Travel]
tags: [beaches, tides, water-quality, travel-data, location-data, beach-conditions]
auth: api_key
---

# Compare Beaches Around the World

What it does Beach Information gives you searchable beach records, local rules, amenities, conditions, and tide forecasts in one API. Use it to look up beaches by country, state, or name, then pull the details you need for a trip planner, beach safety app, or location directory. List available coun…

## Endpoints

| Method | Path | Description | Atoms |
| --- | --- | --- | --- |
| GET | `/countries` | What it does Returns a list of countries available from the service, along with the total count and… | 10 |
| GET | `` | What it does Searches for beaches and returns a paginated list of matching beach records along with… | 10 |
| GET | `/:id` | What it does Returns the details for a single beach identified by its path id. The response is a JS… | 10 |
| GET | `/:id/conditions` | What it does Returns beach condition records for the beach identified by id. The response includes… | 10 |
| GET | `/scored` | What it does Returns a paginated list of top rated beaches. You can control the page size and start… | 10 |
| GET | `/:id/rules` | What it does Retrieves the rules for a specific beach identified by its integer id, returning the b… | 10 |
| GET | `/:id/amenities` | What it does Retrieves the amenities information for a specific beach identified by its numeric id.… | 10 |
| GET | `/tides/:beach_id` | What it does Returns the tide forecast for a specific beach identified by beachid. The response is… | 10 |

## About

## What it does
Beach Information gives you searchable beach records, local rules, amenities, conditions, and tide forecasts in one API. Use it to look up beaches by country, state, or name, then pull the details you need for a trip planner, beach safety app, or location directory.

List available countries with a beach count, or search beaches with `country`, `state`, `search`, `limit`, and `offset`. Search results return each beach's `id`, `name`, `state`, `latitude`, `longitude`, `nearest_buoy_id`, and `nearest_tide_station`, with optional fields like `country`, `nudism`, `lifeguard`, and `surf_spot` when available.

For a specific beach `id`, get the full beach record: `description`, `beach_day_score`, `water_quality`, `weather`, `ocean_conditions`, `rules`, and `amenities`. Rules are broken out by category and status, and amenities include availability, hours, and notes for items such as restrooms, showers, lifeguards, parking, food, accessibility, and rentals.

Use the conditions and tide endpoints when you need time-based data. Beach conditions return dated entries with `water_quality`, `weather`, `ocean_conditions`, `tides`, and `beach_day_score`. Tide forecasts return `beach_id` and a list of `tide_predictions` by date, each with its tide entries.

## Usage

Authenticate with an ApyHub API key in the `apy-token` header.
Full docs and a live playground: https://apyhub.com/ryanvinson/service/beaches-information
