Pulse API
  1. Comparables
Pulse API
  • Introduction
    • Introduction
    • Getting Started
    • Basic concepts
  • Services
    • Backoffice
      • Authentication
        • Generate Access Token
        • Generate Refresh Token
      • Authorization
        • Rotate Key (User)
        • Register Application
        • List (Application)
        • Rotate Key (Application)
        • Revoke Key (Application)
        • Activate Key (Application)
      • Usage
        • Check limits
        • Check usage
    • Domains
      • Valuation
        • Valuation
      • Indicators
        • Indicators
      • Cadastral
        • Cadastral by portal id
        • Cadastral by Reference
      • Comparables
        • Search comparables
          GET
      • Mortgage
        • Pre-approval
      • Location
        • Suggest cadastral
  1. Comparables

Search comparables

GET
/api/integration/v2/comparables/search/basic
Searches and retrieves comparable assets based on the provided filters and criteria, returning standardized data useful for valuation, benchmarking, or market analysis.

Request

Authorization
API Key
Add parameter in header
Authorization
Example:
Authorization: ********************
or
Query Params

Responses

🟢200OK
application/json
Successful Response
Body

🟠422Unprocessable Content
🟠404Not Found
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.urbandataanalytics.com/api/integration/v2/comparables/search/basic?id_uda=54-100633144,54-1003543&asset_id=54-100633144&is_active=0&comparison_type=0,1&operation_type_id=1&typology_type_id=1&property_type_id=4&build_status_id=1&dates_range=2022-05-01, 2022-10-01&construction_year=1989,2000&area=100&source_id=54&price=10,200&include_duplicates=0&lat=40.458202&lon=-3.69779&address=CALLE HUESCA 27, MADRID&distance=500&sort_by=distance&ascending=1&page_num=1&output=json&distribution_id=4&n_baths=2&n_rooms=3&garage=1&outside=1&has_elevator=1&has_terrace=1&has_pool=0&has_air_conditioner=1&has_smoke_outlet=0&has_heating=0&has_kitchen=0&has_storefront=0&has_storage=0&has_bathroom=0&has_facade=0&has_warehouse=0&has_security=0&is_exterior=1&has_loading_dock=0&has_automatic_door=0&flag_potencial_promotion=0&has_access_24h=0&floor=2&cadastral_ref=1687710VK4718F0081FH' \
--header 'Authorization: <api-key>'
Response Response Example
200 - OK
{
    "query_params": {
        "index": null,
        "id": null,
        "id_uda": null,
        "development_id": null,
        "comparison_type": "0,1",
        "vendor_type": null,
        "is_active": null,
        "operation_type": 1,
        "typology_type": 1,
        "typology_id_desktop": null,
        "subtypology_type": null,
        "usage_id": null,
        "property_type": null,
        "construction_type": null,
        "source_id": "10,11,13,14,16,17,24,30,32,34,36,38,41,42,45,54,63,64,65,66,70,73,74,79,82,83,99",
        "id_admin5": null,
        "id_admin0": null,
        "build_status": null,
        "distribution_id": null,
        "date_out": null,
        "dates_in_range": null,
        "dates_range": "2024-11-18,2025-11-18",
        "construction_year": null,
        "date_main_range": null,
        "first_date_origin": null,
        "area": null,
        "baths": null,
        "rooms": null,
        "price": null,
        "gross_yield_estimated_price": null,
        "gross_yield_asking_price": null,
        "price_gap": null,
        "last_price": null,
        "include_duplicates": 0,
        "is_duplicated": null,
        "is_comparable": null,
        "garage": null,
        "outside": null,
        "elevator": null,
        "has_terrace": null,
        "has_pool": null,
        "has_air_conditioner": null,
        "has_smoke_outlet": null,
        "has_heating": null,
        "has_kitchen": null,
        "has_storefront": null,
        "has_storage": null,
        "has_bathroom": null,
        "is_on_the_corner": null,
        "has_facade": null,
        "has_warehouse": null,
        "has_security": null,
        "has_security_system": null,
        "is_exterior": null,
        "has_loading_dock": null,
        "has_automatic_door": null,
        "is_covered": null,
        "flag_potencial_promotion": null,
        "has_access_24h": null,
        "has_natural_gas": null,
        "has_pavement": null,
        "has_street_lighting": null,
        "has_sewerage": null,
        "has_water": null,
        "has_vigilance": null,
        "has_tenant": null,
        "flag_okupa": null,
        "flag_leased": null,
        "flag_reverse_mortgage": null,
        "flag_nuda": null,
        "is_vpo": null,
        "is_auction": null,
        "is_joint_ownership": null,
        "without_possession": null,
        "is_north": null,
        "is_south": null,
        "is_east": null,
        "is_west": null,
        "floor": null,
        "access_type": null,
        "n_elevator": null,
        "n_houses": null,
        "n_garages": null,
        "portfolio_id": "None,70,71,4,65,2,6,7,8,9,10,11,13,14,15,16,17,18,19,22,23,24,25,26,20,3,260,12,28,31,35,39,41,27,29,33,34,36,37,38,40,42,43,44,45,46,47,48,49,50,51,52,53,54,30,240,21,55,56,57,58,59,60,61,62,63,64,66,67,68,69,82,32,5,72,1,77,73,76,80,81,83,79,78,331,103,330,104,110,106,345,116,114,107,111,97,105,96,91,92,250,88,87,98,90,117,115,89,101,94,84,86,93,109,113,108,268,144,119,120,142,136,135,143,141,150,132,153,151,123,149,332,148,133,121,122,140,152,156,145,147,131,134,155,165,171,163,164,247,259,157,159,166,168,245,158,269,333,354,244,238,169,239,170,128,270,167,176,346,173,175,254,172,248,265,271,282,276,281,283,273,262,286,261,264,267,257,297,287,292,284,321,280,285,295,294,278,338,279,272,342,341,293,299,343,154,339,365,277,337,360,289,350,334,355,364,361,348,370,85,349,362,323,352,378,357,347,359,367,373,369,371,358,319,304,301,315,300,303,306,313,340,305,296,298,288,311,344,312,266,322,318,74,302,310,314,317,291,320,316,307,118,366,377,75,380,329,326,324,327,351,328,372,376,290,374,353,382,368,363,309,379,375,381",
        "sort_by": null,
        "ascending": 1,
        "lat": 40.458201946492096,
        "lon": -3.6977902019855797,
        "address": null,
        "distance": 20,
        "boundary": null,
        "geometry": null,
        "bbox": null,
        "country": "es",
        "country_id": null,
        "exclude": null,
        "project": "id,title,is_active,action_id,action_name,usage_id,usage_name,comparison_type,operation_type_id,operation_type_name,property_type_id,property_type_name,subtypology_name,subtypology_type_id,typology_type_id,typology_type_name,construction_type_id,construction_type_name,build_status_id,build_status_name,last_price,last_pm2,address,location,lat,lon,distance,is_input,similarity,score,date_in,date_out,first_date_origin,updated_at,date_diff,has_air_conditioner,has_common_areas,has_elevator,has_garage,has_garage_in_price,has_gym,has_pool,has_racket_court,has_security,has_storage,has_terrace,furnished,is_exterior,is_agency,is_bank,is_coop,is_short_rent,is_vpo,is_comparable,cat_area,category_id,n_rooms,n_baths,area,construction_year,floor,is_accurate_address,admin0,admin1,admin2,admin3,admin4,admin5,admin6,id_admin0,id_admin1,id_admin2,id_admin3,id_admin4,id_admin5,id_admin6,postal_code,geohash7,first_price,first_pm2,last_price_pm2_with_correction,last_price_with_correction,contact_url,retail_listing,vendor_asset_id,vendor_type,url",
        "n_images": null,
        "page_num": 1,
        "page_size": 30,
        "sample": null,
        "limit": null,
        "pre_limit": null,
        "output": "json",
        "target_area": null,
        "target_floor": null,
        "target_property_type": null,
        "target_build_status": null,
        "target_baths": null,
        "target_rooms": null,
        "target_has_elevator": null,
        "target_has_storage": null,
        "target_has_terrace": null,
        "target_has_air_conditioner": null,
        "target_has_garage": null,
        "target_has_pool": null,
        "target_is_exterior": null,
        "similarity": null,
        "closing_match_score": null,
        "duplicates": 1,
        "product": null,
        "asset_id": null
    },
    "query_asset": {
        "id_admin5": 26620,
        "admin5": "Castillejos",
        "id_admin6": 51997,
        "admin6": "Sección 056",
        "id_admin4": 13966,
        "admin4": "Tetuán",
        "id_admin3": 4440,
        "admin3": "Madrid",
        "id_admin1": 14,
        "admin1": "Comunidad de Madrid",
        "id_admin2": 48,
        "admin2": "Madrid",
        "id_admin0": 1,
        "admin0": "Spain"
    },
    "results": [
        {
            "id": 86846634593,
            "title": "Estudio en venta en Calle de Huesca  , Castillejos - Cuzco",
            "is_active": 0,
            "action_id": 3,
            "action_name": "Unpublished w/o confirmed date",
            "usage_id": 1,
            "usage_name": "Residential",
            "comparison_type": 0,
            "operation_type_id": 1,
            "operation_type_name": "Venta",
            "property_type_id": 7,
            "property_type_name": "Study",
            "subtypology_name": "Colective housing",
            "subtypology_type_id": 2,
            "typology_type_id": 1,
            "typology_type_name": "Residencial",
            "construction_type_id": 2,
            "construction_type_name": "Segunda mano",
            "build_status_id": 1,
            "build_status_name": "Buen estado",
            "last_price": 270000.0,
            "last_pm2": 7714.285714285715,
            "address": "Calle de Huesca  , Castillejos - Cuzco",
            "location": {
                "coordinates": [
                    -3.697619621,
                    40.458183349
                ],
                "type": "Point"
            },
            "lat": 40.458183349,
            "lon": -3.697619621,
            "distance": 14.0,
            "is_input": null,
            "similarity": null,
            "score": {
                "score_area": null,
                "score_n_rooms": null,
                "score_n_baths": null,
                "score_floor": null,
                "score_build_status_id": null,
                "score_has_elevator": null,
                "score_has_storage": null,
                "score_has_terrace": null,
                "score_has_air_conditioner": null,
                "score_has_garage": null,
                "score_has_pool": null,
                "score_is_exterior": null,
                "score_property_type_id": null,
                "score_distance": null,
                "score": null
            },
            "date_in": "2025-06-13",
            "date_out": "2025-08-19",
            "first_date_origin": "2025-06-13",
            "updated_at": "2025-08-20",
            "date_diff": 10,
            "has_air_conditioner": 1,
            "has_common_areas": null,
            "has_elevator": 1,
            "has_garage": null,
            "has_garage_in_price": null,
            "has_gym": null,
            "has_pool": null,
            "has_racket_court": null,
            "has_security": null,
            "has_storage": null,
            "has_terrace": null,
            "furnished": null,
            "is_exterior": null,
            "is_agency": 1,
            "is_bank": 0,
            "is_coop": 0,
            "is_short_rent": false,
            "is_vpo": 0,
            "is_comparable": 1,
            "cat_area": 1,
            "category_id": 1,
            "n_rooms": null,
            "n_baths": 1,
            "area": 35.0,
            "construction_year": null,
            "floor": 5.0,
            "is_accurate_address": 0,
            "admin0": "Spain",
            "admin1": "Comunidad de Madrid",
            "admin2": "Madrid",
            "admin3": "Madrid",
            "admin4": "Tetuán",
            "admin5": "Castillejos",
            "admin6": "Sección 056",
            "id_admin0": 1,
            "id_admin1": 14,
            "id_admin2": 48,
            "id_admin3": 4440,
            "id_admin4": 13966,
            "id_admin5": 26620,
            "id_admin6": 51997,
            "postal_code": "28020",
            "geohash7": "ezjq5v5",
            "first_price": 299000.0,
            "first_pm2": 8542.86,
            "last_price_pm2_with_correction": 7143.43,
            "last_price_with_correction": 250020.0,
            "contact_url": "https://www.fotocasa.es/es/inmobiliaria-grupo-inmobilia-servicios-inmobiliarios/comprar/inmuebles/espana/todas-las-zonas/l?clientId=9202762894884",
            "retail_listing": "Fotocasa",
            "vendor_asset_id": "INM40131",
            "vendor_type": 2,
            "url": "https://www.fotocasa.es/es/comprar/viviendas/madrid-capital/todas-las-zonas/l?propertyNotFound"
        }
    ],
    "message": "Comparable data retrieved successfully",
    "pagination": {
        "num_results": 1,
        "page_current": 1,
        "total_count": 1,
        "page_count": 1
    },
    "code": 200
}
Modified at 2025-11-26 12:10:10
Previous
Cadastral by Reference
Next
Pre-approval
Built with