Sign inGet a free API keyDashboard
Menu

APIs / Real estate / Spitogatos

1 credit per call8 endpoints12 datapoints

Spitogatos API

Spitogatos API for Greek property to rent or buy, listing counts, map results, properties, agents and areas as JSON. 1 credit per successful call.

Get a free API keyRun it below
Spitogatos
GET/v1/spitogatos/agent-search?query=tzeli
{
  "success": true,
  "data": {
    "query": "tzeli",
    "pagination": {
      "page": 1,
      "per_page": 25,
      "total": 2,
      "last_page": 1,
      "has_next_page": false
    },
    "items": [
      {
        "id": 20312,
        "name": "TZELI HOME",
        "slug": "TZELI-HOME",
        "logo": "https://m2.spitogatos.gr/284965438_200x100.jpg?v=20130730",
        "profile_url": "https://www.spitogatos.gr/mesites/TZELI-HOME/20312",
        "membership": "expert",
        "address": "Υμηττού, 41, Καισαριανή Ελλάδα, 16121",
        "area": "Καισαριανή (Αθήνα - Νότια Προάστια)",
        "phones": [
          "+302110014573",
          "+306906062919"
        ],
        "website": "https://tzelihome.gr/",
        "is_developer": false,
        "description": "TZELI HOME REAL ESTATE\n\nΗ εταιρεία TZELI HOME REAL ESTATE είναι η ελληνική δύναμη στον χώρο των ακινήτων στην Αθήνα.\n\n Υπεύθυνα και αξιόπιστα εξειδικεύεται σε όλο το φάσμα των κτηματομεσιτικών υπηρεσιών. \n Διαθέτει το πιο προηγμένο σύστημα …"
      },
      {
        "id": 9594,
        "name": "ΤΖELI REAL ESTATE",
        "slug": "TZELI-REAL-ESTATE",
        "logo": "https://m3.spitogatos.gr/284405468_200x100.jpg?v=20130730",
        "profile_url": "https://www.spitogatos.gr/mesites/TZELI-REAL-ESTATE/9594",
        "membership": "expert",
        "address": "ΑΓΙΟΥ ΑΝΔΡΕΟΥ 183 ΠΑΤΡΑ",
        "area": "Πάτρα (Αχαΐα)",
        "phones": [
          "+302616000500",
          "+306939850807"
        ],
        "website": "https://tzelirealestate.gr/",
        "is_developer": false,
        "description": "Η εταιρεία TZELI REAL ESTATE είναι η ελληνική δύναμη στον χώρο των ακινήτων στην Πάτρα .  \n\nΥπεύθυνα και αξιόπιστα εξειδικεύεται σε όλο το φάσμα των κτηματομεσιτικών υπηρεσιών.\n\nΔιαθέτει το πιο προηγμένο σύστημα μηχανογράφησης και την πιο ά…"
      }
    ]
  },
  "meta": {
    "endpoint_family": "agent_search",
    "request_id": "req_3eaf8bcf8181421dbcaa4a731134bb69",
    "credits_charged": 1,
    "credits_remaining": 1810
  }
}
200 OKJSONX-Credits-Used: 1
Recorded from our API and shortened.

Sample data

What one call returns

A recorded run of agent-search: the fields and shapes you will get, shortened to 2 items.

#idintegernamestringslugstringlogourlprofile_urlurlmembershipstringaddressstringareastringphonesstring[]websiteurlis_developerbooleandescriptionstring
120312TZELI HOMETZELI-HOMEhttps://m2.spitogatos.gr/284965438_200x100.jpg?v=20130730https://www.spitogatos.gr/mesites/TZELI-HOME/20312expertΥμηττού, 41, Καισαριανή Ελλάδα, 16121Καισαριανή (Αθήνα - Νότια Προάστια)[2 items]https://tzelihome.gr/falseTZELI HOME REAL ESTATE Η εταιρεία TZELI HOME REAL ESTATE είναι η ελληνική δύναμη στον χώρο των ακινήτων στην Αθήνα. Υπεύθυνα και αξιόπιστα εξειδικεύεται σε όλο το φάσμα των κτηματομεσιτικών υπηρεσιών. Διαθέτει το πιο προηγμένο σύστημα …
29594ΤΖELI REAL ESTATETZELI-REAL-ESTATEhttps://m3.spitogatos.gr/284405468_200x100.jpg?v=20130730https://www.spitogatos.gr/mesites/TZELI-REAL-ESTATE/9594expertΑΓΙΟΥ ΑΝΔΡΕΟΥ 183 ΠΑΤΡΑΠάτρα (Αχαΐα)[2 items]https://tzelirealestate.gr/falseΗ εταιρεία TZELI REAL ESTATE είναι η ελληνική δύναμη στον χώρο των ακινήτων στην Πάτρα . Υπεύθυνα και αξιόπιστα εξειδικεύεται σε όλο το φάσμα των κτηματομεσιτικών υπηρεσιών. Διαθέτει το πιο προηγμένο σύστημα μηχανογράφησης και την πιο ά…

Recorded from our API · 2 items shown · 12 datapoints per itemGET /v1/spitogatos/agent-search?query=tzeli

12 datapoints

Identity

  • idinteger
  • namestring
  • slugstring

Contact

  • profile_urlurl
  • phonesstring[]
  • websiteurl

Location

  • addressstring
  • areastring

Other

  • logourl
  • membershipstring
  • is_developerboolean
  • descriptionstring

Playground

Run this API

cURLshell
curl "https://api.perceptlayer.com/v1/spitogatos/agent-search?query=tzeli" \
  -H "X-API-Key: $API_KEY"

Spitogatos · 8 endpoints

Endpoints

Every endpoint takes the same key. Open one for its parameters and an example request.

EndpointRequired parametersCost
GET/v1/spitogatos/agent
id+1 optional
1 credit
GET/v1/spitogatos/agent-properties
id+2 optional
1 credit
GET/v1/spitogatos/agent-search
query+3 optional
1 credit
GET/v1/spitogatos/autocomplete
query+2 optional
1 credit
GET/v1/spitogatos/count
listing_type+20 optional
1 credit
GET/v1/spitogatos/property
id+1 optional
1 credit
GET/v1/spitogatos/search
listing_type+23 optional
1 credit
GET/v1/spitogatos/search-map
listing_type+20 optional
1 credit

Overview

What you can get

The Spitogatos API returns Spitogatos property data as JSON through 8 endpoints. Every endpoint takes an optional locale: el or en.

  • Search: search, count and search-map take a listing_type (rent or sale), with category (residential, commercial or land), area_ids[] and property_types[] (repeatable), construction_year_min, construction_year_max, price_min, price_max, area_min, area_max, rooms_min, rooms_max, and new_development, reductions, furnished, elevator, balcony, garden, air_conditioning and storage. search also takes sort (relevance or price), order (asc or desc) and page.
  • Properties: property takes an id.
  • Agents: agent-search takes a query, with area_id and page; agent takes an id; agent-properties takes an id, with page.
  • Autocomplete: autocomplete takes a query, with limit.

The recorded agent-search for "tzeli" returns the query, pagination with a total of 2 agents, and items, each with id, name, slug, logo, profile_url, membership, address, area, phones, website, is_developer and description.

How a call works

Find an agent, then their listings: GET /v1/spitogatos/agent-search?query=tzeli with your key in the X-API-Key header. Each item's id is what agent and agent-properties take. To search homes, call GET /v1/spitogatos/search?listing_type=rent&area_ids[]=100&price_max=900&rooms_min=2&sort=price. Every successful call costs 1 credit; failed calls cost nothing.

Real estateJSONRESTMCP

More real estate APIs

28Hse4zida59199.co99acresAdondevivirApartment ListApartments.comAqarAqarmapArgenpropathome

Use cases

Track asking rents and prices for an area in Greece

Use the Spitogatos API to track asking rents and prices for an area in Greece

Count listings that match a set of filters with `count`

Use the Spitogatos API to count listings that match a set of filters with `count`

Watch price reductions with `reductions`

Use the Spitogatos API to watch price reductions with `reductions`

List an agency's properties with `agent-properties`

Use the Spitogatos API to list an agency's properties with `agent-properties`

FAQ

Questions

Do I need a Spitogatos account?

No. You call this Spitogatos API with your Perceptlayer key in the `X-API-Key` header, with no Spitogatos login.

How much does the Spitogatos API cost?

Each successful call costs one credit. New accounts get free credits to start, and credit packs bring the price down as you scale.

What format are responses in?

Every endpoint returns JSON, with no HTML parsing on your side.

Can I get results in English?

Yes. Set `locale` to en, or el for Greek.

Should I build a Spitogatos scraper instead?

You can, but a Spitogatos scraper is code you maintain: page changes break it, requests get blocked, and Spitogatos's terms govern how you collect data. The Spitogatos API gives you 8 endpoints of named JSON fields for 1 credit per successful call, and failed calls cost nothing. A scraper makes sense only for data these endpoints don't return, so check the response in the playground on this page first.

Try the Spitogatos API with 100 free credits

No credit card. Failed calls are never billed.

Get a free API keyRead the docs