Data API

THE HOSTLIST
DATA API

A read-only JSON feed of 30,000+ web hosting companies, ranked by HRI, our independent rating with no paid placements. Build landing pages, comparison tools, or research on data you can actually trust, then attribute and link back.

Ranked, not paid

Every list is ordered by HRI, built from verified reviews, completeness, freshness and performance. No company pays for position.

Built for the web

Clean JSON, CORS open, CDN-cached one day. Fetch it server-side at build time and ship the data as static, indexable HTML.

Fair to use

Free for most editorial use in exchange for attribution and a dofollow link to hostlist.io. Tell us about commercial or high-volume use.

Endpoints

PUBLIC DATA. CLEAR ROUTES.

GET https://hostlist.io/api/v1/hosts?segment=PURE_HOST&category=wordpress-hosting&limit=100
GET https://hostlist.io/api/v1/hosts/{slug}
GET https://hostlist.io/api/v1/hosts/{slug}/facts
GET https://hostlist.io/api/v1/vocabulary

# sample
{
  "meta": { "source": "https://hostlist.io", "updated": "...", "count": 100 },
  "hosts": [
    {
      "rank": 1, "name": "ChemiCloud", "slug": "chemicloud-middletown-usa",
      "hostScore": 93, "subScores": { "trust": .., "performance": .. },
      "country": "USA", "website": "https://...", "logo": "https://...",
      "hostlistUrl": "https://hostlist.io/host/chemicloud-middletown-usa"
    }
  ]
}

Category queries share the same definitions and HRI order as the public category pages and return up to 120 hosts. Enumerate every category, country, and segment at /api/v1/vocabulary, or load category pool sizes from /api/v1/categories.

MCP server

HOSTLIST FOR AI TOOLS.

One endpoint, https://hostlist.io/api/mcp, over Streamable HTTP. Nothing to install, no local process, no key to paste. Point a client at it and five tools appear.

Claude Code
claude mcp add --transport http hostlist https://hostlist.io/api/mcp
Claude Desktop, Cursor, VS Code
{
  "mcpServers": {
    "hostlist": {
      "url": "https://hostlist.io/api/mcp"
    }
  }
}
No API key

Anonymous and read-only. An agent can query the directory the moment it connects. Nothing to request, nothing to rotate, no token in your transcript.

Read only, by design

Every tool reads. None of them writes, and there is no tool that edits a listing. Hosts update their own profile in the dashboard after claiming it, never through this endpoint.

The five tools
find_hostsSearch active hosting companies by name, country or segment. HRI order.
get_hostEverything public about one company: HRI and its four components, location, founding year, ratings.
compare_hostsTwo to five companies side by side on the same fields.
explain_hriThe current HRI version, its four pillars, and the ranking policy.
directory_activityThe latest dated changes to the directory.
Things to ask once it is connected
Which UK hosts score highest on HRI?Compare Hostinger, SiteGround and Kinsta.What is HostPapa’s Trust score and why?How is HRI calculated?Find hosting companies in Germany.What changed in the directory this week?
Who uses it
Bloggers and reviewersComparison and "best hosting" sitesAgencies recommending hostsResearchers and journalistsHosting tools and dashboardsAffiliate and deals sites
Ask for access

TELL US YOUR USE CASE.

The public endpoints are open. Use this form if you want a private key, guaranteed throughput, a custom dataset, or you are planning commercial use. We answer most requests within two working days.

THE DETAILS.

Is the HostList Data API free?

The data is free to use for most non-commercial and editorial use cases, in exchange for clear attribution and a dofollow link back to hostlist.io. High-volume or commercial use may have terms; tell us your use case and we will confirm.

What data does the API return?

Each host returns its name, HRI (and the trust, completeness, freshness and performance sub-scores), segment, country and city, founded year, logo, website, review ratings, and its hostlist.io profile URL. Lists are ranked by HRI, never by payment.

How fresh is the data?

Responses are cached for one day and reflect the latest HRI run. Rankings update as new reviews, performance signals and profile data come in. Fetch at build time and rebuild daily to stay current.

Can I use it on my own site?

Yes, that is exactly what it is for. Fetch it server-side at build time and render the data as static HTML. Keep your own editorial angle rather than copying full tables, attribute HostList, and link back with a dofollow link.

Do I need an API key?

Not by default, the public endpoints are open and CDN-cached. If your use case needs guaranteed throughput or a private key, request one through the form on this page.