▣ GEOLOCATION · TRAVEL

Search US Places API

What it does

Place Search lets you look up places by text query and get matching location results back in a structured response. Send a query, and optionally set limit to control how many matches you want, up to 200.

Use it when you need place lookup inside a booking flow, a map search box, or an address autocomplete feature. The endpoint is built for simple search-driven discovery: you provide a name or place phrase such as " Station", and the API returns the matched places in its response body.

Because the response schema is open-ended, you should treat the returned payload as a searchable place result set rather than a fixed record shape. That makes Place Search useful for integrating with mapping UIs, location pickers, nearby search, or internal tools that need to resolve user-entered place names into API results.

If your application needs fast place discovery from free-text input, Place Search gives you a minimal query interface and a flexible result payload for downstream filtering, display, or ranking.

GET

Search places

https://api.eu.apyhub.com/dosvak/search-places

QUICKSTART

GUIDE

Quickstart

Search for places matching a query term like “Station”.

curl -X GET "https://api.eu.apyhub.com/dosvak/search-places?query=Station" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

Returns a JSON object containing the matching search results. The response may include additional provider-specific fields depending on the available place data.

{
  "query": "Station",
  "count": 1,
  "results": [
    {
      "source_table": "point",
      "osm_id": 4792457222,
      "name": "Idaho Falls Power Charging Station",
      "category": "charging_station",
      "lat": 43.49133630054193,
      "lon": -112.04375269999998
    }
  ]
}

TRY ITLIVE · 10 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 places matching a text query and returns a JSON object. The response shape is not yet defined in the output schema beyond being an object with additional properties allowed.

Query Parameter(s)

Attribute	Type	Mandatory	Description
limit	Integer	No	Maximum number of results to return. Default: 50. Minimum: 1. Maximum: 200.
query	String	Yes	Search text for the place lookup. Minimum length: 2 characters.

Response

Returns a JSON object containing the search results. The response may include additional provider-specific fields.

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.