API · Search

Search Filters

Narrow AI search results by adding a filter_ parameter to your search URL. Filtering is applied before ranking, so what comes back is the best matches within the filter — not a short list with most of it removed. Searches without a filter_ parameter behave exactly as before.

A quick example

https://yourstore.com/?s=boots&filter_category=Winter

The shopper still searches in plain language. The filter decides which slice of the catalogue that search runs against.

Parameters

filter_type
Content type
product
post, page, product, or any public custom post type
filter_category
Category
Winter
WooCommerce product categories and WordPress categories both land here
filter_tag
Tag
sale
product tags and post tags
filter_brand
Brand
Cocolo
where your catalogue provides one
filter_tax_<taxonomy>
Any custom taxonomy
filter_tax_course_cat=Business
use the taxonomy slug after tax_

Three rules worth knowing

Values are the term name, not the slug

Use software development, not software-development. Encode spaces as %20. Capitalisation does not matter.

Combining filters narrows further

Every filter you add must match. filter_type=product plus filter_category=Winter returns products in Winter, not products or Winter.

Custom taxonomies need the tax_ prefix

A taxonomy called course_cat is filtered with filter_tax_course_cat, not filter_course_cat. Only the built-in dimensions in the table above are used without it.

You do not have to guess

The WordPress plugin lists every parameter your own site accepts, with the real values from your catalogue next to each one — your actual categories, your actual taxonomies, and a plain “nothing on this site yet” where a taxonomy is empty. Copy a value straight out of the table.

In WP Admin: Queryra → Support → Search filters

Not the same as…

“Filter” means three different things around Queryra. This page is about the first one.

  • URL filters — this page. You choose the slice of the catalogue.
  • Filters read from the query itself — a shopper typing “wireless headphones under $80, not Beats” gets the price cap and the exclusion applied automatically, with nothing to configure.
  • PHP filters (hooks) — for developers extending what gets indexed. See Queryra Developer Filters.

Related

Don't see your plugin or theme here?

Not sure it works with Queryra, or want us to verify compatibility? Get in touch — tell us the plugin or theme and we'll check, usually the same day.

WordPress Support Forum