tools-only Raindrop.io Search Query Syntax
The search query parameter on the /raindrops/{collectionId} endpoint accepts the same search syntax used in the Raindrop.io app. You can test searches in the app first, then copy the query string for API use.
Full help: https://help.raindrop.io/using-search
Basic Search
| Syntax | Description | Example |
|---|---|---|
word1 word2 |
Items containing these words (in title, description, domain, or page content) | apple iphone |
"exact phrase" |
Items containing the exact phrase | "superman vs. batman" |
-term |
Exclude results containing term | -superman |
Tag Operators
| Syntax | Description | Example |
|---|---|---|
#tag |
Items with a specific tag | #coffee |
#"multi word" |
Items with a multi-word tag | #"coffee beans" |
-#tag |
Items without a specific tag | -#coffee |
Boolean Logic
| Syntax | Description | Example |
|---|---|---|
word1 word2 |
AND (default) - items containing all terms | apple iphone |
word1 word2 match:OR |
OR - items containing either term | superman batman match:OR |
Field-Specific Search
| Syntax | Description | Example |
|---|---|---|
title:term |
Search in title only | title:css |
title:"phrase" |
Search exact phrase in title | title:"css grid" |
excerpt:term |
Search in description/excerpt | excerpt:css |
excerpt:"phrase" |
Exact phrase in description | excerpt:"css grid" |
note:term |
Search in notes | note:css |
note:"phrase" |
Exact phrase in notes | note:"css grid" |
link:term |
Search in URL | link:drop |
link:"phrase" |
Exact phrase in URL | link:"crunch base" |
Date Filters
| Syntax | Description | Example |
|---|---|---|
created:YYYY-MM-DD |
Created on specific date | created:2024-06-15 |
created:YYYY-MM |
Created in specific month | created:2024-06 |
created:YYYY |
Created in specific year | created:2024 |
created:>YYYY-MM-DD |
Created after date | created:>2024-01-01 |
created:<YYYY-MM-DD |
Created before date | created:<2024-07-01 |
lastUpdate:YYYY-MM-DD |
Last updated on date | lastUpdate:2024-06-15 |
Type Filters
| Syntax | Description |
|---|---|
type:link |
Regular links |
type:article |
Articles |
type:image |
Images |
type:video |
Videos |
type:document |
Documents |
type:audio |
Audio files |
Special Filters
| Syntax | Description |
|---|---|
❤️ |
Favourites (important items) |
file:true |
Items with file attachments |
notag:true |
Untagged items |
cache.status:ready |
Items with permanent copy saved |
-cache.status:ready |
Items without permanent copy |
reminder:true |
Items with reminders |
info: |
Prefix to disable full-text search |
URL Encoding for curl
When using search queries with curl, URL-encode special characters:
# Search by tag
curl -s -H "Authorization: Bearer $RAINDROP_TOKEN" \
"https://api.raindrop.io/rest/v1/raindrops/0?search=%23tagname"
# Search by exact phrase
curl -s -H "Authorization: Bearer $RAINDROP_TOKEN" \
"https://api.raindrop.io/rest/v1/raindrops/0?search=%22exact%20phrase%22"
# Search by type
curl -s -H "Authorization: Bearer $RAINDROP_TOKEN" \
"https://api.raindrop.io/rest/v1/raindrops/0?search=type%3Aarticle"
# Favourites
curl -s -H "Authorization: Bearer $RAINDROP_TOKEN" \
"https://api.raindrop.io/rest/v1/raindrops/0?search=%E2%9D%A4%EF%B8%8F"
# Untagged items
curl -s -H "Authorization: Bearer $RAINDROP_TOKEN" \
"https://api.raindrop.io/rest/v1/raindrops/0?search=notag%3Atrue"
# Created after a date
curl -s -H "Authorization: Bearer $RAINDROP_TOKEN" \
"https://api.raindrop.io/rest/v1/raindrops/0?search=created%3A%3E2024-01-01"
Common Encoding Reference
| Character | Encoded |
|---|---|
| space | %20 |
# |
%23 |
" |
%22 |
: |
%3A |
< |
%3C |
> |
%3E |
❤️ |
%E2%9D%A4%EF%B8%8F |
Combined Search Examples
Articles tagged "design" created this year
search="type%3Aarticle%20%23design%20created%3A2024"
curl -s -H "Authorization: Bearer $RAINDROP_TOKEN" \
"https://api.raindrop.io/rest/v1/raindrops/0?search=$search"
Untagged items in a specific collection
curl -s -H "Authorization: Bearer $RAINDROP_TOKEN" \
"https://api.raindrop.io/rest/v1/raindrops/COLLECTION_ID?search=notag%3Atrue"
Bookmarks matching either term
search="react%20vue%20match%3AOR"
curl -s -H "Authorization: Bearer $RAINDROP_TOKEN" \
"https://api.raindrop.io/rest/v1/raindrops/0?search=$search"