Docs — Policy Data Commons

Overview

The Commons is a catalog: each listing documents where a data product lives and how to access it. Products maintained by Tech Policy Press share one API surface, documented here. Community products link out to their own docs from their listing page.

The public API exposes two resources for now: Entities (the knowledge graph — companies, agencies, people, regulations, topics) and the News feed (cited articles, optionally scoped to an entity). Everything is JSON over HTTPS.

Authentication

Authenticated endpoints take a bearer token from your account session:

curl https://api.knowledgehub.techpolicy.press/api/v1/entities \
  -H "Authorization: Bearer $TOKEN"

The MCP server requires no authentication — it is free and open, subject to rate limits and a global daily budget.

Entities

GET/api/v1/entities

Search and browse entities. Params: q (search), type (person, organization, regulation, court_case, event, concept, topic), limit, offset.

# response shape
{
  "data": [
    { "id": "…", "name": "Federal Trade Commission", "type": "agency",
      "slug": "ftc", "article_count": 412 }
  ],
  "meta": { "total": 1, "limit": 20, "offset": 0 }
}

GET/api/v1/entities/:idOrSlug

Full detail for one entity, including its relationships to other entities — each with a relationship type and confidence.

News feed

GET/api/v1/articles

Cited news items. Params: q, entity_id (scope to one entity), date_from, date_to, limit, offset. Every item carries source, url, and date.

curl "https://api.knowledgehub.techpolicy.press/api/v1/articles?entity_id=ftc&limit=10" \
  -H "Authorization: Bearer $TOKEN"

MCP server

Point any MCP-capable agent (Claude, ChatGPT, custom agents) at one endpoint and it can search the graph, pull evidence, and ask grounded questions. Add to your client config:

{
  "mcpServers": {
    "knowledge-hub": {
      "url": "https://api.knowledgehub.techpolicy.press/api/v1/mcp"
    }
  }
}

Available tools: search_entities, get_entity, search_articles, search_litigation, ask_knowledge_hub. Every tool response includes source, URL, and date on every item.

Datasets & CSVs

Products with a Dataset or CSV badge offer bulk downloads from their listing page. Licenses vary by product — check the listing's license field before redistribution.