Astraluno Places API
The Places API from Astraluno — 1 operation(s) for places.
The Places API from Astraluno — 1 operation(s) for places.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/astraluno-com:astraluno-com-places-api"
curl "https://apis.io/api/v1/apis?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Astraluno public Places API
version: 1.0.0
description: Read-only astrology computations. No birth data is stored or logged. 60 compute requests/min/IP; 120 light requests/min/IP. No keys. Free corpus.
servers:
- url: https://astraluno.com
tags:
- name: Places
paths:
/api/v1/places:
get:
operationId: places
summary: places
description: Read-only, free, no API key. Tropical, geocentric, Whole Sign. No birth data is stored or logged; request bodies and queries never enter logs or stats. Angular numbers also have D°MM′ strings in degree_strings (JSON pointers). Respect uncertainty windows and all sign possibilities. Dates include the IANA timezone used.
parameters:
- name: q
in: query
required: true
schema:
type: string
minLength: 2
maxLength: 100
pattern: ^[^\x00-\x1f]*$
example: Milano
- name: lang
in: query
required: false
schema:
default: en
description: 'Language code. Published: en, it. Other codes fall back to English with a language.note.'
type: string
maxLength: 35
example: en
- name: limit
in: query
required: false
schema:
default: 8
type: integer
minimum: 1
maximum: 20
example: 8
responses:
'200':
description: Computed result with source and citation URL
content:
application/json:
schema:
$schema: https://json-schema.org/draft/2020-12/schema
type: object
properties:
language:
type: object
properties:
requested:
type: string
effective:
type: string
enum:
- en
- es
- fr
- it
note:
type:
- string
- 'null'
required:
- requested
- effective
- note
additionalProperties: false
source:
type: string
const: Astraluno
url:
type: string
format: uri
timezone:
anyOf:
- type: string
minLength: 1
maxLength: 100
pattern: ^[A-Za-z0-9_+-]+(?:\/[A-Za-z0-9_+-]+)*$
- type: 'null'
degree_strings:
type: object
propertyNames:
type: string
additionalProperties:
type: string
description: D°MM′ strings keyed by JSON pointer to every angular number in this response, including ranges. The engine snapshot is unchanged.
places:
type: array
items:
type: object
properties:
id:
type: integer
minimum: -9007199254740991
maximum: 9007199254740991
label:
type: string
lat:
type: number
lon:
type: number
tz:
type: string
minLength: 1
maxLength: 100
pattern: ^[A-Za-z0-9_+-]+(?:\/[A-Za-z0-9_+-]+)*$
required:
- id
- label
- lat
- lon
- tz
additionalProperties: false
selectionGuidance:
type: string
required:
- language
- source
- url
- timezone
- degree_strings
- places
- selectionGuidance
additionalProperties: false
'400':
description: Structured validation, engine or rate-limit error. Birth data is never stored or logged.
headers:
Retry-After:
description: Seconds until retry (429)
schema:
type: integer
content:
application/json:
schema:
$schema: https://json-schema.org/draft/2020-12/schema
type: object
properties:
error:
type: object
properties:
code:
type: string
message:
type: string
details:
anyOf:
- {}
- type: 'null'
required:
- code
- message
- details
additionalProperties: false
required:
- error
additionalProperties: false
'404':
description: Structured validation, engine or rate-limit error. Birth data is never stored or logged.
headers:
Retry-After:
description: Seconds until retry (429)
schema:
type: integer
content:
application/json:
schema:
$schema: https://json-schema.org/draft/2020-12/schema
type: object
properties:
error:
type: object
properties:
code:
type: string
message:
type: string
details:
anyOf:
- {}
- type: 'null'
required:
- code
- message
- details
additionalProperties: false
required:
- error
additionalProperties: false
'413':
description: Structured validation, engine or rate-limit error. Birth data is never stored or logged.
headers:
Retry-After:
description: Seconds until retry (429)
schema:
type: integer
content:
application/json:
schema:
$schema: https://json-schema.org/draft/2020-12/schema
type: object
properties:
error:
type: object
properties:
code:
type: string
message:
type: string
details:
anyOf:
- {}
- type: 'null'
required:
- code
- message
- details
additionalProperties: false
required:
- error
additionalProperties: false
'415':
description: Structured validation, engine or rate-limit error. Birth data is never stored or logged.
headers:
Retry-After:
description: Seconds until retry (429)
schema:
type: integer
content:
application/json:
schema:
$schema: https://json-schema.org/draft/2020-12/schema
type: object
properties:
error:
type: object
properties:
code:
type: string
message:
type: string
details:
anyOf:
- {}
- type: 'null'
required:
- code
- message
- details
additionalProperties: false
required:
- error
additionalProperties: false
'429':
description: Structured validation, engine or rate-limit error. Birth data is never stored or logged.
headers:
Retry-After:
description: Seconds until retry (429)
schema:
type: integer
content:
application/json:
schema:
$schema: https://json-schema.org/draft/2020-12/schema
type: object
properties:
error:
type: object
properties:
code:
type: string
message:
type: string
details:
anyOf:
- {}
- type: 'null'
required:
- code
- message
- details
additionalProperties: false
required:
- error
additionalProperties: false
'500':
description: Structured validation, engine or rate-limit error. Birth data is never stored or logged.
headers:
Retry-After:
description: Seconds until retry (429)
schema:
type: integer
content:
application/json:
schema:
$schema: https://json-schema.org/draft/2020-12/schema
type: object
properties:
error:
type: object
properties:
code:
type: string
message:
type: string
details:
anyOf:
- {}
- type: 'null'
required:
- code
- message
- details
additionalProperties: false
required:
- error
additionalProperties: false
tags:
- Places