Price Search Engine (PSE) parameters

PSE Information : Query Testing Tool

PSE parameters are all optional. Specifying parameter will filter the search result. Once filtering has been done, you can also specify sorting parameters to control the order of the search result.

Available PSE Options:

Search Result Filtering Parameters:

keyword = Keyword [alphanumeric search phrase(s)] (Specify an optional default keyword)

• Multiple keywords can be specified separated by spaces. Special characters such as + - can be added for special rules. See Advanced Search Tips
• If you are passing keyword automatically from your own script, make sure the keyword(s) are URL Encoded to ensure it is URL syntax compliant.
• EXAMPLE: (searching for microsoft xbox)
  • &dff_keyword=microsoft+xbox
  • .....DFF_PSE_SCRIPT....?dff_keyword=microsoft+xbox

catnum = Category # [numeric] (Specify an optional default category)

• Category number obtained from DFF list of categories.
• You can download (CSV/Excel, TAB) to see DFF list of categories.
• Get category # using DFF Category # Finder.
• EXAMPLE: (only show result from category # 340 computer hardware)
  • &dff_catnum=340
  • ...DFF_PSE_SCRIPT....?dff_catnum=340

mfgnum = Manufacturer # [numeric] (Specify an optional default manufacturer)

• Manufacturer number can be obtained from DFF list of manufacturers.
• You can download (CSV/Excel, TAB) to see DFF list of manufacturers.
• Get manufacturer # using DFF Manufacturer # Finder.
• EXAMPLE: (only show result from Manufacturer # Sony)
  • &dff_mfgnum=
  • ...DFF_PSE_SCRIPT...?dff_mfgnum=

mernum = Merchant / Store # [numeric] (Specify an optional default store)

• Merchant/Store number can be obtained from DFF list of stores.
• You can download (CSV/Excel, TAB, PHP array) to see DFF list of Merchants/Stores.
• Get merchant # using DFF Merchant/Store # Finder.
• EXAMPLE: (only show result from Merchant # 6739 Walmart Online)
  • &dff_mernum=6739
  • ...DFF_PSE_SCRIPT...?dff_mernum=6739

pricelow = Minimum price to show [numeric with/without decimal] (Specify an optional Minimum Price)

• Setting pricelow parameter will force search output to only show search result equal to or greater than pricelow.
• EXAMPLE: (only show result with minimum price of $100.00 or greater)
  • &dff_pricelow=100
  • ...DFF_PSE_SCRIPT...?dff_pricelow=100

pricehigh = Maximum price to show [numeric with/without decimal] (Specify an optional Maximum Price)

• Setting pricehigh parameter will force search output to only show search result equal to or less than pricehigh.
• EXAMPLE: (only show result with maximum price of $500.00 or less)
  • &dff_pricelow=500
  • ...DFF_PSE_SCRIPT...?dff_pricelow=500

---

Behaviour & Styling Parameters:

view = Controls the style of displaying search result items. (only apply to Javascript + dynamic language calling scripts. DOES not apply to XML/JSON).

• The view options are: grid, text, list
• The default view is list.
• EXAMPLE:
  • &dff_view=grid
  • ...DFF_PSE_SCRIPT...?dff_view=grid
  
  

mr = URL Schema # [numeric] (Specify a mod_rewrite URL schema)

• mod_rewrite is a way to modify the appearance of URL making it easier to read and more SEO compliant.
• Using mod_rewrite you can stuff in SEO related keywords which may help your search engine keyword ranking.
• Read more Wikipedia::mod_rewrite. Learn how to use mod_rewrite with PSE.
• In order to use mod_rewrite with PSE you have to Create a URL Schema, then you specify the URL schema number after the mr=.
• EXAMPLE: (use mod_rewrite with URL Schema #1)
  • &dff_mr=1
  • ...DFF_PSE_SCRIPT...?dff_mr=1

nw = External Links Open New Window [numeric] ( 1 = new window ) if not specified external links will open in existing window.

• There is only one value you can pass-in with the nw parameter, it is a numerical value of 1 which means TRUE / Enabled.
• EXAMPLE: (open external links in new window)
  • &dff_nw=1
  • ...DFF_PSE_SCRIPT...?dff_nw=1

bar = Hide search bar [alphabet] ( h = hide ) if not specified external links will open in existing window.

• Search bar is the row above search result which contains the Search Text Box and the Category drop down selection box.
• There is only one value you can pass-in with the bar parameter, it is the lowercase letter h which means hide.
• EXAMPLE: (hide search bar)
  • &dff_bar=h
  • ...DFF_PSE_SCRIPT...?dff_bar=h

sp = Hide search path [alphabet] ( h = hide ) if not specified search path will be shown.

• Search path is the same as bread crumb, it display the category levels, search criteria such as search keyword, filters using store, manufacturer, price range.
• There is only one value you can pass-in with the sp parameter, it is the lowercase letter h which means hide.
• EXAMPLE: (hide search path)
  • &dff_sp=h
  • ...DFF_PSE_SCRIPT...?dff_sp=h

ml = Hide merchant logo image [alphabet] ( h = hide ) if not specified merchant logo will be shown.

• Merchant logo is the small 120x30 pixels image representing the logo or symbol of the store which products are being shown.
• There is only one value you can pass-in with the ml parameter, it is the lowercase letter h which means hide.
• EXAMPLE: (hide search merchant logo image)
  • &dff_ml=h
  • ...DFF_PSE_SCRIPT...?dff_ml=h

style = DFF Template (Specify a style template #) [numeric]

• You must create your own DFF Template to obtain a DFF Template #. Created at ACP > Template (optional)
• DFF Template is a simple and easy way to manipulate the color, font and style of the HTML output of the PSE search result.
• EXAMPLE: (use DFF Template # 1209)
  • &dff_style=1209
  • ...DFF_PSE_SCRIPT...?dff_style=1209

offset = Start search result listing from a certain row number, instead of starting from 1.

• offset parameter allow you to jump and show listing starting from a certain row number.
• EXAMPLE: (starting from rec # 20)
  • &dff_offset=20
  • ...DFF_PSE_SCRIPT...?dff_offset=20
• Learn how to implement paging using offset and limit

limit = Limit search result listing to only show a maximum number of records.

• If limit is set, your search result will be limited the only show the maximum number of records specified.
• EXAMPLE: (show only 50 records max)
  • &dff_limit=50
  • ...DFF_PSE_SCRIPT...?dff_limit=50
• Learn how to implement paging using offset and limit

---

Sorting Parameters

sort = The sort parameter controls how the search result will be ordered.

---

PSE Data Query Testing Tool

We have a data query testing tool to help test the affect of the Price Search Engine parameters located at Affiliate Login > Support > Debug > PSE.