---
title: "4zida API: Search | Perceptlayer"
description: "Search from 4zida as JSON. 1 credit per successful call."
url: https://perceptlayer.com/apis/4zida/search
---

[APIs](https://perceptlayer.com/apis) / [4zida](https://perceptlayer.com/apis/4zida) / Search

# 4zida: Search

Search from 4zida as JSON. 1 credit per successful call.

GET `/v1/4zida/search`

## Parameters

Send parameters in the query string.

| Parameter | Type | Required | Allowed values |
| --- | --- | --- | --- |
| `for` | string | Required | sale, rent |
| `type` | string | Optional | apartments, houses, offices, lots, vehicle\_spots |
| `place_ids[]` | list of integer | Optional | Any |
| `min_price` | integer | Optional | Any |
| `max_price` | integer | Optional | Any |
| `min_area` | integer | Optional | Any |
| `max_area` | integer | Optional | Any |
| `min_price_per_m2` | integer | Optional | Any |
| `max_price_per_m2` | integer | Optional | Any |
| `min_floor` | integer | Optional | Any |
| `max_floor` | integer | Optional | Any |
| `rooms[]` | list of string | Optional | studio, one\_room, one\_and\_half\_room, two\_room, two\_and\_half\_room, three\_room, three\_and\_half\_room, four\_room, four\_and\_half\_plus, one\_floor, two\_floors, three\_floors, four\_floors, five\_floors, six\_floors, shop, office, practice, warehouse, hall, catering, kiosk, plant, sports, yard, tourist, building, building\_land, farmland, industrial\_land, garage, parking |
| `categories[]` | list of string | Optional | flat, house\_flat, studio, salon, penthaus, garden\_apartment, duplex, vacation-house, montage-house, row-house, detached-house, semi-detached-house, village-house, homestead, household |
| `states[]` | list of string | Optional | original, new, in\_progress, repaired, needs\_repair |
| `furnished[]` | list of string | Optional | yes, no, semi |
| `heating[]` | list of string | Optional | airConditioning, allocators, central, district, heatPump, electricity, gas, marbleRadiator, norwegianRadiators, solid, storageHeater, tileStove, underfloor, none |
| `payment_terms[]` | list of string | Optional | day, month, 3 months, 6 months, year |
| `advertiser_types[]` | list of string | Optional | agency, firm, investor, owner |
| `registered` | string | Optional | yes, partially, in\_progress, no |
| `sort` | string | Optional | newest, price\_asc, price\_desc, area\_asc, area\_desc |
| `page` | integer | Optional | Any |
| `elevator` | boolean | Optional | Any |
| `terrace` | boolean | Optional | Any |
| `yard` | boolean | Optional | Any |
| `garage` | boolean | Optional | Any |
| `parking_space` | boolean | Optional | Any |
| `attic` | boolean | Optional | Any |
| `basement` | boolean | Optional | Any |
| `air_conditioning` | boolean | Optional | Any |
| `pets_allowed` | boolean | Optional | Any |
| `smoking_allowed` | boolean | Optional | Any |
| `inhabitable_now` | boolean | Optional | Any |
| `cctv` | boolean | Optional | Any |
| `alarm_secured` | boolean | Optional | Any |
| `asphalt_access` | boolean | Optional | Any |
| `sewerage` | boolean | Optional | Any |
| `power_line` | boolean | Optional | Any |
| `phone_line` | boolean | Optional | Any |
| `wheelchair_access` | boolean | Optional | Any |
| `virtual_sightseeing` | boolean | Optional | Any |
| `video_or_3d_tour` | boolean | Optional | Any |
| `urgent` | boolean | Optional | Any |
| `with_images` | boolean | Optional | Any |
| `new_build` | boolean | Optional | Any |

## Example request

4zida

GET /v1/4zida/search?for=rent&type=apartments&place\_ids\[\]=2&max\_price=600&sort=price\_asc 

```
{
  "success": true,
  "data": {
    "items": [
      {
        "id": "64dca9623ac9d7a2920c0067",
        "url": "https://www.4zida.rs/izdavanje-stanova/ledine-novi-beograd-beograd/petosoban-stan/64dca9623ac9d7a2920c0067",
        "title": "Ledine",
        "headline": "Uknjižen • Namešteno",
        "subtitle": "Useljivo ",
        "for": "rent",
        "type": "apartment",
        "structure": "Petosoban stan",
        "price": 3,
        "currency": "EUR",
        "area_m2": 200,
        "room_count": 5,
        "floor": 1,
        "total_floors": 2,
        "last_floor": false,
        "ground_floor": false,
        "attic_floor": false,
        "state": "original",
        "furnished": "yes",
        "heating": "district",
        "registered": "yes",
        "inhabitable": true,
        "terrace": 3,
        "payment_term": "day",
        "address": "kapetanovićeva",
        "address_redacted": true,
        "place_ids": [
          535,
          139,
          2
        ],
        "place_names": [
          "Ledine",
          "Novi Beograd",
          "Beograd"
        ],
        "city_id": 2,
        "municipality_id": 139,
        "neighborhood_id": 535,
        "created_at": "2023-08-16T10:48:02+00:00",
        "activated_at": "2023-08-18T14:09:31+00:00",
        "image": {
          "url": "https://resizer2.4zida.rs/MMwAmsJ9GFUOAyvDIPG7nbhi7eFF9jn5SFvc9HbRT7w/rs:fill:420:0:0/bG9jYWw6Ly8vNjRkY2E5NjIzYWM5ZDdhMjkyMGMwMDY3LzMyNGJhOGFlMGU.webp",
          "variants": {
            "380x0_fill_0_webp": "https://resizer2.4zida.rs/fdN6RirzJDTFTWUmdwj2QZ0Lg42pEdj36zRqWBdVsQA/rs:fill:380:0:0/bG9jYWw6Ly8vNjRkY2E5NjIzYWM5ZDdhMjkyMGMwMDY3LzMyNGJhOGFlMGU.webp",
            "380x0_fill_0_jpeg": "https://resizer2.4zida.rs/L-hkYyWxLyXmndh7581T50_Z_3URx7togfeikc_nV9k/rs:fill:380:0:0/bG9jYWw6Ly8vNjRkY2E5NjIzYWM5ZDdhMjkyMGMwMDY3LzMyNGJhOGFlMGU.jpeg",
            "420x0_fill_0_webp": "https://resizer2.4zida.rs/MMwAmsJ9GFUOAyvDIPG7nbhi7eFF9jn5SFvc9HbRT7w/rs:fill:420:0:0/bG9jYWw6Ly8vNjRkY2E5NjIzYWM5ZDdhMjkyMGMwMDY3LzMyNGJhOGFlMGU.webp",
            "420x0_fill_0_jpeg": "https://resizer2.4zida.rs/phPqpUvIdMg5NiLPLZ4uCjcW9LGBxAAEDiSM8B3HP9k/rs:fill:420:0:0/bG9jYWw6Ly8vNjRkY2E5NjIzYWM5ZDdhMjkyMGMwMDY3LzMyNGJhOGFlMGU.jpeg",
            "840x0_fill_0_webp": "https://resizer2.4zida.rs/W56LQlPH0yfhQkDtPuvK5Ai_KnaEMWIPbXQbm_h8FA8/rs:fill:840:0:0/bG9jYWw6Ly8vNjRkY2E5NjIzYWM5ZDdhMjkyMGMwMDY3LzMyNGJhOGFlMGU.webp",
            "840x0_fill_0_jpeg": "https://resizer2.4zida.rs/IVOJF3shvvWQAzUDFQQU6qwdABR_eek0XeUJdqrA6Qg/rs:fill:840:0:0/bG9jYWw6Ly8vNjRkY2E5NjIzYWM5ZDdhMjkyMGMwMDY3LzMyNGJhOGFlMGU.jpeg"
          },
          "thumb_hash": "HwgODQKUh795+FdYdoaJiFexYAY4"
        },
        "thumbnails": [
          {
            "url": "https://resizer2.4zida.rs/MMwAmsJ9GFUOAyvDIPG7nbhi7eFF9jn5SFvc9HbRT7w/rs:fill:420:0:0/bG9jYWw6Ly8vNjRkY2E5NjIzYWM5ZDdhMjkyMGMwMDY3LzMyNGJhOGFlMGU.webp",
            "variants": "…",
            "thumb_hash": "HwgODQKUh795+FdYdoaJiFexYAY4"
          },
          {
            "url": "https://resizer2.4zida.rs/NgsayamlDSTK_syQ7rqO1dMemtBpgH7RTL7fARQ9hNs/rs:fill:420:0:0/bG9jYWw6Ly8vNjRkY2E5NjIzYWM5ZDdhMjkyMGMwMDY3L2ZmOThkZWMxYTM.webp",
            "variants": "…",
            "thumb_hash": "IAgODQJ0h8yG+Gp4dWZ5h3RwRAgl"
          },
          {
            "url": "https://resizer2.4zida.rs/f9sXkAO6WgLLBiNzTqfYQcP8ubZgkm5BrcJlkvHYWJQ/rs:fill:420:0:0/bG9jYWw6Ly8vNjRkY2E5NjIzYWM5ZDdhMjkyMGMwMDY3LzFmZGVlMGFjYTM.webp",
            "variants": "…",
            "thumb_hash": "nRgKDQK9l392JmeJmXSIiLTwBRl/"
          }
        ],
        "image_count": 7,
        "virtual_tour": false,
        "advertiser_type": "firm",
        "author_id": 891256,
        "agency": {
          "id": 250045,
          "url": "https://www.4zida.rs/vlasnici/cuprija/gradnja-radosavljevic/250045",
          "logo_url": "https://resizer2.4zida.rs/unsigned/rs:fit:200:200/plain/local:///agencies/01cfd60626.png@png"
        },
        "premium": false,
        "featured": false
      },
      {
        "id": "6af218f560c3c28ac102927b",
        "url": "https://www.4zida.rs/izdavanje-stanova/borca-palilula-opstina-beograd/jednosoban-stan/6af218f560c3c28ac102927b",
        "title": "J N A 91",
        "headline": "Na 1. spratu • Namešteno • Parking",
        "subtitle": "Parking • Dozvoljeno pušenje • Useljivo ",
        "for": "rent",
        "type": "apartment",
        "structure": "Jednosoban stan",
        "price": 35,
        "currency": "EUR",
        "area_m2": 36,
        "room_count": 1,
        "floor": 1,
        "floor_label": 1,
        "total_floors": 4,
        "last_floor": false,
        "ground_floor": false,
        "attic_floor": false,
        "state": "new",
        "furnished": "yes",
        "heating": "electricity",
        "inhabitable": true,
        "elevator": 0,
        "terrace": 2,
        "garage": 0,
        "parking_space": 1,
        "payment_term": "day",
        "address": "J N A",
        "address_redacted": false,
        "place_ids": [
          272,
          28257,
          2
        ],
        "place_names": [
          "Borča",
          "Palilula opština",
          "Beograd"
        ],
        "city_id": 2,
        "municipality_id": 28257,
        "neighborhood_id": 272,
        "created_at": "2026-11-09T19:03:17+00:00",
        "activated_at": "2026-11-09T19:28:07+00:00",
        "image": {
          "url": "https://resizer2.4zida.rs/-1cqb0_wRHGCtgGE6MjQVL0QymKBMMmeN73v4ZpTLp4/rs:fill:420:0:0/bG9jYWw6Ly8vNmFmMjE4ZjU2MGMzYzI4YWMxMDI5MjdiLzg3Y2IxYmM5NTE.webp",
          "variants": {
            "380x0_fill_0_webp": "https://resizer2.4zida.rs/Z30lXQgrBGbYZtt8QXWWDevCz6oGtsfPEBYDwlNaszE/rs:fill:380:0:0/bG9jYWw6Ly8vNmFmMjE4ZjU2MGMzYzI4YWMxMDI5MjdiLzg3Y2IxYmM5NTE.webp",
            "380x0_fill_0_jpeg": "https://resizer2.4zida.rs/OEU1ldTsjZCyVveqKF1Anr-FYDZj75hP5ZnS9Crrl8Y/rs:fill:380:0:0/bG9jYWw6Ly8vNmFmMjE4ZjU2MGMzYzI4YWMxMDI5MjdiLzg3Y2IxYmM5NTE.jpeg",
            "420x0_fill_0_webp": "https://resizer2.4zida.rs/-1cqb0_wRHGCtgGE6MjQVL0QymKBMMmeN73v4ZpTLp4/rs:fill:420:0:0/bG9jYWw6Ly8vNmFmMjE4ZjU2MGMzYzI4YWMxMDI5MjdiLzg3Y2IxYmM5NTE.webp",
            "420x0_fill_0_jpeg": "https://resizer2.4zida.rs/hO7e38CHyyzBfTU-seYNn9NRE7M5B6AUtSdTXEgl8-w/rs:fill:420:0:0/bG9jYWw6Ly8vNmFmMjE4ZjU2MGMzYzI4YWMxMDI5MjdiLzg3Y2IxYmM5NTE.jpeg",
            "840x0_fill_0_webp": "https://resizer2.4zida.rs/9589ohOiZRsRX91KIXt_E-u_AFfNJUAQTaDqGmbqQbc/rs:fill:840:0:0/bG9jYWw6Ly8vNmFmMjE4ZjU2MGMzYzI4YWMxMDI5MjdiLzg3Y2IxYmM5NTE.webp",
            "840x0_fill_0_jpeg": "https://resizer2.4zida.rs/-rzK4T9vgviaeVyufxslkYZsuUc69ht-iFUG9utL0rU/rs:fill:840:0:0/bG9jYWw6Ly8vNmFmMjE4ZjU2MGMzYzI4YWMxMDI5MjdiLzg3Y2IxYmM5NTE.jpeg"
          }
        },
        "thumbnails": [
          {
            "url": "https://resizer2.4zida.rs/-1cqb0_wRHGCtgGE6MjQVL0QymKBMMmeN73v4ZpTLp4/rs:fill:420:0:0/bG9jYWw6Ly8vNmFmMjE4ZjU2MGMzYzI4YWMxMDI5MjdiLzg3Y2IxYmM5NTE.webp",
            "variants": "…"
          },
          {
            "url": "https://resizer2.4zida.rs/AYUP80v0QL1ii5xee-LImd-EthrUN44_FXelWD0yrKw/rs:fill:420:0:0/bG9jYWw6Ly8vNmFmMjE4ZjU2MGMzYzI4YWMxMDI5MjdiLzZkMjI5YTkxOGU.webp",
            "variants": "…"
          },
          {
            "url": "https://resizer2.4zida.rs/LVqhfiYmRQKbsNl9BjmF-CsZALzdXR1V5-YD9KglyA4/rs:fill:420:0:0/bG9jYWw6Ly8vNmFmMjE4ZjU2MGMzYzI4YWMxMDI5MjdiL2QzOWRjNzM4Y2E.webp",
            "variants": "…"
          }
        ],
        "image_count": 5,
        "virtual_tour": false,
        "advertiser_type": "owner",
        "author_id": 795735,
        "premium": false,
        "featured": false
      },
      {
        "id": "676adf61fc54f5cb8a029ad0",
        "url": "https://www.4zida.rs/izdavanje-stanova/mladenovac-mesto-mladenovac-opstina-beograd/jednosoban-stan/676adf61fc54f5cb8a029ad0",
        "title": "Mladenovac (mesto)",
        "headline": "Na 2. spratu • Namešteno",
        "subtitle": " ",
        "for": "rent",
        "type": "apartment",
        "structure": "Jednosoban stan",
        "price": 50,
        "currency": "EUR",
        "area_m2": 30,
        "room_count": 1,
        "floor": 2,
        "floor_label": 2,
        "ground_floor": false,
        "attic_floor": false,
        "furnished": "yes",
        "terrace": 1,
        "place_ids": [
          81,
          28274,
          2
        ],
        "place_names": [
          "Mladenovac (mesto)",
          "Mladenovac opština",
          "Beograd"
        ],
        "city_id": 2,
        "municipality_id": 28274,
        "neighborhood_id": 81,
        "created_at": "2024-12-24T16:20:49+00:00",
        "activated_at": "2024-12-24T16:20:49+00:00",
        "image": {
          "url": "https://resizer2.4zida.rs/a5WEfNSOIYaeXuf7sfNAcUipy1e8j-kMT-b3oMb7yoI/rs:fill:420:0:0/bG9jYWw6Ly8vNjc2YWRmNjFmYzU0ZjVjYjhhMDI5YWQwLzUyZDU5NzI4MGQ.webp",
          "variants": {
            "380x0_fill_0_webp": "https://resizer2.4zida.rs/dCi2neu52m8zmP8SqYFcEEi4YGWefms9oMUsGtdesp4/rs:fill:380:0:0/bG9jYWw6Ly8vNjc2YWRmNjFmYzU0ZjVjYjhhMDI5YWQwLzUyZDU5NzI4MGQ.webp",
            "380x0_fill_0_jpeg": "https://resizer2.4zida.rs/fLTFVwuTkfGzvpnMs4JJyWiG0ejHkg6NSf0pl-QOte0/rs:fill:380:0:0/bG9jYWw6Ly8vNjc2YWRmNjFmYzU0ZjVjYjhhMDI5YWQwLzUyZDU5NzI4MGQ.jpeg",
            "420x0_fill_0_webp": "https://resizer2.4zida.rs/a5WEfNSOIYaeXuf7sfNAcUipy1e8j-kMT-b3oMb7yoI/rs:fill:420:0:0/bG9jYWw6Ly8vNjc2YWRmNjFmYzU0ZjVjYjhhMDI5YWQwLzUyZDU5NzI4MGQ.webp",
            "420x0_fill_0_jpeg": "https://resizer2.4zida.rs/9c64dzzqbKFGswfZwEciTWrcjyafp4DOBHETs01-o-U/rs:fill:420:0:0/bG9jYWw6Ly8vNjc2YWRmNjFmYzU0ZjVjYjhhMDI5YWQwLzUyZDU5NzI4MGQ.jpeg",
            "840x0_fill_0_webp": "https://resizer2.4zida.rs/wUJ7yby19B_fpqWJKhzbPLRE-ecWh1R-1-RhG9nCl6k/rs:fill:840:0:0/bG9jYWw6Ly8vNjc2YWRmNjFmYzU0ZjVjYjhhMDI5YWQwLzUyZDU5NzI4MGQ.webp",
            "840x0_fill_0_jpeg": "https://resizer2.4zida.rs/Yypb7_yMLlg3-3Gi73g0hG4r1QI_d_mbFy6rfBhHU1E/rs:fill:840:0:0/bG9jYWw6Ly8vNjc2YWRmNjFmYzU0ZjVjYjhhMDI5YWQwLzUyZDU5NzI4MGQ.jpeg"
          },
          "thumb_hash": "WRgKBYI7mHV2mIiga7Zoil+unEB4"
        },
        "thumbnails": [
          {
            "url": "https://resizer2.4zida.rs/a5WEfNSOIYaeXuf7sfNAcUipy1e8j-kMT-b3oMb7yoI/rs:fill:420:0:0/bG9jYWw6Ly8vNjc2YWRmNjFmYzU0ZjVjYjhhMDI5YWQwLzUyZDU5NzI4MGQ.webp",
            "variants": "…",
            "thumb_hash": "WRgKBYI7mHV2mIiga7Zoil+unEB4"
          },
          {
            "url": "https://resizer2.4zida.rs/DGpKEJk4at8fxE9he5iFf9qqvH3-Z9FKIkAnJ3Cjmng/rs:fill:420:0:0/bG9jYWw6Ly8vNjc2YWRmNjFmYzU0ZjVjYjhhMDI5YWQwLzQyYzcyZmY0ZjM.webp",
            "variants": "…",
            "thumb_hash": "IAgKLYjIi5pveHdPdrd2lXlwlQZm"
          },
          {
            "url": "https://resizer2.4zida.rs/1q-JwWtY4omC5ZuNxNq8Zd4nHfOwges9wm8Z4W3Lh2g/rs:fill:420:0:0/bG9jYWw6Ly8vNjc2YWRmNjFmYzU0ZjVjYjhhMDI5YWQwLzY2ZDA1NjY4NDU.webp",
            "variants": "…",
            "thumb_hash": "nBgODYJziImPZ3d3h3h2hz/ytwJs"
          }
        ],
        "image_count": 10,
        "virtual_tour": false,
        "advertiser_type": "agency",
        "author_id": 231490,
        "agency": {
          "id": 69507,
          "url": "https://www.4zida.rs/agencije/beograd/frigo-2000/69507",
          "logo_url": "https://resizer2.4zida.rs/unsigned/rs:fit:200:200/plain/local:///agencies/2cf1eebb72.jpeg@png"
        },
        "premium": false,
        "featured": false
      }
    ],
    "page": 1,
    "per_page": 20,
    "total": 421,
    "total_pages": 22,
    "has_more": true
  },
  "meta": {
    "endpoint_family": "search",
    "request_id": "req_e2a0f08260eb4fb58a1b8f6937ef330d",
    "credits_charged": 1,
    "credits_remaining": 1899
  }
}
```

200 OK JSON X-Credits-Used: 1

Recorded from our API and shortened.

[Run this endpoint in the playground](https://perceptlayer.com/apis/4zida?try=search#playground) with your own parameters. 1 credit per successful call; failed calls are free.
