# faceless-api

> UK public-sector data as clean JSON, one schema, refreshed daily from official
> Open-Government-Licence feeds — no scraping. Public procurement notices (Find a
> Tender OCDS) and planning applications (planning.data.gov.uk). Built for bid
> intelligence, proptech, and AI agents. Native MCP server + x402 pay-per-request.
> Personal data is dropped at ingest (Blind Mode).

Base URL: https://faceless-api.faceless-api.workers.dev
Machine-readable spec: https://faceless-api.faceless-api.workers.dev/openapi.json

## Auth & pricing

- Free key: sign up at the website (bot-protected form) → 250 requests/month,
  no card. Agents without a key can pay per request via x402 (see below) — no signup.
- Send the key as `Authorization: Bearer fapi_...` on every data request.
- 1 credit = 1 request; paid plans from $29/mo; usage at GET /v1/usage (free).
- Every response: {"ok":true,"data":[...],"meta":{...}} or
  {"ok":false,"error":{"code","message","docs_url"}}.

## Datasets

- GET /v1/data — list sources and their filter params (public).
- GET /v1/data/uk-tenders — UK public procurement notices (Find a Tender OCDS),
  for bid intelligence / lead-gen / market research. Filters: buyer, status,
  procurement_method, cpv_codes, value_amount_min/_max, published_at_after/_before,
  q, page, per_page.
- GET /v1/data/uk-planning — UK planning applications, same schema conventions.
  Filters: authority, reference, decision_date_after/_before, q, page, per_page.

## For AI agents

- MCP server (Streamable HTTP): https://faceless-api.faceless-api.workers.dev/mcp
  with the same bearer key. Tools: list_sources, get_usage, query_uk_tenders,
  query_uk_planning. Structured JSON results with credits_remaining in meta.
- x402 pay-per-request (no account, USDC on Base):
  GET /x402/data/{source} → HTTP 402 with payment requirements → pay → retry
  with X-PAYMENT header. ~$0.005/request.

## Docs

- Human docs: https://faceless-api.faceless-api.workers.dev/docs
- Quickstart: get a key, then
  curl -H "Authorization: Bearer fapi_..." "https://faceless-api.faceless-api.workers.dev/v1/data/uk-tenders?value_amount_min=1000000"