GROO reality Nabidky API
The Nabidky API from GROO reality — 2 operation(s) for nabidky.
Work with this as data
Every API 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 apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.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.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/groo-cz:groo-cz-nabidky-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: GROO reality — veřejné Nabidky API
version: 1.0.0
description: 'Nabídka nemovitostí realitní kanceláře GROO reality (Lenka Prajková, DiS.).
Čtení je otevřené a bez klíče; rozsah dat je stejný jako na webu. Limit je 60 požadavků za minutu na IP.
Kontaktní formulář API záměrně nenabízí — kontakt navazuje člověk.'
contact:
name: GROO reality
email: prajkova@groo.cz
url: https://www.groo.cz/
license:
name: CC BY 4.0
identifier: CC-BY-4.0
termsOfService: https://www.groo.cz/pravni-informace
servers:
- url: https://www.groo.cz/api/v1
description: Ostrý provoz
tags:
- name: Nabidky
paths:
/nabidky:
get:
operationId: vypisNabidek
summary: Výpis nabídek
description: Filtr přijímá tytéž parametry jako výpis na webu. Povolené hodnoty vrací /ciselniky.
parameters:
- name: typ
in: query
required: false
schema:
type: string
examples:
- prodej
description: prodej | pronajem
- name: kategorie
in: query
required: false
schema:
type: string
examples:
- byt
description: byt | dum | pozemek | komercni | ostatni
- name: dispozice
in: query
required: false
schema:
type: string
examples:
- 2+kk,3+1
description: Štítky oddělené čárkou; kategorii z nich odvodí
- name: obec
in: query
required: false
schema:
type: string
examples:
- Praha
description: Obec ze seznamu v /ciselniky
- name: cena_do
in: query
required: false
schema:
type: string
examples:
- '9000000'
description: Horní hranice ceny v Kč. Neodlišuje prodej od pronájmu — kombinujte s typ.
- name: vymera_od
in: query
required: false
schema:
type: string
examples:
- '60'
description: Dolní hranice výměry v m²
- name: q
in: query
required: false
schema:
type: string
description: Fulltext přes obec, ulici, dispozici i číslo nabídky
- name: limit
in: query
schema:
type: integer
default: 50
minimum: 1
maximum: 200
- name: offset
in: query
schema:
type: integer
default: 0
minimum: 0
responses:
'200':
description: Stránka výsledků
content:
application/json:
schema:
type: object
properties:
celkem:
type: integer
description: Počet všech odpovídajících
cena_na_vyzadani:
type: integer
description: Kolik z nich má cenu na vyžádání. Takové nabídky projdou jakýmkoli cena_do, takže o ně je celkem nadhodnocené.
limit:
type: integer
offset:
type: integer
dalsi:
type:
- string
- 'null'
format: uri
description: Odkaz na další stránku, nebo null na konci.
filtr:
type: object
description: Jak byl dotaz pochopen.
polozky:
type: array
items:
type: object
properties:
id:
type: string
examples:
- groo1516
url:
type: string
format: uri
nazev:
type: string
typ:
type:
- string
- 'null'
enum:
- prodej
- pronájem
- null
kategorie:
type:
- string
- 'null'
enum:
- byt
- dum
- pozemek
- komercni
- ostatni
- null
vymera_m2:
type:
- number
- 'null'
cena:
type: object
properties:
castka:
type:
- number
- 'null'
description: null = cena na vyžádání
mena:
type:
- string
- 'null'
examples:
- CZK
jednotka:
type:
- string
- 'null'
examples:
- za měsíc
skryta:
type: boolean
adresa:
type: object
properties:
obec:
type:
- string
- 'null'
cast_obce:
type:
- string
- 'null'
ulice:
type:
- string
- 'null'
description: Jen u nabídek, kde ulici ukazuje i stránka.
psc:
type:
- string
- 'null'
gps:
type:
- object
- 'null'
properties:
lat:
type: number
lon:
type: number
stav:
type: string
examples:
- v nabídce
- prodáno
nahled:
type:
- string
- 'null'
format: uri
perex:
type:
- string
- 'null'
'400':
description: Neplatný parametr
'429':
description: Překročený limit požadavků
tags:
- Nabidky
/nabidky/{id}:
get:
operationId: detailNabidky
summary: Detail nabídky
parameters:
- name: id
in: path
required: true
schema:
type: string
examples:
- groo1516
description: Číslo nabídky jako v URL webu; projde i holé číslo.
responses:
'200':
description: Nabídka i s popisem, parametry, fotkami a makléřem
content:
application/json:
schema:
allOf:
- type: object
properties:
id:
type: string
examples:
- groo1516
url:
type: string
format: uri
nazev:
type: string
typ:
type:
- string
- 'null'
enum:
- prodej
- pronájem
- null
kategorie:
type:
- string
- 'null'
enum:
- byt
- dum
- pozemek
- komercni
- ostatni
- null
vymera_m2:
type:
- number
- 'null'
cena:
type: object
properties:
castka:
type:
- number
- 'null'
description: null = cena na vyžádání
mena:
type:
- string
- 'null'
examples:
- CZK
jednotka:
type:
- string
- 'null'
examples:
- za měsíc
skryta:
type: boolean
adresa:
type: object
properties:
obec:
type:
- string
- 'null'
cast_obce:
type:
- string
- 'null'
ulice:
type:
- string
- 'null'
description: Jen u nabídek, kde ulici ukazuje i stránka.
psc:
type:
- string
- 'null'
gps:
type:
- object
- 'null'
properties:
lat:
type: number
lon:
type: number
stav:
type: string
examples:
- v nabídce
- prodáno
nahled:
type:
- string
- 'null'
format: uri
perex:
type:
- string
- 'null'
- type: object
properties:
popis:
type:
- string
- 'null'
dispozice:
type:
- string
- 'null'
examples:
- 3+kk
parametry:
type: array
items:
type: object
properties:
nazev:
type: string
hodnota:
type: string
jednotka:
type:
- string
- 'null'
fotky:
type: array
items:
type: string
format: uri
fotky_ai:
type: array
items:
type: string
format: uri
description: Podmnožina `fotky`, kterou vytvořila nebo upravila umělá inteligence (vizualizace, virtuální staging). Neukazují skutečný stav nemovitosti; štítek je vypálený i v obrázku.
zverejneno:
type:
- string
- 'null'
format: date
makler:
type:
- object
- 'null'
properties:
jmeno:
type: string
telefon:
type: string
email:
type: string
'404':
description: Nabídka neexistuje nebo není veřejná
'429':
description: Překročený limit požadavků
tags:
- Nabidky
externalDocs:
url: https://www.groo.cz/pro-ai
description: Stránka o strojových rozhraních — pro lidi i pro agenty