API Reference

This document provides detailed information on how to interact with the Truth Satellite API, including authentication, available endpoints, request parameters, and response formats.

Base URL

The API is hosted at: https://truthsatellite.space/api

All requests must be sent over HTTPS.

---

Authentication

The API requires authentication via API Keys, OAuth2, or JWT Tokens.

1. API Key Authentication

Pass your API key in the Authorization header:

GET /facts
Authorization: Bearer YOUR_API_KEY

2. OAuth2 Authentication

For enterprise integrations, OAuth2 is available.

Step 1: Get Access Token

POST /oauth/token
Content-Type: application/json  

{
  "client_id": "your_client_id",
  "client_secret": "your_client_secret",
  "grant_type": "client_credentials"
}

Step 2: Use Access Token

GET /facts
Authorization: Bearer ACCESS_TOKEN

3. JWT Token Authentication

Clients can authenticate using JSON Web Tokens (JWT):

Authorization: Bearer YOUR_JWT_TOKEN

More on Security & Authentication

---

Rate Limits

To prevent abuse, API requests are rate-limited:

Plan	Requests per Minute	Requests per Day
Free	10	1,000
Pro	100	50,000
Enterprise	Unlimited	Unlimited

For increased limits, upgrade your plan at https://truthsatellite.space

---

API Endpoints

1. Fetch Intelligence Reports

**GET **/facts

Retrieves classified intelligence reports.

Request Parameters

Parameter	Type	Required	Description
category	string	No	“finance”, “geopolitics”, “technology”
limit	int	No	Number of results (default: 10)
timestamp	string	No	Retrieve data from a specific date

Example Response

{
  "data": [
    {
      "id": "12345",
      "source": "classified",
      "content": "A major financial entity moved $3B offshore before market collapse.",
      "timestamp": "2025-02-08T14:00:00Z"
    }
  ]
}

---

2. Query Historical Data

GET /historical

Access past intelligence reports.

Example Request

GET /historical?category=geopolitics&timestamp=2024-12-01
Authorization: Bearer YOUR_API_KEY

Example Response

{
  "data": [
    {
      "id": "67890",
      "source": "leaked_documents",
      "content": "A secret diplomatic meeting between two nations was held in Zurich.",
      "timestamp": "2024-12-01T18:30:00Z"
    }
  ]
}

---

3. Webhooks & AI Alerts

POST /alerts

Allows AI agents to subscribe to intelligence updates.

Request Body

{
  "category": "finance",
  "keywords": ["insider trading", "offshore accounts"],
  "notify": "webhook"
}

Example Response

{
  "status": "success",
  "message": "Alert created successfully."
}

More on Webhooks

---

Error Codes & Handling

Code	Meaning	Solution
400	Bad Request	Check request parameters.
401	Unauthorized	Invalid or missing API key.
403	Forbidden	You don’t have access to this resource.
429	Too Many Requests	Rate limit exceeded. Wait or upgrade plan.
500	Internal Server Error	Try again later.

---

Example Integrations

Python Client

import requests

API_KEY = "YOUR_API_KEY"
url = "https://api.truthsatellite.com/facts?category=finance"

headers = {"Authorization": f"Bearer {API_KEY}"}
response = requests.get(url, headers=headers)

print(response.json())

JavaScript Client

const fetch = require('node-fetch');

const API_KEY = "YOUR_API_KEY";
const url = "https://api.truthsatellite.com/facts?category=finance";

fetch(url, {
    headers: { "Authorization": `Bearer ${API_KEY}` }
})
.then(res => res.json())
.then(data => console.log(data));

---

Changelog

✔ Version 1.3.2 (Current) – Expanded AI support, enhanced security features.

✔ Version 1.2.0 – Added historical intelligence archive.

✔ Version 1.0.0 – Initial API release.