Skip to main content
Tools that accept a query or keywords parameter support a Lucene-style search syntax. This gives you precise control over what results are returned.

​
Quick Reference

SyntaxExampleMeaning
Plain keywordsbitcoin cryptoMatch either term (OR)
Quoted phrase"machine learning"Exact phrase match
ANDAI AND roboticsBoth terms required
ORTesla OR SpaceXEither term matches
Grouping(AI OR ML) AND healthcareCombine operators
@handles@karpathyMatch mentions

​
Plain Keywords

Space-separated keywords are treated as OR queries — results matching any of the terms are returned. 
artificial intelligence
This matches posts containing “artificial” OR “intelligence” (or both).

​
Quoted Phrases

Wrap terms in double quotes to match an exact phrase: 
"machine learning"
This only matches posts containing the exact phrase “machine learning” as a contiguous string. You can combine phrases with other terms: 
"deep learning" AND python

​
Boolean Operators

Two boolean operators are supported: AND and OR. They are case-insensitive.
Both terms must be present in the result.
AI AND crypto

"artificial intelligence" AND ethics

​
Grouping with Parentheses

Use parentheses to control operator precedence: 
(AI OR "artificial intelligence") AND ethics

(bitcoin OR ethereum) AND (regulation OR policy)
Without parentheses, operators are evaluated left to right. Use grouping to make your intent explicit, especially when mixing AND and OR.

​
Platform-Specific Search Scope

Different tools search different fields depending on the platform:
PlatformContent Searched
Twitter postsPost text
Instagram postsCaptions and subtitles
Instagram commentsComment text
Reddit postsTitle and selftext
Reddit commentsBody text
TikTok postsDescription and transcripts

​
Examples by Platform

Find posts about AI from specific conversations:
"artificial intelligence" AND (startup OR venture)
Find posts mentioning a user:
@elonmusk AND Tesla
Find fashion-related posts:
"street style" OR "fashion week"
Find food content in a specific cuisine:
(sushi OR ramen) AND Tokyo
Find technical discussions:
"rust programming" AND (async OR concurrency)
Find product reviews:
review AND (iPhone OR Pixel)
Find trending content:
"day in my life" AND (NYC OR "New York")
Find educational content:
(tutorial OR "how to") AND cooking
For TikTok, also consider using getTiktokPostsByHashtags which searches the indexed hashtags column directly — this is faster and more precise than keyword search for hashtag-based discovery.

​
Syntax Rules

These rules are enforced by the server. Queries that violate them will be rejected.
RuleValidInvalid
Operators need terms on both sidesAI AND cryptoAND crypto
Cannot start with AND or ORbitcoin OR ethereumOR bitcoin
Cannot end with an operatorAI AND MLAI AND
Max query length: 250 characters——

​
Unsupported Syntax

The following are not supported and will be stripped or treated as spaces:
SyntaxBehavior
Field operators (from:, lang:, since:, until:)Stripped from query
Forward slashes (/)Treated as spaces (24/7 becomes 24 7)
Colons (:)Treated as spaces
Backslashes (\)Removed
Apostrophes (')Removed
Square brackets ([])Removed
Leading wildcards (*term)Stripped
If you need to filter by date range, language, or author, use the dedicated tool parameters (e.g., startDate, endDate, language, username) instead of embedding them in the query string.