Home › Store Building Guide

Query Strings

A query string allows you define specific parameters when returning a list of products. 

Available Parameters:

  • c - possible values are category ID, category slug or category placeholder (%ci).
  • network - possible values are network name, or a part thereof.
  • merchant - possible values are merchant name, or a part thereof.
  • name - possible values are product name, or a part thereof.
  • price - possible values are exact price or price range.
    • price=-10 equals products priced less than 10.
    • price=10- equals products prices more than 10.
    • price=10-20 equals products priced between 10 and 20.
  • saleprice - possible values are exact saleprice or saleprice range.
    • saleprice=-10 equals products sale priced less than 10.
    • saleprice=10- equals products sale prices more than 10.
    • saleprice=10-20 equals products sale priced between 10 and 20.
  • sort - possible values are field names (like sort=price) optionally preceded by '-' (like sort=-price) for reverse sorting.
  • word - possible values are a keyword which appears in the product name, description and/or tags.
  • tags - possible values are words, separated by "+".

 

Example Usages:

Filter products by category ID

c=12345

Filter products by category slug

c=running-shoes

Filter products by an affiliate network name

network=Google Affiliate Network

Filter products by a partial affiliate network name

network=Google

Filter products by product name

name=Nike Running Shoes

Filter products by merchant name

merchant=Apple iTunes

Filter products by a partial merchant name

merchant=Apple

Filter products by an exact price

price=10

Filter products by a less than price

price=-10

Filter products by a more than price

price=10-

Filter products by a price range

price=10-20

Filter products by one keyword tag

tags=shoe

Filter products by multiple keyword tags

tags=shoe+running

Filter products by all words in product's name, description or tags)

word=shoe+running

Custom query string advanced examples

Filter products by category ID and price range

c=12345&price=10-20

Filter products by category ID, price range and network

c=12345&price=10-20&network=shareasale

Filter products by words and price

words=running+shoe&price=10-