▣ GEOLOCATION · STANDARD DATA

US County Climate Search API

What it does

Climate County Search lets you look up counties by a climate-related query string and returns a structured search response. Send a query, and optionally set limit to control how many matches you get back.

Use it when you need county-level lookup in a workflow that starts from a place name, region, or other climate-related term. The endpoint is designed for simple search, so it fits front-end autocomplete, internal admin tools, or data enrichment steps where you need to resolve a county from user input.

The request schema is small: query is required and must be at least 2 characters long, while limit defaults to 50 and can be set up to 200. The response schema is open-ended, so the service returns a structured search payload without promising fixed fields beyond the documented API contract.

If your application needs to match county names against climate-oriented searches, Climate County Search gives you a direct lookup endpoint with minimal input and a flexible response shape.

GET

Search climate counties

http://localhost:8080/dosvak/search-climate-counties

QUICKSTART

GUIDE

Quickstart

Search climate counties for a location like Los Angeles.

curl -X GET "http://localhost:8080/dosvak/search-climate-counties?query=Los%20Angeles&limit=50" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

Returns a JSON object with additional properties, so the response shape may include search results and other fields defined by the API.

{
  "query": "Los Angeles",
  "count": 1,
  "results": [
    {
      "county_fips": "06037",
      "county_name": "LOS ANGELES",
      "state_name": "CALIFORNIA",
      "flood_risk": "5.289",
      "heat_risk": "0.0",
      "drought_risk": "0.0",
      "wildfire_risk": "0.0",
      "storm_risk": "5.204",
      "risk_score": "2.36305"
    }
  ],
  "attribution": [
    {
      "source": "NOAA NCEI",
      "dataset": "Storm Events Database",
      "license": "U.S. federal government data",
      "url": "https://www.ncei.noaa.gov/pub/data/swdi/stormevents/csvfiles/",
      "notice": "Climate risk scores are derived from NOAA storm event history and are not official NOAA risk ratings."
    },
    {
      "source": "U.S. Census Bureau TIGER/Line",
      "dataset": "TIGER/Line County Boundaries 2024",
      "license": "Public domain / U.S. federal government work",
      "url": "https://www2.census.gov/geo/tiger/TIGER2024/COUNTY/",
      "notice": "Derived from U.S. Census Bureau TIGER/Line boundary data; not endorsed or certified by the Census Bureau."
    }
  ]
}

TRY ITLIVE · 100 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Searches for climate counties using a query string and returns a JSON object. The request supports limiting the number of results returned.

Query Parameter(s)

Attribute	Type	Mandatory	Description
limit	Integer	No	Maximum number of results to return.<br>Default: 50.<br>Minimum: 1.<br>Maximum: 200.
query	String	Yes	Search term to look up climate counties.<br>Minimum length: 2.

Response

Returns a JSON object. The output schema only specifies that the response is an object and allows additional properties; it does not define any fixed top-level fields.

Parameter	Type	Mandatory	Description

Query parameters

Name

Type

Description

limitOPTIONAL

integer

—

DEFAULT 50

queryREQUIRED

string

—

▣ COMMON ERRORS

Errors any endpoint can return

400bad_request

Required parameter missing or malformed body.

401unauthorized

API key missing, revoked, or not authorized for this service.

429rate_limited

Your plan's per-second rate exceeded. Retry with exponential backoff.

503upstream_busy

Backend temporarily unavailable. Try again in a few seconds.