Publisher API Documentation

📘 Overview

This API provides content in multiple industry-standard formats designed for modern publishers, AI systems, search engines, and licensing platforms.

🚀 Quick Start

Base URL

https://drpaulfarrow.com/publisher

Example Requests

# Get all articles
curl https://drpaulfarrow.com/publisher/api/v1/articles

# Get single article
curl https://drpaulfarrow.com/publisher/api/v1/articles/privacy-first-advertising

# RSS feed
curl https://drpaulfarrow.com/publisher/rss.xml

# MCP query
curl -X POST https://drpaulfarrow.com/publisher/mcp \
  -H "Content-Type: application/json" \
  -d '{"tool":"get_article","parameters":{"slug":"privacy-first-advertising"}}'

📄 HTML Articles

Returns a fully-formed HTML article page with comprehensive metadata.

Included Metadata

• Schema.org: Article JSON-LD for search engines
• OpenGraph: Social media sharing metadata
• Twitter Cards: Twitter-specific metadata
• AI Permissions: Custom meta tags for AI crawlers
• Canonical URL: Preferred URL for content
• RSS Link: Auto-discovery for feed readers

AI Permission Tags

<meta name="ai-training" content="allow" />
<meta name="ai-inference" content="allow" />
<meta name="ai-commercial" content="allow" />

📰 RSS Feeds

Global Feed

Returns last 50 articles across all categories.

Category Feed

Example: /rss/privacy.xml

Tag Feed

Example: /rss/tag/ai.xml

Available Categories

privacy | neuroscience | adtech | ai | career

🗺️ XML Sitemaps

Sitemap index linking to all sub-sitemaps.

All article URLs with last modified dates.

Category listing pages.

Tag listing pages.

🔌 REST API

List Articles

Query Parameters

Parameter	Type	Description
category	string	Filter by category
tag	string	Filter by tag
limit	integer	Items per page (default: 20)
cursor	integer	Pagination offset (default: 0)

Example Response

{
  "data": [
    {
      "id": "privacy-first-advertising",
      "title": "The Future of Privacy-First Advertising",
      "author": "Dr. Paul Farrow",
      "published_at": "2025-01-15T10:00:00Z",
      "category": "privacy",
      "tags": ["privacy", "advertising"],
      "excerpt": "...",
      "canonical_url": "https://drpaulfarrow.com/publisher/privacy-first-advertising",
      "allow_ai_training": true,
      "allow_ai_inference": true
    }
  ],
  "pagination": {
    "cursor": 20,
    "hasMore": false,
    "total": 10
  }
}

Get Single Article

Returns complete article including HTML and plaintext content.

Other Endpoints

🎯 GraphQL API

Interactive GraphiQL interface available at /graphql

Example Query

query {
  articles(category: "privacy", limit: 5) {
    id
    title
    author
    published_at
    excerpt
    tags
    allow_ai_training
  }
  
  categories
  tags
}

Search Query

query {
  search(query: "artificial intelligence") {
    id
    title
    excerpt
    canonical_url
  }
}

🤖 MCP (Model Context Protocol)

Exposes publisher content to LLMs via standardized MCP tools.

Available Tools

Tool	Parameters	Description
list_articles	none	Get all articles with metadata
get_article	slug	Get single article by ID
search_articles	query	Search articles by text
get_categories	none	List all categories
get_tags	none	List all tags

Example Request

{
  "tool": "get_article",
  "parameters": {
    "slug": "privacy-first-advertising"
  }
}

Example Response

{
  "tool": "get_article",
  "result": { /* full article object */ },
  "timestamp": "2025-11-17T12:00:00Z",
  "rights": {
    "licensing_endpoint": "https://drpaulfarrow.com/publisher/api/v1/licensing",
    "attribution_required": true
  }
}

🌐 NLWeb Format

Natural Language Web format (v0.83+) with structured metadata for AI consumption.

Response Structure

• intent: Content purpose (inform, persuade, etc.)
• context: Domain, publisher, content type
• entities: People, topics, organizations mentioned
• claims: Key statements with confidence levels
• citations: Source attribution
• rights: Licensing and permissions
• suggested_actions: What users can do
• content: Full article text and metadata

📦 Archive Export

JSON Export

Complete archive in JSON format with metadata.

NDJSON Export

Newline-delimited JSON, one article per line.

XML Export

Complete archive in XML format.

🔒 Access Control

Robots.txt

Configures crawler access for different user agents including AI bots.

Rate Limiting

API endpoints are rate-limited to 100 requests per 15 minutes per IP address.

CORS

CORS is enabled for all origins to facilitate testing and integration.

📊 Content Model

All articles follow a unified content model:

{
  "id": "string (unique slug)",
  "title": "string",
  "subtitle": "string (optional)",
  "author": "string",
  "published_at": "ISO 8601 datetime",
  "updated_at": "ISO 8601 datetime",
  "category": "string",
  "tags": ["array of strings"],
  "excerpt": "string (short description)",
  "content_html": "string (HTML)",
  "content_plaintext": "string (plain text)",
  "cover_image_url": "string (optional)",
  "canonical_url": "string (full URL)",
  "rights_licensing": "string",
  "allow_ai_crawl": "boolean",
  "allow_ai_training": "boolean",
  "allow_ai_inference": "boolean",
  "licensing_endpoint": "string (URL)"
}

📞 Contact & Licensing

For licensing inquiries, commercial use, or technical support:

• Email: paulfarrow@microsoft.com
• Licensing API: /api/v1/licensing
• Website: drpaulfarrow.com

Attribution

When using content from this API, please provide proper attribution:

Farrow, P. (2025). [Article Title]. Retrieved from https://drpaulfarrow.com/publisher/[article-id]