Skip to main content

Example search queries for link filters

S
Written by Short.io
Updated this week

The Short.io filters are based on a lightweight and performant Lucene-like search engine which allows you to look for short links using various fields and applying certain logical combinations among them.

Available searchable fields

Here is a list of the search fields which you can use to filter your short links:

Field

Description

androidURL

Android redirect URL

archived

Archive status of the short link (true or false)

clicksLimit

Clicks limit setting for temporary links

cloaking

Cloaking status (true or false)

createdAt

Short link creation timestamp (Unix epoch time format in milliseconds)

expiredURL

Redirect URL setting for expired link

expiresAt

Short link expiration timestamp (Unix epoch time format in milliseconds)

FolderId

Folder assignment of the short link

id

Unique identifier of the short link

iphoneURL

iOS redirect URL

originalURL

Target URL (or original long link)

ownerId

Unique identifier of the short link's owner

password

Password protection setting (to be used as follows - password:y)

path

Short link path

redirectType

HTTP redirect code of the short link

for example, 308

source

Short link creation method - API or website

splitPercent

A/B (variation) testing redirect percent

splitURL

Full URL of the variation page

tags

Tags of the short link

title

Title of the short link

updatedAt

Timestamp of the last short link update (Unix epoch time format in milliseconds)

Query syntax and examples

Below, we present several examples of how to perform searches accurately.

Basic keyword matching

When you input a keyword (or a portion of it) into the search query field and click on apply, your result list will display all the short links that include this keyword in any of the available search fields.

For example, if you search for Link_1:

then the result list might look as follows:

In the first row Link_1 is part of the original URL; in the second row it is contained in the short link, and in the third row we find it in the link title.

Note: Searching for a given keyword in any field is case insensitive. Therefore, if you enter, for example, short_link1 as your query, it can result in finding not just the short links that fit this criteria, but also those that contain Short_link1, Short_Link1, or any combination of upper and lower case letters.

Using wildcard parameters

Wildcards are special characters that can stand in for unknown characters in a text and are handy for locating multiple items with similar, but not identical data.

You can use the quotation mark (?) and the asterisk sign (*) in your short links filters

as follows:

  • the quotation mark (?) replaces only one character in your keyword. If you search, for example, for any short links which contain in their title "summer_sale_<number>", you can enter as a query - title: summer_sale_?

  • the asterisk sign (*) replaces zero or more characters in your keyword. If you search, for example, for any short links which contain "sale" in their path, you can enter as a query - path: *sale*

Refining your search results

In order to limit the results, you can set more precise filters by:

  • entering the exact keyword in quotation marks, for example - "Link_1456"

    which will result in:

  • specifying the field where to search for the exact keyword, for example - title:"Link_238"

    which will produce:

Using timestamp filters

The following search fields require an additional conversion to the Unix epoch time format in milliseconds: createdAt, expiresAt and updatedAt.

For example, if you are looking for all the temporary short links which will expire on July 30, 2025 or before that date:

then you need to convert the date in Unix time - 1753876800000 and enter the following query expiresAt:<=1753876800000:

Using Boolean operators and logical NOT

You can combine several search fields in one query by applying the operators AND, OR and by using the logical NOT.

For example, you can search for all the links where path:*ew_arrivals* AND originalURL:" https://mybrand.bg/new_arrivals_30_percent_off". The result will be:

And if your goal is to further filter out the summer_sale results, all you need to do is expand the query with the NOT operator: (path:*ew_arrivals* AND originalURL:"https://mybrand.bg/new_arrivals_30_percent_off") AND NOT title:"summer_sale"

Using unique identifiers

You can search for a specific short link or links in a folder by using their unique identifiers. (More information on retrieving identifiers can be found in the article: https://help.short.io/en/articles/9755750-how-to-retrieve-domain-link-and-folder-identifiers-from-the-short-io-urls-and-api)

To filter by short link id, your search query should look similar to this one: id:lnk_5je2_OYLEbypKgjYoJfff4uXwl

And to filter by folder id, use the following query, for example: FolderId:sdcnlUo3lZ_58olRtlVn4


Related articles

Did this answer your question?