Tag Queries

Complex Query Syntax

Presence or absence of tags indicated with prefix "+" and "~" respectively.
Examples below are not encoded (for readability):
+banana&+boxed - query all URLs, that have both "banana" and "boxed" tags attached.
+banana&~boxed - query all URLs, that have "banana" tag and doesn't have "boxed" tag attached.
+banana|+boxed - query all URLs, that have "banana" tag or "boxed" tag attached.
(+banana|+boxed)&(+fresh|~premium) - query all URLs, that have: 1) "banana" tag or "boxed" tag attached; and also have 2) "fresh" tag attached or doesn't have "premium" tag.
"+" prefix may be omitted (it is considered by default)
For AND operator you can use different symbols: &, comma, semicolon.
For XOR operator you can use: ^

Autotags

Currently supported autotags:

• archived - used to query URLs that were archived. Archived URLs disappear from view (Manage URLs) page.
• visited - used to query URLs that were visited at least once (this is not the same as 0-clicks, because click counter may be reset)
• ping - used to query URLs being monitored by our "Link health" service
• email_stats - used to query URLs being sent in daily email reports
• smart - used to query Smart Links.

In addition to above autotags, there is a separate autotag for each domain and separate autotag for each satellite account.

Examples:
+mydomain.com,-visited - query all URLs in domain mydomain.com that never been visited.
mydomain1.com|mydomain2.com - query all URLs that belong to domain mydomain1.com or mydomain2.com.
john_b,mydomain3.com - query all URLs created by john_b in domain mydomain3.com.

Date tags

Tag query may contain date conditions. For example:
>2018-01-01 - query only URLs created after 0am January 1, 2018.
>2018-01-01,<2018-01-02 - query only URLs created from 0am to 24pm January 1, 2018
>DELETE /urls?tags=<2018-02-01 - less than symbol < in this syntax means before.
Delete URLs created before Feb 1, 2018
Tag query for links created today might look like this:
>2018-04-23&<2018-04-24