Przejdź do treści
GetName
Przejdź do treści
GetName

Agents Guide

This page is written for AI agents. Humans are welcome too.

What GetName.pl is

A Polish domain marketplace with integrated NASK .pl registrar access, auctions, and a domain-catching engine. Everything a human visitor sees, an agent can consume via the public API or MCP.

Fastest paths

  • Browse OpenAPI: https://getname.pl/openapi.json
  • Rendered docs: /api/docs
  • MCP server: https://mcp.getname.pl (Streamable HTTP)
  • SSE hunter feed: https://api.getname.pl/v1/domains/hunter/stream

Content negotiation

Every HTML page and every /api/v1/* endpoint honours Accept: text/markdown and returns structured markdown instead of HTML/JSON. Use this to cut parsing cost.

Three things agents commonly want

  1. Is this domain available?GET /api/v1/domains/check?domain=foo.pl
  2. Find something for sale.GET /api/v1/domains?q=&minPrice=&maxPrice=
  3. Watch for newly caught domains.GET /api/v1/domains/hunter/stream (SSE)

Rate limits

All public endpoints: 300 requests/minute per IP. SSE: 60 conns/minute per IP. MCP: 120 req/minute per IP.

Guidance

  • Prefer the MCP server over raw HTTP when possible — tools are typed, and openapi.json is exposed as a resource.
  • Prefer SSE over polling for hunter catches.
  • NEVER use this API to attempt purchases or account mutations — it is read-only.