Inmotek API V3


Introduction


Welcome to Inmotek API V3. In the next sections we will explain how to start working with Inmotek API and obtain the first requests.
You would need an Inmotek Agency Id and Agency token that could be given by any agency with an active contract with Inmotek.

This documentation is to help you to obtain data. Any customization in the website or any appearence changing is completely out of this API. A basic knowledge of some programming language is required to understand the given code. You can learn the basics of simple language here and here.

Requirements

No requeriments except explained before.

Any programming language allows you to send and receive data via API, however if you are going to use an external CMS such as Worpress or Joomla, verify that they have API support.

Getting Started

In order to start making API requests, you will first need a token, a unique encrypted key for each agency. This key will allow you access to any API request. You will also need the agency_id and experiment a bit.

How to Obtain a token #back to top

Currently the token cannot be generated by the Inmotek application..
Please request it directly from us and we will provide it to you.


Get Token by Inmotek App

From the "my_web" section in Inmotek you can generate a Token which you can use for any API call


Your first request #back to top

How do I make an API request?

There are many ways to make an API request, from a request through a web browser to libraries adapted to each programming language, but an easy way to verify it is using "POSTMAN" a program that allows you to check easily and simply these types of requests.

First, you have to send the token and the agency_id in the header (Example with "me" request)
We can make a request to the API by sending the data by parameters...(Example with get "subzones" request)
Or it can also be sent in JSON format in the body ... (Example with "property_search" request)

How cache works?

All requests are cached whenever are requested. API V3 Cache technology erases cache when data stored in Inmotek changes. For instead "me" request would be served from cache until Agency changes any data that is included in "me" request.

Every JSON file served will have a parameter indicating the cached time in PHP Y-m-d H:i:s format.

Param Value
nocahe 1

 {
    "request": {
        "status": "200",
        "msg": "The request is correct",
        "date": "2020-12-23 16:05:41"
 },
    "data": {
	param1: data1,
	param2: data2,
	param3: data3,
	param4: data4
  },
    "cached_time": "2020-12-23 16:05:41"
}

Sending the parameter "nocache" with value "1" will force API to return nocached data.
It is recommended not to use "nocache" parameter because cached data are automatically refreshed when changes are made in inmotek.

List of parameters #back to top

Lorem the It is a long established fact that a reader will be distracted by the readable content of a page when looking at its layout. The point of using Lorem Ipsum is that it has a more-or-less normal distribution of letters, as opposed to using 'Content here, content here', making it look like readable English. long established fact that a reader will be distracted by the readable content of a page when looking at its layout. The point of using Lorem Ipsum is that it has a more-or-less normal distribution of letters, as opposed to using 'Content here, content here', making it look like readable English.

Remember: Not all parameters are stackable, so you will have to think about which parameter to remove to allow another.


 {
    "params": {
        
    "search_group": {
        "description":"Very IMPORTANT parameter. It allows you to decide whether to search the group data or not. Can be True or False",
        "$ref":"bool"
    },
    "filter_groups": {
        "filter_groups":"Important parameter for group websites. This parameter allows you to filter the properties by the group to which they belong. The value accepted is the unique group code that you must request from Inmotek support."
    },
    "all_data": {
        "description":"It allows to obtain the complete list of the petition. Can be True or False",
        "$ref":"bool"
    },
    "min_price": {
        "description":"Any type of number(float, integer)",
        "$ref":"int/float"
    },
    "max_price": {
        "description":"Any type of number(float, integer)",
        "$ref":"int/float"
    },
    "min_meters": {
        "description":"Any type of number(float, integer)",
        "$ref":"int/float"
    },
    "max_meters": {
        "description":"Any type of number(float, integer)",
        "$ref":"int/float"
    },
    "rooms": {
        "description":"Any type of number(integer) to filter exact rooms",
        "$ref":"int"
    },
    "bathrooms": {
        "description":"Any type of number(integer) to filter exact bathrooms",
        "$ref":"int"
    },
    "min_rooms": {
        "description":"Any type of number(integer) to filter a minimum number of rooms",
        "$ref":"int"
    },
    "min_bathrooms": {
        "description":"Any type of number(integer) to filter a minimum number of bathrooms",
        "$ref":"int"
    },
    "garage": {
        "description":"Two possible values, True or False",
        "$ref":"bool"
    },
    "lift": {
        "description":"Two possible values, True or False",
        "$ref":"bool"
    },
    "operation": {
        "description":"String with these possible values, (a; v; t; a,v; a,v,t; a,t; v,t )",
        "$ref":"string"
    },
    "location": {
        "description":"Single or separate numbers with possible value from the id locations list",
        "$ref":"string/int"
    },
    "location_zones": {
        "description":"Array(Json) of numbers with possible values from the id locations list including as children possible values from id zones list",
        "$ref":"string"
    },
    "country": {
        "description":"Single or separate numbers with possible value from the id country list",
        "$ref":"string/int"
    },
    "zone": {
        "description":"Single or separate numbers with possible value from the id zones list",
        "$ref":"string/int"
    },
    "subzone": {
        "description":"Single or separate numbers with possible value from the id subzones list",
        "$ref":"string/int"
    },
    "province": {
        "description":"Single or separate numbers with possible value from the id provinces list",
        "$ref":"string/int"
    },
    "type": {
        "description":"Single or separate numbers with possible value from the id type list",
        "$ref":"string/int"
    },
    "property_code": {
        "description":"Single integer",
        "$ref":"int"
    },
    "property_ref": {
        "description":"Single string",
        "$ref":"string"
    },
    "property_status": {
        "description":"Field with three possible values (1=>In portfolio; 2=>Managed; 1,2=>Returns both). You can also search for both with 1,2 (If you need data from other states, try using from inmotek) ",
        "$ref":"string/int"
    },
    "featured": {
        "description":"Value indicating whether the response should contain only featured or none at all. The difference with the "outstanding" call is in the cache refresh time and data. Can be true or false",
        "$ref":"boolean"
    },
    "search_order_field": {
        "description":"Numbering indicating under which value the search results will be sorted. Possible values are (1=>Date,2=>Rooms, 3=>Price, 4=>Meters, 5=>Bathrooms, 6=>Featured)",
        "$ref":"string"
    },
    "search_order": {
        "description":"Value indicating the type of order in the search results. Possible values are (ASC, DESC)",
        "$ref":"string"
    },
    "search_code": {
        "description":"Single integer only for request 'search_property'",
        "$ref":"int"
    },
    "search_ref": {
        "description":"Single string only for request 'search_property'",
        "$ref":"string"
    },
    "search_exact_code": {
        "description":"Parameter to filter by the exact value of the propertyCode. Only for the 'search_property',
        "$ref":"int"
    },
    "search_exact_ref": {
        "description":"Parameter to filter by the exact value of the propertyReference. Only for the 'search_property',
        "$ref":"string"
    },
    "search_code_ref": {
        "description":"Parameter that can contain the propertyCode or propertyReference to filter properties. Only for the 'search_property' request.",
        "$ref":"int"
    },
    "search_exact_code_ref": {
        "description":"Parameter that can contain the exact value of the propertyCode or propertyReference to filter properties. Only for the 'search_property' request.",
        "$ref":"string"
    },
    "letter": {
        "description":"Letter associated to the agency. If used together with the code you can search for a specific property of that agency.",
        "$ref":"string"
    },
    "air": {
        "description":"Two possible values, True or False",
        "$ref":"bool"
    },
    "heating": {
        "description":"Two possible values, True or False",
        "$ref":"bool"
    },
    "storage": {
        "description":"Two possible values, True or False",
        "$ref":"bool"
    },
    "terrace": {
        "description":"Two possible values, True or False",
        "$ref":"bool"
    },
    "garden": {
        "description":"Two possible values, True or False",
        "$ref":"bool"
    },
    "lift": {
        "description":"Two possible values, True or False",
        "$ref":"bool"
    },
    "limit": {
        "description":"Limit the amount of data to return. For the request 'search_property' you can use two numbers to limit from which point I get the data and how much data. Example: 0,10 ; this returns from property zero onwards a total of ten properties.",
        "$ref":"string"
    },
    "contact_name": {
        "description":"Name of the contact to create.",
        "$ref":"string"
    },
    "contact_surname": {
        "description":"Surname of the contact to create.",
        "$ref":"string"
    },
    "contact_phone": {
        "description":"Contact phone number.",
        "$ref":"int"
    },
    "contact_mobile": {
        "description":"Contact's mobile number.",
        "$ref":"int"
    },
    "contact_email": {
        "description":"Contact email.",
        "$ref":"string"
    },
    "contact_notes": {
        "description":"Detailed notes of contact communication.",
        "$ref":"string"
    },
    "contact_origin": {
        "description":"Free field. It is advisable to use the name of the website or the URL where the communication comes from.",
        "$ref":"string"
    },
    "contact_in_out": {
        "description":"Input type, can be (IN, OUT).",
        "$ref":"string"
    },
    "contact_is_promotion": {
        "description":"Boolean value that can be true or false.",
        "$ref":"bool"
    }
    "frominmotek": {
        "description":"Enables access to the property regardless of its status. Can be (1)",
        "$ref":"bool"
    }
 }
    

How to Use Request #back to top

To form a correct request, it must be concatenated to the base URL:
http://api.inmotek.net/v3/
the request to be made.
For example:
http://api.inmotek.net/v3/me


Response types #back to top

For a good understanding, the errors that may occur have been classified so that it is understood why a request could fail or the expected value was not received.

Status Msg
400 "Request 'X' does not exists"
400 "Given 'X' is empty and this is mandatory"
400 ""Given 'X' is empty and this is mandatory when 'all_data' is active""
400 "Given 'X' is wrong"
400 "Given 'X' is not accessible. Fordibben"
400 "You shouldn't be here. Access IP Fordibben"
500 "I am NOT a word search"
204 "The request is correct but did not return data"
400 "Syntax error or missing resources"
401 "You are not authorized to see this data"
500 "Error processing request"
418 "UKNOW ERROR SERVER!!"

With this request to the API we obtain the information of the agency as well as address and logo.

Header parameters

Param Type Mandatory
agency-id integer true
token string true

Accepted parameters

Param Type Mandatory Stackable
lang string false Always
nocache bool false Always

Example:


 {
    "request": {
        "status": "200",
        "msg": "The request is correct",
        "date": "2020-1X-1X 1X:1X:1X"
 },
    "me": {
        "agency_id": "28XX",
        "code_name": "lorem",
        "company_name": "lOREM IPSUM",
        "legal_name": "LOREM IPSUM S.A",
        "tax_id": "55555555Y",
        "lang": "es",
        "address": "C/lorem ipsum 12 Left",
        "city": "Lorem",
        "province": "Lorem",
        "country": "España",
        "zip": "00000",
        "web": "www.lorem-ipsum.com",
        "associated_id": "",
        "logo": "rutalogo~lorem_ipsum.jpg",
        "logo_associated": "rutalogoapi~loremapi.jpg"
  },
    "cached_time": "2020-1X-1X 1X:1X:1X"
 }

Outstanding - #back to top

With this request to the API we obtain the information of the outstanding properties. The answer is a reduced JSON with the most important data.

Header parameters

Param Type Mandatory
agency-id integer true
token string true

Accepted parameters

Param Type Mandatory Stackable
lang string false Always
operation string false Always
search_group bool false Always
nocache bool false Always

Example:


{
    "request": {
        "status": "200",
        "msg": "The request is correct",
        "date": "2020-XX-XX XX:XX:XX"
    },
    "outstanding": [
        {
            "propertyCode": "1XXX",
            "propertyAgency": "Lorem",
            "title": "Lorem the It is a long established fact that a reader will be distracted by the readable content",
            "propertyReference": "1XXX",
            "propertyPromocion": false,
            "propertyStatus": "1",
            "propertySituation": "LOREM-IPSUM",
            "propertyOutstanding": true,
            "propertyRegisterDate": "2020-XX-XX",
            "propertyUpdateDate": "2020-XX-XX XX:XX:XX",
            "propertyOffice": "1",
            "propertyVisibility": false,
            "propertyOperation": {
                "operationType": "a,v",
                "operationPriceSale": "10XXXXX",
                "operationPriceRent": "10XX",
                "operationPricePreviousSale": "15XXXX",
                "operationPricePreviousRent": null
            },
            "propertyContact": {
                "contactName": "XXXXX",
                "contactEmail": "xxxx@xx.com",
                "contactPicture": "xxx",
                "contactPrimaryPhonePrefix": "34",
                "contactPrimaryPhoneNumber": "xxx",
                "contactSecondaryPhonePrefix": "34",
                "contactSecondaryPhoneNumber": "xxx"
            },
            "propertyAddress": {
                "addressTownCode": "3XXX",
                "addressTown": "Lorem Ipsum",
                "addressProvinceCode": "2X",
                "addressProvince": "Lorem",
                "addressCountryCode": "1",
                "addressCountry": "España",
                "addressZoneCode": "1X",
                "addressZone": "Lorem ipsum",
                "addressSubZoneCode": "1X",
                "addressSubZone": "Lorem Ipsum",
                "addressCoordinatesLatitude": "43.XXXXX",
                "addressCoordinatesLongitude": "-2.XXXXX",
                "addressVisibility": "full"
            },
            "propertyFeatures": {
                "featuresType": "Piso",
                "featuresSubType": "XXXX",
                "featuresAreaConstructed": "X.X",
                "featuresAreaUsable": "XX.X",
                "featuresBathroomNumber": "X",
                "featuresNoRequireCes": false,
                "featuresCesIndex": "X.XXX",
                "featuresEnergyCertificateRating": "XX",
                "featuresEnergyCertificatePerfomance": "X.XXX",
                "featuresEnergyCertificateRatingCo2": "XXX",
                "featuresCesRegisterNum": "XXX",
                "featuresRooms": "X",
                "featuresConditionedAir": false,
                "featuresHeating": false,
                "featuresStorage": false,
                "featuresGarage": false,
                "featuresGarageIncluded": false,
                "featuresAccess": false,
                "featuresGarden": false,
                "featuresPool": false,
                "featuresTerrace": false,
                "featuresAlarm": false,
                "featuresElevator": false
            },
            "propertyMedia": {
                "hasVideo": false,
                "photo_min": "XX-XX-XX-XX.jpg",
                "url_min": "http://img.pruebas-inmotek.net/media/XXXX/fotos/inmuebles/XXXX/min/min-2XXX~XX-XX-XX-XX.jpg",
                "photo": "XX-XX-XX-XX-XX-XX",
                "url": "http://img.pruebas-inmotek.net/media/XX/fotos/inmuebles/XXX/med/med-XXX~XX-XX-XX-XX-XXX.jpg",
                "photo_large": "XXX-XX-XXX-XX-XX-XX.jpg",
                "url_large": "http://img.pruebas-inmotek.net/media/XXX/fotos/inmuebles/2XXX/2XXX~XX-XX-XX-XX-XX-XX.jpg"
            },
            "propertyImages": [
                "http://img.pruebas-inmotek.net/media/XXXXX/fotos/inmuebles/2XXXX/2XXXX~XXXXXXX.jpg",
                "http://img.pruebas-inmotek.net/media/XXXXX/fotos/inmuebles/2XXXX/2XXXX~XXXXXX.jpg",
                "http://img.pruebas-inmotek.net/media/XXXXX/fotos/inmuebles/2XXXX/2XXXX~2XXXXX.jpg",
                "http://img.pruebas-inmotek.net/media/XXXXX/fotos/inmuebles/2XXXX/2XXXX~XXXXXX.jpg",
                "http://img.pruebas-inmotek.net/media/XXXXX/fotos/inmuebles/2XXXX/2XXXX~XXXXXX.jpg"
            ],
            "propertyDescription": "Lorem the It is a long established fact that a reader will be distracted by the readable content of a page when looking at its layout."
        }
    ],
    "cached_time": "2020-12-24 10:52:18"
}

Property News - #back to top

With this request to the API we obtain the information of the new properties. The answer is a reduced JSON with the most important data.

Header parameters

Param Type Mandatory
agency-id integer true
token string true

Accepted parameters

Param Type Mandatory Stackable
lang string false Always
operation string false Always
search_group bool false Always
nocache bool false Always

Example:


{
    "request": {
        "status": "200",
        "msg": "The request is correct",
        "date": "2020-XX-XX XX:XX:XX"
    },
    "outstanding": [
        {
            "propertyCode": "1XXX",
            "propertyAgency": "Lorem",
            "title": "Lorem the It is a long established fact that a reader will be distracted by the readable content",
            "propertyReference": "1XXX",
            "propertyPromocion": false,
            "propertyStatus": "1",
            "propertySituation": "LOREM-IPSUM",
            "propertyOutstanding": true,
            "propertyRegisterDate": "2020-XX-XX",
            "propertyUpdateDate": "2020-XX-XX XX:XX:XX",
            "propertyOffice": "1",
            "propertyVisibility": false,
            "propertyOperation": {
                "operationType": "a,v",
                "operationPriceSale": "10XXXXX",
                "operationPriceRent": "10XX"
            },
            "propertyAddress": {
                "addressTownCode": "3XXX",
                "addressTown": "Lorem Ipsum",
                "addressProvinceCode": "2X",
                "addressProvince": "Lorem",
                "addressCountryCode": "1",
                "addressCountry": "España",
                "addressZoneCode": "1X",
                "addressZone": "Lorem ipsum",
                "addressSubZoneCode": "1X",
                "addressSubZone": "Lorem Ipsum",
                "addressCoordinatesLatitude": "43.XXXXX",
                "addressCoordinatesLongitude": "-2.XXXXX",
                "addressVisibility": "full"
            },
            "propertyFeatures": {
                "featuresType": "Piso",
                "featuresSubType": "XXXX",
                "featuresAreaConstructed": "X.X",
                "featuresAreaUsable": "XX.X",
                "featuresBathroomNumber": "X",
                "featuresNoRequireCes": false,
                "featuresCesIndex": "X.XXX",
                "featuresEnergyCertificateRating": "XX",
                "featuresEnergyCertificatePerfomance": "X.XXX",
                "featuresEnergyCertificateRatingCo2": "XXX",
                "featuresCesRegisterNum": "XXX",
                "featuresRooms": "X",
                "featuresConditionedAir": false,
                "featuresHeating": false,
                "featuresStorage": false,
                "featuresGarage": false,
                "featuresGarageIncluded": false,
                "featuresAccess": false,
                "featuresGarden": false,
                "featuresPool": false,
                "featuresTerrace": false,
                "featuresAlarm": false,
                "featuresElevator": false
            },
            "propertyMedia": {
                "hasVideo": false,
                "photo_min": "XX-XX-XX-XX.jpg",
                "url_min": "http://img.pruebas-inmotek.net/media/XXXX/fotos/inmuebles/XXXX/min/min-2XXX~XX-XX-XX-XX.jpg",
                "photo": "XX-XX-XX-XX-XX-XX",
                "url": "http://img.pruebas-inmotek.net/media/XX/fotos/inmuebles/XXX/med/med-XXX~XX-XX-XX-XX-XXX.jpg",
                "photo_large": "XXX-XX-XXX-XX-XX-XX.jpg",
                "url_large": "http://img.pruebas-inmotek.net/media/XXX/fotos/inmuebles/2XXX/2XXX~XX-XX-XX-XX-XX-XX.jpg"
            },
            "propertyImages": [
                "http://img.pruebas-inmotek.net/media/XXXXX/fotos/inmuebles/2XXXX/2XXXX~XXXXXXX.jpg",
                "http://img.pruebas-inmotek.net/media/XXXXX/fotos/inmuebles/2XXXX/2XXXX~XXXXXX.jpg",
                "http://img.pruebas-inmotek.net/media/XXXXX/fotos/inmuebles/2XXXX/2XXXX~2XXXXX.jpg",
                "http://img.pruebas-inmotek.net/media/XXXXX/fotos/inmuebles/2XXXX/2XXXX~XXXXXX.jpg",
                "http://img.pruebas-inmotek.net/media/XXXXX/fotos/inmuebles/2XXXX/2XXXX~XXXXXX.jpg"
            ],
            "propertyDescription": "Lorem the It is a long established fact that a reader will be distracted by the readable content of a page when looking at its layout."
        }
    ],
    "cached_time": "2020-12-24 10:52:18"
}

Property Reduced - #back to top

With this request to the API we obtain the information of the properties with reduced prices. The answer is a reduced JSON with the most important data.

Header parameters

Param Type Mandatory
agency-id integer true
token string true

Accepted parameters

Param Type Mandatory Stackable
lang string false Always
operation string false Always
search_group bool false Always
nocache bool false Always

Example:


{
    "request": {
        "status": "200",
        "msg": "The request is correct",
        "date": "2020-XX-XX XX:XX:XX"
    },
    "outstanding": [
        {
            "propertyCode": "1XXX",
            "propertyAgency": "Lorem",
            "title": "Lorem the It is a long established fact that a reader will be distracted by the readable content",
            "propertyReference": "1XXX",
            "propertyPromocion": false,
            "propertyStatus": "1",
            "propertySituation": "LOREM-IPSUM",
            "propertyOutstanding": true,
            "propertyRegisterDate": "2020-XX-XX",
            "propertyUpdateDate": "2020-XX-XX XX:XX:XX",
            "propertyOffice": "1",
            "propertyVisibility": false,
            "propertyOperation": {
                "operationType": "a,v",
                "operationPriceSale": "10XXXXX",
                "operationPriceRent": "10XX"
            },
            "propertyAddress": {
                "addressTownCode": "3XXX",
                "addressTown": "Lorem Ipsum",
                "addressProvinceCode": "2X",
                "addressProvince": "Lorem",
                "addressCountryCode": "1",
                "addressCountry": "España",
                "addressZoneCode": "1X",
                "addressZone": "Lorem ipsum",
                "addressSubZoneCode": "1X",
                "addressSubZone": "Lorem Ipsum",
                "addressCoordinatesLatitude": "43.XXXXX",
                "addressCoordinatesLongitude": "-2.XXXXX",
                "addressVisibility": "f"
            },
            "propertyFeatures": {
                "featuresType": "Piso",
                "featuresSubType": "XXXX",
                "featuresAreaConstructed": "X.X",
                "featuresAreaUsable": "XX.X",
                "featuresBathroomNumber": "X",
                "featuresNoRequireCes": false,
                "featuresCesIndex": "X.XXX",
                "featuresEnergyCertificateRating": "XX",
                "featuresEnergyCertificatePerfomance": "X.XXX",
                "featuresEnergyCertificateRatingCo2": "XXX",
                "featuresCesRegisterNum": "XXX",
                "featuresRooms": "X",
                "featuresConditionedAir": false,
                "featuresHeating": false,
                "featuresStorage": false,
                "featuresGarage": false,
                "featuresGarageIncluded": false,
                "featuresAccess": false,
                "featuresGarden": false,
                "featuresPool": false,
                "featuresTerrace": false,
                "featuresAlarm": false,
                "featuresElevator": false
            },
            "propertyMedia": {
                "hasVideo": false,
                "photo_min": "XX-XX-XX-XX.jpg",
                "url_min": "http://img.pruebas-inmotek.net/media/XXXX/fotos/inmuebles/XXXX/min/min-2XXX~XX-XX-XX-XX.jpg",
                "photo": "XX-XX-XX-XX-XX-XX",
                "url": "http://img.pruebas-inmotek.net/media/XX/fotos/inmuebles/XXX/med/med-XXX~XX-XX-XX-XX-XXX.jpg",
                "photo_large": "XXX-XX-XXX-XX-XX-XX.jpg",
                "url_large": "http://img.pruebas-inmotek.net/media/XXX/fotos/inmuebles/2XXX/2XXX~XX-XX-XX-XX-XX-XX.jpg"
            },
            "propertyImages": [
                "http://img.pruebas-inmotek.net/media/XXXXX/fotos/inmuebles/2XXXX/2XXXX~XXXXXXX.jpg",
                "http://img.pruebas-inmotek.net/media/XXXXX/fotos/inmuebles/2XXXX/2XXXX~XXXXXX.jpg",
                "http://img.pruebas-inmotek.net/media/XXXXX/fotos/inmuebles/2XXXX/2XXXX~2XXXXX.jpg",
                "http://img.pruebas-inmotek.net/media/XXXXX/fotos/inmuebles/2XXXX/2XXXX~XXXXXX.jpg",
                "http://img.pruebas-inmotek.net/media/XXXXX/fotos/inmuebles/2XXXX/2XXXX~XXXXXX.jpg"
            ],
            "propertyDescription": "Lorem the It is a long established fact that a reader will be distracted by the readable content of a page when looking at its layout."
        }
    ],
    "cached_time": "2020-12-24 10:52:18"
}

Property Search - #back to top

With this request to the API we obtain the information of several properties by different types of filter. Most filters are stackable so there is no problem finding what you want. The answer is a reduced JSON with the most important data.

Header parameters

Param Type Mandatory
agency-id integer true
token string true

Accepted parameters

Param Type Mandatory Stackable
lang string false Always
operation string false Always
type string false Always
min_price integer false Always
max_price integer false Always
province integer false Half
location integer false Half
zone integer false Half
subzone integer false Half
province_location array false Half
location_zones array false Half
garage bool false Always
lift bool false Always
air bool false Always
heating bool false Always
storage bool false Always
terrace bool false Always
garden bool false Always
min_meters integer false Always
max_meters integer false Always
rooms integer false Always
bathrooms integer false Always
min_rooms integer false Always
min_bathrooms integer false Always
search_code string false Always
search_order_field integer false Always
search_order string false Always
search_group bool false Always
filter_groups string false Always
search_ref string false Always
property_status int/string false Always
featured bool false Always
belongs_promotion bool false Always
vpo bool false Always
limit string false Always
nocache bool false Always

Example:


{
    "request": {
        "status": "200",
        "msg": "The request is correct",
        "date": "2021-08-17 10:55:02"
    },
    "customer_properties": [
        {
            "propertyCode": "180",
            "propertyAgency": "test",
            "propertyTitle": "Piso en Venta, zona Centro de Logroño",
            "propertyReference": "180",
            "propertyPromocion": false,
            "propertyStatus": "1",
            "propertySituation": "",
            "propertyOutstanding": true,
            "propertyRegisterDate": "2021-07-27",
            "propertyUpdateDate": "2021-08-06 12:03:56",
            "propertyOffice": "1",
            "propertyVisibility": false,
            "propertyOperation": {
                "operationType": "v",
                "operationPriceSale": "90000",
                "operationPriceRent": "0",
                "operationPricePreviousSale": "95000",
                "operationPricePreviousRent": null
            },
            "propertyContact": {
                "contactName": "XXXXX",
                "contactEmail": "ventas@XXX.es",
                "contactPicture": "XXXX",
                "contactPrimaryPhonePrefix": "34",
                "contactPrimaryPhoneNumber": "622043935",
                "contactSecondaryPhonePrefix": "34",
                "contactSecondaryPhoneNumber": "622043935"
            },
            "propertyAddress": {
                "addressTownCode": "4129",
                "addressTown": "Log",
                "addressProvinceCode": "26",
                "addressProvince": "La R",
                "addressCountryCode": "1",
                "addressCountry": "España",
                "addressZoneCode": "4472",
                "addressZone": "Centro",
                "addressSubZoneCode": "12614",
                "addressSubZone": "Estación Autobuses",
                "addressCoordinatesLatitude": "42.458309",
                "addressCoordinatesLongitude": "-2.446412",
                "addressVisibility": "hidden"
            },
            "propertyFeatures": {
                "featuresType": "Piso",
                "featuresTypeABS": "Piso",
                "featuresSubType": "Piso",
                "featuresSubTypeABS": "Piso",
                "featuresAreaConstructed": "73.0",
                "featuresAreaUsable": "70.0",
                "featuresAreaLand": "XXXX.0",
                "featuresBathroomNumber": "1",
                "featuresNoRequireCes": false,
                "featuresCesIndex": "0.000",
                "featuresEnergyCertificateRating": "",
                "featuresEnergyCertificatePerfomance": "0.000",
                "featuresEnergyCertificateRatingCo2": "",
                "featuresCesRegisterNum": "",
                "featuresCesEndDate": "00/00/0000",
                "featuresStreetcar": false,
                "featuresVPO": false,
                "featuresRooms": "3",
                "featuresFurnished": true,
                "featuresWardrobes": false,
                "featuresBankProperty": false,
                "featuresConditionedAir": true,
                "featuresHeating": true,
                "featuresHotWater": false,
                "featuresStorage": false,
                "featuresGarage": false,
                "featuresGarageIncluded": false,
                "featuresAccess": true,
                "featuresGarden": false,
                "featuresPool": false,
                "featuresTerrace": true,
                "featuresBalcony": false,
                "featuresAlarm": false,
                "featuresLiftGroundFloor": false,
                "featuresLift": true
            },
            "propertyMedia": {
                "hasVideo": false,
                "photo_min": "20201217_124245.jpg",
                "url_min": "https://img.inmotek.net/media/test/fotos/inmuebles/180/min/min-180~2021217_12424.jpg",
                "photo": "20201217_124245.jpg",
                "url": "https://img.inmotek.net/media/test/fotos/inmuebles/180/med/med-180~2020117_12245.jpg",
                "photo_large": "20201217_124245.jpg",
                "url_large": "https://img.inmotek.net/media/test/fotos/inmuebles/180/180~2020217_12445.jpg"
            },
            "propertyImages": [
                "https://img.inmotek.net/media/test/fotos/inmuebles/180/180~20201217_124245.jpg",
                "https://img.inmotek.net/media/test/fotos/inmuebles/180/180~20201217_124303.jpg",
                "https://img.inmotek.net/media/test/fotos/inmuebles/180/180~20201217_124212.jpg",
                "https://img.inmotek.net/media/test/fotos/inmuebles/180/180~20201217_122457.jpg",
                "https://img.inmotek.net/media/test/fotos/inmuebles/180/180~20201217_122530.jpg"
            ],
            "propertyDescription": "Esta es una descripcion de prueba"
        }
    ],
    "cached_time": "2021-08-17 10:55:02"
}

Num property search - #back to top

With this request to the API we will obtain the amount of properties that exist according to the given filters.

Header parameters

Param Type Mandatory
agency-id integer true
token string true

Accepted parameters

Param Type Mandatory Stackable
lang string false Always
operation string false Always
type string false Always
min_price integer false Always
max_price integer false Always
province integer false Half
location integer false Half
zone integer false Half
subzone integer false Half
province_location array false Half
location_zones array false Half
garage bool false Always
elevator bool false Always
air bool false Always
heating bool false Always
storage bool false Always
terrace bool false Always
garden bool false Always
min_meters integer false Always
max_meters integer false Always
rooms integer false Always
bathrooms integer false Always
min_rooms integer false Always
min_bathrooms integer false Always
search_code string false Always
filter_groups string false Always
search_group bool false Always
search_ref string false Always
property_status int/string false Always
featured bool false Always
belongs_promotion bool false Always
vpo bool false Always
limit string false Always
nocache bool false Always

Example:


 {
    "request": {
        "status": "200",
        "msg": "The request is correct",
        "date": "2021-XX-XX XX:XX:XX"
    },
    "num_properties": 850,
    "cached_time": "2021-XX-XX XX:XX:XX"
}

Property - #back to top

With this request to the API we obtain the information of several properties by different types of filter. Most filters are stackable so there is no problem finding what you want. The answer is a reduced JSON with the most important data.

Header parameters

Param Type Mandatory
agency-id integer true
token string true

Accepted parameters

Param Type Mandatory Stackable
lang string false Always
property_code int true Always
property_ref string false Always
search_group bool false Always
property_status int/string false Always
frominmotek int/string false Always
nocache bool false Always

Example:


{
    "request": {
        "status": "200",
        "msg": "The request is correct",
        "date": "20XX-XX-XX XX:XX:XX"
    },
    "propertys": [
        {
            "propertyCode": "XXXX",
            "propertyTitle": "Lorem Ipsum dobler",
            "propertyReference": "XXXX",
	    "propertyStatus": "1",
            "propertyVisibility": true,
            "propertyRegisterDate": "XXXX",
            "propertyUpdateDate": "XXXXX",
            "propertyOperation": {
                "operationType": "a,v",
                "operationPriceSale": "XXXXXX",
                "operationPriceRent": "XXXX",
                "operationPriceCommunity": "XXXX",
                "operationPriceCommunityNotes": "XXXXXXX",
                "operationPricePreviousSale": "8XXXXXXX",
                "operationPricePreviousRent": null
            },
            "propertyContact": {
                "contactName": "XXXXX",
                "contactEmail": "info@inmotek.com",
                "contactPicture": "http://XXXX.inmotek.net/media/XXXXX/fotos/usuarios/1-XXXX.jpg",
                "contactPrimaryPhonePrefix": "34",
                "contactPrimaryPhoneNumber": "60XXXXX",
                "contactSecondaryPhonePrefix": "34",
                "contactSecondaryPhoneNumber": "60xxxxxx"
            },
            "propertyAddress": {
                "addressVisibility": "full",
                "addressStreetName": "XXXXX",
                "addressStreetNumber": "XX",
                "addressFloor": "1",
                "addressStair": "XX",
                "addressDoor": "XX",
                "addressSituation": "XX",
                "addressPostalCode": "4XXXXX",
                "addressTown": "XXXX",
                "addressProvince": "XXXX",
                "addressZone": "XXXXX",
                "addressSubZone": XXXXX,
                "addressCountry": "España",
                "addressCoordinatesPrecision": "1",
                "addressCoordinatesLatitude": "43.XXXXX",
                "addressCoordinatesLongitude": "-2.XXXXX"
            },
            "propertyFeatures": {
                "featuresType": "Piso",
                "featuresSubType": "XXXX",
                "featuresAreaConstructed": "1XX.0",
                "featuresAreaUsable": "XX.0",
                "featuresAreaLand": "XXXX.0",
                "featuresBathroomNumber": "X",
                "featuresBedroomNumber": "X",
                "featuresBuiltYear": "2XXXX",
                "featuresConditionedAir": true,
                "featuresConditionedAirName": "climatizacion",
                "featuresHeating": true,
                "featuresHeatingName": "Electrica",
                "featuresConservation": "X",
                "featuresConservationName": "New or SemyNew",
                "featuresLiftGroundFloor": false,
                "featuresAntenna": false,
                "featuresLift": false,
                "featuresBus": false,
                "featuresSubway": false,
                "featuresClub": false,
                "featuresGames": false,
                "featuresPaddle": false,
                "featuresCommunityParking": false,
                "featuresSolarPanels": false,
                "featuresSolarium": false,
                "featuresStreetcar": true,
                "featuresVPO": false,
                "featuresVideoIntercom": false,
                "featuresSeaViews": false,
                "featuresTrain": false,
                "featuresDoorman": false,
                "featuresNoRequireCes": false,
                "featuresCesIndex": "43.000",
                "featuresEnergyCertificateRating": "F",
                "featuresEnergyCertificatePerfomance": "2XX.000",
                "featuresEnergyCertificateRatingCo2": "E",
                "featuresCesRegisterNum": "AXXXXXX-1X-004X",
                "featuresCesEndDate": "2XXX-XX-XX",
                "featuresBankProperty": false,
                "featuresGarden": false,
                "featuresPets": false,
                "featuresUtensils": false,
                "featuresPrivateBathroom": false,
                "featuresMicrowave": false,
                "featuresBeds": false,
                "featuresRefrigerator": false,
                "featuresForeign": false,
                "featuresIron": false,
                "featuresDryer": false,
                "featuresSmoking": false,
                "featuresTv": false,
                "featuresKiln": false,
                "featuresWasher": false,
                "featuresCeramicHob": false,
                "featuresDishwasher": false,
                "featuresWifi": false,
                "featuresWindowViews": false,
                "featuresBedSheets": false,
                "featuresTypeBed": false,
                "featuresCleaning": false,
                "featuresOrientationName": "Norte|Sur|Oeste",
                "featuresOrientationEast": false,
                "featuresOrientationWest": false,
                "featuresOrientationNorth": false,
                "featuresOrientationSouth": false,
                "featuresFurnished": "true",
                "featuresFurnishedName": "AMUEBLADO",
                "featuresPool": false,
                "featuresRooms": "XXXX",
                "featuresStorage": false,
                "featuresTerrace": false,
                "featuresWardrobes": false,
                "featuresParkingAvailable": false,
                "featuresGarage": false,
                "featuresGarageIncluded": false,
                "featuresAccess": false,
                "featuresViews": false,
                "featuresFloorsPerFloor": false,
                "featuresLivingRoom": false,
                "featuresHall": false,
                "featuresBalcony": false,
                "featuresKitchenNotes": XXXXX,
                "featuresEquippedKitchen": false,
                "featuresLarder": false,
                "featuresDomotica": false,
                "featuresLaundryRoom": false,
                "featuresBowWindow": false,
                "featuresBlinds": false,
                "featuresHighCeilings": false,
                "featuresClothersRack": false,
                "featuresDressingRoom": false,
                "featuresBunkBed": false,
                "featuresStrongBox": false,
                "featuresSupplies": false
            },
            "propertyDescription": [
                {
                    "descriptionLanguage": "spanish",
                    "descriptionText": "Lorem the It is a long established fact that a reader will be distracted by the readable content of a page when looking at its layout. The point of using Lorem Ipsum is that it has a more-or-less normal distribution of letters"
                },
                {
                    "descriptionLanguage": "english",
                    "descriptionText": "Lorem the It is a long established fact that a reader will be distracted by the readable content of a page when looking at its layout. The point of using Lorem Ipsum is that it has a more-or-less normal distribution of letters"
                }
            ],
            "propertyMetadata": {
                "es": {
                    "metaLanguage": "spanish",
                    "metaTitle": "Piso en la zona centrica y tranquila de XXX",
                    "metaDescription": "Description of SSS"
                }
            },
            "propertyImages": [
                {
                    "imageLabel": "Parking",
                    "imageOrder": 1,
                    "imageUrl": "http://lorem.inmotek.net/media/lorem/fotos/inmuebles/1205/1205~XXXX.jpg"
                },
                {
                    "imageLabel": "Plano",
                    "imageOrder": 2,
                    "imageUrl": "http://lorem.inmotek.net/media/lorem/fotos/inmuebles/1205/1205~XXXXX.jpg"
                },
                {
                    "imageLabel": "Parking",
                    "imageOrder": 3,
                    "imageUrl": "http://lorem.inmotek.net/media/lorem/fotos/inmuebles/1205/1205~XXXXX.jpg"
                },
                {
                    "imageLabel": "Baño",
                    "imageOrder": 4,
                    "imageUrl": "http://lorem.inmotek.net/media/lorem/fotos/inmuebles/1205/1205~XXXXX.jpg"
                },
                {
                    "imageLabel": "Terraza",
                    "imageOrder": 5,
                    "imageUrl": "http://lorem.inmotek.net/media/lorem/fotos/inmuebles/1205/1205~XXXX.jpg"
                }
            ],
            "propertyDocuments": [
                {
                    "DocName": "XXXX.pdf",
                    "DocLabel": "DOC CES",
                    "DocDescription": "ceslabel",
                    "DocType": "plano",
                    "DocUrl": "//img.inmotek.net/media/XXXX/documentos/inmuebles/XXXXX~XXXX30.pdf"
                }
            ],
            "propertyVirtualTours3D": [
                {
                    "virtualTour": {
                        "virtualTourType": "matterport",
                        "virtualTourUrl": "https://my.matterport.com/show/?m=XXXXXXXXXXX"
                    }
                }
            ],
            "propertyVirtualTours360": [
                {
                    "virtualTour": {
                        "virtualTourType": "360",
                        "virtualTourUrl": "https://my.XXXXX.com/show/?m=XXXXXXXXXXX"
                    }
                }
            ],
            "propertyVideos": [
                {
                    "videoUrl": "https://www.youtube.com/watch?v=XXXXXXXXX"
                }
            ]
        }
    ],
    "cached_time": "20XX-XX-XX XX:XX:00"
}

Offices - #back to top

With this request to the API we obtain the information from all the agency's offices. The answer is a reduced JSON with the most important data.

Header parameters

Param Type Mandatory
agency-id integer true
token string true

Accepted parameters

Param Type Mandatory Stackable
lang string false Always
search_group bool false Always
nocache bool false Always

Example:


 {
    "request": {
        "status": "200",
        "msg": "The request is correct",
        "date": "20XX-1X-XX 1X:XX:4X"
    },
    "offices": [
        {
            "id": "1",
            "principal": "1",
            "publish": "1",
            "name": "Lorem(Ipsum)",
            "latitude": "43.131479",
            "longitude": "-2.538297",
            "country": "España",
            "province": "XXXX",
            "city": "XXXXX",
            "address": "Lorem Ipsum 12",
            "cp": "4XXXX",
            "phone": "99999999",
            "phone_2": "88888888",
            "fax": "77777777",
            "email": "info@lorem-ipsum.com"
        },
        {
            "id": "2",
            "principal": "0",
            "publish": "1",
            "name": "Ipsum(Lorem)",
            "latitude": "43.175851",
            "longitude": "-2.576846",
            "country": "España",
            "province": "XXXXX",
            "city": "XXXXXX",
            "address": "Ipsum Lorem  14",
            "cp": "4XXXX",
            "phone": "9888888",
            "phone_2": "8777777",
            "fax": "75555555",
            "email": "lorem-ipsum2@gmail.com"
        }
    ],
    "cached_time": "20XX-XX-2X XX:XX:4X"
}

Countries - #back to top

With this request to the API we obtain the information of all the countries that have properties or if we mark "all_data" all the countries.

Header parameters

Param Type Mandatory
agency-id integer true
token string true

Accepted parameters

Param Type Mandatory Stackable
lang string false Always
operation string false Always
country int/string false Always
all_data bool false Half
search_group bool false Always
nocache bool false Always

Example:


 {
    "request": {
        "status": "200",
        "msg": "The request is correct",
        "date": "20XX-0X-0X XX:XX:XX"
    },
    "countries": [
        {
            "id": "1",
            "value": "España"
        }
    ],
    "cached_time": "202X-XX-XX XX:XX:XX"
}

Provinces - #back to top

With this request to the API we obtain the information of all the provinces that have properties or if we mark "all_data" all the provinces of a specific country.

Header parameters

Param Type Mandatory
agency-id integer true
token string true

Accepted parameters

Param Type Mandatory Stackable
lang string false Always
operation string false Always
country int/string true Half
province int/string false Always
all_data bool false Half
search_group bool false Always
filter_groups string false Always
nocache bool false Always

Example:


 {
    "request": {
        "status": "200",
        "msg": "The request is correct",
        "date": "202X-XX-XX XX:XX:XX"
    },
    "provinces": [
        {
            "id": "48",
            "value": "Bizkaia"
        },
        {
            "id": "20",
            "value": "Gipuzkoa"
        }
    ],
    "cached_time": "202X-XX-XX XX:XX:XX"
}

Locations - #back to top

With this request to the API we obtain the information of all the towns that have properties or if we mark "all_data" all locations of a specific province.

Header parameters

Param Type Mandatory
agency-id integer true
token string true

Accepted parameters

Param Type Mandatory Stackable
lang string false Always
operation string false Always
country int/string false Half
province int/string true Half
location int/string false Always
all_data bool false Half
search_group bool false Always
filter_groups string false Always
nocache bool false Always

Example:


 {
    "request": {
        "status": "200",
        "msg": "The request is correct",
        "date": "202X-XX-XX XX:XX:XX"
    },
    "locations": [
        {
            "id": "7514",
            "value": "Berriz"
        },
        {
            "id": "7520",
            "value": "Durango"
        },
        {
            "id": "7592",
            "value": "Zaldibar"
        },
        {
            "id": "7523",
            "value": "Elorrio"
        },
        {
            "id": "7503",
            "value": "Atxondo"
        },
        {
            "id": "7488",
            "value": "Abadiño"
        },
        {
            "id": "7559",
            "value": "Mallabia"
        },
        {
            "id": "7526",
            "value": "Ermua"
        }
    ],
    "cached_time": "202X-XX-XX XX:XX:XX"
}

Zones - #back to top

With this request to the API we obtain the information of all the zones that have properties or if we mark "all_data" all the zones of a specific location.

Header parameters

Param Type Mandatory
agency-id integer true
token string true

Accepted parameters

Param Type Mandatory Stackable
lang string false Always
operation string false Always
country int/string false Half
province int/string false Half
location int/string true Half
zone int/string false Always
all_data bool false Half
search_group bool false Always
filter_groups string false Always
nocache bool false Always

Example:


 {
    "request": {
        "status": "200",
        "msg": "The request is correct",
        "date": "202X-XX-XX XX:XX:XX"
    },
    "zones": [
        {
            "id": "9638",
            "value": "Muntsaratz"
        },
        {
            "id": "9641",
            "value": "Traña-Matiena"
        }
    ],
    "cached_time": "202X-XX-XX XX:XX:XX"
}

Subzones - #back to top

With this request to the API we obtain the information of all the subzones that have properties or if we mark "all_data" all the subzones of a specific zone.

Header parameters

Param Type Mandatory
agency-id integer true
token string true

Accepted parameters

Param Type Mandatory Stackable
lang string false Always
operation string false Always
country int/string false Half
province int/string false Half
location int/string false Half
zone int/string true Always
subzone int/string false Always
all_data bool false Half
search_group bool false Always
filter_groups string false Always
nocache bool false Always

Example:


 {
    "request": {
        "status": "200",
        "msg": "The request is correct",
        "date": "202X-XX-XX XX:XX:XX"
    },
    "sub_zones": [
        {
            "id": "31",
            "value": "Moscardó"
        },
        {
            "id": "32",
            "value": "Zofio"
        },
        {
            "id": "33",
            "value": "Pradolongo"
        },
        {
            "id": "34",
            "value": "Almendrales"
        }
    ],
    "cached_time": "202X-XX-XX XX:XX:XX"
}

Types - #back to top

With this request to the api, we get the information of all types of properties from our agency. If we check "all_data" we will obtain all the types and subtypes that we contemplate.

Header parameters

Param Type Mandatory
agency-id integer true
token string true

Accepted parameters

Param Type Mandatory Stackable
lang string false Always
operation string false Always
all_data bool false Always
search_group bool false Always
nocache bool false Always

Example:


 {
    "request": {
        "status": "200",
        "msg": "The request is correct",
        "date": "2021-XX-XX 15:XX:XX"
    },
    "types": [
        {
            "id": "1",
            "value": "Piso",
            "data": [
                {
                    "id": "2",
                    "value": "Piso"
                },
                {
                    "id": "3",
                    "value": "Atico"
                },
                {
                    "id": "4",
                    "value": "Apartamento"
                },
                {
                    "id": "5",
                    "value": "Duplex"
                },
                {
                    "id": "6",
                    "value": "Loft"
                },
                {
                    "id": "33",
                    "value": "Buhardilla"
                },
                {
                    "id": "40",
                    "value": "Triplex"
                },
                {
                    "id": "41",
                    "value": "Quadplex"
                },
                {
                    "id": "42",
                    "value": "Bajo"
                },
                {
                    "id": "45",
                    "value": "Estudio"
                }
            ]
        },
        {
            "id": "2",
            "value": "Casa",
            "data": [
                {
                    "id": "7",
                    "value": "Adosado"
                },
                {
                    "id": "8",
                    "value": "Chalet"
                },
                {
                    "id": "9",
                    "value": "Bungalow"
                },
                {
                    "id": "10",
                    "value": "Casa"
                },
                {
                    "id": "27",
                    "value": "Bifamiliar"
                },
                {
                    "id": "30",
                    "value": "Caserio"
                },
                {
                    "id": "44",
                    "value": "Modulo_camping"
                },
                {
                    "id": "47",
                    "value": "Masia"
                },
                {
                    "id": "48",
                    "value": "Villa"
                },
                {
                    "id": "54",
                    "value": "Pareado"
                }
            ]
        },
        {
            "id": "3",
            "value": "Oficina",
            "data": [
                {
                    "id": "11",
                    "value": "Oficina"
                },
                {
                    "id": "12",
                    "value": "Despacho"
                },
                {
                    "id": "13",
                    "value": "Departamento"
                }
            ]
        },
        {
            "id": "4",
            "value": "Local",
            "data": [
                {
                    "id": "14",
                    "value": "Local"
                },
                {
                    "id": "15",
                    "value": "Lonja"
                },
                {
                    "id": "16",
                    "value": "Almacen"
                },
                {
                    "id": "17",
                    "value": "Txoko"
                },
                {
                    "id": "28",
                    "value": "Bar"
                },
                {
                    "id": "32",
                    "value": "Restaurante"
                },
                {
                    "id": "43",
                    "value": "Bodega"
                }
            ]
        },
        {
            "id": "5",
            "value": "Nave",
            "data": [
                {
                    "id": "18",
                    "value": "Nave"
                },
                {
                    "id": "19",
                    "value": "Almacen"
                },
                {
                    "id": "20",
                    "value": "Granero"
                },
                {
                    "id": "31",
                    "value": "Pabellon"
                }
            ]
        },
        {
            "id": "6",
            "value": "Terreno",
            "data": [
                {
                    "id": "23",
                    "value": "Terreno"
                },
                {
                    "id": "24",
                    "value": "Solar"
                },
                {
                    "id": "25",
                    "value": "Parcela"
                },
                {
                    "id": "52",
                    "value": "Finca"
                }
            ]
        },
        {
            "id": "7",
            "value": "Trastero",
            "data": [
                {
                    "id": "26",
                    "value": "Trastero"
                }
            ]
        },
        {
            "id": "8",
            "value": "Edificio",
            "data": [
                {
                    "id": "34",
                    "value": "Edificio"
                },
                {
                    "id": "35",
                    "value": "Residencial"
                },
                {
                    "id": "36",
                    "value": "Industrial"
                },
                {
                    "id": "37",
                    "value": "Mixto"
                },
                {
                    "id": "38",
                    "value": "Oficinas"
                },
                {
                    "id": "39",
                    "value": "Hotel"
                },
                {
                    "id": "46",
                    "value": "Castillo"
                },
                {
                    "id": "51",
                    "value": "Comercial"
                }
            ]
        },
        {
            "id": "9",
            "value": "Garaje",
            "data": [
                {
                    "id": "21",
                    "value": "Garaje_coche"
                },
                {
                    "id": "22",
                    "value": "Garaje_moto"
                },
                {
                    "id": "53",
                    "value": "Garaje_barco"
                }
            ]
        },
        {
            "id": "10",
            "value": "Habitación",
            "data": [
                {
                    "id": "49",
                    "value": "Familia"
                },
                {
                    "id": "50",
                    "value": "Estudiante"
                }
            ]
        }
    ],
    "cached_time": "2021-xx-xx xx:xx:xx"
}

Promotions - #back to top

With this request to the API we will obtain the promotions of our agency and from them the typologies and from these the properties that are part of a promotion.

Header parameters

Param Type Mandatory
agency-id integer true
token string true

Accepted parameters

Param Type Mandatory Stackable
lang string false Always
id_promotion int true Always
search_group bool false Always
nocache bool false Always

Example:


{
    "request": {
        "status": "200",
        "msg": "The request is correct",
        "date": "2021-XX-XX XX:XX:XX"
    },
    "customer_properties": [
        {
            "promotionCode": "1",
            "promotionTitle": "Edificio en el arenal",
            "promotionSubtitle": "Ideal para tu jubilación",
            "promotionReference": "Edificio en el arenal",
            "promotionDescription": "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Aliquam elit dolor, elementum in nisi vel",
            "promotionDwelling": "251",
            "promotionUpdateDate": "2022-03-15 11:06:56",
            "promotionAddress": {
                "addressTownCode": "7515",
                "addressTown": "Bilbao",
                "addressProvinceCode": "48",
                "addressProvince": "Bizkaia",
                "addressCountryCode": "1",
                "addressCountry": "España",
                "addressZoneCode": "8118",
                "addressZone": "Abando",
                "addressCoordinatesLatitude": "43.2621062965096",
                "addressCoordinatesLongitude": "-2.92438510997317"
            },
            "promotionFeatures": {
                "featuresBarbecue": "1",
                "featuresSauna": "1",
                "featuresSocialClub": "1",
                "featuresSquash": "1",
                "featuresGym": "1",
                "featuresTennis": "1",
                "featuresGames": "1",
                "featuresUrbanization": "1",
                "featuresPaddle": "1",
                "featuresVigilance": "1",
                "featuresPool": "1"
            },
            "promotionContact": {
                "contactName": "Ana Isabel Quevedo",
                "contactEmail": "ana@saresoft.com",
                "contactPicture": "http://img.inmotek.net/media/plantillademo/fotos/usuarios/42-team1.jpg",
                "contactPrimaryPhonePrefix": "34",
                "contactPrimaryPhoneNumber": "",
                "contactSecondaryPhonePrefix": "34",
                "contactSecondaryPhoneNumber": "944236887"
            },
            "promotionMedia": {
                "photo": "036-1170x877.jpg",
                "url": "http://img.inmotek.net/media/plantillademo/fotos/promociones/1~036-1170x877.jpg"
            },
            "promotionTypology": [
                {
                    "id": "2",
                    "tipo": "Piso",
                    "subtipo": "",
                    "descripcion": "Bajos luminosos con jardín",
                    "preciodesde": "215000.000",
                    "preciohasta": "215000.000",
                    "habs": 2,
                    "banos": 2,
                    "metrosdesde": "120.00",
                    "metroshasta": "200.00",
                    "ascensor": "1",
                    "ascensorcalle": "1",
                    "accesominusvalidos": "1",
                    "calefaccion": null,
                    "aguacaliente": null,
                    "terraza": "1",
                    "trastero": "1",
                    "tienegaraje": "1",
                    "aire": true,
                    "bus": "1",
                    "metro": "1",
                    "tren": "1",
                    "tranvia": "1",
                    "notas": "

Viviendas 2 habitaciones 2 baños

\r\n", "fotos_tipologias": [], "documentos_tipologia": [], "inmuebles_tipologia": [ { "id": "119", "ref": "", "address": "1 1º B", "price": "215000", "meters": "122.0" }, { "id": "1679", "ref": "", "address": "1 1º A", "price": "215000", "meters": "122.0" } ] } ], "promotionBaremos": { "preciomin": null, "preciomax": null, "minmetros": null, "maxmetros": null, "minmetros_cons": null, "maxmetros_cons": null, "maxhabi": null, "minhabi": null, "maxbanos": null, "minbanos": null }, "promotionFotos": [ { "max": "http://img.inmotek.net/media/plantillademo/fotos/promociones/1~036-1170x877.jpg", "med": "http://img.inmotek.net/media/plantillademo/fotos/promociones/med/med-1~036-1170x877.jpg", "min": "http://img.inmotek.net/media/plantillademo/fotos/promociones/min/min-1~036-1170x877.jpg", "dim": "1080 X ", "fototext": "", "fotodesc": "" }, { "max": "http://img.inmotek.net/media/plantillademo/fotos/promociones/1~008-1170x877.jpg", "med": "http://img.inmotek.net/media/plantillademo/fotos/promociones/med/med-1~008-1170x877.jpg", "min": "http://img.inmotek.net/media/plantillademo/fotos/promociones/min/min-1~008-1170x877.jpg", "dim": "1080 X ", "fototext": "", "fotodesc": "" }, { "max": "http://img.inmotek.net/media/plantillademo/fotos/promociones/1~013.jpg", "med": "http://img.inmotek.net/media/plantillademo/fotos/promociones/med/med-1~013.jpg", "min": "http://img.inmotek.net/media/plantillademo/fotos/promociones/min/min-1~013.jpg", "dim": "1080 X ", "fototext": "", "fotodesc": "" } ], "promotionFotos3D": [ { "url": "https://vt.plushglobalmedia.com/tour/TT15K5PDOP/embed", "texto": "" } ], "promotionVideos": [ "https://www.youtube.com/watch?v=Y_OiyTMNW0Q" ], "promotionDocuments": [ { "name": "plano", "title": "", "url": "http://img.inmotek.net/media/plantillademo/documentos/promociones/1~145.pdf" }, { "name": "fotos", "title": "", "url": "http://img.inmotek.net/media/plantillademo/documentos/promociones/1~456.pdf" }, { "name": "plano", "title": "", "url": "http://img.inmotek.net/media/plantillademo/documentos/promociones/1~609.pdf" } ] }, { "promotionCode": "2", "promotionTitle": "Puerta del príncipe, apartamentos de lujo", "promotionSubtitle": "Completamente reformados", "promotionReference": "Edificio Sopena", "promotionDescription": "Lorem ipsum dolor sit amet, consectetur adipiscing elit.", "promotionDwelling": "", "promotionUpdateDate": "2022-03-15 11:06:56", "promotionAddress": { "addressTownCode": "1979", "addressTown": "Ciudad Real", "addressProvinceCode": "13", "addressProvince": "Ciudad Real", "addressCountryCode": "1", "addressCountry": "España", "addressZoneCode": "2131", "addressZone": "Centro", "addressCoordinatesLatitude": "38.98476278269615", "addressCoordinatesLongitude": "-3.9270773925903235" }, "promotionFeatures": { "featuresBarbecue": "1", "featuresSauna": "1", "featuresSocialClub": "1", "featuresSquash": "1", "featuresGym": "1", "featuresTennis": "1", "featuresGames": "1", "featuresUrbanization": "1", "featuresPaddle": "1", "featuresVigilance": "1", "featuresPool": "1" }, "promotionContact": { "contactName": "Arturo Ruiz Fernandez", "contactEmail": "amaya@saresoft.com", "contactPicture": "http://img.inmotek.net/media/plantillademo/fotos/usuarios/1-team2.jpg", "contactPrimaryPhonePrefix": "34", "contactPrimaryPhoneNumber": "", "contactSecondaryPhonePrefix": "34", "contactSecondaryPhoneNumber": "944236887" }, "promotionMedia": { "photo": "616_32534_canon-canoneos5dmarkiii-5760x3840-000535.jpg", "url": "http://img.inmotek.net/media/plantillademo/fotos/promociones/2~616_32534_canon-canoneos5dmarkiii-5760x3840-000535.jpg" }, "promotionTypology": [ { "id": "4", "tipo": "Piso", "subtipo": "", "descripcion": "Viviendas de 2 habitaciones", "preciodesde": "200000.000", "preciohasta": "400000.000", "habs": 3, "banos": 3, "metrosdesde": "100.00", "metroshasta": "90.30", "ascensor": "1", "ascensorcalle": "", "accesominusvalidos": "", "calefaccion": null, "aguacaliente": null, "terraza": "", "trastero": "", "tienegaraje": "", "aire": false, "bus": "", "metro": "", "tren": "", "tranvia": "", "notas": "Viviendas de 2 habitaciones", "fotos_tipologias": [], "documentos_tipologia": [], "inmuebles_tipologia": [ { "id": "118", "ref": "", "address": "12 2º ", "price": "12333", "meters": "123.0" }, { "id": "1668", "ref": "", "address": " stº 1", "price": "0", "meters": "0.0" }, { "id": "1669", "ref": "", "address": "12 2º ", "price": "0", "meters": "123.0" }, { "id": "1670", "ref": "", "address": "12 2º ", "price": "0", "meters": "123.0" } ] }, { "id": "6", "tipo": "Piso", "subtipo": "", "descripcion": "Vivienda de 4 habitaciones", "preciodesde": "150000.000", "preciohasta": "300000.000", "habs": 5, "banos": 3, "metrosdesde": "89.00", "metroshasta": "89.00", "ascensor": "1", "ascensorcalle": "1", "accesominusvalidos": "", "calefaccion": null, "aguacaliente": null, "terraza": "", "trastero": "", "tienegaraje": "1", "aire": false, "bus": "1", "metro": "", "tren": "", "tranvia": "", "notas": "Viviendas de 4 habitaciones y 2 baños, exteriores con terraza", "fotos_tipologias": [], "documentos_tipologia": [], "inmuebles_tipologia": [ { "id": "1687", "ref": "", "address": "29 1º B", "price": "0", "meters": "89.0" }, { "id": "1690", "ref": "", "address": "29 1º B", "price": "0", "meters": "89.0" }, { "id": "1691", "ref": "", "address": "29 1º B", "price": "0", "meters": "89.0" }, { "id": "1692", "ref": "", "address": "29 1º B", "price": "0", "meters": "89.0" } ] } ], "promotionBaremos": { "preciomin": null, "preciomax": null, "minmetros": null, "maxmetros": null, "minmetros_cons": null, "maxmetros_cons": null, "maxhabi": null, "minhabi": null, "maxbanos": null, "minbanos": null }, "promotionFotos": [ { "max": "http://img.inmotek.net/media/plantillademo/fotos/promociones/2~616_32534_canon-canoneos5dmarkiii-5760x3840-000535.jpg", "med": "http://img.inmotek.net/media/plantillademo/fotos/promociones/med/med-2~616_32534_canon-canoneos5dmarkiii-5760x3840-000535.jpg", "min": "http://img.inmotek.net/media/plantillademo/fotos/promociones/min/min-2~616_32534_canon-canoneos5dmarkiii-5760x3840-000535.jpg", "dim": "1080 X ", "fototext": "", "fotodesc": "" }, { "max": "http://img.inmotek.net/media/plantillademo/fotos/promociones/2~616_32534_canon-canoneos5dmarkiii-5760x3840-000512.jpg", "med": "http://img.inmotek.net/media/plantillademo/fotos/promociones/med/med-2~616_32534_canon-canoneos5dmarkiii-5760x3840-000512.jpg", "min": "http://img.inmotek.net/media/plantillademo/fotos/promociones/min/min-2~616_32534_canon-canoneos5dmarkiii-5760x3840-000512.jpg", "dim": "1080 X ", "fototext": "", "fotodesc": "" }, { "max": "http://img.inmotek.net/media/plantillademo/fotos/promociones/2~616_32534_canon-canoneos5dmarkiii-5760x3840-000511.jpg", "med": "http://img.inmotek.net/media/plantillademo/fotos/promociones/med/med-2~616_32534_canon-canoneos5dmarkiii-5760x3840-000511.jpg", "min": "http://img.inmotek.net/media/plantillademo/fotos/promociones/min/min-2~616_32534_canon-canoneos5dmarkiii-5760x3840-000511.jpg", "dim": "1080 X ", "fototext": "", "fotodesc": "" }, { "max": "http://img.inmotek.net/media/plantillademo/fotos/promociones/2~616_32534_canon-canoneos5dmarkiii-5760x3840-000493.jpg", "med": "http://img.inmotek.net/media/plantillademo/fotos/promociones/med/med-2~616_32534_canon-canoneos5dmarkiii-5760x3840-000493.jpg", "min": "http://img.inmotek.net/media/plantillademo/fotos/promociones/min/min-2~616_32534_canon-canoneos5dmarkiii-5760x3840-000493.jpg", "dim": "1080 X ", "fototext": "", "fotodesc": "" }, { "max": "http://img.inmotek.net/media/plantillademo/fotos/promociones/2~616_32534_canon-canoneos5dmarkiii-5760x3840-000555.jpg", "med": "http://img.inmotek.net/media/plantillademo/fotos/promociones/med/med-2~616_32534_canon-canoneos5dmarkiii-5760x3840-000555.jpg", "min": "http://img.inmotek.net/media/plantillademo/fotos/promociones/min/min-2~616_32534_canon-canoneos5dmarkiii-5760x3840-000555.jpg", "dim": "1080 X ", "fototext": "", "fotodesc": "" }, { "max": "http://img.inmotek.net/media/plantillademo/fotos/promociones/2~616_32534_canon-canoneos5dmarkiii-5760x3840-000560.jpg", "med": "http://img.inmotek.net/media/plantillademo/fotos/promociones/med/med-2~616_32534_canon-canoneos5dmarkiii-5760x3840-000560.jpg", "min": "http://img.inmotek.net/media/plantillademo/fotos/promociones/min/min-2~616_32534_canon-canoneos5dmarkiii-5760x3840-000560.jpg", "dim": "1080 X ", "fototext": "", "fotodesc": "" } ], "promotionFotos3D": [ { "url": "https://vt.plushglobalmedia.com/tour/TT15K5PDOP/embed", "texto": "" } ], "promotionVideos": [ "https://www.youtube.com/watch?v=BH--_4lUn0Y" ], "promotionDocuments": [ { "name": "publi", "title": "", "url": "http://img.inmotek.net/media/plantillademo/documentos/promociones/2~box-5.jpg" }, { "name": "plano", "title": "", "url": "http://img.inmotek.net/media/plantillademo/documentos/promociones/2~box-5.jpg" } ] } ], "cached_time": "2021-XX-XX XX:XX:XX" }

Promotion - #back to top

https://api.inmotek.net/v3/promotions

With this request to the API we will obtain the promotions of our agency and from them the typologies and from these the properties that are part of a promotion.

Header parameters

Param Type Mandatory
agency-id integer true
token string true

Accepted parameters

Param Type Mandatory Stackable
lang string false Always
id_promotion int true Always
search_group bool false Always
nocache bool false Always

Example:


{
    "request": {
        "status": "200",
        "msg": "The request is correct",
        "date": "2021-XX-XX XX:XX:XX"
    },
    "customer_properties": [
        {
            "promotionCode": "1",
            "promotionTitle": "Edificio en el arenal",
            "promotionSubtitle": "Ideal para tu jubilación",
            "promotionReference": "Edificio en el arenal",
            "promotionDescription": "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Aliquam elit dolor, elementum in nisi vel",
            "promotionDwelling": "251",
            "promotionUpdateDate": "2022-03-15 11:06:56",
            "promotionAddress": {
                "addressTownCode": "7515",
                "addressTown": "Bilbao",
                "addressProvinceCode": "48",
                "addressProvince": "Bizkaia",
                "addressCountryCode": "1",
                "addressCountry": "España",
                "addressZoneCode": "8118",
                "addressZone": "Abando",
                "addressCoordinatesLatitude": "43.2621062965096",
                "addressCoordinatesLongitude": "-2.92438510997317"
            },
            "promotionFeatures": {
                "featuresBarbecue": "1",
                "featuresSauna": "1",
                "featuresSocialClub": "1",
                "featuresSquash": "1",
                "featuresGym": "1",
                "featuresTennis": "1",
                "featuresGames": "1",
                "featuresUrbanization": "1",
                "featuresPaddle": "1",
                "featuresVigilance": "1",
                "featuresPool": "1"
            },
            "promotionContact": {
                "contactName": "Ana Isabel Quevedo",
                "contactEmail": "ana@saresoft.com",
                "contactPicture": "http://img.inmotek.net/media/plantillademo/fotos/usuarios/42-team1.jpg",
                "contactPrimaryPhonePrefix": "34",
                "contactPrimaryPhoneNumber": "",
                "contactSecondaryPhonePrefix": "34",
                "contactSecondaryPhoneNumber": "944236887"
            },
            "promotionMedia": {
                "photo": "036-1170x877.jpg",
                "url": "http://img.inmotek.net/media/plantillademo/fotos/promociones/1~036-1170x877.jpg"
            },
            "promotionTypology": [
                {
                    "id": "2",
                    "tipo": "Piso",
                    "subtipo": "",
                    "descripcion": "Bajos luminosos con jardín",
                    "preciodesde": "215000.000",
                    "preciohasta": "215000.000",
                    "habs": 2,
                    "banos": 2,
                    "metrosdesde": "120.00",
                    "metroshasta": "200.00",
                    "ascensor": "1",
                    "ascensorcalle": "1",
                    "accesominusvalidos": "1",
                    "calefaccion": null,
                    "aguacaliente": null,
                    "terraza": "1",
                    "trastero": "1",
                    "tienegaraje": "1",
                    "aire": true,
                    "bus": "1",
                    "metro": "1",
                    "tren": "1",
                    "tranvia": "1",
                    "notas": "

Viviendas 2 habitaciones 2 baños

\r\n", "fotos_tipologias": [], "documentos_tipologia": [], "inmuebles_tipologia": [ { "id": "119", "ref": "", "address": "1 1º B", "price": "215000", "meters": "122.0" }, { "id": "1679", "ref": "", "address": "1 1º A", "price": "215000", "meters": "122.0" } ] } ], "promotionBaremos": { "preciomin": null, "preciomax": null, "minmetros": null, "maxmetros": null, "minmetros_cons": null, "maxmetros_cons": null, "maxhabi": null, "minhabi": null, "maxbanos": null, "minbanos": null }, "promotionFotos": [ { "max": "http://img.inmotek.net/media/plantillademo/fotos/promociones/1~036-1170x877.jpg", "med": "http://img.inmotek.net/media/plantillademo/fotos/promociones/med/med-1~036-1170x877.jpg", "min": "http://img.inmotek.net/media/plantillademo/fotos/promociones/min/min-1~036-1170x877.jpg", "dim": "1080 X ", "fototext": "", "fotodesc": "" }, { "max": "http://img.inmotek.net/media/plantillademo/fotos/promociones/1~008-1170x877.jpg", "med": "http://img.inmotek.net/media/plantillademo/fotos/promociones/med/med-1~008-1170x877.jpg", "min": "http://img.inmotek.net/media/plantillademo/fotos/promociones/min/min-1~008-1170x877.jpg", "dim": "1080 X ", "fototext": "", "fotodesc": "" }, { "max": "http://img.inmotek.net/media/plantillademo/fotos/promociones/1~013.jpg", "med": "http://img.inmotek.net/media/plantillademo/fotos/promociones/med/med-1~013.jpg", "min": "http://img.inmotek.net/media/plantillademo/fotos/promociones/min/min-1~013.jpg", "dim": "1080 X ", "fototext": "", "fotodesc": "" } ], "promotionFotos3D": [ { "url": "https://vt.plushglobalmedia.com/tour/TT15K5PDOP/embed", "texto": "" } ], "promotionVideos": [ "https://www.youtube.com/watch?v=Y_OiyTMNW0Q" ], "promotionDocuments": [ { "name": "plano", "title": "", "url": "http://img.inmotek.net/media/plantillademo/documentos/promociones/1~145.pdf" }, { "name": "fotos", "title": "", "url": "http://img.inmotek.net/media/plantillademo/documentos/promociones/1~456.pdf" }, { "name": "plano", "title": "", "url": "http://img.inmotek.net/media/plantillademo/documentos/promociones/1~609.pdf" } ] }, { "promotionCode": "2", "promotionTitle": "Puerta del príncipe, apartamentos de lujo", "promotionSubtitle": "Completamente reformados", "promotionReference": "Edificio Sopena", "promotionDescription": "Lorem ipsum dolor sit amet, consectetur adipiscing elit.", "promotionDwelling": "", "promotionUpdateDate": "2022-03-15 11:06:56", "promotionAddress": { "addressTownCode": "1979", "addressTown": "Ciudad Real", "addressProvinceCode": "13", "addressProvince": "Ciudad Real", "addressCountryCode": "1", "addressCountry": "España", "addressZoneCode": "2131", "addressZone": "Centro", "addressCoordinatesLatitude": "38.98476278269615", "addressCoordinatesLongitude": "-3.9270773925903235" }, "promotionFeatures": { "featuresBarbecue": "1", "featuresSauna": "1", "featuresSocialClub": "1", "featuresSquash": "1", "featuresGym": "1", "featuresTennis": "1", "featuresGames": "1", "featuresUrbanization": "1", "featuresPaddle": "1", "featuresVigilance": "1", "featuresPool": "1" }, "promotionContact": { "contactName": "Arturo Ruiz Fernandez", "contactEmail": "amaya@saresoft.com", "contactPicture": "http://img.inmotek.net/media/plantillademo/fotos/usuarios/1-team2.jpg", "contactPrimaryPhonePrefix": "34", "contactPrimaryPhoneNumber": "", "contactSecondaryPhonePrefix": "34", "contactSecondaryPhoneNumber": "944236887" }, "promotionMedia": { "photo": "616_32534_canon-canoneos5dmarkiii-5760x3840-000535.jpg", "url": "http://img.inmotek.net/media/plantillademo/fotos/promociones/2~616_32534_canon-canoneos5dmarkiii-5760x3840-000535.jpg" }, "promotionTypology": [ { "id": "4", "tipo": "Piso", "subtipo": "", "descripcion": "Viviendas de 2 habitaciones", "preciodesde": "200000.000", "preciohasta": "400000.000", "habs": 3, "banos": 3, "metrosdesde": "100.00", "metroshasta": "90.30", "ascensor": "1", "ascensorcalle": "", "accesominusvalidos": "", "calefaccion": null, "aguacaliente": null, "terraza": "", "trastero": "", "tienegaraje": "", "aire": false, "bus": "", "metro": "", "tren": "", "tranvia": "", "notas": "Viviendas de 2 habitaciones", "fotos_tipologias": [], "documentos_tipologia": [], "inmuebles_tipologia": [ { "id": "118", "ref": "", "address": "12 2º ", "price": "12333", "meters": "123.0" }, { "id": "1668", "ref": "", "address": " stº 1", "price": "0", "meters": "0.0" }, { "id": "1669", "ref": "", "address": "12 2º ", "price": "0", "meters": "123.0" }, { "id": "1670", "ref": "", "address": "12 2º ", "price": "0", "meters": "123.0" } ] }, { "id": "6", "tipo": "Piso", "subtipo": "", "descripcion": "Vivienda de 4 habitaciones", "preciodesde": "150000.000", "preciohasta": "300000.000", "habs": 5, "banos": 3, "metrosdesde": "89.00", "metroshasta": "89.00", "ascensor": "1", "ascensorcalle": "1", "accesominusvalidos": "", "calefaccion": null, "aguacaliente": null, "terraza": "", "trastero": "", "tienegaraje": "1", "aire": false, "bus": "1", "metro": "", "tren": "", "tranvia": "", "notas": "Viviendas de 4 habitaciones y 2 baños, exteriores con terraza", "fotos_tipologias": [], "documentos_tipologia": [], "inmuebles_tipologia": [ { "id": "1687", "ref": "", "address": "29 1º B", "price": "0", "meters": "89.0" }, { "id": "1690", "ref": "", "address": "29 1º B", "price": "0", "meters": "89.0" }, { "id": "1691", "ref": "", "address": "29 1º B", "price": "0", "meters": "89.0" }, { "id": "1692", "ref": "", "address": "29 1º B", "price": "0", "meters": "89.0" } ] } ], "promotionBaremos": { "preciomin": null, "preciomax": null, "minmetros": null, "maxmetros": null, "minmetros_cons": null, "maxmetros_cons": null, "maxhabi": null, "minhabi": null, "maxbanos": null, "minbanos": null }, "promotionFotos": [ { "max": "http://img.inmotek.net/media/plantillademo/fotos/promociones/2~616_32534_canon-canoneos5dmarkiii-5760x3840-000535.jpg", "med": "http://img.inmotek.net/media/plantillademo/fotos/promociones/med/med-2~616_32534_canon-canoneos5dmarkiii-5760x3840-000535.jpg", "min": "http://img.inmotek.net/media/plantillademo/fotos/promociones/min/min-2~616_32534_canon-canoneos5dmarkiii-5760x3840-000535.jpg", "dim": "1080 X ", "fototext": "", "fotodesc": "" }, { "max": "http://img.inmotek.net/media/plantillademo/fotos/promociones/2~616_32534_canon-canoneos5dmarkiii-5760x3840-000512.jpg", "med": "http://img.inmotek.net/media/plantillademo/fotos/promociones/med/med-2~616_32534_canon-canoneos5dmarkiii-5760x3840-000512.jpg", "min": "http://img.inmotek.net/media/plantillademo/fotos/promociones/min/min-2~616_32534_canon-canoneos5dmarkiii-5760x3840-000512.jpg", "dim": "1080 X ", "fototext": "", "fotodesc": "" }, { "max": "http://img.inmotek.net/media/plantillademo/fotos/promociones/2~616_32534_canon-canoneos5dmarkiii-5760x3840-000511.jpg", "med": "http://img.inmotek.net/media/plantillademo/fotos/promociones/med/med-2~616_32534_canon-canoneos5dmarkiii-5760x3840-000511.jpg", "min": "http://img.inmotek.net/media/plantillademo/fotos/promociones/min/min-2~616_32534_canon-canoneos5dmarkiii-5760x3840-000511.jpg", "dim": "1080 X ", "fototext": "", "fotodesc": "" }, { "max": "http://img.inmotek.net/media/plantillademo/fotos/promociones/2~616_32534_canon-canoneos5dmarkiii-5760x3840-000493.jpg", "med": "http://img.inmotek.net/media/plantillademo/fotos/promociones/med/med-2~616_32534_canon-canoneos5dmarkiii-5760x3840-000493.jpg", "min": "http://img.inmotek.net/media/plantillademo/fotos/promociones/min/min-2~616_32534_canon-canoneos5dmarkiii-5760x3840-000493.jpg", "dim": "1080 X ", "fototext": "", "fotodesc": "" }, { "max": "http://img.inmotek.net/media/plantillademo/fotos/promociones/2~616_32534_canon-canoneos5dmarkiii-5760x3840-000555.jpg", "med": "http://img.inmotek.net/media/plantillademo/fotos/promociones/med/med-2~616_32534_canon-canoneos5dmarkiii-5760x3840-000555.jpg", "min": "http://img.inmotek.net/media/plantillademo/fotos/promociones/min/min-2~616_32534_canon-canoneos5dmarkiii-5760x3840-000555.jpg", "dim": "1080 X ", "fototext": "", "fotodesc": "" }, { "max": "http://img.inmotek.net/media/plantillademo/fotos/promociones/2~616_32534_canon-canoneos5dmarkiii-5760x3840-000560.jpg", "med": "http://img.inmotek.net/media/plantillademo/fotos/promociones/med/med-2~616_32534_canon-canoneos5dmarkiii-5760x3840-000560.jpg", "min": "http://img.inmotek.net/media/plantillademo/fotos/promociones/min/min-2~616_32534_canon-canoneos5dmarkiii-5760x3840-000560.jpg", "dim": "1080 X ", "fototext": "", "fotodesc": "" } ], "promotionFotos3D": [ { "url": "https://vt.plushglobalmedia.com/tour/TT15K5PDOP/embed", "texto": "" } ], "promotionVideos": [ "https://www.youtube.com/watch?v=BH--_4lUn0Y" ], "promotionDocuments": [ { "name": "publi", "title": "", "url": "http://img.inmotek.net/media/plantillademo/documentos/promociones/2~box-5.jpg" }, { "name": "plano", "title": "", "url": "http://img.inmotek.net/media/plantillademo/documentos/promociones/2~box-5.jpg" } ] } ], "cached_time": "2021-XX-XX XX:XX:XX" }

Property Promotions - #back to top

https://api.inmotek.net/v3/property_promotions

With this request to the api we get the information of all the properties that are part of a build promotion.

Header parameters

Param Type Mandatory
agency-id integer true
token string true

Accepted parameters

Param Type Mandatory Stackable
lang string false Always
operation string false Always
id_typology integer true Always
nocache bool false Always

Example:


{
    "request": {
        "status": "200",
        "msg": "The request is correct",
        "date": "20XX-XX-XX XX:XX:XX"
    },
    "propertys": [
        {
            "propertyCode": "XXXX",
            "propertyTitle": "Lorem Ipsum dobler",
            "propertyReference": "XXXX",
            "propertyVisibility": true,
            "propertyRegisterDate": "XXXX",
            "propertyUpdateDate": "XXXXX",
            "propertyOperation": {
                "operationType": "a,v",
                "operationPriceSale": "XXXXXX",
                "operationPriceRent": "XXXX",
                "operationPriceCommunity": "XXXX"
            },
            "propertyContact": {
                "contactName": "XXXXX",
                "contactEmail": "info@inmotek.com",
                "contactPicture": "http://XXXX.inmotek.net/media/XXXXX/fotos/usuarios/1-XXXX.jpg",
                "contactPrimaryPhonePrefix": "34",
                "contactPrimaryPhoneNumber": "60XXXXX",
                "contactSecondaryPhonePrefix": "34",
                "contactSecondaryPhoneNumber": "60xxxxxx"
            },
            "propertyAddress": {
                "addressVisibility": "f",
                "addressStreetName": "XXXXX",
                "addressStreetNumber": "XX",
                "addressFloor": "1",
                "addressStair": "XX",
                "addressDoor": "XX",
                "addressSituation": "XX",
                "addressPostalCode": "4XXXXX",
                "addressTown": "XXXX",
                "addressProvince": "XXXX",
                "addressZone": "XXXXX",
                "addressSubZone": XXXXX,
                "addressCountry": "España",
                "addressCoordinatesPrecision": "1",
                "addressCoordinatesLatitude": "43.XXXXX",
                "addressCoordinatesLongitude": "-2.XXXXX"
            },
            "propertyFeatures": {
                "featuresType": "Piso",
                "featuresSubType": "XXXX",
                "featuresAreaConstructed": "1XX.0",
                "featuresAreaUsable": "XX.0",
                "featuresBathroomNumber": "X",
                "featuresBedroomNumber": "X",
                "featuresBuiltYear": "2XXXX",
                "featuresConditionedAir": true,
                "featuresConditionedAirName": "climatizacion",
                "featuresHeating": true,
                "featuresHeatingName": "Electrica",
                "featuresConservation": "X",
                "featuresConservationName": "New or SemyNew",
                "featuresDoorman": false,
                "featuresNoRequireCes": false,
                "featuresCesIndex": "43.000",
                "featuresEnergyCertificateRating": "F",
                "featuresEnergyCertificatePerfomance": "2XX.000",
                "featuresEnergyCertificateRatingCo2": "E",
                "featuresCesRegisterNum": "AXXXXXX-1X-004X",
                "featuresGarden": false,
                "featuresOrientationName": "Norte|Sur|Oeste",
                "featuresOrientationEast": false,
                "featuresOrientationWest": false,
                "featuresOrientationNorth": false,
                "featuresOrientationSouth": false,
                "featuresFurnished": "true",
                "featuresFurnishedName": "AMUEBLADO",
                "featuresPool": false,
                "featuresRooms": "XXXX",
                "featuresStorage": false,
                "featuresTerrace": false,
                "featuresWardrobes": false,
                "featuresParkingAvailable": false,
                "featuresGarage": false,
                "featuresGarageIncluded": false,
                "featuresAccess": false
            },
            "propertyDescription": [
                {
                    "descriptionLanguage": "spanish",
                    "descriptionText": "Lorem the It is a long established fact that a reader will be distracted by the readable content of a page when looking at its layout. The point of using Lorem Ipsum is that it has a more-or-less normal distribution of letters"
                },
                {
                    "descriptionLanguage": "english",
                    "descriptionText": "Lorem the It is a long established fact that a reader will be distracted by the readable content of a page when looking at its layout. The point of using Lorem Ipsum is that it has a more-or-less normal distribution of letters"
                }
            ],
            "propertyImages": [
                {
                    "imageLabel": "Parking",
                    "imageOrder": 1,
                    "imageUrl": "http://lorem.inmotek.net/media/lorem/fotos/inmuebles/1205/1205~XXXX.jpg"
                },
                {
                    "imageLabel": "Plano",
                    "imageOrder": 2,
                    "imageUrl": "http://lorem.inmotek.net/media/lorem/fotos/inmuebles/1205/1205~XXXXX.jpg"
                },
                {
                    "imageLabel": "Parking",
                    "imageOrder": 3,
                    "imageUrl": "http://lorem.inmotek.net/media/lorem/fotos/inmuebles/1205/1205~XXXXX.jpg"
                },
                {
                    "imageLabel": "Baño",
                    "imageOrder": 4,
                    "imageUrl": "http://lorem.inmotek.net/media/lorem/fotos/inmuebles/1205/1205~XXXXX.jpg"
                },
                {
                    "imageLabel": "Terraza",
                    "imageOrder": 5,
                    "imageUrl": "http://lorem.inmotek.net/media/lorem/fotos/inmuebles/1205/1205~XXXX.jpg"
                }
            ],
            "propertyDocuments": [
                {
                    "DocName": "XXXX.pdf",
                    "DocLabel": "DOC CES",
                    "DocDescription": "ceslabel",
                    "DocUrl": "//img.inmotek.net/media/XXXX/documentos/inmuebles/XXXXX~XXXX30.pdf"
                }
            ],
            "propertyVirtualTours3D": [
                {
                    "virtualTour": {
                        "virtualTourType": "matterport",
                        "virtualTourUrl": "https://my.matterport.com/show/?m=XXXXXXXXXXX"
                    }
                }
            ],
            "propertyVirtualTours360": [
                {
                    "virtualTour": {
                        "virtualTourType": "360",
                        "virtualTourUrl": "https://my.XXXXX.com/show/?m=XXXXXXXXXXX"
                    }
                }
            ],
            "propertyVideos": [
                {
                    "videoUrl": "https://www.youtube.com/watch?v=XXXXXXXXX"
                }
            ]
        }
    ],
    "cached_time": "20XX-XX-XX XX:XX:00"
}

Contact - #back to top

https://api.inmotek.net/v3/contact

With this API request you can create a contact at Inmotek with which the agency can decide whether or not to create a demand.

Header parameters

Param Type Mandatory
agency-id integer true
token string true

Accepted parameters

Param Type Mandatory Stackable
property_code int true Always
contact_name string true Always
contact_surname string true Always
contact_phone int false Always
contact_mobile int false Always
contact_email string false Always
contact_notes string false Always
contact_origin string false Always
contact_in_out string true Always
contact_is_promotion boolean false Always
nocache bool false Always

Changelog - #back to top

2021-10-13

-When searching for a property by reference, it was not done correctly. Fixed.

-When searching by property identifier, in some cases it could return duplicate properties. Fixed.

2021-10-14

-Multiple type search returned a null error. Fixed.

2021-10-20

-When making requests by group it returned unselected properties. Fixed.

-The "propertyPromocion" field is removed and replaced by "propertyPromotion"

2021-10-25

-Multiple type search returned a null error again. Fixed.

-It is enabled to search by number of dynamic rooms and bathrooms. Example: rooms:1,2; bathroom:1,2,3 (Properties with one or two bedrooms and one, two or three bathrooms)

-The "search_type" parameter is changed to "search_order_field". The "search_type" parameter will remain active but it is recommended to change to the new one before 2022.

2021-11-03

-It is enabled to search by number of dynamic property status. Example: property_status:1,2; (Properties with 1 or 2 status)

2021-11-04

-Fixed a bug that existed when combining meters and price filters.

-Fixed a problem that caused "propertyVisibility" to always be false.

2021-11-11

-Added "terrace" and "balcony" fields to the data returned in "property_search" and "property".

-It is now possible to obtain managed and portfolio properties in a single response with "property_status"..

2021-11-15

-Duplicate properties were displayed when searching for properties with subtype references "warehouse". Fixed.

2021-11-16

-Error when searching for sub-zones by zone and locality. Fixed.

2022-02-14

-Lift option is added

-Error when sending empty optional parameters. Fixed.

2022-03-01

-Error when searching by several localities and zones as it returned properties that were in those selected localities and in those selected zones in restrictive mode. Now an "OR" is applied to search in those localities or in those zones. Fixed.

2022-03-17

-A field (propertyGroup) is added in the "Property" call to identify whether a property is a group property or not..

2022-04-01

-New variable "web_group" is added for the "property_search" request in order to get more accurate data depending on the type of web requesting the data.

-New type "outstanding" added for "search_order_field".

2022-05-04

-New variable "garden" is added for the request "property_search" and "num_property_search".

2023-02-01

-Two news params, search_code_ref and search_exact_code_ref is added for the request "property_search" and "num_property_search". "search_code_ref" unifies the current "search_code" and "search_ref" into a single filter.

2023-02-08

-Add news params, featuresKitchenNotes, featuresLarder, featuresDomotica, featuresLaundryRoom, featuresBowWindow, featuresBlinds, featuresHighCeilings, featuresClothersRack, featuresDressingRoom, featuresBunkBed, featuresStrongBox, featuresSupplies is added for the request "property".

2023-07-07

-Added frominmotek parameter.

2024-08-28

-Added new filter `VPO`.