API Documentation

Integrate InfoMuck intelligence into your applications, workflows, and analytics platforms.

API Access

API access is available on Pro and Team plans. Generate your API key from Settings → API in your dashboard.

Quick Start

Authentication

All API requests require authentication via Bearer token:

curl https://api.infomuck.com/v1/briefings \
  -H "Authorization: Bearer YOUR_API_KEY"

Base URL: https://api.infomuck.com/v1
Format: JSON
Rate Limits: 1000 requests/hour (Pro), 5000 requests/hour (Team)

Endpoints

GET /briefings

Retrieve recent briefings with optional filters.

Query Parameters:

Parameter	Type	Description
`topic`	string	Filter by topic: ai, cyber, defence, antitrust, telecom
`since`	ISO 8601	Return briefings after this date (e.g., 2025-01-01)
`limit`	integer	Max results (default: 50, max: 100)
`impact`	string	Filter by impact level: low, medium, high, very_high

Example Request:

curl "https://api.infomuck.com/v1/briefings?topic=ai&limit=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response:

{
  "data": [
    {
      "id": "brief_abc123",
      "title": "OMB Overhaul Slashes AI Compliance Requirements 60%",
      "category": "AI Policy",
      "summary": "New OMB memos replace Biden-era safety vetting...",
      "impact": "high",
      "published_at": "2025-01-16T08:00:00Z",
      "read_time_minutes": 6,
      "sources": ["OMB", "FedScoop", "GAO Report"],
      "url": "https://infomuck.com/briefings/brief_abc123"
    }
  ],
  "pagination": {
    "next": "https://api.infomuck.com/v1/briefings?cursor=xyz789",
    "has_more": true
  }
}

GET /briefings/{id}

Retrieve a specific briefing by ID, including full content.

Example Request:

curl https://api.infomuck.com/v1/briefings/brief_abc123 \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response:

{
  "id": "brief_abc123",
  "title": "OMB Overhaul Slashes AI Compliance Requirements 60%",
  "category": "AI Policy",
  "content": "Full briefing markdown content here...",
  "impact": "high",
  "published_at": "2025-01-16T08:00:00Z",
  "read_time_minutes": 6,
  "sources": [
    {
      "name": "OMB Memo M-25-04",
      "url": "https://whitehouse.gov/omb/..."
    }
  ],
  "tags": ["ai", "compliance", "omb", "executive_action"]
}

GET /pipelines

List all your configured pipelines.

Example Response:

{
  "data": [
    {
      "id": "pipe_xyz456",
      "name": "AI Policy Watch",
      "filters": {
        "topics": ["ai"],
        "impact": ["high", "very_high"]
      },
      "delivery": {
        "method": "email",
        "frequency": "daily"
      },
      "active": true
    }
  ]
}

POST /pipelines

Create a new pipeline programmatically.

Example Request:

curl -X POST https://api.infomuck.com/v1/pipelines \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Cyber Alerts",
    "filters": {
      "topics": ["cyber"],
      "impact": ["high", "very_high"]
    },
    "delivery": {
      "method": "webhook",
      "url": "https://yourapp.com/webhook",
      "frequency": "realtime"
    }
  }'

Webhooks

Receive real-time notifications when new briefings match your pipeline filters.

Payload Format:

{
  "event": "briefing.published",
  "timestamp": "2025-01-16T08:00:00Z",
  "data": {
    "id": "brief_abc123",
    "title": "White House Issues Emergency AI Directive",
    "category": "AI Policy",
    "impact": "very_high",
    "url": "https://infomuck.com/briefings/brief_abc123"
  }
}

Security: All webhook requests include an X-InfoMuck-Signature header for verification.

Error Handling

The API uses standard HTTP status codes:

Code	Meaning
`200`	Success
`400`	Bad Request (invalid parameters)
`401`	Unauthorized (invalid API key)
`403`	Forbidden (plan doesn't include API access)
`429`	Rate Limit Exceeded
`500`	Internal Server Error

Error Response Format:

{
  "error": {
    "code": "invalid_parameter",
    "message": "Unknown topic 'blockchain'. Valid topics: ai, cyber, defence, antitrust, telecom",
    "param": "topic"
  }
}

Official SDKs

Python

pip install infomuck

View Docs →

Node.js

npm i @infomuck/node

View Docs →

Go

go get github.com/infomuck/go

View Docs →

Need Help?

Join our developer community or reach out to our technical support team.

Contact Support Example Code