Sign in Get API key
Gratka API

Polish Property Listings for Sale and Rent, Listing Details, Locations and Agents

Scrappa's read-only Gratka API turns the Polish property portal into structured JSON. Search flats, houses, rooms, commercial units, garages and plots for sale or rent by city, district, price, area, rooms and sort; read full listing details with coordinates, features, fees and images; find cities and districts; and read the agency behind a listing.

500 free credits
No card needed
From $0.20 / 1k
Pay as you go
Structured JSON
Ready for apps
API key access
Test in minutes
Start for free View documentation
Browse endpoints Try first endpoint
4
Endpoints
Poland
Market
Sale and rent
Transactions

Try it now

Make one request. Inspect structured JSON.

Use the first endpoint in this API family with a Scrappa API key. Every account includes 500 free monthly credits, so you can validate the response shape before buying credits.

Get free API key Try in Playground Open docs
Request preview
Request 
curl -X GET "https://scrappa.co/api/gratka/search?type=mieszkania&transaction=rent&location=krakow&price_max=3000&sort=cheap" \
  -H "Accept: application/json" \
  -H "X-API-KEY: YOUR_API_KEY"
JSON response 
{
  "success": true,
  "transaction": "rent",
  "type": "mieszkania",
  "total": 1503,
  "page": 1,
  "per_page": 35,
  "total_pages": 43,
  "has_more": true,
  "listings": [],
  "meta": {
    "endpoint_family": "search",
    "billable": true,
    "attempts": 1,
    "filtered_out": 0
  }
}

What you can build

Structured data for real applications. Here are some ideas.

Property Search Applications

Build Polish property search with filters for type, city, district, price, area, rooms and sort.

Market Monitoring

Track asking prices and price per square metre by city and district for sale and rent.

Listing Data Enrichment

Pull the full record of a listing: price, area, rooms, bedrooms, bathrooms, coordinates, features and photos.

Agency Research

See which agency or agent sits behind a listing and what else they offer.

Location Tools

Resolve place names to search-ready city and district values with autocomplete.

Gratka scraper API

Gratka API for property search, listing details, locations and agents in Poland

The Gratka API is built for proptech teams, investors and analysts working with Polish property. Search listings for sale and rent, then use listing details, location autocomplete and agent data to build search tools, market monitors and data products.

Search flats, houses, rooms, commercial units, garages and plots.

Filter by city, district, price, area, rooms and sort.

Get full listing details with coordinates, features and photos.

Find cities and districts the search accepts.

Read the agency and agent behind a listing.

Call 4 read-only endpoints that return structured JSON.

Choose the right Gratka API endpoint

Search Gratka listings

Find a city with location autocomplete, then pass it to the search endpoint with a price range. Filters are applied by Gratka and unknown parameters are rejected.

Open Gratka Property Search API docs

Read the full record of a listing

Take the url from search and request the listing endpoint for coordinates, bedrooms, bathrooms, features and all photos.

Open Gratka Listing Details API docs

Look up an agency

Send a listing url to the agent endpoint to read the agency, the agent and their other listings.

Open Gratka Agent Profile API docs

Available endpoints

Everything you need in one API.

Related resources

Otodom API overview

Compare with Polish listings from Otodom.

Scrappa vs Do-it-yourself property data extraction

See how Scrappa compares to the official API.

Dedicated Gratka endpoints
Scrappa: yes (4 endpoints)
Do-it-yourself property data extraction:
Output format
Scrappa: Structured JSON
Do-it-yourself property data extraction: Raw page content
Unknown filters
Scrappa: Rejected with a clear error
Do-it-yourself property data extraction: Silently ignored by the platform
Request mode
Scrappa: Read-only
Do-it-yourself property data extraction: Depends on implementation
Parser maintenance
Scrappa: Handled by Scrappa
Do-it-yourself property data extraction: Your team

Key features

4 read-only endpoints for Poland
Sale and rent listings
Filters for type, city, district, price, area, rooms and sort
Full listing details with coordinates, features and photos
Location autocomplete with search-ready values
Agency and agent data derived from a listing
Phone numbers are not returned

Frequently asked questions

The Gratka API is Scrappa's read-only REST API for property listings in Poland. It covers search, listing details, location autocomplete and agent data.

No. Scrappa is an independent service and is not affiliated with or endorsed by Gratka. A Scrappa API key is used to access the endpoints on this page.

No. Gratka has no such filter. Bedrooms and bathrooms are returned per listing by the listing endpoint when the seller entered them.

No. Phone and fax numbers are never returned.

No. Gratka has no standalone agency page, so the agent endpoint reads the agency from one listing.

No. All Gratka endpoints on this page are read-only.

Start using the Gratka API

Sign up and get 500 free credits. No credit card required.

Create Free Account View Documentation