--- title: "Spitogatos API: JSON data, 8 endpoints, 1 credit per call" description: "Spitogatos API for Greek property to rent or buy, listing counts, map results, properties, agents and areas as JSON. 1 credit per successful call." url: https://perceptlayer.com/apis/spitogatos --- [APIs](https://perceptlayer.com/apis) / [Real estate](https://perceptlayer.com/verticals/real-estate) / Spitogatos 1 credit per call 8 endpoints 12 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 key](https://perceptlayer.com/signup) Run 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 OK JSON X-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. | # | id integer | name string | slug string | logo url | profile\_url url | membership string | address string | area string | phones string\[\] | website url | is\_developer boolean | description string | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 1 | 20312 | TZELI HOME | TZELI-HOME | https://m2.spitogatos.gr/284965438\_200x100.jpg?v=20130730 | https://www.spitogatos.gr/mesites/TZELI-HOME/20312 | expert | Υμηττού, 41, Καισαριανή Ελλάδα, 16121 | Καισαριανή (Αθήνα - Νότια Προάστια) | \[2 items\] | https://tzelihome.gr/ | false | TZELI HOME REAL ESTATE Η εταιρεία TZELI HOME REAL ESTATE είναι η ελληνική δύναμη στον χώρο των ακινήτων στην Αθήνα. Υπεύθυνα και αξιόπιστα εξειδικεύεται σε όλο το φάσμα των κτηματομεσιτικών υπηρεσιών. Διαθέτει το πιο προηγμένο σύστημα … | | 2 | 9594 | ΤΖELI REAL ESTATE | TZELI-REAL-ESTATE | https://m3.spitogatos.gr/284405468\_200x100.jpg?v=20130730 | https://www.spitogatos.gr/mesites/TZELI-REAL-ESTATE/9594 | expert | ΑΓΙΟΥ ΑΝΔΡΕΟΥ 183 ΠΑΤΡΑ | Πάτρα (Αχαΐα) | \[2 items\] | https://tzelirealestate.gr/ | false | Η εταιρεία TZELI REAL ESTATE είναι η ελληνική δύναμη στον χώρο των ακινήτων στην Πάτρα . Υπεύθυνα και αξιόπιστα εξειδικεύεται σε όλο το φάσμα των κτηματομεσιτικών υπηρεσιών. Διαθέτει το πιο προηγμένο σύστημα μηχανογράφησης και την πιο ά… | Recorded from our API · 2 items shown · 12 datapoints per item GET /v1/spitogatos/agent-search?query=tzeli 12 datapoints ### Identity - id integer - name string - slug string ### Contact - profile\_url url - phones string\[\] - website url ### Location - address string - area string ### Other - logo url - membership string - is\_developer boolean - description string Playground ## Run this API cURL shell ``` 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. | Endpoint | Required parameters | Cost | | --- | --- | --- | | [GET `/v1/spitogatos/agent`](https://perceptlayer.com/apis/spitogatos/agent) | `id` +1 optional | 1 credit | | [GET `/v1/spitogatos/agent-properties`](https://perceptlayer.com/apis/spitogatos/agent-properties) | `id` +2 optional | 1 credit | | [GET `/v1/spitogatos/agent-search`](https://perceptlayer.com/apis/spitogatos/agent-search) | `query` +3 optional | 1 credit | | [GET `/v1/spitogatos/autocomplete`](https://perceptlayer.com/apis/spitogatos/autocomplete) | `query` +2 optional | 1 credit | | [GET `/v1/spitogatos/count`](https://perceptlayer.com/apis/spitogatos/count) | `listing_type` +20 optional | 1 credit | | [GET `/v1/spitogatos/property`](https://perceptlayer.com/apis/spitogatos/property) | `id` +1 optional | 1 credit | | [GET `/v1/spitogatos/search`](https://perceptlayer.com/apis/spitogatos/search) | `listing_type` +23 optional | 1 credit | | [GET `/v1/spitogatos/search-map`](https://perceptlayer.com/apis/spitogatos/search-map) | `listing_type` +20 optional | 1 credit | Overview ## About the Spitogatos API ## 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 estate JSON REST MCP ### More real estate APIs [28Hse](https://perceptlayer.com/apis/28hse) [4zida](https://perceptlayer.com/apis/4zida) [591](https://perceptlayer.com/apis/591-house) [99.co](https://perceptlayer.com/apis/99co) [99acres](https://perceptlayer.com/apis/99acres) [Adondevivir](https://perceptlayer.com/apis/adondevivir) [Apartment List](https://perceptlayer.com/apis/apartment-list) [Apartments.com](https://perceptlayer.com/apis/apartments-com) [Aqar](https://perceptlayer.com/apis/aqar) [Aqarmap](https://perceptlayer.com/apis/aqarmap) [Argenprop](https://perceptlayer.com/apis/argenprop) [athome](https://perceptlayer.com/apis/athome) 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 key](https://perceptlayer.com/signup) [Read the docs](https://docs.perceptlayer.com)