IPFYI

Developer Reference

Build with IPFYI

Public REST API with 11 endpoints. No authentication. OpenAPI 3.0 schema, machine-readable feeds, and markdown content endpoints.

API Documentation OpenAPI Schema

Quick Start

No API key. No signup. Just fetch.

GET /api/stats/ 
$ curl -s https://ipfyi.com/api/stats/

{
  "countries": 250,
  "asns": 500,
  "ports": 1025,
  "protocols": 50,
  "glossary_terms": 149,
  "guides": 149,
  "languages": 15
}

API Endpoints

Public, read-only, 120 req/min rate limit. All responses are JSON.

GET /api/countries/ List all ~250 countries
GET /api/asns/ Paginated autonomous systems
GET /api/cities/ Paginated cities
GET /api/isps/ Paginated ISPs
GET /api/ip-ranges/ Paginated IP ranges
GET /api/ports/ All ports ?risk_level=high
GET /api/protocols/ All network protocols
GET /api/glossary/ All glossary terms
GET /api/languages/ 15 supported languages
GET /api/stats/ Public data coverage statistics

Interactive docs at /api/docs/ · Schema at /api/schema/

Markdown Endpoints

Append .md to any content URL for plain-text markdown.

/protocol/<slug>.md → /protocol/http.md
/glossary/<slug>.md → /glossary/dns.md
/guides/<series>/<slug>.md → .../what-is-an-ip-address.md
/port/<number>.md → /port/443.md
/compare/<slug>.md → /compare/tcp-vs-udp.md

Content-Type: text/markdown; charset=utf-8 · CORS: *

Machine-Readable Files

Standard endpoints for crawlers, AI models, and automation.

robots.txt Crawler access rules sitemap.xml XML sitemap index security.txt Security contact · RFC 9116 schema.yaml OpenAPI 3.0 specification llms.txt AI/LLM site summary llms-full.txt Complete content index for LLMs

Subscribe

Networking guides via syndication feeds.

RSS 2.0 Atom 1.0 Sitemap

Usage

120 requests/min 0 auth required JSON response format UTF-8 encoding