Looking for the overview — what this API returns, what it costs, and a call you can run without a key? See the eauction.gr API page →

Real Estate

eauction.gr API & Scraper

Use search to list auctions from eauction.gr, the notaries' e-auction platform, filtered by auction date, posting date, status (posted, ready, completed, suspended, cancelled), outcome (awarded or no bidders), item type and subtype, one of the 13 regions, municipality, starting price, debtor name or auction code.

3 actionsLive JSON1,000 free credits$0.67–$1.50 / 1,000 creditsMCP-ready

Get a free key Open in playground

🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.

Each row carries an auction_id; pass it to detail for the full record: starting price, award amount when the auction was awarded, schedule in Europe/Athens time, debtors and pursuing creditors with tax ids as the source publishes them, the auction officer (notary), notes, documents, photos and the lots of a multi-property auction. Values are returned exactly as published: after an auction closes the platform itself replaces personal data with *** and the response says so.

Reference

Amounts and statuses

Keep the price basis and the source's own status words.

Field	Meaning
starting_price_eur	Τιμή 1ης Προσφοράς — the first-offer (starting) price set for the auction
award_amount_eur	Ποσό κατακύρωσης — the awarded amount, only on completed + awarded auctions
status / status_label	Stable slug plus the Greek label exactly as printed (Αναρτημένος, Έτοιμος προς διενέργεια, Ολοκληρωμένος, Σε αναστολή, Ματαιωμένος, ...)
outcome	awarded or no_bidders, completed auctions only
personal_data_withheld_by_source	true when the platform itself shows *** for names, tax ids and notes

Amounts are EUR as printed by the source; no fees or taxes are added. A group auction has no price of its own; its lots carry the prices.

Live example

Real request and response JSON

Captured from the indexed primary action, search, on Nov 3, 2026, 1:40 PM UTC.

Captured request

{
  "method": "POST",
  "url": "https://api.reefapi.com/eauction-gr/v1/search",
  "headers": {
    "x-api-key": "$REEF_KEY",
    "content-type": "application/json"
  },
  "body": {
    "item_type": "real_estate",
    "item_subtype": "residence",
    "region": "attica"
  }
}

Captured response

{
  "ok": true,
  "meta": {
    "api": "eauction-gr",
    "endpoint": "search",
    "mode": "live",
    "latency_ms": 1169.8,
    "record_count": 20,
    "bytes": 131581,
    "cache_hit": false,
    "upstream_requests": 2,
    "charged_credits": 2,
    "version": "0.1.0",
    "request_id": "f49e0e11f71b4bde",
    "queue_ms": 1.8,
    "fetched_at": "2026-11-03T13:40:19.076Z"
  },
  "data": {
    "auctions": [
      {
        "auction_id": "deaj05a_b107d5252gab0cbf3_c6_id3",
        "code": "EYFqSiXxuc",
        "url": "https://www.eauction.gr/Auction/Details/deaj05a_b107d5252gab0cbf3_c6_id3",
        "status": "ready",
        "status_label": "Έτοιμος προς διενέργεια",
        "outcome": null,
        "starting_price_eur": 87000,
        "starting_price_text": "87.000,00 €",
        "auction_date": "2026-11-04",
        "auction_time": "10:00",
        "auction_datetime_local": "2026-11-04T10:00:00",
        "timezone": "Europe/Athens",
        "posted_date": "2026-03-30",
        "debtors": [
          "ΜΠΟΥΚΑΚΙΩΤΗΣ ΔΗΜΗΤΡΙΟΣ"
        ],
        "debtors_withheld_by_source": false,
        "item_type": "real_estate",
        "item_type_label": "Ακίνητο",
        "item_subtype": "residence",
        "item_subtype_label": "Κατοικία",
        "region": "Αττικής",
        "region_slug": "attica",
        "municipality": "Αθηναίων",
        "is_lot": false,
        "parent_auction_id": null,
        "parent_code": null,
        "image_url": "https://www.eauction.gr/Auction/GetAuctionImage?auctionId=brUl%2fu1KIqY%3d&fileId=HPKxgynANDk%3d&thumb=true"
      },
      {
        "auction_id": "3_0h44206f7c7k___22a_e_501cac550",
        "code": "hJHEC9WQ3w",
        "url": "https://www.eauction.gr/Auction/Details/3_0h44206f7c7k___22a_e_501cac550",
        "status": "ready",
        "status_label": "Έτοιμος προς διενέργεια",
        "outcome": null,
        "starting_price_eur": 137500,
        "starting_price_text": "137.500,00 €",
        "auction_date": "2026-11-04",
        "auction_time": "10:00",
        "auction_datetime_local": "2026-11-04T10:00:00",
        "timezone": "Europe/Athens",
        "posted_date": "2026-04-02",
        "debtors": [
          "ΒΑΣΙΛΕΙΑΔΗ ΕΙΡΗΝΗ",
          "ΒΑΣΙΛΕΙΑΔΗΣ ΣΤΑΜΑΤΙΟΣ"
        ],
        "debtors_withheld_by_source": false,
        "item_type": "real_estate",
        "item_type_label": "Ακίνητο",
        "item_subtype": "residence",
        "item_subtype_label": "Κατοικία",
        "region": "Αττικής",
        "region_slug": "attica",
        "municipality": "Περιστερίου",
        "is_lot": false,
        "parent_auction_id": null,
        "parent_code": null,
        "image_url": "https://www.eauction.gr/Auction/GetAuctionImage?auctionId=4Y9NvIPKJoA%3d&fileId=JPEm3APkk6Q%3d&thumb=true"
      },
      {
        "auction_id": "ad2j5e2e5j20be40_2c72_133kd60d51",
        "code": "5ewcmTGnVK-001",
        "url": "https://www.eauction.gr/Auction/Details/ad2j5e2e5j20be40_2c72_133kd60d51",
        "status": "suspended",
        "status_label": "Σε αναστολή",
        "outcome": null,
        "starting_price_eur": 146000,
        "starting_price_text": "146.000,00 €",
        "auction_date": "2026-11-04",
        "auction_time": "10:00",
        "auction_datetime_local": "2026-11-04T10:00:00",
        "timezone": "Europe/Athens",
        "posted_date": "2026-04-06",
        "debtors": [
          "Θρασύβουλος ΒΑΣΙΛΑΤΟΣ του Μηνά και της Ελένης"
        ],
        "debtors_withheld_by_source": false,
        "item_type": "real_estate",
        "item_type_label": "Ακίνητο",
        "item_subtype": "residence",
        "item_subtype_label": "Κατοικία",
        "region": "Αττικής",
        "region_slug": "attica",
        "municipality": "Πειραιώς",
        "is_lot": true,
        "parent_auction_id": "0bbc64dd7311140_3g67c613c3_14eac",
        "parent_code": "5ewcmTGnVK",
        "image_url": "https://www.eauction.gr/Auction/GetAuctionImage?auctionId=OAbDrgXyLbg%3d&fileId=GuzP995tKxE%3d&thumb=true"
      }
    ],
    "total": 1830,
    "total_is_exact": true,
    "page": 1,
    "page_size": 20,
    "last_page": 92,
    "has_more": true,
    "next_page": 2,
    "page_beyond_last": false,
    "empty_confirmed": false,
    "query": {
      "date_from_defaulted": true,
      "date_from": "2026-11-03",
      "date_to": null,
      "posted_from": null,
      "posted_to": null,
      "status": "all",
      "outcome": null,
      "item_type": "real_estate",
      "item_subtype": "residence",
      "region": "Αττικής",
      "municipality": null,
      "min_price": null,
      "max_price": null,
      "debtor": null,
      "code": null,
      "sort": "date_asc",
      "page": 1
    },
    "source": "eauction.gr"
  }
}

Actions

What the eauction.gr API does

Action	Description	Concrete use case	Key params
search	Search Greek electronic public auctions (eauction.gr, the notaries' platform): by auction date, posting date, status/outcome, item type and subtype, region, municipality, starting price, debtor name or auction code.	Real-estate investors call search to search Greek electronic public auctions (eauction.gr, the notaries' platform).	date_from, date_to, posted_from, posted_to, status, ...
detail	Full public record of one auction: status, award amount when the source publishes it, starting price, schedule, debtors and pursuing creditors with tax ids as published, the auction officer (notary) and contact, notes, documents, photos, lots.	Brokerage tools call detail to get full public record of one auction.	auction_id, url
filters	The source's own filter lists: statuses, outcomes, item types and subtypes, the 13 regions with their municipalities (ids + Greek names), ship types, sorts.	Property dashboards call filters to get the source's own filter lists.	none

Code samples

Call search from your stack

curl -X POST https://api.reefapi.com/eauction-gr/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"item_type":"real_estate","item_subtype":"residence","region":"attica"}'

import requests

r = requests.post(
    "https://api.reefapi.com/eauction-gr/v1/search",
    headers={"x-api-key": REEF_KEY},
    json={
  "item_type": "real_estate",
  "item_subtype": "residence",
  "region": "attica"
},
)
print(r.json()["data"])

const res = await fetch("https://api.reefapi.com/eauction-gr/v1/search", {
  method: "POST",
  headers: {
    "x-api-key": process.env.REEF_KEY,
    "content-type": "application/json",
  },
  body: JSON.stringify({
  "item_type": "real_estate",
  "item_subtype": "residence",
  "region": "attica"
}),
});
const { ok, data, meta, error } = await res.json();

MCP one-liner

Ask your MCP-connected assistant: call reefapi.eauction-gr.search with {"item_type":"real_estate","item_subtype":"residence","region":"attica"}.

Use cases

Who uses this API and why

Distressed real estate deal sourcing in Greece
Tracking auction results and award amounts
Monitoring auctions by region or municipality
Credit and NPL servicer portfolio research
Alerting on newly posted auctions

FAQ

Questions developers ask before integrating

Which auctions are covered?

The public eauction.gr search: real estate (12,126 upcoming on 2026-11-03), movable items (159), other (3) and perishable goods (0 that day). Upcoming and recent auctions are both searchable with date_from / date_to.

Why do I get 'too broad'?

The platform refuses very wide searches. A window starting 2026-07-01 (31,984 results) was accepted on 2026-11-03; a window starting 2026-05-01 was refused. Narrow with date_to, item_type, region or status. The answer is an INVALID_PARAM error with the platform's own sentence, never a silent empty list.

How does paging work?

20 auctions per page. The response gives the exact total, last_page, has_more and next_page. Asking past the last page returns page_beyond_last: true with the real total.

Can I filter by region and municipality?

Yes, for real estate. Region accepts a slug (attica, crete, central-macedonia ...), the Greek name or the platform id; municipality accepts the Greek name or id. The filters action lists all 13 regions and 325 municipalities.

Do I get the winning bid?

The awarded amount is returned for completed auctions with outcome awarded (for example 7,610.00 € on a 7,605.00 € starting price). The winning bidder is not published by the platform.

Why are some names ***?

After an auction is completed, suspended or cancelled the platform withholds personal data under GDPR and prints ***. The API returns exactly that and sets personal_data_withheld_by_source to true.

Is the floor area returned?

Not as a field: the platform does not publish area or street address as structured data. They usually appear in the notes text and the attached documents, which are returned with their links.

What is not included?

Bidding, registration, participant lists and anything that needs an account. Documents and photos are returned as links, not as file contents.

What is the eauction.gr API?

eauction.gr API is a ReefAPI endpoint group for greek notaries' electronic public auctions: property and movable auctions, starting prices, status, results and full auction records. It returns live JSON through POST requests under /eauction-gr/v1.

Is the eauction.gr API free to try?

Yes. ReefAPI starts with 1,000 free credits, no card required. eauction.gr calls use the same shared credit balance as every other ReefAPI engine.

Do I need an eauction.gr login or account?

No login to eauction.gr is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.

How fresh is the eauction.gr data?

The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.

How many credits does the eauction.gr API use?

eauction.gr actions currently cost 2 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.

Can I call eauction.gr from an AI assistant or MCP client?

Yes. Connect ReefAPI once through MCP and your assistant can call eauction-gr actions with the same key, credit pool and JSON envelope used by normal REST requests.

docs / eauction-gr

eauction.gr

Greek notaries' electronic public auctions: property and movable auctions, starting prices, status, results and full auction records.

base /eauction-gr/v13 endpoints

post/eauction-gr/v1/search2 credits

Search Greek electronic public auctions (eauction.gr, the notaries' platform): by auction date, posting date, status/outcome, item type and subtype, region, municipality, starting price, debtor name or auction code.

Parameter		Allowed / range	Description
date_from	optional	—	Auction (conduct) date from, YYYY-MM-DD. Default: today in Greece — the source's own default. The source refuses very wide windows (it answers 'too many results'; measured: from 2026-07-01 = 31,984 results accepted, from 2026-05-01 refused) — narrow with date_to, item_type, region or status.
date_to	optional	—	Auction (conduct) date to, YYYY-MM-DD, inclusive.
posted_from	optional	—	Date the auction was posted on the platform, from (YYYY-MM-DD).
posted_to	optional	—	Date the auction was posted on the platform, to (YYYY-MM-DD).
status = all	optional	posted · open · ready · cancelled · completed · participants_finalized · suspended · all	Auction status as the source names it. 'completed' = conducted; combine with 'outcome' to keep only awarded or only no-bidder results.
outcome	optional	awarded · no_bidders	Only with status=completed: awarded auctions or those that ended without bidders.
item_type	optional	real_estate · movable · other · perishable	What is auctioned: real_estate (Ακίνητο), movable (Κινητό), other, perishable.
item_subtype	optional	residence · other_commercial · shop · office · parking · storage · industrial · plot · plot_with_building · farmland · farmland_with_building · hotel · ship · other_movable	Property/movable subtype (residence, shop, office, plot, farmland, hotel, ship, ...). Implies its item_type.
region	optional	east-macedonia-thrace · attica · north-aegean · western-greece · western-macedonia · epirus · thessaly · ionian-islands · central-macedonia · crete · south-aegean · peloponnese · central-greece	One of Greece's 13 regions (slug, the Greek name as printed by the source, or the source's numeric id from the 'filters' action). Real estate only.
municipality	optional	—	Municipality (Δήμος) — the Greek name as printed by the source or its numeric id (see the 'filters' action). Real estate only; implies its region.
min_price	optional	0–	Minimum starting price (Τιμή 1ης Προσφοράς) in EUR, whole euros.
max_price	optional	0–	Maximum starting price in EUR, whole euros.
debtor	optional	—	Search by debtor name as published (5-399 characters, case-insensitive, Greek or Latin as the source wrote it). The source withholds names after an auction closes.
code	optional	—	The auction's unique code (Μοναδικός Κωδικός), or its beginning (5-49 characters). Lots carry the parent code plus -001, -002...
sort = date_asc	optional	date_asc · date_desc · price_asc · price_desc	Sort order (the source's four orders).
page = 1	optional	1–100000	Result page, 20 auctions per page. has_more/next_page say whether another exists.

Try in playground →

post/eauction-gr/v1/detail2 credits

Full public record of one auction: status, award amount when the source publishes it, starting price, schedule, debtors and pursuing creditors with tax ids as published, the auction officer (notary) and contact, notes, documents, photos, lots.

Parameter		Allowed / range	Description
auction_id	required	—	auction_id from search (or parent_auction_id / related_auctions[].auction_id).
url	optional	—	Alternatively the full eauction.gr /Auction/Details/ URL.

Try in playground →

post/eauction-gr/v1/filters2 credits

The source's own filter lists: statuses, outcomes, item types and subtypes, the 13 regions with their municipalities (ids + Greek names), ship types, sorts.

Try in playground →

Example request · search

curl -X POST https://api.reefapi.com/eauction-gr/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"item_type":"real_estate","item_subtype":"residence","region":"attica"}'

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}

Built for volume

5M+ requests a day

Measured at 60 requests a second across the fleet, with no central bottleneck. Volume pricing is on request, and per-key limits are raised for high-volume accounts.

Missing a source?

We build it

Tell us a site we do not cover yet and it becomes an engine. A customer asked for bestprice.gr on a Sunday and it was in the catalog the next day.

Support

2 minute median reply

Median time from a question in the live chat to the first answer, measured across every answered conversation. Setup help included, no support tier to buy.

One key, one balance

Every API included

No per-site plans and no separate subscriptions. One key and one credit pool across the whole catalog, so adding a source costs nothing up front.

Planning something large? Tell us the volume and the sources and we will come back with what it costs and what we would have to build.

Comparing scraping APIs?ReefAPI vs Bright Data