What you get
| Field | Type | Sample value |
|---|---|---|
title |
string | Tarnina przy Szczecinku – działka budowlana 723 m2 |
price |
string | 119000.00 |
description |
string | TARNINA PRZY SZCZECINKU – DZIAŁKA BUDOWLANA 723 m2 DZIAŁKA POD BUDOWĘ DOMU JEDN… |
url |
string | gratka.pl/nieruchomosci/dzialka-szczecine… |
ad_keywords |
string | {"typstr":"strona_z_ogloszeniem","kat":"nieruchomosci","podkat":"dzialki-i-grun… |
area |
string | 723 |
data_layer |
string | {"property":{"id":49659791,"url":"https:\/\/gratka.pl\/nieruchomosci\/dzialka-s… |
environment_air_quality_level |
string | good |
All 52 fields
Key fields
titlepricedescriptionurlad_keywordsareadata_layerenvironment_air_quality_levelenvironment_air_qualityenvironment_air_quality_descriptionetagpowierzchniaheader_titleid_on_frontendis_highlightedlast_modifiedlocation_country_codelocation_locationlocation_map_zoomlocation_countylocation_communemarket_typepresentation_typeprice_currencyprice_m2_amountprice_formattedprice_m2_formattedpromotion_pointsreferencesales_manago_data_property_market_typesales_manago_data_property_transaction_typesales_manago_data_property_typesimilar_listing_urlstatustransactiontypes_primary_type
Technical fields
detailed_informationenvironment_public_transportidis_top_promotedoffer_detailed_informationphotosprice_m2_currencytypes_main_typeutilitiesservice_promocena_is_activecategory_pathpokojenumber_of_roomsnumber_of_rooms_countquestions_about_missing_detailscategory
Every field with its type, and the schemas, are in contract.json.
Sample records
1 saved record. This is a saved sample, not a live run.
title |
price |
description |
url |
ad_keywords |
area |
|---|---|---|---|---|---|
| Tarnina przy Szczecinku – działka budowlana 723 m2 | 119000.00 | TARNINA PRZY SZCZECINKU – DZIAŁKA BUDOWLANA 723 m2 DZIAŁKA POD BUDOWĘ DOMU JEDN… | gratka.pl/nieruchomosci/dzialka-szczecine… | {"typstr":"strona_z_ogloszeniem","kat":"nieruchomosci","podkat":"dzialki-i-grun… | 723 |
Scroll sideways to see more columns.
Inputs
-
urlURL · requiredPaste the URL of a gratka.pl page of the same kind as the sample: its path looks like /nieruchomosci/{slug}/ob/{int}. Any such page works, not only the one the API was built from.
Request
POST https://api.cleanedweb.com/v1/catalog/public/apis/generated_29ef9905a3fdba86da3951e8/endpoints/generated_29ef9905a3fdba86da3951e8_search/run
curl -X POST https://api.cleanedweb.com/v1/catalog/public/apis/generated_29ef9905a3fdba86da3951e8/endpoints/generated_29ef9905a3fdba86da3951e8_search/run \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Idempotency-Key: UNIQUE_REQUEST_ID" \
-H "Content-Type: application/json" \
-d '{
"input": {
"url": "https://gratka.pl/nieruchomosci/dzialka-szczecinecki-szczecinek/ob/49659791"
},
"version": 1,
"max_items": 25
}'
Save the Idempotency-Key before you send, and reuse it only to retry the same request. The key needs the run scope. See Run a catalog API.
version pins major v1, whose newest minor (1.0) answers. Leave it out and the call runs on the latest major.
Changelog
-
v1.0 (major) ·
Use it from an AI agent
Open in your coding agent
Add CleanedWeb to your agent as an MCP server, such as a custom connector in Claude or ChatGPT, then sign in with your CleanedWeb account. The agent can then find this API, run it and read the records. An API key with the read and run scopes works too.
https://api.cleanedweb.com/mcp?profile=catalog
Then ask, for example: Use CleanedWeb to get 25 records from the Gratka Property Details API.
The agent calls get_api with generated_29ef9905a3fdba86da3951e8, then run_api. Runs are charged like any other run. See Connect an MCP client.
Coverage
- Category
- Real estate
Reach. A run reads the one page you name and returns its record; max_items, timeout_seconds and your budget still bound it.
CleanedWeb is not affiliated with Gratka.