Deep Linking Instructions
The deep linking instructions allow you to link your customers straight into predefined live searches.

The deep linking instructions allow you to link your customers straight into predefined live searches for various search types.
IMPORTANT: You should not share or advertise links to your search results pages directly as they contain a unique search session that is for a single user/customer only. After roughly 20 minutes, the search session will expire and not be bookable, despite still displaying the results on screen.
We have a deeplink generator page to make it easier to build deeplinks for your website. Just perform a search on your website and paste the results page URL into the generator, it will convert your search into a deeplink that you can share with your customers.
Shared Parameters
The parameters below are shared between all search types. All parameters in red are required. Parameters in green are required under the defined circumstances, all other parameters are optional and may have default values assigned to them when not provided.
| Parameter | Example(s) | Description |
|---|---|---|
| AppID | https://dl.tvllnk.com/deeplink/100 | You unique application id (found in your travelify dashboard under Applications > API Keys > Application ID) is part of the deep link URL |
| st | st=Flights st=Accommodation st=DynamicPackaging st=CarRental st=TicketsAttractions | Search type |
| lang | lang=en lang=de lang=fr | Language code (default en) |
| curr | curr=GBP curr=EUR | Currency code (default GBP) |
| nat | nat=GB nat=IE | Primary traveller nationality country code (default GB) |
| scr | src=google-adwords src=icelolly | Optional source tracking can be used for tagging any orders placed to an advertising source |
| adt | adt=2 | Number of adults (1-9) |
| chd | chd=2 | Number of children (0-9) |
| chdage | chdage=4&chdage=5 | Child ages (must specify an age for each child searched) |
| inf | inf=1 | Number of infants (0-number of adults) |
Flights
Search for one-way or return flights. You can specify an exact departure date (fr) or a dynamic departure date based on the number of days from the current date (frd). For return flights, you can specify a specific return date (to) or use a duration in days (dur).
| Parameter | Example(s) | Description |
|---|---|---|
| org | org=LON | Origin IATA airport/city code |
| dst | dst=AGP | Destination IATA airport/city code |
| fr | from=2022-05-20 | Departure date (yyyy-mm-dd) |
| to | to=2022-05-27 | Optional return date (yyyy-mm-dd) for return flights |
| frd | frd=30 | Dynamic departure date (days from current date) |
| dur | dur=7 | Optional duration (days) for return flights |
| flex | flex=true flex=false | Flexible dates - if true, normally allows searching up to 3 days either side of the searched date, supplier dependent (default false) |
| dir | dir=true dir=false | Direct flights preferred (default false) |
| cabin | cabin=Any cabin=Economy cabin=PremiumEconomy cabin=Business cabin=First | Preferred cabin class (default Any) |
| carrier | carrier=BA | Search for a single carrier/airline |
Example deep link for a return flight from London All (LON) to Malaga (AGP) departing on 20th May 2022, returning 27th May 2022 for 2 adults:
https://dl.tvllnk.com/deeplink/100?st=Flights&org=LON&dst=AGP&fr=2022-05-20&to=2022-05-27&adt=2
Example deep link for a return flight from London All (LON) to Malaga (AGP) departing in 20 days from today for 7 days with flexible dates for 2 adults and 2 children (age 4 & 5) only searching for Economy class:
Accommodation
Search for accommodation in a location. You can specify an exact check-in date (fr) or a dynamic check-in date based on the number of days from the current date (frd). You can specify a specific check-out date (to) or use a duration in nights (dur) from the check-in date.
| Parameter | Example(s) | Description |
|---|---|---|
| loc | loc=Barcelona | Location name |
| ctry | ctry=ES | Location country code |
| fr | from=2022-05-20 | Check-in date (yyyy-mm-dd) |
| to | to=2022-05-27 | Check-out date (yyyy-mm-dd) |
| frd | frd=30 | Dynamic check-in date (days from current date) |
| dur | dur=7 | Duration (nights) |
| loct | loct=City loct=Airport loct=PointOfInterest loct=Property | Location type lookup (default City) |
| rad | rad=15 | Search radius around the location in KM (default 10, but some areas will have a radius override to bring back results for the whole area searched, for example Majorca, ES has an override of 54km to cover the whole island) |
| rat | rat=3 rat=3.5 | Minimum star rating (default 0) |
| brd | brd=Any brd=RoomOnly brd=SelfCatering brd=BedAndBreakfast brd=HalfBoard brd=FullBoard brd=AllInclusive | Preferred board basis (default Any) |
Example deep link for accommodation in Barcelona, ES checking in on 20th May 2022 and check out on 27th May 2022 for 2 adults:
Example deep link for accommodation in Dubai, AE checking in from 20 days from today for a duration of 7 nights for 2 adults with a minimum star rating of 3 and All-Inclusive board only:
Dynamic Packaging
Search for dynamic packaging (flight + hotel) in a location. You can specify an exact check-in date (fr) or a dynamic check-in date based on the number of days from the current date (frd). You can specify a specific check-out date (to) or use a duration in nights (dur) from the check-in date.
| Parameter | Example(s) | Description |
|---|---|---|
| org | org=LON | Flight origin IATA airport/city code |
| dst | dst=BCN | Flight destination IATA airport/city code |
| loc | loc=Barcelona | Accommodation location name |
| ctry | ctry=ES | Accommodation location country code |
| fr | from=2022-05-20 | Departure date (yyyy-mm-dd) |
| to | to=2022-05-27 | Return/check-out date (yyyy-mm-dd) |
| frd | frd=30 | Dynamic departure date (days from current date) |
| dur | dur=7 | Duration (nights) |
| flex | flex=true flex=false | Flexible dates - if true, normally allows searching up to 3 days either side of the searched date, supplier dependent (default false) |
| dir | dir=true dir=false | Direct flights preferred (default false) |
| cabin | cabin=Any cabin=Economy cabin=PremiumEconomy cabin=Business cabin=First | Preferred cabin class (default Any) |
| carrier | carrier=BA | Search for a single carrier/airline |
| loct | loct=City loct=Airport loct=PointOfInterest loct=Property | Accommodation location type lookup (default City) |
| rad | rad=10 | Search radius around the location in KM (default 10, but some areas will have a radius override to bring back results for the whole area searched, for example Majorca, ES has an override of 54km to cover the whole island) |
| rat | rat=3 rat=3.5 | Minimum star rating (default 0) |
| brd | brd=Any brd=RoomOnly brd=SelfCatering brd=BedAndBreakfast brd=HalfBoard brd=FullBoard brd=AllInclusive | Preferred board basis (default Any) |
Example deep link for flight + hotel in Malaga, ES flying from London All (LON) checking in on 20th May 2022 and check out on 27th May 2022 for 2 adults, Half Board and a minimum star rating of 3:
Example deep link for flight + hotel in Dubai, AE flying from London All (LON) checking in from 20 days from today for a duration of 7 nights for 2 adults flying Business class only:
Car Rental
Search for rental cars in a location. You can specify an exact pickup date (fr) or a dynamic pickup date based on the number of days from the current date (frd). You can specify a specific dropoff date (to) or use a duration in days (dur) from the pickup date.
| Parameter | Example(s) | Description |
|---|---|---|
| pup | pup=Malaga | Pickup location name |
| pupctry | pupctry=ES | Pickup location country code |
| fr | from=2022-05-20T09:00 | Pickup date and time (yyyy-mm-ddTHH:mm) |
| to | to=2022-05-27T14:30 | Dropoff date and time (yyyy-mm-ddTHH:mm) |
| frd | frd=30 | Dynamic pickup date (days from current date) |
| dur | dur=7 | Duration (days) |
| pupt | pupt=City pupt=Airport pupt=PointOfInterest pupt=Property | Pickup location type lookup (default Airport) |
| drp | drp=Malaga | Optional dropoff location name (if not specified will return to same as pickup location) |
| drpctry | drpctry=ES | Optional dropoff location country code |
| drpt | pupt=City pupt=Airport pupt=PointOfInterest pupt=Property | Dropoff location type lookup (default Airport) |
| age | age=30 | Driver age (default 30) |
Example deep link for car rental from Barcelona Airport, ES with a pickup of 20th May 2022 at 9:30am and dropoff on 27th May 2022 at 2:30pm, driver age of 40:
Tickets and Attractions
Search for tickets and attractions in a location. You can specify an exact check-in date (fr) or a dynamic check-in date based on the number of days from the current date (frd). You can specify a specific check-out date (to) or use a duration in nights (dur) from the check-in date.
| Parameter | Example(s) | Description |
|---|---|---|
| loc | loc=Barcelona | Location name |
| ctry | ctry=ES | Location country code |
| fr | from=2022-05-20 | Date from (yyyy-mm-dd) |
| to | to=2022-05-27 | Date to (yyyy-mm-dd) |
| frd | frd=30 | Dynamic date from (days from current date) |
| dur | dur=7 | Duration (nights) |
| loct | loct=City loct=Airport loct=PointOfInterest loct=Property | Location type lookup (default City) |
| rat | rat=3 rat=3.5 | Minimum star rating if searching for properties (default 0) |
Example deep link for tickets and attractions in Barcelona, ES between 20th May 2022 and 27th May 2022 for 2 adults:
Example deep link for tickets and attractions in Dubai, AE between 20 days from today for a duration of 7 nights for 2 adults:
https://dl.tvllnk.com/deeplink/100?st=TicketsAttractions&loc=Dubai&ctry=AE&frd=20&dur=7&adt=2


