Project Ghost API

The web reading layer for AI agents. Convert any public URL into structured, agent-ready data — entities, signals, summaries — in a single API call.

BASE URL https://project-ghost-production.up.railway.app

Auth Required

None

Open API — no key needed

Response Format

JSON

All endpoints return JSON

Avg Response Time

~7s

Including AI processing

MCP Support

Native

Works with Cursor & Claude

Quick Start

Make your first API call in 30 seconds.

cURL
Python
JavaScript
# Extract structured data from any URL
curl -X POST https://project-ghost-production.up.railway.app/distill   -H "Content-Type: application/json"   -d '{"url": "https://apple.com"}'

Endpoints

POST /distill Any URL → structured agent data ▼

Description

The core endpoint. Pass any public URL and receive structured intelligence — title, summary, entities, signals, confidence score, and tokens saved. Powers all agent use cases.

Request Body

url requiredstringAny publicly accessible URL. Example: https://apple.com

Example Request

POST /distill
{
  "url": "https://apple.com"
}

Example Response

200OK

{
  "url": "https://apple.com",
  "title": "Apple",
  "content": "Apple MacBook Neo Amazing Mac...",
  "tokens_saved": "91.2%",
  "signals_data": {
    "decision_signal": {
      "business_intent": "Apple promotes its latest hardware lineup...",
      "priority_score": 8,
      "category": "Technology"
    },
    "items": [
      {
        "title": "MacBook Pro with M5",
        "entities": ["Apple", "MacBook", "M5"],
        "impact_score": 9
      }
    ],
    "integrity_layer": {
      "confidence_score": 0.87,
      "is_high_integrity": true
    }
  },
  "created_at": "2026-03-13T10:00:00Z"
}

GET /health Liveness check ▼

Description

Returns API status and current version. Use this to verify the service is running before making distill calls.

Example Response

200OK

{
  "status": "ok",
  "version": "2.0"
}

GET /feed Poll cached intelligence signals ▼

Description

Returns previously processed signals from the Ghost intelligence database. Use this to poll for cached results without re-processing URLs.

Query Parameters

limitintegerNumber of results to return. Default: 20, Max: 100

min_confidencefloatFilter by minimum confidence score (0.0 - 1.0). Default: 0.5

Example Request

GET /feed?limit=10&min_confidence=0.7

GET /search Search signals by entity name ▼

Description

Search the Ghost intelligence database by entity name. Returns all signals where the entity appears — companies, people, products.

Query Parameters

q requiredstringEntity name to search for. Example: nvidia, apple, elon musk

limitintegerNumber of results. Default: 10

Example Request

GET /search?q=apple&limit=5

MCP /mcp Native MCP agent integration ▼

Description

Native Model Context Protocol endpoint. Plug Ghost directly into Cursor, Claude Desktop, or any MCP-compatible agent framework as a tool.

MCP Config (Claude Desktop / Cursor)

{
  "mcpServers": {
    "project-ghost": {
      "url": "https://project-ghost-production.up.railway.app/mcp",
      "transport": "http"
    }
  }
}

Project Ghost v2.0 · Landing Page · Contact