---
title: "Place search (public, no key)"
method: GET
path: "/public/geo/search"
tags: ["Public"]
---

# Place search (public, no key)

`GET /public/geo/search`

## Request

- Base URL: `https://api.astroway.info/v1`
- URL: `https://api.astroway.info/v1/public/geo/search`
- Auth: none required

The same answer as GET /geo/search without a key, for a birthplace field in a widget or a static page: candidates with coordinates, IANA zone, population and names in our 21 languages. Costs 1 unit of the public bucket (30 an hour per address without a key), so search after the visitor pauses typing rather than on every key. `Cache-Control: public, max-age=86400`. Attribution is in the body: displaying the data carries the GeoNames CC BY 4.0 credit. Reverse lookup and the offset on a date stay keyed (GET /geo/reverse, GET /geo/timezone).

## Query parameters

- `q` string, required
- `lang` 'uk' | 'en' | 'de' | 'pl' | 'es' | 'pt' | 'fr' | 'it' | 'nl' | 'cs' | 'ro' | 'hu' | 'el' | 'tr' | 'ar' | 'hi' | 'ja' | 'ko' | 'vi' | 'id' | 'ru'
- `limit` integer
- `country` string
- `fields` string
- `precision` integer

## Response `200`

OK

- object
  - `ok` boolean
  - `data` object
    - `query` string, nullable
    - `lang` string, nullable
    - `count` number, nullable
    - `results` object[], nullable
      - `id` number, nullable
      - `name` string, nullable
      - `originalName` string, nullable
      - `admin1` string, nullable
      - `admin1Code` string, nullable
      - `countryCode` string, nullable
      - `country` string, nullable
      - `latitude` number, nullable
      - `longitude` number, nullable
      - `timezone` string, nullable
      - `population` number, nullable
      - `featureCode` string, nullable
      - `matchedName` string, nullable
      - `exact` boolean, nullable
    - `note` string, nullable
    - `dataset` object, nullable
      - `source` string, nullable
      - `url` string, nullable
      - `namesUrl` string, nullable
      - `licence` string, nullable
      - `downloaded` string, nullable
      - `count` number, nullable
    - `attribution` object, nullable
      - `source` string, nullable
      - `sourceUrl` string, nullable
      - `licence` string, nullable
      - `licenceUrl` string, nullable
      - `notice` string, nullable
  - `_footer` string: Free-tier watermark, present on every public response. Keys on a paid plan do not receive it.

## Other responses

- `400`: Invalid sign or date

## Changes

- **2026-11-07** `e45dc317711a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/astroway/apis/astroway-calculation-api/changes/public/geo/search/get.md)

---

[API](https://skmtc.dev/astroway/apis/astroway-calculation-api.md) - [All operations](https://skmtc.dev/astroway/apis/astroway-calculation-api/llms.txt) - [OpenAPI document](https://skmtc.dev/astroway/apis/astroway-calculation-api/revisions/e5facc47e1b8?raw)
