Using the "not" Prefix in API Filters

Overview

The Repliers API now supports a powerful "not" prefix that allows you to exclude specific values from your search results. This feature works across all API fields and provides flexible filtering options to help you find exactly what you're looking for.

Basic Usage

To exclude a specific value from your results, simply add the not: prefix before the value you want to exclude.

Syntax

field_name=not:value_to_exclude

Example

To find all listings except those with a "Detached" style:

https://api.repliers.io/listings?details.style=not:Detached

This query will return all listings where the style is anything other than "Detached" (Semi-Detached, Terraced, Apartment, etc.).

Multiple Exclusions

You can exclude multiple values by using the not: prefix with multiple parameters. This is particularly useful for fields that support arrays.

Example

To exclude both "Detached" and "Semi-Detached" properties:

https://api.repliers.io/listings?details.style=not:Detached&details.style=not:Semi-Detached

This will return listings with any style except "Detached" or "Semi-Detached".

Excluding Null Values

Sometimes you may want to filter out listings where a field hasn't been defined or is empty. Use not:null to exclude these entries.

Example

To show only listings where the style field has been populated:

https://api.repliers.io/listings?details.style=not:null

This ensures that all returned listings have a defined style value.

Combining Exclusions

You can combine not:null with other exclusions to create more sophisticated filters.

Example

To find listings that have a defined style but are not "Detached":

https://api.repliers.io/listings?details.style=not:Detached&details.style=not:null

This query will return listings where:

• The style field is populated (not null)
• The style is not "Detached"

Common Use Cases

Property Searches

• Exclude specific property types: details.propertyType=not:Apartment
• Exclude multiple bedroom counts: details.numBedrooms=not:1&details.numBedrooms=not:2
• Find properties with defined parking: details.parking=not:null

Location Filtering

• Exclude specific areas: address.area=not:Peel
• Exclude multiple postcodes: address.zip=not:90210&address.zip=not:90213

Important Notes

• The not: prefix works with all API fields, including raw fields.
• Multiple exclusions are applied with AND logic (all conditions must be met)
• not:null specifically targets fields that are undefined, empty, or null
• The not: prefix is case-sensitive, so ensure your values match exactly

Support

If you encounter any issues with the not: prefix functionality or need help with complex filtering scenarios, please contact our support team with specific examples of the queries you're trying to run.

Updated on: 09/07/2025