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
| Parameter | Type | Description | Required |
|---|---|---|---|
| object | string | The 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."
}
