CenaDomeny.cz

API dokumentace

Veřejné API umožňuje zavolat stejné hodnocení domén, jaké nabízí web, přímo z vlastní integrace. Dostupné je pro tarify Starter a Pro.

Autentizace

API klíč si vygenerujete v sekci API klíč v Mém účtu - zobrazí se jen jednou hned po vygenerování, uložte si ho na bezpečné místo. Každé volání API ho posílá v hlavičce Authorization (nebo alternativně X-Api-Key):

Hlavička 
Authorization: Bearer cdk_váš_api_klíč

Uživatel smí mít jen jeden aktivní klíč - jeho vygenerováním v Mém účtu se předchozí klíč zneplatní.

Ohodnocení domény

POST /api/v1/domains/{domain}/analyze

Doména se zadává přímo v cestě URL. Tělo požadavku se neposílá.

cURL 
curl -X POST \
  -H "Authorization: Bearer cdk_váš_api_klíč" \
  https://cenadomeny.cz/api/v1/domains/example.cz/analyze

Odpověď - tarif Starter

Cena, cenové rozpětí a rozpad kalkulace.

200 OK · Starter 
{
  "domain": "example.cz",
  "valuation": {
    "currency": "CZK",
    "midpoint": 45000,
    "range": { "low": 30000, "high": 60000 }
  },
  "breakdown": [
    { "label": "Klíčové slovo / délka", "note": "...", "weight": 1.1 }
  ],
  "generatedAt": "2026-09-07T12:00:00+00:00"
}

Odpověď - tarif Pro

Vše z tarifu Starter a navíc AI popis webu (summary) a odkazy na živý náhled webu (preview).

200 OK · Pro 
{
  "domain": "example.cz",
  "valuation": { "currency": "CZK", "midpoint": 45000, "range": { "low": 30000, "high": 60000 } },
  "breakdown": [ { "label": "Klíčové slovo / délka", "note": "...", "weight": 1.1 } ],
  "generatedAt": "2026-09-07T12:00:00+00:00",
  "summary": "AI-generovaný popis webu...",
  "preview": {
    "desktop": "https://...",
    "mobile": "https://..."
  }
}

Chybové stavy

Status Chyba Význam
401 unauthorized Chybí, je neplatná nebo zneplatněná hlavička s API klíčem.
422 invalid_domain Doména v URL neodpovídá platnému formátu.
403 quota_exceeded Vyčerpaný měsíční limit API volání pro daný tarif.
429 rate_limited Příliš mnoho požadavků za krátký čas (viz limity níže). Hlavička Retry-After říká, za kolik vteřin to zkusit znovu.

Chybová odpověď má vždy tvar {"error": "...", "message": "..."}.

Limity

  • Měsíční kvóta API volání - 1000 pro Starter, 10000 pro Pro. Kvóta je oddělená od limitu analýz na webu a čerpá se jen při novém (nekešovaném) ocenění domény.
  • Tvrdý rate limit 30 požadavků/minutu na jeden API klíč, bez ohledu na měsíční kvótu.

Přehled vlastních posledních volání (čas, doména, status kód) najdete přímo v Mém účtu pod API klíčem.

Chcete si API vyzkoušet bez psaní kódu? Použijte API sandbox.