Create links with search results

⚠ Attention: this help article requires some advanced knowledge; use it for your own benefit and at your own risk.

index of this help article

Create advanced links to deliver search results

This help article will teach you how to create advanced urls to then build links that can be applied wherever you want, directing to specific search results for your website

A URL is an internet address. In this case we'll teach you how to use internet addresses for your site, created specifically so that when they are entered in the internet browser or used as links, they deliver property results according to a logic determined by you.

Introduction

When you do a traditional search on your website, pressing the search button of your search engine without selecting any filter, it will return all the properties on your website as a result.

These results, which are visible in the browser as photos and text, in a listing, have a specific internet address (url), which contains parameters that can be edited in an advanced way to get different results

Simple usage mode

The simplest way to get customized urls is by doing customized searches. Select different options in the search filters and then press the Search button. See the example in this image

When you press the search button you'll get a url; copy it and use it as a link to show results from your website on your own site or on third-party sites.

Advanced usage mode

As we mentioned, copying the url of a given search result lets you build a link to show those same property results through a button or a link on your website or on third-party websites.

Important: For every URL you build to display property listings, you must provide the parameter &view=list&page=0 at the end of the URL; otherwise it will cause problems in the property list view

http://flex.mapaprop.com/buscar/?operation=&type=&bedrooms=&zone1=&currency=&priceFrom=&priceTo=&view=list&page=0

For this case, the url is made up of a large number of parameters (surely unknown and hard to understand for you), which define which results are to be shown. Let's do a brief analysis.

Main URL: There is a main url, which is your website's address preceded by http:// and followed by a slash "/"

http://www.sudominio.com/

Search function (/buscar/?): Then there is a determination of the search function, defined by "/buscar/?"

http://www.sudominio.com/buscar/?

Search parameters: Finally there are precoded functions (parameters), which allow you to define the results to display

http://www.sudominio.com/buscar/?operation=&type=&bedrooms=&zone1=&currency=&priceFrom=&priceTo=&view=list&page=0

For this case, we can already see that there is a base URL and then a large number of parameters that we still don't know (highlighted in bold)

http://www.sudominio.com/buscar/**?operation=&type=&bedrooms=&zone1=&currency=&priceFrom=&priceTo=&view=list&page=0**

In the next section, we'll begin to analyze these parameters to understand them and finally manipulate them to our liking, in order to get the results we want.

Search parameters

As we mentioned before, there is a base URL (internet domain preceded by http:// and followed by /buscar/?)

http://www.sudominio.com/buscar/?

and then a large number of parameters that we still don't know.

operation=&type=&bedrooms=&zone1=&currency=&priceFrom=&priceTo=&view=list&page=0

Analysis of the parameters

Let's do a brief analysis of these parameters to get to know them and then be able to change them.

To begin, we can see that there is a character that repeats constantly, and it is "&". This character is a divider or concatenator (adder) of parameters: it lets you define the start of a new parameter.

operation=**&type=&bedrooms=&zone1=&currency=&priceFrom=&priceTo=&view=list&**page=0

To understand it better, if I have a url like the following...

http://www.sudominio.com/buscar/?operation=&type=&view=list&page=0

It defines, after /buscar/?

an operation type: operation=
a property type: type=
a view type for the results: view=list
a results page number: page=0

All these parameters are concatenated with a "&" which allows you to insert parameters consecutively and thus build the search URL.

Remember that for any parameter to work you must always place /buscar/? before them

Now that we understand how a search URL is composed, let's see how to change the parameters to get URLs that show property listings with different results

http://www.sudominio.com/buscar/?operation=&type=&bedrooms=&zone1=&currency=&priceFrom=&priceTo=&view=list&page=0

For this case let's analyze the parameters that make up the URL, after the domain (preceded by http://)

/buscar/?operation=&type=&bedrooms=&zone1=&currency=&priceFrom=&priceTo=&view=list&page=0

It defines

an operation type: operation=
a property type: type=
a number of bedrooms: bedrooms=
a zone 1: zone1=
a currency type: currency=
a price from: priceFrom=
a price to: priceTo=
a view type for the results: view=list
a results page number: page=0

All these parameters are concatenated with a "&" which allows you to insert parameters consecutively and thus build the search URL.

Now let's try changing this url to get a different result. For example, if I want to define a different number of bedrooms I'll change the url, specifically the bedrooms parameter, entering a new value, for example "1"

example 1: "bedrooms=1"

http://flex.mapaprop.com/buscar/?operation=1&type=&**bedrooms=1**&zone1=&currency=&priceFrom=&priceTo=&view=list&page=0

If you paste this URL into your browser's address bar, the result will be a listing containing all properties that have been defined with 1 bedroom

Now, if I want to define a specific operation (sale, rental or temporary rental) I'll change the operation parameter by adding a new value, for example 1 (sale)

example 2: "operation=1"

http://flex.mapaprop.com/buscar/?**operation=1**&type=&**bedrooms=1**&zone1=&currency=&priceFrom=&priceTo=&view=list&page=0

If you paste this URL into your internet browser's address bar, a page will be shown with results of properties with operation type 1 only (sale, operation=1), but also with 1 bedroom (bedroom=1).

Some usage examples

The minimum parameter to deliver a listing result is the following (defined as a url).

http://flex.mapaprop.com/buscar/?**view=list&page=0**

Where view-list defines a listing and page=0 defines a results page number. Both parameters are located after the url /buscar/? and separated by the & character

Map results

The minimum parameter to deliver a map result is the following (defined as a url)

http://flex.mapaprop.com/buscar/?**view=map**

For this case, view-map defines a result shown on a map. For this case, it will show all the properties on the website.

Results for a specific zone

The parameters to deliver results by zones relate to the zone coding based on zone1=&zone2=&zone3. This URL will deliver properties from all zones

http://flex.mapaprop.com/buscar/?zone1=&zone2=&zone3&view=list&page=0

Remember to always add the parameter &view=list&page=0 at the end of the URL !NOTE To get zone codes, we always recommend using the simple method of building urls, mentioned earlier in this tutorial. Use the search engine selecting your zones and press search, then copy the code.

http://flex.mapaprop.com/buscar/?zone1=16&zone2=&zone3=&view=list&page=0