Endpoints

Full reference for all Bootprint API endpoints.

All Data

The All Data endpoint returns a random image and fact for a specific celestial object.

Endpoint

GET /all

Base URL

https://api.bootprint.space/all

Example Request

curl -X GET "https://api.bootprint.space/all/mars"

Parameters

ParameterTypeDescriptionRequired
objectstringThe celestial object name (e.g., mars, jupiter, moon)Yes

Example Response

{
  "object": "mars",
  "image": "https://cdn.bootprint.space/mars/1.png",
  "image_id": "c3a1f9a7-29e4-4f91-9f1c-7d2e987f8d7d",
  "fact": "Mars is home to the tallest mountain in the solar system.",
  "fact_id": "e8b4b024-52b7-4d1c-b64b-329d6c0f3f0e"
}

Random Image

The Random Image endpoint returns only a random image URL for a specific celestial object.

Endpoint

GET /img

Base URL

https://api.bootprint.space/img

Example Request

curl -X GET "https://api.bootprint.space/img/mars"

Example Response

{
  "object": "mars",
  "image": "https://cdn.bootprint.space/mars/1.png",
  "image_id": "c3a1f9a7-29e4-4f91-9f1c-7d2e987f8d7d"
}

Random Fact

The Random Fact endpoint returns only a random fact for a specific celestial object.

Endpoint

GET /fact

Base URL

https://api.bootprint.space/fact

Example Request

curl -X GET "https://api.bootprint.space/fact/mars"

Example Response

{
  "object": "mars",
  "fact": "Mars is home to the tallest mountain in the solar system.",
  "fact_id": "e8b4b024-52b7-4d1c-b64b-329d6c0f3f0e"
}

Error Responses

If the request is invalid or the object is not supported, the API will return an error.

{
  "error": "Invalid object name. Please provide a valid celestial object."
}

Rate Limiting

The Bootprint API allows 60 requests per minute.

You may optionally send client identity headers such as x-client-id, x-client-name, x-client-type, and x-client-version. These headers are optional, but they help us identify requests and investigate abuse more effectively.

Example:

curl https://api.bootprint.space/all/mars \
  -H "x-client-id: user-123" \
  -H "x-client-name: Bootprint Web" \
  -H "x-client-type: browser" \
  -H "x-client-version: 1.0.0"

When the limit is exceeded, the API returns HTTP 429 with a Retry-After header and a response such as:

{
  "error": "Rate limit exceeded. Please wait 1 minute before trying again."
}

On this page