### GET /api/sources Source: https://osintmcp.com/api-docs/index List all ingested sources with their scraping status and metadata. ```APIDOC ## GET /api/sources ### Description List all ingested sources with their scraping status and metadata. ### Method GET ### Endpoint `/api/sources` ### Response #### Success Response (200) - **sources** (Source[]) - An array of source objects. - **count** (int) - The total number of sources. ### Response Example ```json { "sources": [ { "id": "src-abcde", "url": "http://example.com/source", "title": "Source Title", "content": "Content snippet.", "published_at": "2023-10-27T09:00:00Z", "scrape_status": "completed", "credibility": { "score": 0.8, "factors": ["established", "unbiased"] } } ], "count": 250 } ``` ### Request Example ```bash curl http://localhost:8080/api/sources ``` ``` -------------------------------- ### GET /api/thresholds Source: https://osintmcp.com/api-docs/index Get the current publication threshold configuration, including confidence, magnitude, and source age. ```APIDOC ## GET /api/thresholds ### Description Current publication threshold configuration (confidence, magnitude, source age). ### Method GET ### Endpoint `/api/thresholds` ### Response #### Success Response (200) - **ThresholdConfig** (object) - An object containing the current threshold settings. ### Response Example ```json { "min_confidence": 0.6, "min_magnitude": 3.0, "max_source_age_hours": 72 } ``` ### Request Example ```bash curl http://localhost:8080/api/thresholds ``` ``` -------------------------------- ### GET /api/stats Source: https://osintmcp.com/api-docs/index Retrieve system statistics including event counts, uptime, and performance metrics. ```APIDOC ## GET /api/stats ### Description System statistics including event counts, uptime, and performance metrics. ### Method GET ### Endpoint `/api/stats` ### Response #### Success Response (200) - **uptime_seconds** (int) - The system uptime in seconds. - **total_events** (int) - The total number of intelligence events processed. - **total_sources** (int) - The total number of ingested sources. - **avg_confidence** (float) - The average confidence score of events. - **enrichment_rate** (float) - The rate at which data is enriched. ### Response Example ```json { "uptime_seconds": 3600, "total_events": 15000, "total_sources": 250, "avg_confidence": 0.75, "enrichment_rate": 0.92 } ``` ### Request Example ```bash curl http://localhost:8080/api/stats ``` ``` -------------------------------- ### GET /api/feed.rss Source: https://osintmcp.com/api-docs/index Get an RSS 2.0 feed of the 20 most recent published intelligence events. ```APIDOC ## GET /api/feed.rss ### Description RSS 2.0 feed of the 20 most recent published intelligence events. ### Method GET ### Endpoint `/api/feed.rss` ### Response #### Success Response (200) - **application/rss+xml** - An RSS 2.0 formatted feed. ### Request Example ```bash curl http://localhost:8080/api/feed.rss ``` ``` -------------------------------- ### GET /api/pipeline/metrics Source: https://osintmcp.com/api-docs/index Retrieve processing pipeline metrics, including source and event counts by status and bottleneck analysis. ```APIDOC ## GET /api/pipeline/metrics ### Description Processing pipeline metrics including source and event counts by status, bottleneck analysis. ### Method GET ### Endpoint `/api/pipeline/metrics` ### Response #### Success Response (200) - **PipelineMetrics** (object) - An object containing various pipeline metrics. ### Response Example ```json { "source_counts": { "total": 250, "pending": 10, "completed": 230, "failed": 10 }, "event_counts": { "total": 15000, "published": 12000, "rejected": 1000, "pending": 2000 }, "bottlenecks": [ { "stage": "Data Extraction", "latency_ms": 500 } ] } ``` ### Request Example ```bash curl http://localhost:8080/api/pipeline/metrics ``` ``` -------------------------------- ### GET /api/events Source: https://osintmcp.com/api-docs/index Retrieve a list of intelligence events with options for filtering, pagination, and sorting. ```APIDOC ## GET /api/events ### Description Query intelligence events with filtering, pagination, and sorting. ### Method GET ### Endpoint `/api/events` ### Parameters #### Query Parameters - **limit** (int) - Optional - Maximum number of events to return (default: 100) - **page** (int) - Optional - Page number for pagination (default: 1) - **status** (string) - Optional - Filter by status: published, rejected, pending - **categories** (string[]) - Optional - Filter by categories (comma-separated) - **since** (timestamp) - Optional - Filter events after this timestamp ### Response #### Success Response (200) - **events** (Event[]) - A list of intelligence events. - **count** (int) - The total number of events matching the query. - **query** (EventQuery) - Details about the applied query parameters. ### Response Example ```json { "events": [ { "id": "evt-12345", "title": "New Geopolitical Development", "summary": "A significant event occurred in the region.", "category": "geopolitics", "magnitude": 0.8, "confidence": { "score": 0.7, "reasoning": "Multiple sources confirm.", "source_count": 5 }, "sources": [], "entities": [], "location": { "name": "Region A", "coordinates": [34.0522, -118.2437] }, "timestamp": "2023-10-27T10:00:00Z", "status": "published" } ], "count": 100, "query": { "limit": 20, "page": 1, "status": "published", "categories": "geopolitics", "since": "2023-10-26T00:00:00Z" } } ``` ### Request Example ```bash curl "https://osintmcp.com/api/events?limit=20&status=published" ``` ``` -------------------------------- ### GET /api/events/:id Source: https://osintmcp.com/api-docs/index Retrieve detailed information about a specific intelligence event using its unique identifier. ```APIDOC ## GET /api/events/:id ### Description Retrieve detailed information about a specific event by ID. ### Method GET ### Endpoint `/api/events/:id` ### Parameters #### Path Parameters - **id** (string) - Required - Unique event identifier ### Response #### Success Response (200) - **Event** (object) - Detailed information about the event. ### Response Example ```json { "id": "evt-1234567890", "title": "Specific Event Title", "summary": "Detailed summary of the event.", "category": "cyber", "magnitude": 0.9, "confidence": { "score": 0.95, "reasoning": "High certainty from multiple authoritative sources.", "source_count": 10 }, "sources": [ { "id": "src-abcde", "url": "http://example.com/source", "title": "Source Title", "content": "Content snippet.", "published_at": "2023-10-27T09:00:00Z", "scrape_status": "completed", "credibility": { "score": 0.8, "factors": ["established", "unbiased"] } } ], "entities": [ { "name": "Entity Name", "type": "person", "relevance": 0.7 } ], "location": { "name": "Specific Location", "coordinates": [40.7128, -74.0060] }, "timestamp": "2023-10-27T09:30:00Z", "status": "published" } ``` ### Request Example ```bash curl http://localhost:8080/api/events/evt-1234567890 ``` ``` -------------------------------- ### Retrieve System Statistics (API) Source: https://osintmcp.com/api-docs/index Fetches system statistics including uptime, total event and source counts, average confidence, and enrichment rate. Returns a JSON object with these metrics. Input: None. Output: JSON object. ```http GET /api/stats ``` -------------------------------- ### Retrieve Publication Thresholds (API) Source: https://osintmcp.com/api-docs/index Fetches the current configuration for publication thresholds, including minimum confidence, magnitude, and maximum source age. Returns a JSON object with the ThresholdConfig. Input: None. Output: JSON object. ```http GET /api/thresholds ``` -------------------------------- ### Retrieve Pipeline Metrics (API) Source: https://osintmcp.com/api-docs/index Fetches processing pipeline metrics, such as event counts by status and bottleneck analysis. Returns a JSON object representing PipelineMetrics. Input: None. Output: JSON object. ```http GET /api/pipeline/metrics ``` -------------------------------- ### List Ingested Sources (API) Source: https://osintmcp.com/api-docs/index Retrieves a list of all ingested sources, including their scraping status and metadata. The response is a JSON object containing a list of Source objects and the total count. Input: None. Output: JSON object. ```http GET /api/sources ``` -------------------------------- ### Retrieve Intelligence Events (API) Source: https://osintmcp.com/api-docs/index Fetches intelligence events with support for filtering by limit, page, status, categories, and timestamp. It returns a JSON object containing events, total count, and query parameters. Dependencies: None. Input: Query parameters. Output: JSON object. ```http GET /api/events?limit=20&status=published ``` -------------------------------- ### Retrieve RSS Feed of Events (API) Source: https://osintmcp.com/api-docs/index Provides an RSS 2.0 feed of the 20 most recent published intelligence events. The response content type is application/rss+xml. Input: None. Output: RSS 2.0 XML feed. ```http GET /api/feed.rss ``` -------------------------------- ### POST /api/thresholds Source: https://osintmcp.com/api-docs/index Update publication thresholds for event filtering. This allows adjustment of minimum confidence, minimum magnitude, and maximum source age. ```APIDOC ## POST /api/thresholds ### Description Update publication thresholds for event filtering. ### Method POST ### Endpoint `/api/thresholds` ### Parameters #### Request Body - **min_confidence** (float) - Optional - Minimum confidence score (0.0-1.0). If not provided, the current value is retained. - **min_magnitude** (float) - Optional - Minimum event magnitude. If not provided, the current value is retained. - **max_source_age_hours** (int) - Optional - Maximum source age in hours (0 = no limit). If not provided, the current value is retained. ### Response #### Success Response (200) - **ThresholdConfig** (object) - The updated threshold configuration. ### Response Example ```json { "min_confidence": 0.7, "min_magnitude": 4.0, "max_source_age_hours": 48 } ``` ### Request Example ```bash curl -X POST http://localhost:8080/api/thresholds \ -H "Content-Type: application/json" \ -d '{ "min_confidence": 0.6, "min_magnitude": 3.0, "max_source_age_hours": 72 }' ``` ``` -------------------------------- ### Update Publication Thresholds (API) Source: https://osintmcp.com/api-docs/index Updates the publication thresholds used for event filtering. Accepts a JSON payload with parameters like `min_confidence`, `min_magnitude`, and `max_source_age_hours`. Returns the updated ThresholdConfig. Dependencies: cURL or similar HTTP client. Input: JSON payload. Output: JSON object. ```http curl -X POST http://localhost:8080/api/thresholds -H "Content-Type: application/json" -d '{"min_confidence": 0.6, "min_magnitude": 3.0}' ``` -------------------------------- ### Retrieve Specific Event by ID (API) Source: https://osintmcp.com/api-docs/index Retrieves detailed information for a specific intelligence event using its unique identifier. The endpoint returns a JSON object representing the Event model. Input: Event ID. Output: JSON object (Event). ```http GET /api/events/evt-1234567890 ``` === COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.