Skip to main content
Beach Day API logo
  • Category: lifestyle & entertainment
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 8
  • Triggers: 0
  • Slug: BEACH_DAY_API
  • Version: 20261101_00

Tools

Slug: BEACH_DAY_API_GET_BEACH_AMENITIESGet facilities and accessibility amenities for a beach without paying for the full beach profile. Costs 2 API credits.

Input Parameters

integer
required
Beach ID returned by Search Beaches.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BEACH_DAY_API_GET_BEACH_DETAILSGet a full beach profile, including current score, water quality, weather, ocean conditions, rules, and amenities. Costs 5 API credits.

Input Parameters

integer
required
Beach ID returned by Search Beaches.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BEACH_DAY_API_GET_BEACH_RULESGet activity rules for a beach without paying for the full beach profile. Costs 2 API credits.

Input Parameters

integer
required
Beach ID returned by Search Beaches.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BEACH_DAY_API_GET_TIDE_PREDICTIONSGet up to seven days of stored tide-prediction groups for a beach. Each successful request costs 1 API credit.

Input Parameters

integer
required
Beach ID returned by Search Beaches.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BEACH_DAY_API_LIST_BEACH_CONDITIONSReturn current and recent condition snapshots for a beach, including score, water quality, weather, ocean conditions, and available tide data. Costs 3 API credits per page.

Input Parameters

integer
Maximum condition snapshots to return in this page (1-200).
integer
Zero-based index of the first condition snapshot to return. Omit for the first page, then pass the previous response’s next_offset (repeating the same beach_id and limit) to get the next page.
integer
required
Beach ID returned by Search Beaches.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BEACH_DAY_API_LIST_BEACHES_BY_SCOREReturn beaches ranked by current Beach Day Score from highest to lowest. Costs 10 API credits per page; use only when ranking is needed.

Input Parameters

integer
Maximum ranked beaches to return in this page (1-200).
integer
Zero-based index of the first ranked beach to return. Omit for the first page, then pass the previous response’s next_offset (repeating the same limit) to get the next page.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BEACH_DAY_API_LIST_COUNTRIESList countries covered by Beach Day API with beach counts, ordered from highest to lowest count. Costs 1 API credit.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BEACH_DAY_API_SEARCH_BEACHESFind beaches by name, country, or state/province code and return IDs for detail, conditions, rules, amenities, and tide lookups. Costs 1 API credit per page.

Input Parameters

integer
Maximum beaches to return in this page (1-500).
string
State or province code, such as CA, AU-NSW, ES-AN, or BR-RJ.
integer
Zero-based index of the first beach to return. Omit for the first page, then pass the previous response’s next_offset (repeating the same search, country, state, and limit) to get the next page.
Case-insensitive beach-name search term, such as Malibu.
string
Case-insensitive country name, such as United States or New Zealand.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not