Purili Search API documentation

curl -sS "https://puri.li/api/search?q=privacy+search+engine&page=1"

const params = new URLSearchParams({ q: "privacy search engine", page: "1" })
const response = await fetch("https://puri.li/api/search?" + params)
if (!response.ok) throw new Error("Search request failed")

const data = await response.json()
for (const result of data.results) {
  console.log(result.title, result.url)
}

import requests

response = requests.get(
    "https://puri.li/api/search",
    params={"q": "privacy search engine", "page": 1},
    timeout=10,
)
response.raise_for_status()
for result in response.json()["results"]:
    print(result["title"], result["url"])

GET https://puri.li/api/search?q=site%3Aeuropa.eu+digital+privacy&page=1&exact=0

curl -sS "https://puri.li/api/search" \
  -H "Content-Type: application/json" \
  -d '{"q":"site:europa.eu digital privacy","page":1,"exact":false}'

{
  "results": [
    {
      "id": "crawled-0-1",
      "title": "Data protection in the EU",
      "url": "https://europa.eu/youreurope/citizens/consumers/internet-telecoms/data-protection-online-privacy/",
      "displayUrl": "europa.eu › youreurope › citizens › consumers",
      "description": "EU rules protect your personal data...",
      "favicon": "/api/favicon?host=europa.eu",
      "source": "crawled"
    }
  ],
  "total": 174,
  "timeMs": "0.09",
  "hasNext": true,
  "totalPages": 18,
  "page": 1,
  "correction": null
}

{
  "type": "showing",
  "original": "yahoo financ",
  "corrected": "yahoo finance"
}

curl -sS --get "https://puri.li/api/context" \
  --data-urlencode "url=https://example.com/article"

curl -sS "https://puri.li/api/context" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/article"}'

{
  "url": "https://example.com/article",
  "title": "Example article",
  "summary": "A concise stored summary.",
  "content": "Complete clean text stored by Purili...",
  "passages": ["First extracted passage...", "Second passage..."],
  "structured": { "type": "Article" },
  "coverage": "stored-extracted-passages",
  "source": "purili-index",
  "liveFetch": false
}

npm install @purili/web-search

import { purili } from "@purili/web-search"

const results = await purili.search("independent search engines")
const page = await purili.context(results.results[0].url)
console.log(page.content)

https://puri.li/mcp

{
  "mcpServers": {
    "purili": {
      "command": "npx",
      "args": ["-y", "@purili/mcp-server"]
    }
  }
}

const api = "https://puri.li"
const search = await fetch(api + "/api/search?q=" + encodeURIComponent(query))
const { results } = await search.json()

const sources = await Promise.all(
  results.slice(0, 5).map(async ({ url, title }) => {
    const response = await fetch(api + "/api/context?url=" + encodeURIComponent(url))
    if (!response.ok) return null
    const context = await response.json()
    return { title, url, text: context.content, coverage: context.coverage }
  })
)

const evidence = sources.filter(Boolean)

{
  "error": "URL not found in the Purili index.",
  "url": "https://example.com/not-indexed"
}