Name: Sea Surface Temperature API: Ocean Temperature Data
Brand: sst-guru
SKU: api-sst-guru-sst
Availability: InStock
Author: API Market

Pavel Zusko

# Sea Surface Temperature API: Current, Forecast and History

## Overview

The Sea Surface Temperature API returns sea water temperature for any point you pass as a latitude and longitude pair. GET /current gives a seven day daily series centred on today: the past three days, today, and a forecast for the next three days. GET /historical returns one reading per day for a date range you choose, with data available from 2010 and up to 31 days per request. GET /averages returns the minimum, maximum and average temperature for each of the 12 months at that location, so you can describe a typical year without pulling years of history yourself.

It is built for travel and beach sites that show water temperature, surf, dive and fishing apps, hotel and resort booking pages, marine and coastal research tools, and weather dashboards. Every reading comes back in both Celsius and Fahrenheit. Daily endpoints return a JSON array of objects with date (YYYYMMDD), tempC and tempF, and the averages endpoint returns one object per month with index, name, avgTempC, avgTempF, minTempC, minTempF, maxTempC and maxTempF.

## Features

*   **3 endpoints**: /current for the recent days plus a 3 day forecast, /historical for daily readings in a date range, and /averages for monthly climate figures.
*   **Coordinate lookup**: Pass one latlon query parameter such as 25.76,-80.13. Latitude runs from -90 to 90 and longitude from -180 to 180.
*   **History since 2010**: /historical returns one value per day from 2010 to the current date, up to 31 days per request.
*   **Short forecast**: /current returns seven daily values: three past days, today and the next three days.
*   **Monthly averages**: /averages returns min, max and average temperature for January through December at one location.
*   **Celsius and Fahrenheit**: Every reading includes both tempC and tempF, so no unit conversion is needed on your side.
*   **Plans by endpoint**: Pro covers /current, Ultra adds /averages, and Mega includes all three endpoints including /historical.
*   **Rate limit**: Every plan, including the free trial, allows up to 10 requests per second.

## Use Cases

*   **Travel and beach sites**: Show today's sea temperature and the next three days on destination, beach and hotel pages.
*   **Surf, dive and fishing apps**: Help users pick a day or wetsuit by showing current water temperature and the short forecast for a spot.
*   **Best time to visit guides**: Use /averages to show which months have the warmest water at a destination.
*   **Marine and coastal research**: Pull daily /historical readings since 2010 in 31 day windows to build time series for a location.
*   **Weather and outdoor dashboards**: Add sea temperature next to air temperature and wind for coastal cities.
*   **Resort and booking pages**: Display a monthly water temperature table to set guest expectations by season.

## Pricing

| Plan | Price | What you get | Rate limit | Endpoints |
|---|---|---|---|---|
| Basic | $0 | 7-day free trial with 100 API calls | 10 requests/second | 3 |
| Pro | $4.95/month | 70,000 calls/month, then US$0.0001 per extra call | 10 requests/second | 1 |
| Ultra | $14.95/month | 250,000 calls/month, then US$0.0001 per extra call | 10 requests/second | 2 |
| Mega | $29.95/month | 600,000 calls/month, then US$0.00005 per extra call | 10 requests/second | 3 |

## API Documentation

### Base URL

All requests go through the API.market gateway at this base URL:

```
https://prod.api.market/api/v1/sst-guru/sst
```

### Authentication

Every request needs your API.market key in the `x-api-market-key` header:

```
x-api-market-key: YOUR_API_KEY
```

Replace `YOUR_API_KEY` with your actual API key.

### Endpoints

#### 1. Sea temperature monthly averages

Returns min, max, and average Sea Surface Temperature for each month of the year.

**Method:** `GET`

**Endpoint:** `/averages`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| `latlon` | query | Comma-separated values of the latitude and longitude of the requested location. Allowed latitude values are in the range of -90..90. Allowed longitude values are in the range of -180..180. | string | Yes | - | - |

**Example Request:**

```bash
curl -X GET "https://prod.api.market/api/v1/sst-guru/sst/averages?latlon=25.76,-80.13" \
  -H "x-api-market-key: YOUR_API_KEY"
```

**Example Response (200 OK, abridged):**

```json
[
  {
    "index": 1,
    "name": "January",
    "avgTempC": 24.51,
    "avgTempF": 76.12,
    "minTempC": 23.73,
    "minTempF": 74.71,
    "maxTempC": 25.61,
    "maxTempF": 78.1
  },
  {
    "index": 2,
    "name": "February",
    "avgTempC": 24.36,
    "avgTempF": 75.85,
    "minTempC": 23.88,
    "minTempF": 74.98,
    "maxTempC": 24.77,
    "maxTempF": 76.59
  }
]
```

#### 2. Current Sea Temperature

Provides current Sea Surface Temperature, historical data for the past three days, and forecast for the next three days.

**Method:** `GET`

**Endpoint:** `/current`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| `latlon` | query | Comma-separated values of the latitude and longitude of the requested location. | string | Yes | - | - |

**Example Request:**

```bash
curl -X GET "https://prod.api.market/api/v1/sst-guru/sst/current?latlon=25.76,-80.13" \
  -H "x-api-market-key: YOUR_API_KEY"
```

**Example Response (200 OK, abridged):**

```json
[
  {
    "date": "20261005",
    "tempC": 28.93,
    "tempF": 84.07
  },
  {
    "date": "20261006",
    "tempC": 29.1,
    "tempF": 84.38
  }
]
```

#### 3. Historical Sea Temperature

Provides historical Sea Surface Temperature for the requested location and time interval. Historical data is available from 2010 until the current date. A requested interval can not exceed 31 days.

**Method:** `GET`

**Endpoint:** `/historical`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| `latlon` | query | Comma-separated values of the latitude and longitude of the requested location. | string | Yes | - | - |
| `startDate` | query | Start date of the requested historical interval in the YYYYMMDD format. | string | Yes | - | - |
| `endDate` | query | End date of the requested historical interval in the YYYYMMDD format. | string | Yes | - | - |

**Example Request:**

```bash
curl -X GET "https://prod.api.market/api/v1/sst-guru/sst/historical?latlon=25.76,-80.13&startDate=20260901&endDate=20260903" \
  -H "x-api-market-key: YOUR_API_KEY"
```

**Example Response (200 OK, abridged):**

```json
[
  {
    "date": "20260901",
    "tempC": 30.38,
    "tempF": 86.68
  },
  {
    "date": "20260902",
    "tempC": 29.85,
    "tempF": 85.73
  }
]
```

## Status Codes

| Code | Status | Description |
|---|---|---|
| 200 | OK | The request succeeded and the data is in the response body. |
| 400 | Bad Request | A required parameter is missing or invalid, or the `x-api-market-key` header is missing. |
| 401 | Unauthorized | The `x-api-market-key` value is invalid or expired. |
| 403 | Forbidden | Your subscription does not include this endpoint. Check which endpoints your plan includes. |
| 404 | Not Found | The requested item or path was not found. |
| 429 | Too Many Requests | You went over your plan's rate limit (10 requests/second depending on plan) or used up your plan's calls. |
| 500 | Internal Server Error | Something failed while processing the request. Retry after a short delay. |
| 503 | Service Unavailable | The service is temporarily unavailable. Retry later. |

## Rate Limits

Every plan allows up to 10 requests per second. The free trial includes 100 calls, Pro includes 70,000 calls a month, Ultra 250,000 and Mega 600,000; on the paid plans extra calls are billed per call rather than blocked. If you send requests faster than your plan allows you get HTTP 429, so back off, wait for the time given in the Retry-After header when it is present, and retry.

## FAQ

**Is there a free trial?**

Yes. The Basic plan is a 7-day free trial with 100 API calls and access to all three endpoints: /current, /averages and /historical.

**How much do the paid plans cost and what do they include?**

Pro is $4.95 a month for 70,000 calls and covers /current only. Ultra is $14.95 a month for 250,000 calls and covers /current and /averages. Mega is $29.95 a month for 600,000 calls and covers all three endpoints including /historical. Extra calls are billed at $0.0001 each on Pro and Ultra and $0.00005 each on Mega.

**How do I call the API?**

Send a GET request to the endpoint with your API key in the x-api-market-key header, for example /current?latlon=25.76,-80.13. Responses are JSON.

**What format does the latlon parameter use?**

A single string with latitude and longitude separated by a comma, latitude first, for example 25.76,-80.13. Latitude must be between -90 and 90 and longitude between -180 and 180.

**What date format does /historical expect?**

startDate and endDate are both required in YYYYMMDD format with no separators, for example startDate=20260901&endDate=20260903. The interval cannot be longer than 31 days, and data is available from 2010 to the current date.

**What does /current return?**

An array of seven daily readings: the past three days, today and a forecast for the next three days. Each item has date in YYYYMMDD format plus tempC and tempF.

**What if my coordinates are on land?**

Use a point on the water or right at the shoreline, such as a beach in front of a hotel, for the most relevant reading. The provider states that points on land are matched to a nearby marine location.

**Which plan do I need for historical data?**

/historical is included in the free trial and in the Mega plan. Pro and Ultra do not include it.

## Contact Us

If you have any questions or need assistance, you can reach out to us through the embedded chat on the bottom right corner of the page or send an email to hello@magicapi.com.


Get sea surface temperature by latitude and longitude: daily readings, a 3 day forecast, monthly averages and history since 2010. Start with a free trial.

Sea Surface Temperature API: Ocean Temperature Data

Basic

SST Guru

Ultra

Mega

Sea surface temperature API for any latitude and longitude, with daily ocean temperature readings, a short forecast, monthly averages and history back to 2010.