API Reference

Ask a question over HTTP and get an answer with its sources attached, or a clear note when none can be verified. No SDK required.

Base URL

https://api.pauhu.ai/v1

Responses are JSON. The cited-answer endpoint is open; no key is required for the free tier.

Search

GET /v1/search

Parameter	Type	Description
`q`	string, required	Your question or query.
`limit`	integer, optional	Maximum number of matches to return.
`lang`	string, optional	Preferred answer language (ISO code).

Example

curl "https://api.pauhu.ai/v1/search?q=GDPR&limit=1"

{
  "query": "GDPR",
  "count": 1,
  "answer": "The relevant source indicates: ...",
  "freshest_cited_at": "2018-05-25",
  "citations": [
    {
      "url": "https://eur-lex.europa.eu/legal-content/AUTO/?uri=CELEX:32016R0679",
      "text_fragment_url": "https://eur-lex.europa.eu/...#:~:text=...",
      "as_of": "2018-05-25",
      "signature": "cd5cac12...<cryptographic attestation>"
    }
  ]
}

The cited-answer model

Every answer is one of two things, never anything in between:

Cited. The answer links to its original source (url), a deep link to the exact passage (text_fragment_url), the date the source was current (as_of / freshest_cited_at), and a signature you can verify the citation against.
An explicit gap. When no source can be verified, count is 0 and the answer says so plainly. Pauhu does not invent a source.

Key response fields

Field	Description
`answer`	The answer text, grounded in the cited sources.
`count`	Number of verified matches. `0` means an honest gap.
`citations[]`	The sources: `url`, `text_fragment_url`, `as_of`, `signature`.
`freshest_cited_at`	The most recent date among the cited sources.

Coverage

Pauhu answers over EU legal, technical, and scientific sources, and is adding more. Cited programming answers are available; translation and voice are rolling out.

Authentication

The free cited-answer tier is open and anonymous. Higher-volume and team plans use a Bearer token in the Authorization header. See Pricing.

Questions or an issue? Email hello@pauhu.ai.