≈1.2k tokens on demand. Your agent reads this file only when SKILL.md points to it.
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"
