Pi-hole website screenshot

Pi-hole

Pi-hole is an open source network-wide DNS sinkhole that blocks ads, tracking, and unwanted domains across all devices on a local network without requiring per-device software. It runs on lightweight hardware such as Raspberry Pi and offers a web admin interface plus a REST API (introduced in v6 via the pihole-FTL binary) for programmatic management of blocklists, allowlists, groups, clients, DNS settings, and live query logs.

Pi-hole publishes 4 APIs on the APIs.io network, including Auth API, DNS API, Groups API, and 1 more. Tagged areas include DNS, Ad Blocking, Network Security, Privacy, and Open-Source.

Pi-hole’s developer surface includes authentication, documentation, engineering blog, and 9 more developer resources.

🌐 Visit website 📡 Source on GitHub
24.4/100 emerging ▬ flat Agent 17/100 agent aware Full breakdown ↓
scored 2026-08-25 · rubric v0.14.0
AccessSelf serve
4 APIs
DNSAd BlockingNetwork SecurityPrivacyOpen-SourceSelf-Hosted

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-08-25 · rubric v0.14.0
Composite quality — 24.4/100 · emerging
Contract Quality 11.9 / 25
Developer Ergonomics 4.8 / 20
Access Clarity 0.0 / 20
Operational Transparency 0.3 / 13
Contract Governance 0.0 / 12
Discoverability 7.4 / 10
Agent readiness — 17/100 · agent aware
Machine-Readable Contract 18 / 18
Agentic Access Contract 10 / 10
Documented Reversibility 0 / 6
MCP Server 0 / 12
Machine-Readable Auth 10 / 10
Idempotency 0 / 9
Stable Error Semantics 0 / 8
Request/Response Examples 0 / 7
Rate-Limit Signaling 0 / 7
Typed Event Surface 0 / 6
Agent Skills 0 / 5
Well-Known Catalog 0 / 4
Consent & Bot Identity 0 / 3
A2A Agent Card 0 / 8
Dry-Run / Simulate Mode 0 / 4
Delegated User Identity 0 / 6
Protected Resource Metadata 0 / 5
Registration Without a Human 0 / 6
Agentic Commerce Surface 0 / 5
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/pi-hole: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 4

Individual APIs this provider publishes, each with its own machine-readable definition.

Pi-hole Auth API

Session authentication.

Pi-hole DNS API

DNS blocking configuration.

Pi-hole Groups API

Manage DNS blocking groups.

Pi-hole Info API

Pi-hole instance information.

Open Collections 6

Open, tool-agnostic API collections (OpenAPI-derived and Bruno).

API Collection

OPEN COLLECTION

Pi-hole REST Auth API

OPEN COLLECTION

Pi-hole REST Auth DNS API

OPEN COLLECTION

Pi-hole REST Auth Groups API

OPEN COLLECTION

Pi-hole REST Auth Info API

OPEN COLLECTION

Pi-hole REST API

OPEN COLLECTION

Security Posture 2

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Pi Hole Authentication

apiKey · 1 scheme

SECURITY

Pi Hole Domain Security

TLSv1.3 · HSTS · DMARC

SECURITY

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Pi Hole Agentic Access

7 operations · 4 acting

7 operations · 4 acting

AGENTIC

Resources

Documentation 1

Reference material describing how the API behaves

Documentation
Documentation

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

AgenticAccess
AgenticAccess

Build 2

SDKs, sample code, and the tooling you integrate with

GitHubOrganization
GitHubOrganization
 Source Code
Source Code

Access & Security 2

Authentication, authorization, and security posture

DomainSecurity
DomainSecurity
 Authentication
Authentication

Learn 1

Tutorials, courses, talks, and written guidance

Discourse Forum
Discourse Forum

Company 3

The organization behind the API

LinkedIn
LinkedIn
 Website
Website
 Blog
Blog

Other 2

Properties that don't map to a standard resource type

FTL Source
FTL Source
 Donate
Donate

Source (apis.yml)

apis.yml Raw ↑ 
aid: pi-hole
name: Pi-hole
description: Pi-hole is an open source network-wide DNS sinkhole that blocks ads, tracking, and unwanted domains across all
  devices on a local network without requiring per-device software. It runs on lightweight hardware such as Raspberry Pi and
  offers a web admin interface plus a REST API (introduced in v6 via the pihole-FTL binary) for programmatic management of
  blocklists, allowlists, groups, clients, DNS settings, and live query logs.
type: Index
accessModel:
  pricing: unknown
  onboarding: self-serve
  trial: false
  try_now: false
  public: false
  label: Self-serve signup
  confidence: medium
  source:
  - authentication
  generated: '2026-07-22'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/pi-hole.png
tags:
- DNS
- Ad Blocking
- Network Security
- Privacy
- Open-Source
- Self-Hosted
tags_raw:
- DNS
- Ad Blocking
- Network Security
- Privacy
- Open Source
- Self-Hosted
url: https://raw.githubusercontent.com/api-evangelist/pi-hole/refs/heads/main/apis.yml
created: '2026-05-11'
modified: '2026-05-11'
specificationVersion: '0.23'
apis:
- aid: pi-hole:pi-hole-auth-api
  name: Pi-hole Auth API
  description: Session authentication.
  humanURL: https://docs.pi-hole.net/api/
  baseURL: http://pi.hole/api
  tags:
  - Authentication
  tags_raw:
  - Auth
  properties:
  - type: OpenAPI
    url: openapi/pi-hole-auth-api-openapi.yml
  - type: Documentation
    url: https://docs.pi-hole.net/api/
  - type: Authentication
    url: https://docs.pi-hole.net/api/auth/
- aid: pi-hole:pi-hole-dns-api
  name: Pi-hole DNS API
  description: DNS blocking configuration.
  humanURL: https://docs.pi-hole.net/api/
  baseURL: http://pi.hole/api
  tags:
  - DNS
  properties:
  - type: OpenAPI
    url: openapi/pi-hole-dns-api-openapi.yml
  - type: Documentation
    url: https://docs.pi-hole.net/api/
  - type: Authentication
    url: https://docs.pi-hole.net/api/auth/
- aid: pi-hole:pi-hole-groups-api
  name: Pi-hole Groups API
  description: Manage DNS blocking groups.
  humanURL: https://docs.pi-hole.net/api/
  baseURL: http://pi.hole/api
  tags:
  - Group
  tags_raw:
  - Groups
  properties:
  - type: OpenAPI
    url: openapi/pi-hole-groups-api-openapi.yml
  - type: Documentation
    url: https://docs.pi-hole.net/api/
  - type: Authentication
    url: https://docs.pi-hole.net/api/auth/
- aid: pi-hole:pi-hole-info-api
  name: Pi-hole Info API
  description: Pi-hole instance information.
  humanURL: https://docs.pi-hole.net/api/
  baseURL: http://pi.hole/api
  tags:
  - Info
  properties:
  - type: OpenAPI
    url: openapi/pi-hole-info-api-openapi.yml
  - type: Documentation
    url: https://docs.pi-hole.net/api/
  - type: Authentication
    url: https://docs.pi-hole.net/api/auth/
common:
- type: AgenticAccess
  url: agentic-access/pi-hole-agentic-access.yml
- type: DomainSecurity
  url: security/pi-hole-domain-security.yml
- type: Authentication
  url: authentication/pi-hole-authentication.yml
- type: LinkedIn
  url: https://www.linkedin.com/company/the-pi-hole
- type: Website
  url: https://pi-hole.net
- type: Documentation
  url: https://docs.pi-hole.net
- type: GitHubOrganization
  url: https://github.com/pi-hole
- type: Source Code
  url: https://github.com/pi-hole/pi-hole
- type: FTL Source
  url: https://github.com/pi-hole/FTL
- type: Discourse Forum
  url: https://discourse.pi-hole.net
- type: Donate
  url: https://pi-hole.net/donate/
- type: Blog
  url: https://pi-hole.net/blog/
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com

Work with this as data

Every provider here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for providers

9 MCP tools reach this
  • find_providersBrowse and filter every provider in the catalog.
  • get_provider_artifactsEvery artifact this provider publishes, grouped by type.
  • get_provider_operationsEvery operation across all of their OpenAPIs — one call instead of parsing every spec.
  • get_provider_toolsEvery MCP tool they ship, with the operation each wraps.
  • get_provider_evidenceHow each part of their score was established. Free — the basis for a claim should not sit behind it.
  • get_provider_ratingPRO — composite, band, trend and facet scores.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools

Call it yourself

curl for this page
This provider 
curl "https://apis.io/api/v1/providers/pi-hole"
All providers 
curl "https://apis.io/api/v1/providers?limit=25"
Every operation they expose 
curl "https://apis.io/api/v1/providers/pi-hole/operations?limit=25"
How their score was established 
curl "https://apis.io/api/v1/providers/pi-hole/evidence"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.