Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
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. By signing up you are subscribing to the APIs.io and API Evangelist
newsletters — you can unsubscribe from any issue. See our
Privacy Policy and Terms.
openapi: 3.2.0
info:
title: Astroletra Com Datos API
version: 1.1.0
contact:
name: Astroletra
email: info@astroletra.com
url: https://astroletra.com/datos/api/
license:
name: CC BY 4.0
url: https://creativecommons.org/licenses/by/4.0/
description: 'Operations tagged Datos across 2 of this provider''s published API definitions: astroletra-com-openapi.json, astroletra-com-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.astroletra.com
tags:
- name: Datos
paths:
/api/v1/datos/{fichero}:
get:
operationId: datos
summary: Fichero de datos abiertos (CSV, JSON o iCal)
description: Los mismos ficheros de https://astroletra.com/datos/ servidos desde la API, para descargarlos con cualquier cliente, también con urllib de Python y con pandas. Sin clave; 60 peticiones por minuto e IP.
parameters:
- name: fichero
in: path
required: true
description: Nombre del fichero, por ejemplo lunaciones.csv, eclipses.json, retrogrados.csv, ingresos-solares.csv, calendario-2027.csv o todo.ics. La lista está en https://astroletra.com/datos/.
schema:
type: string
pattern: ^[a-z0-9][a-z0-9-]*\.(csv|json|ics)$
example: lunaciones.csv
responses:
'200':
description: El fichero pedido
content:
text/csv:
schema:
type: string
application/json:
schema:
type: object
text/calendar:
schema:
type: string
'404':
description: No existe un fichero con ese nombre
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'429':
description: Demasiadas peticiones (más de 60 por minuto); mira Retry-After
headers:
Retry-After:
schema:
type: integer
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'503':
description: El fichero no está disponible en este momento
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
tags:
- Datos
servers:
- url: https://api.astroletra.com
components:
schemas:
Error:
type: object
properties:
error:
type: string
details:
type:
- array
- 'null'
items:
type: object
properties:
path:
type: string
message:
type: string
required:
- error
x-refined-from:
- astroletra-com-openapi.json
- astroletra-com-openapi.yml